{"_id":"5b0e13ffc4664e0003c75b5b","project":"5b0e13ffc4664e0003c75a66","version":{"_id":"5b0e13ffc4664e0003c75a67","project":"5b0e13ffc4664e0003c75a66","__v":4,"createdAt":"2015-09-17T16:58:03.490Z","releaseDate":"2015-09-17T16:58:03.490Z","categories":["5b0e13ffc4664e0003c75a68","5b0e13ffc4664e0003c75a69","5b0e13ffc4664e0003c75a6a","5b0e13ffc4664e0003c75a6b","5b0e13ffc4664e0003c75a6c","5b0e13ffc4664e0003c75a6d","5b0e13ffc4664e0003c75a6e","5b0e13ffc4664e0003c75a6f","5b0e13ffc4664e0003c75a70","5b0e13ffc4664e0003c75a71","5b0e13ffc4664e0003c75a72","5b0e13ffc4664e0003c75a73","5b0e13ffc4664e0003c75a74","5b0e13ffc4664e0003c75a75","5b0e13ffc4664e0003c75a76","5b0e13ffc4664e0003c75a77","5b0e13ffc4664e0003c75a89","5b0e13ffc4664e0003c75a8a","5b0e13ffc4664e0003c75a9d","5b0e13ffc4664e0003c75a9e","5b0e13ffc4664e0003c75a9f","5b0e13ffc4664e0003c75aa0","5b0e13ffc4664e0003c75aa1","5b0e13ffc4664e0003c75aa2","5b0e13ffc4664e0003c75aa3","5b0e13ffc4664e0003c75aa4","5b0e13ffc4664e0003c75aa5","5b0e13ffc4664e0003c75aa6","5b0e13ffc4664e0003c75aa7","5b0e13ffc4664e0003c75aa8","5b0e13ffc4664e0003c75aa9","5b0e13ffc4664e0003c75aaa","5b0e13ffc4664e0003c75aab","5b0e13ffc4664e0003c75aac","5b0e13ffc4664e0003c75aad","5b0e13ffc4664e0003c75aae","5b0e13ffc4664e0003c75aaf","5b0e13ffc4664e0003c75ab2","5bb3374f4306ad0003eb18e7","5bbf3c5373e72a000318362b","5bc065567d1cb0000384c649","5cbf19a5f9181f0033fbb968"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"category":{"_id":"5b0e13ffc4664e0003c75aaa","project":"5b0e13ffc4664e0003c75a66","version":"5b0e13ffc4664e0003c75a67","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-12-05T15:44:15.650Z","from_sync":false,"order":6,"slug":"datasets-hub","title":"DATASETS HUB"},"user":"5613e4f8fdd08f2b00437620","__v":0,"parentDoc":null,"githubsync":"","metadata":{"title":"","description":"","image":[]},"updates":["5a9454acbec35c00121d3799","5a957e3a5e17cc0038ed9e62","5a9622b47dbee10012ed3925"],"next":{"pages":[],"description":""},"createdAt":"2017-08-04T16:44:48.934Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"examples":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":43,"body":"[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"* [Overview](#section-overview)\\n* [Choose your studies](#section-choose-your-studies)\\n* [Start your query](#section-start-your-query)\\n* [Start by searching through a study](#section-start-by-searching-through-a-study)\\n* [Start from an entity](#section-start-from-an-entity)\\n* [Filter by an entity's properties](#section-filter-by-an-entity-s-properties)\\n* [View the query results](#section-view-the-query-results)\\n* [Access data for use in your project](#section-access-data-for-use-in-your-project)\",\n  \"title\": \"On this page\"\n}\n[/block]\n##Overview\n\nLearn about selecting studies for your query and filtering by metadata properties. Get an overview of your query results and use them in your projects on the Platform.\n\n##Choose your study\n\nOpen the Data Browser to display the studies available for querying and choose one.  Note that in order to use Controlled Data you need [Controlled Data access via the dbGaP](doc:dbgap-controlled-data-access).\n\n##Start your query\nTo start your query, use either of these options.\n\n###Start by searching through a study\n\nTo search through a study you have selected you can build a query using from search terms. The intuitive, autocomplete search functionality uses your terms to suggest pre-built queries. \n\nSelect a query and continue to edit it on the Data Browser canvas. For more information, see [Data Browser query: start by searching through a study](doc:data-browser-query-search-through-a-study).\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/7ef6fed-start-by-searching-through-dataset.jpg\",\n        \"start-by-searching-through-dataset.jpg\",\n        922,\n        493,\n        \"#f7f8f8\"\n      ]\n    }\n  ]\n}\n[/block]\n###Start from an entity\n\nThe [entities](doc:about-metadata-for-studies) of the studies you selected are displayed on the Data Browser when you first open it, as shown below. \n\nStart your queries from a study entities. Simply click on an entity, such as **Sample** below, to start.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/44cab4b-start-from-an-entity.jpg\",\n        \"start-from-an-entity.jpg\",\n        920,\n        432,\n        \"#f5f6f6\"\n      ]\n    }\n  ]\n}\n[/block]\nAdd entities by clicking on a previously added entity. A list of entities associated with the first one appears, as shown below. For instance, a **Subject** can have associated **Sample** or **File**.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/4cd073f-building-a-query.jpg\",\n        \"building-a-query.jpg\",\n        816,\n        542,\n        \"#f3f3f3\"\n      ]\n    }\n  ]\n}\n[/block]\n##Filter by an entity's properties\n\nOnce you've selected an entity, you can filter by that entity's properties. Click **+ Add property** below each entity to add filters. Take advantage of the search box's partial matching functionality to generate a list of properties and values to help you get started.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/7e0f1af-filter-by-entity-properties.jpg\",\n        \"filter-by-entity-properties.jpg\",\n        184,\n        275,\n        \"#8f3da8\"\n      ],\n      \"border\": true\n    }\n  ]\n}\n[/block]\nNote that you can edit a property at any time by clicking the pencil icon. You will be unable to add more values for each property otherwise. \n\n##View the query results\n\nThe table below the Data Browser contains a list of results for the entities which match your query. This table allows you to review returned results, but it does not allow you to select or filter results. All selection and filtering have to be done via the query on the Data Browser canvas.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/b93121f-view-the-query-results.jpg\",\n        \"view-the-query-results.jpg\",\n        1361,\n        896,\n        \"#f4f4f4\"\n      ],\n      \"caption\": \"View query results in table format.\"\n    }\n  ]\n}\n[/block]\n \n##Access data for use in your project\n\nOnce you've built a query, you can access the resulting data for use in a project. Learn more about [accessing data from the Data Browser](doc:access-data-from-the-data-browser).","excerpt":"<a href=\"query-datasets\" style=\"color:#132c56\">QUERY DATASETS</a> ><a href=\"about-the-data-browser\" style=\"color:#132c56\">About the Data Browser</a> > Data Browser feature query structure","slug":"data-browser-query-structure","type":"basic","title":"↳ Data Browser query structure"}

↳ Data Browser query structure

<a href="query-datasets" style="color:#132c56">QUERY DATASETS</a> ><a href="about-the-data-browser" style="color:#132c56">About the Data Browser</a> > Data Browser feature query structure

[block:callout] { "type": "warning", "body": "* [Overview](#section-overview)\n* [Choose your studies](#section-choose-your-studies)\n* [Start your query](#section-start-your-query)\n* [Start by searching through a study](#section-start-by-searching-through-a-study)\n* [Start from an entity](#section-start-from-an-entity)\n* [Filter by an entity's properties](#section-filter-by-an-entity-s-properties)\n* [View the query results](#section-view-the-query-results)\n* [Access data for use in your project](#section-access-data-for-use-in-your-project)", "title": "On this page" } [/block] ##Overview Learn about selecting studies for your query and filtering by metadata properties. Get an overview of your query results and use them in your projects on the Platform. ##Choose your study Open the Data Browser to display the studies available for querying and choose one. Note that in order to use Controlled Data you need [Controlled Data access via the dbGaP](doc:dbgap-controlled-data-access). ##Start your query To start your query, use either of these options. ###Start by searching through a study To search through a study you have selected you can build a query using from search terms. The intuitive, autocomplete search functionality uses your terms to suggest pre-built queries. Select a query and continue to edit it on the Data Browser canvas. For more information, see [Data Browser query: start by searching through a study](doc:data-browser-query-search-through-a-study). [block:image] { "images": [ { "image": [ "https://files.readme.io/7ef6fed-start-by-searching-through-dataset.jpg", "start-by-searching-through-dataset.jpg", 922, 493, "#f7f8f8" ] } ] } [/block] ###Start from an entity The [entities](doc:about-metadata-for-studies) of the studies you selected are displayed on the Data Browser when you first open it, as shown below. Start your queries from a study entities. Simply click on an entity, such as **Sample** below, to start. [block:image] { "images": [ { "image": [ "https://files.readme.io/44cab4b-start-from-an-entity.jpg", "start-from-an-entity.jpg", 920, 432, "#f5f6f6" ] } ] } [/block] Add entities by clicking on a previously added entity. A list of entities associated with the first one appears, as shown below. For instance, a **Subject** can have associated **Sample** or **File**. [block:image] { "images": [ { "image": [ "https://files.readme.io/4cd073f-building-a-query.jpg", "building-a-query.jpg", 816, 542, "#f3f3f3" ] } ] } [/block] ##Filter by an entity's properties Once you've selected an entity, you can filter by that entity's properties. Click **+ Add property** below each entity to add filters. Take advantage of the search box's partial matching functionality to generate a list of properties and values to help you get started. [block:image] { "images": [ { "image": [ "https://files.readme.io/7e0f1af-filter-by-entity-properties.jpg", "filter-by-entity-properties.jpg", 184, 275, "#8f3da8" ], "border": true } ] } [/block] Note that you can edit a property at any time by clicking the pencil icon. You will be unable to add more values for each property otherwise. ##View the query results The table below the Data Browser contains a list of results for the entities which match your query. This table allows you to review returned results, but it does not allow you to select or filter results. All selection and filtering have to be done via the query on the Data Browser canvas. [block:image] { "images": [ { "image": [ "https://files.readme.io/b93121f-view-the-query-results.jpg", "view-the-query-results.jpg", 1361, 896, "#f4f4f4" ], "caption": "View query results in table format." } ] } [/block] ##Access data for use in your project Once you've built a query, you can access the resulting data for use in a project. Learn more about [accessing data from the Data Browser](doc:access-data-from-the-data-browser).