Differences

This shows you the differences between two versions of the page.

--- documentation:software:atlas:cohorts [2016/08/22 16:58] – jhardin
+++ documentation:software:atlas:cohorts [2019/05/30 20:43] (current) – anthonysena
@@ Line 1: / Line 1: @@
 ~~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.
@@ Line 13: / Line 16: @@
 ===== Cohort Definition (Under construction) =====
 ----
-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.
+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 =====
@@ 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.
-===== 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.
-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 =====