documentation:software:atlas:cohorts
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
documentation:software:atlas:cohorts [2016/08/19 15:49] jhardin |
documentation:software:atlas:cohorts [2019/05/30 20:43] (current) anthonysena |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ~~NOTOC~~ | ~~NOTOC~~ | ||
| + | ===== IMPORTANT NOTE ===== | ||
| - | ======Editing Cohorts====== | + | All ATLAS documentation has moved to [[https://github.com/OHDSI/ATLAS/wiki|GitHub]]. Please disregard the content below as it is legacy and kept for posterity. |
| + | |||
| + | ======Editing Cohorts (LEGACY) ====== | ||
| ---- | ---- | ||
| When performing an analysis, usually the first step is to define the population of interest (also known as a cohort). This functionality was originally built as part of the [[http://www.ohdsi.org/web/wiki/doku.php?id=documentation:software:circe|Circe working group]] and now Circe has been fully incorporated into Atlas. | When performing an analysis, usually the first step is to define the population of interest (also known as a cohort). This functionality was originally built as part of the [[http://www.ohdsi.org/web/wiki/doku.php?id=documentation:software:circe|Circe working group]] and now Circe has been fully incorporated into Atlas. | ||
| Line 11: | Line 14: | ||
| You can use the table to browse through existing cohort definitions. The filter functionality above the table can be used to filter the list based on a search string. Furthermore, the columns in the table can be used to sort the information in the table to find the cohort(s) of interest. | You can use the table to browse through existing cohort definitions. The filter functionality above the table can be used to filter the list based on a search string. Furthermore, the columns in the table can be used to sort the information in the table to find the cohort(s) of interest. | ||
| - | ===== Cohort Definition ===== | + | ===== Cohort Definition (Under construction) ===== |
| ---- | ---- | ||
| - | Coming soon! | + | A cohort can be created and may contain for example users of a given drug, people with a specific outcome or some combination of both. Cohorts can be created by clicking on the Cohorts menu item and then the blue New Cohort button in the upper right hand side of the page. Or you can click the "Define a New Cohort" button from the home page. |
| + | |||
| + | Your cohort will initially be titled 'New Cohort Definition,' as seen in the text field at the top of the screen. Please rename your new cohort in a unique, descriptive manner and hit "Save". Note, your cohort will always remain open as your current working cohort, seen on the top left of the main contents frame, until you hit 'Close.' You will have to close any open cohort before creating a new cohort. | ||
| + | |||
| + | Please carefully read the paragraph regarding Cohort Definition, which explains what a cohort is and what criteria are needed to define a cohort. You will then need to select and define the Cohort Entry Criteria (Initial Event, Initial Event Inclusion Criteria, and Additional Qualifying Inclusion Criteria). You may also choose to define Cohort Exit Criteria and Censoring Events but these are not required or may not apply to your cohort. | ||
| + | |||
| + | Please read and follow the instructions closely on how to define each criteria and select the appropriate time windows. Most criteria (except for Demographics) will require you to import concept sets in order to utilize the vocabulary to properly identify your criteria. You can further refine each criteria with additional criteria attributes on the right side of the screen. If you have not previously created your concept set, you can click the 'New Concept Set' button once the import concept set window appears. Once you have filled in all your desired criteria, you have finished building your cohort. | ||
| ===== Concept Sets ===== | ===== Concept Sets ===== | ||
| Line 23: | Line 33: | ||
| When you feel that your cohort definition is complete, you can use the Generate tab to generate a list of people in your cohort. This tab will show a table of CDM data sources that are available with the following properties: | When you feel that your cohort definition is complete, you can use the Generate tab to generate a list of people in your cohort. This tab will show a table of CDM data sources that are available with the following properties: | ||
| - | - Generate button: clicking this button will execute SQL code against your CDM to select people that will define your cohort. | + | * Generate button: clicking this button will execute SQL code against your CDM to select people that will define your cohort. |
| - | - Source Name: the source name of your CDM | + | * Source Name: the source name of your CDM |
| - | - Generation Status: This will show the status of the cohort generation activity | + | * Generation Status: This will show the status of the cohort generation activity |
| - | - Distinct People: If the cohort has been generated, this will show the distinct number of people in the cohort | + | * Distinct People: If the cohort has been generated, this will show the distinct number of people in the cohort |
| - | - Generated: The date and time the cohort was generated | + | * Generated: The date and time the cohort was generated |
| - | - Generation Duration: How long it took to generate the cohort | + | * Generation Duration: How long it took to generate the cohort |
| Once this cohort is generated, you can use the reporting section to obtain further descriptive analytics around this cohort. | Once this cohort is generated, you can use the reporting section to obtain further descriptive analytics around this cohort. | ||
| Line 35: | Line 45: | ||
| ---- | ---- | ||
| - | The reporting tab provides cohort summarization and visualization tools. This functionality was originally built as part of the [Heracles working group](http://www.ohdsi.org/web/wiki/doku.php?id=documentation:software:heracles) and now Heracles has been fully incorporated into Atlas. | + | The reporting tab provides cohort summarization and visualization tools. This functionality was originally built as part of the [[http://www.ohdsi.org/web/wiki/doku.php?id=documentation:software:heracles|Heracles working group]] and now Heracles has been fully incorporated into Atlas. |
| - | From the reporting tab, you will see a column with the reports that are defined in the Heracles Analysis List section of this [article](http://www.ohdsi.org/web/wiki/doku.php?id=documentation:software:heracles). Then you will see a column for each CDM source that has been defined. From here you can select each report by placing a check mark in the column and select the Generate button to generate the reports. This will start an analysis job that you can monitor by selecting the "Jobs" menu item. | + | From the reporting tab, you will see a column with the reports that are defined in the Heracles Analysis List section of this [[http://www.ohdsi.org/web/wiki/doku.php?id=documentation:software:heracles|article]]. Then you will see a column for each CDM source that has been defined. From here you can select each report by placing a check mark in the column and select the Generate button to generate the reports. This will start an analysis job that you can monitor by selecting the "Jobs" menu item. |
| Once the analysis is complete, each report will have a "view" button that you can use to view the results. | Once the analysis is complete, each report will have a "view" button that you can use to view the results. | ||
| Line 53: | Line 63: | ||
| This tab provides a human-readable description of the cohort definition. This is useful when describing the logic used to define the cohort along with the concept sets/source codes that make up the definition. | This tab provides a human-readable description of the cohort definition. This is useful when describing the logic used to define the cohort along with the concept sets/source codes that make up the definition. | ||
| - | ===== JSON ===== | + | ===== How to copy an existing cohort/JSON ===== |
| ---- | ---- | ||
| The JSON tab provides JavaScript Object Notation (JSON) representation of the cohort definition and supporting concept sets. This enables you to copy & paste the full cohort definition to provide as part of your study write up or to another member of the OHDSI network to generate the same cohort in their environment. | The JSON tab provides JavaScript Object Notation (JSON) representation of the cohort definition and supporting concept sets. This enables you to copy & paste the full cohort definition to provide as part of your study write up or to another member of the OHDSI network to generate the same cohort in their environment. | ||
| - | If you have a cohort definition in JSON format, you can copy & paste it into the text box in this area and click the "Reload" button found at the bottom right of the page. This will then load the full cohort definition and concept sets into the editor. | + | To copy an existing cohort, click the Cohort button on the left menu, and select the cohort you would like to copy. Within the cohort of interest select the Export tab, click the JSON button, click in the box, click the Ctrl + A keys simultaneously, and then Ctrl + C keys simultaneously. You've now copied the JSON code for the cohort. To create your local copy of the cohort, navigate to your local ATLAS site, click the Cohort button on the left menu, click create the New Cohort blue button in the upper right hand corner of the page. Click the Export tab, click the JSON button, click in the box, remove all of the text in the box by selecting and hitting the Delete key, and then click the Ctrl + V keys simultaneously, and click the Reload button. You've now just created your new cohort and should see the cohort definitions, concept sets, etc within the new cohort. Don't forget to name your new cohort and click the blue Save button just outside the cohort name box. |
| ===== Saving ===== | ===== Saving ===== | ||
documentation/software/atlas/cohorts.1471621750.txt.gz · Last modified: 2016/08/19 15:49 by jhardin
Page Tools
