{"_id":"5a8af39b13885d0039cd8c42","project":"55faf11ba62ba1170021a9a7","version":{"_id":"55faf11ba62ba1170021a9aa","project":"55faf11ba62ba1170021a9a7","__v":40,"createdAt":"2015-09-17T16:58:03.490Z","releaseDate":"2015-09-17T16:58:03.490Z","categories":["55faf11ca62ba1170021a9ab","55faf8f4d0e22017005b8272","55faf91aa62ba1170021a9b5","55faf929a8a7770d00c2c0bd","55faf932a8a7770d00c2c0bf","55faf94b17b9d00d00969f47","55faf958d0e22017005b8274","55faf95fa8a7770d00c2c0c0","55faf96917b9d00d00969f48","55faf970a8a7770d00c2c0c1","55faf98c825d5f19001fa3a6","55faf99aa62ba1170021a9b8","55faf99fa62ba1170021a9b9","55faf9aa17b9d00d00969f49","55faf9b6a8a7770d00c2c0c3","55faf9bda62ba1170021a9ba","5604570090ee490d00440551","5637e8b2fbe1c50d008cb078","5649bb624fa1460d00780add","5671974d1b6b730d008b4823","5671979d60c8e70d006c9760","568e8eef70ca1f0d0035808e","56d0a2081ecc471500f1795e","56d4a0adde40c70b00823ea3","56d96b03dd90610b00270849","56fbb83d8f21c817002af880","573c811bee2b3b2200422be1","576bc92afb62dd20001cda85","5771811e27a5c20e00030dcd","5785191af3a10c0e009b75b0","57bdf84d5d48411900cd8dc0","57ff5c5dc135231700aed806","5804caf792398f0f00e77521","58458b4fba4f1c0f009692bb","586d3c287c6b5b2300c05055","58ef66d88646742f009a0216","58f5d52d7891630f00fe4e77","59a555bccdbd85001bfb1442","5a2a81f688574d001e9934f5","5b080c8d7833b20003ddbb6f"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"category":{"_id":"58458b4fba4f1c0f009692bb","project":"55faf11ba62ba1170021a9a7","version":"55faf11ba62ba1170021a9aa","__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":"566590c83889610d0008a253","githubsync":"","__v":2,"parentDoc":null,"updates":["5aa0986bd046da001243db0b","5b13255d3dc1c10003d8a975"],"next":{"pages":[],"description":""},"createdAt":"2018-02-19T15:56:11.701Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":33,"body":"[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"On this page:\",\n  \"body\": \"* [Overview](#section-overview)\\n  * [Procedure](#section-procedure)\\n  * [Types of suggestions](#section-types-of-suggestions)\\n  * [Example query](#section-example-query)\\n  * [Next step](#section-next-step)\"\n}\n[/block]\n##Overview\n\nYou can build a query in the Data Browser starting from one or more search terms. The intuitive, autocomplete functionality uses your search terms to suggest pre-built queries. Then, you can select a query and continue to edit it on the Data Browser canvas.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/8f514b2-data-browser-keywords-example.png\",\n        \"data-browser-keywords-example.png\",\n        946,\n        460,\n        \"#ba6246\"\n      ]\n    }\n  ]\n}\n[/block]\n<div align=\"right\"><a href=\"#top\">top</a></div>\n\n##Procedure\n\n1. Open the [Data Browser](doc:about-the-data-browser).\n2. Select one or more dataset(s) to query.\n3. Enter one or more terms into the search field.\n4. Click the **Search** button to the right of the search field to query across all entered terms, and select a matched query from the **Results** page.\n5. Alternatively, select one of the matched queries that is displayed under **Related Queries** in the auto-populated list that appears upon entering search term(s), or select one of the existing queries that is displayed in the **Saved** or **Examples** tab. \n\nLearn more below about suggestions that appear once you enter a term, or explore the [Example query](#section-example-query) to see this in action.\n\n<div align=\"right\"><a href=\"#top\">top</a></div>\n\n##Types of suggestions\n\nAs you enter search terms, the following types of suggestions appear:\n###Keywords\n\nSelect keywords, such as **Primary site / Breast**, to refine the queries suggested in the **Related queries** and **Saved** and **Examples** sections. Continue your search by entering another term. \n\nNote that keyword suggestions are shown for every term, independent of previously entered terms in the search field. For more information, see the [Example query](#section-example-query) below.\n\n###Related Queries\n\nA **Related Queries** section is displayed upon entering term(s) in the search field. This section lists pre-built queries based on your search terms. Click on a result to open it in the Data Browser canvas and continue to edit the query. Learn more about [editing queries](doc:data-browser-query-start-from-scratch).\n\n###Saved and Examples\n\nThe **Saved** and **Examples** tabs display any of your saved queries that match the entered search terms and example queries developed by the Seven Bridges bioinformatics team, respectively. Click on a result to open it in the Data Browser canvas and continue to edit the query. Learn more about [editing queries](doc:data-browser-query-start-from-scratch).\n\n<div align=\"right\"><a href=\"#top\">top</a></div>\n\n##Example query\n\nFollow the instructions below to find an example query involving males with a primary tumor of lung adenocarcinoma.\n\n1. Select dataset **TCGA GRCh38**.\n2. In the search field enter the following terms and select the corresponding Keywords: **lung adenocarcinoma** and **Investigation / Investigation Name / Lung Adenocarcinoma**; **male** and **Gender / male**; and **primary tumor** and **Sample type / Primary Tumor**.\n3. Click **Search** to see pre-built queries on the **Results** page.\n4. Select a result to populate the Data Browser canvas with the query.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/ac846b0-data-browser-keywords-example-3.png\",\n        \"data-browser-keywords-example-3.png\",\n        785,\n        405,\n        \"#906387\"\n      ]\n    }\n  ]\n}\n[/block]\n<div align=\"right\"><a href=\"#top\">top</a></div>\n\n##Next step\n\nImport the files from a given query into your project by clicking on **+ Copy files to project**, or [edit your query](doc:data-browser-query-start-from-scratch) further. To return to the search field and modify your query, click on the trash icon in the upper righthand corner.","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 query: start by searching through a dataset","slug":"data-browser-query-start-by-searching-through-a-dataset","type":"basic","title":"↳ Data Browser query: start by searching through a dataset"}

↳ Data Browser query: start by searching through a dataset

<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 query: start by searching through a dataset

[block:callout] { "type": "warning", "title": "On this page:", "body": "* [Overview](#section-overview)\n * [Procedure](#section-procedure)\n * [Types of suggestions](#section-types-of-suggestions)\n * [Example query](#section-example-query)\n * [Next step](#section-next-step)" } [/block] ##Overview You can build a query in the Data Browser starting from one or more search terms. The intuitive, autocomplete functionality uses your search terms to suggest pre-built queries. Then, you can select a query and continue to edit it on the Data Browser canvas. [block:image] { "images": [ { "image": [ "https://files.readme.io/8f514b2-data-browser-keywords-example.png", "data-browser-keywords-example.png", 946, 460, "#ba6246" ] } ] } [/block] <div align="right"><a href="#top">top</a></div> ##Procedure 1. Open the [Data Browser](doc:about-the-data-browser). 2. Select one or more dataset(s) to query. 3. Enter one or more terms into the search field. 4. Click the **Search** button to the right of the search field to query across all entered terms, and select a matched query from the **Results** page. 5. Alternatively, select one of the matched queries that is displayed under **Related Queries** in the auto-populated list that appears upon entering search term(s), or select one of the existing queries that is displayed in the **Saved** or **Examples** tab. Learn more below about suggestions that appear once you enter a term, or explore the [Example query](#section-example-query) to see this in action. <div align="right"><a href="#top">top</a></div> ##Types of suggestions As you enter search terms, the following types of suggestions appear: ###Keywords Select keywords, such as **Primary site / Breast**, to refine the queries suggested in the **Related queries** and **Saved** and **Examples** sections. Continue your search by entering another term. Note that keyword suggestions are shown for every term, independent of previously entered terms in the search field. For more information, see the [Example query](#section-example-query) below. ###Related Queries A **Related Queries** section is displayed upon entering term(s) in the search field. This section lists pre-built queries based on your search terms. Click on a result to open it in the Data Browser canvas and continue to edit the query. Learn more about [editing queries](doc:data-browser-query-start-from-scratch). ###Saved and Examples The **Saved** and **Examples** tabs display any of your saved queries that match the entered search terms and example queries developed by the Seven Bridges bioinformatics team, respectively. Click on a result to open it in the Data Browser canvas and continue to edit the query. Learn more about [editing queries](doc:data-browser-query-start-from-scratch). <div align="right"><a href="#top">top</a></div> ##Example query Follow the instructions below to find an example query involving males with a primary tumor of lung adenocarcinoma. 1. Select dataset **TCGA GRCh38**. 2. In the search field enter the following terms and select the corresponding Keywords: **lung adenocarcinoma** and **Investigation / Investigation Name / Lung Adenocarcinoma**; **male** and **Gender / male**; and **primary tumor** and **Sample type / Primary Tumor**. 3. Click **Search** to see pre-built queries on the **Results** page. 4. Select a result to populate the Data Browser canvas with the query. [block:image] { "images": [ { "image": [ "https://files.readme.io/ac846b0-data-browser-keywords-example-3.png", "data-browser-keywords-example-3.png", 785, 405, "#906387" ] } ] } [/block] <div align="right"><a href="#top">top</a></div> ##Next step Import the files from a given query into your project by clicking on **+ Copy files to project**, or [edit your query](doc:data-browser-query-start-from-scratch) further. To return to the search field and modify your query, click on the trash icon in the upper righthand corner.