{"_id":"5b0e13ffc4664e0003c75b55","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"},"parentDoc":null,"__v":0,"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"},"project":"5b0e13ffc4664e0003c75a66","user":"5613e4f8fdd08f2b00437620","githubsync":"","metadata":{"title":"","description":"","image":[]},"updates":["5a94491ebec35c00121d3359"],"next":{"pages":[],"description":""},"createdAt":"2016-12-05T16:16:07.155Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[]},"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":42,"body":"[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/c4eb513-data-browser-features-f4c.png\",\n        \"data-browser-features-f4c.png\",\n        1339,\n        768,\n        \"#f3f4f4\"\n      ],\n      \"border\": true\n    }\n  ]\n}\n[/block]\n## 1 Dataset name\n\nThe name of the dataset you are querying is on the left side of the top navigation bar. In the image above, you are currently querying the legacy TCGA dataset found under the \"Legacy\" category.\n\nTo clear your canvas and switch to another dataset (e.g. CCLE,), simply click on the visible dataset name (e.g. TCGA). This opens a dialog in which you can select the alternate dataset.\n\n## 2 Query name\n\nThe name of your query is also on the left side of the top navigation bar. This defaults to **New query** if your query is unsaved.\n\n ## 3 Queries\n\nClick on **Queries** to reveal different actions relating to queries, as shown below.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/a0bafd9-queries.png\",\n        \"queries.png\",\n        509,\n        150,\n        \"#f2f3f3\"\n      ]\n    }\n  ]\n}\n[/block]\nChoose to create a new query, open a previously saved query, open an example query provided by the F4C team, or save a query.\n\nLearn more about:\n\n* [Starting from an example query](doc:data-browser-query-start-from-an-example-query)\n* [Building a query from search terms](doc:query-method-2-start-by-searching-through-a-dataset)\n* [Building a query from scratch](doc:data-browser-query-start-from-scratch) \n* [Working from an existing query](doc:data-browser-query-start-from-an-existing-query)\n* [Starting by searching for an ID](doc:data-browser-query-start-by-searching-for-an-id)\n\n\n## 4 Save a query\n\nYou can save any query on the Data Browser. Note that empty canvases cannot be saved as queries.\n\nThis feature is still in Beta, and we will continue to make improvements.\n\nTo save a query:\n\n1. Click **Queries** on the top of the Data Browser canvas next to the help icon.\n2. Select **Save** from the drop-down menu.\n3. In the pop-up window which appears, you can name your query, as shown below. Click **Add** **description** to add a brief description of your query.\n4. Then, click **Save Query**.\n\nAll saved queries can be accessed by selecting **Open save**d from the **Queries** drop-down menu. Learn more about [accessing saved queries](doc:data-browser-query-start-from-an-existing-query).\n\n## 5 The Search Box\n\nClick on **Search by ID** to reveal the search box. The search box allows you to search by UUID, ID (TCGA Barcodes), or file name.\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/ac44019-search-by-id-2.png\",\n        \"search-by-id-2.png\",\n        495,\n        363,\n        \"#ebecec\"\n      ]\n    }\n  ]\n}\n[/block]\nYou can enter more than one UUID, ID (TCGA Barcode), or file name (one per line or separated by commas) into the search box and click **Next** to select a case and continue building a query using the canvas ([learn more](doc:data-browser-query-start-by-searching-for-an-ID)).\n \n## 6 Count\nThe Count feature quantifies the scope of the data returned by your query.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/2374a8f-count-card.png\",\n        \"count-card.png\",\n        568,\n        249,\n        \"#f8efef\"\n      ]\n    }\n  ]\n}\n[/block]\nThe number of entities returned change as you add filters to your query. The count cards at the bottom of the page gray out to let you know the represented quantities need to be refreshed.\n\nTo refresh the number of instances of each entity returned by your query, click the circular arrows next to the count cards.\n\n## 7 Create new query\n\nThis option allows you to delete all previous queries and opens a new query canvas.\n\n## 8 Copy files to project\n\nThe **+Copy files to project** button allows you to copy files that satisfy your query to your desired project. Alternatively, copy files from any **File** node. Learn more about[ accessing data for use in your project](doc:access-data-from-the-data-browser).\n\n\n## 9 Table of results: Details view\n\nThe table below the Data Browser contains further details about your query. The **Details** view displays details of the selected entity in the context of your query, as shown below for the **Sample 1 **entity.\n\nThe lefthand column, **Connections**, displays the inbound and outbound connections for the selected entity  in the context of your query.\n\nThe middle column displays a list of UUIDs corresponding to the selected entity that match your query. Click on any one UUID in the middle column to view its metadata corresponding in the rightmost column.  \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/8b83dfc-details-view.png\",\n        \"details-view.png\",\n        1362,\n        387,\n        \"#ece7ed\"\n      ]\n    }\n  ]\n}\n[/block]\n \n## 10 Table of results: Analytics view\n\nThe table below the Data Browser contains further details about your query. The Analytics view displays the distributions of the members of each entity, as shown below.\n\nThese graphs are an alternative way to visualize query results and reflect the same information as is displayed in the table. Note that currently only pre-defined, selectable values of a property can be visualized.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/5d11373-analytics-view.png\",\n        \"analytics-view.png\",\n        912,\n        305,\n        \"#efe5ef\"\n      ]\n    }\n  ]\n}\n[/block]\n## 11 Export query results\nExport query results as a CSV, JSON, or XML file from this table by clicking **Export**.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/2ff61e3-export-table-results.png\",\n        \"export-table-results.png\",\n        848,\n        257,\n        \"#f8f1f1\"\n      ]\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"data-browser-features","type":"basic","title":"↳ Data Browser features"}

↳ Data Browser features


[block:image] { "images": [ { "image": [ "https://files.readme.io/c4eb513-data-browser-features-f4c.png", "data-browser-features-f4c.png", 1339, 768, "#f3f4f4" ], "border": true } ] } [/block] ## 1 Dataset name The name of the dataset you are querying is on the left side of the top navigation bar. In the image above, you are currently querying the legacy TCGA dataset found under the "Legacy" category. To clear your canvas and switch to another dataset (e.g. CCLE,), simply click on the visible dataset name (e.g. TCGA). This opens a dialog in which you can select the alternate dataset. ## 2 Query name The name of your query is also on the left side of the top navigation bar. This defaults to **New query** if your query is unsaved. ## 3 Queries Click on **Queries** to reveal different actions relating to queries, as shown below. [block:image] { "images": [ { "image": [ "https://files.readme.io/a0bafd9-queries.png", "queries.png", 509, 150, "#f2f3f3" ] } ] } [/block] Choose to create a new query, open a previously saved query, open an example query provided by the F4C team, or save a query. Learn more about: * [Starting from an example query](doc:data-browser-query-start-from-an-example-query) * [Building a query from search terms](doc:query-method-2-start-by-searching-through-a-dataset) * [Building a query from scratch](doc:data-browser-query-start-from-scratch) * [Working from an existing query](doc:data-browser-query-start-from-an-existing-query) * [Starting by searching for an ID](doc:data-browser-query-start-by-searching-for-an-id) ## 4 Save a query You can save any query on the Data Browser. Note that empty canvases cannot be saved as queries. This feature is still in Beta, and we will continue to make improvements. To save a query: 1. Click **Queries** on the top of the Data Browser canvas next to the help icon. 2. Select **Save** from the drop-down menu. 3. In the pop-up window which appears, you can name your query, as shown below. Click **Add** **description** to add a brief description of your query. 4. Then, click **Save Query**. All saved queries can be accessed by selecting **Open save**d from the **Queries** drop-down menu. Learn more about [accessing saved queries](doc:data-browser-query-start-from-an-existing-query). ## 5 The Search Box Click on **Search by ID** to reveal the search box. The search box allows you to search by UUID, ID (TCGA Barcodes), or file name. [block:image] { "images": [ { "image": [ "https://files.readme.io/ac44019-search-by-id-2.png", "search-by-id-2.png", 495, 363, "#ebecec" ] } ] } [/block] You can enter more than one UUID, ID (TCGA Barcode), or file name (one per line or separated by commas) into the search box and click **Next** to select a case and continue building a query using the canvas ([learn more](doc:data-browser-query-start-by-searching-for-an-ID)). ## 6 Count The Count feature quantifies the scope of the data returned by your query. [block:image] { "images": [ { "image": [ "https://files.readme.io/2374a8f-count-card.png", "count-card.png", 568, 249, "#f8efef" ] } ] } [/block] The number of entities returned change as you add filters to your query. The count cards at the bottom of the page gray out to let you know the represented quantities need to be refreshed. To refresh the number of instances of each entity returned by your query, click the circular arrows next to the count cards. ## 7 Create new query This option allows you to delete all previous queries and opens a new query canvas. ## 8 Copy files to project The **+Copy files to project** button allows you to copy files that satisfy your query to your desired project. Alternatively, copy files from any **File** node. Learn more about[ accessing data for use in your project](doc:access-data-from-the-data-browser). ## 9 Table of results: Details view The table below the Data Browser contains further details about your query. The **Details** view displays details of the selected entity in the context of your query, as shown below for the **Sample 1 **entity. The lefthand column, **Connections**, displays the inbound and outbound connections for the selected entity in the context of your query. The middle column displays a list of UUIDs corresponding to the selected entity that match your query. Click on any one UUID in the middle column to view its metadata corresponding in the rightmost column. [block:image] { "images": [ { "image": [ "https://files.readme.io/8b83dfc-details-view.png", "details-view.png", 1362, 387, "#ece7ed" ] } ] } [/block] ## 10 Table of results: Analytics view The table below the Data Browser contains further details about your query. The Analytics view displays the distributions of the members of each entity, as shown below. These graphs are an alternative way to visualize query results and reflect the same information as is displayed in the table. Note that currently only pre-defined, selectable values of a property can be visualized. [block:image] { "images": [ { "image": [ "https://files.readme.io/5d11373-analytics-view.png", "analytics-view.png", 912, 305, "#efe5ef" ] } ] } [/block] ## 11 Export query results Export query results as a CSV, JSON, or XML file from this table by clicking **Export**. [block:image] { "images": [ { "image": [ "https://files.readme.io/2ff61e3-export-table-results.png", "export-table-results.png", 848, 257, "#f8f1f1" ] } ] } [/block]