documentation:software:atlas:concept_sets
Differences
This shows you the differences between two versions of the page.
| Next revision | Previous revision | ||
|
documentation:software:atlas:concept_sets [2016/08/19 15:33] jhardin created |
documentation:software:atlas:concept_sets [2019/05/30 20:43] anthonysena |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ====== Concept Sets ====== | + | ~~NOTOC~~ |
| + | ===== IMPORTANT NOTE ===== | ||
| + | |||
| + | 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. | ||
| + | |||
| + | ====== Concept Sets (LEGACY) ====== | ||
| ---- | ---- | ||
| Atlas provides the ability to create concept sets: these are lists of concepts from the standardized vocabulary that taken together describe a topic of interest for a study. | Atlas provides the ability to create concept sets: these are lists of concepts from the standardized vocabulary that taken together describe a topic of interest for a study. | ||
| Line 5: | Line 10: | ||
| ===== Browsing concept sets ===== | ===== Browsing concept sets ===== | ||
| ---- | ---- | ||
| - | Selecting the Concept Sets menu option in Atlas will show you all of the concept sets available in the system. This table has filtering and sorting capabilities similar to the [[https://github.com/OHDSI/Atlas/wiki/Vocabulary#results|vocabulary results table]]. From this screen, you can click on an existing concept set to explore its definition or you can click the "Add Concept Set" button to start developing a new one. | + | Selecting the Concept Sets menu option in Atlas will show you all of the concept sets available in the system. This table has filtering and sorting capabilities similar to the [[http://www.ohdsi.org/web/wiki/doku.php?id=documentation:cdm:vocabulary|vocabulary results table]]. From this screen, you can click on an existing concept set to explore its definition or you can click the "Add Concept Set" button to start developing a new one. |
| ===== Creating concept sets ===== | ===== Creating concept sets ===== | ||
| Line 17: | Line 22: | ||
| Once you have one or more concepts in your concept set, you can use the concept set expression tab to further define what concepts should be included in the set. On the concept set expression tab, you will see the list of concepts that you have selected in a tabular format. The table has 3 checkboxes that are used to further select/deselect concepts: | Once you have one or more concepts in your concept set, you can use the concept set expression tab to further define what concepts should be included in the set. On the concept set expression tab, you will see the list of concepts that you have selected in a tabular format. The table has 3 checkboxes that are used to further select/deselect concepts: | ||
| - | 1. Exclude: Selecting this checkbox will prevent that concept from being used in the concept set. | + | - Exclude: Selecting this checkbox will prevent that concept from being used in the concept set. |
| - | 2. Descendants: Selecting this check box will use the vocabulary relationships to automatically select all descendants. If this option is used in conjunction with the exclude option, it will exclude the current concept and all descendants. | + | - Descendants: Selecting this check box will use the vocabulary relationships to automatically select all descendants. If this option is used in conjunction with the exclude option, it will exclude the current concept and all descendants. |
| - | 3. Mapped: Selecting this check box will use the vocabulary relationships to automatically select all concepts mapped to the selected concept. | + | - Mapped: Selecting this check box will use the vocabulary relationships to automatically select all concepts mapped to the selected concept. |
| As you define the concept set expression, you can use the other tabs to explore how the expression is evaluated against the vocabulary to select concepts. | As you define the concept set expression, you can use the other tabs to explore how the expression is evaluated against the vocabulary to select concepts. | ||
| + | |||
| + | {{ documentation:software:atlas:atlas_conceptset_exclude_menu.png |}} | ||
| ===== Included concepts ===== | ===== Included concepts ===== | ||
| Line 30: | Line 37: | ||
| ---- | ---- | ||
| The included source codes tab is used to show all of the non-standard concepts that are included when the concept set is evaluated. You can use this tab to review which source codes are included when the concept set is evaluated. This is useful when attempting to translate from a set of source codes (i.e. ICD9) to standard concepts to ensure that your definition is complete. It is also useful when attempting to ensure that the concept set will translate to other data sources that may have different source codes. | The included source codes tab is used to show all of the non-standard concepts that are included when the concept set is evaluated. You can use this tab to review which source codes are included when the concept set is evaluated. This is useful when attempting to translate from a set of source codes (i.e. ICD9) to standard concepts to ensure that your definition is complete. It is also useful when attempting to ensure that the concept set will translate to other data sources that may have different source codes. | ||
| + | |||
| + | ===== Explore evidence ===== | ||
| + | ---- | ||
| + | The evidence tab is used to display concept specific evidence from the LAERTES evidence base. The evidence base is comprised of evidence found in published literature, product labels and spontaneous reports. Use the evidence sources below to find out what evidence has been associated to the concepts included in this concept set. | ||
| ===== Export ===== | ===== Export ===== | ||
| ---- | ---- | ||
| - | The export tab is used to export the concept set expression and/or the concept id list. This is useful if we need to share a concept set definition with others outside of our organization. They can then use this information to import this definition using the [[https://github.com/OHDSI/Atlas/wiki/Vocabulary#import|import functionality under the vocabulary area]]. | + | The export tab is used to export the concept set expression and/or the concept id list. This is useful if we need to share a concept set definition with others outside of our organization. They can then use this information to import this definition using the import functionality under the vocabulary area. |
| - | ===== Saving ===== | + | ===== Compare ===== |
| ---- | ---- | ||
| - | Concept sets must be named and saved in order to persist them between Atlas sessions. There is a save button in the top-right of the page that is used to save this work to the database. | + | The compare tab is used to compare two concept set expressions. The intention of this feature is to expose differences in the way a concept has been defined between studies and expose associated differences in the study results. |
| + | |||
| + | ===== Save ===== | ||
| + | ---- | ||
| + | Concept sets must be named and saved in order to persist them between Atlas sessions. There is a save button to the right of the concept set name box that is used to save this work to the database. Once the save has occurred you will notice that the copy button appears to the right of the concept set name box. | ||
| + | |||
| + | |||
| + | ===== Close ===== | ||
| + | ---- | ||
| + | When you are done using the concept set, you can use the close button to the right of the concept set name box to close it out. This will also remove the reference in your left-hand menu. | ||
| + | |||
| + | ===== Copy ===== | ||
| + | ---- | ||
| + | After you have saved the concept set you can select the copy button to the right of the concept set name box to copy it. | ||
| + | ===== Optimize===== | ||
| + | ---- | ||
| + | When you have finished creating the concept set, you can use the optimize button to the right of the concept set name box to see what concepts are redundant or missing from the main concept. This feature will suggest as to how to modify the concept set by removing or adding to it to make the most parsimonious concept set. When you have reviewed the choices you can select the blue Save Options box to overwrite the current concept set or to create a new concept set. | ||
| + | |||
| + | ===== Delete===== | ||
| + | ---- | ||
| + | You may wish to use the delete button to the right of the concept set name box to eliminate a test concept set or one which you no longer require. | ||
| + | |||
| + | ===== Scope of concept sets ===== | ||
| + | ---- | ||
| + | A given concept set has local scope; meaning that if you copy a concept set and modify it (by removing or changing a concept) within a new cohort it will not impact the original concept set, which may be used in alternative cohorts. | ||
| + | |||
| + | ===== Domains of concept sets ===== | ||
| + | ---- | ||
| + | It is generally not advisable to mix multiple domains (for example condition, observation, procedure) within a given concept set, however there may be times when it is required. If so the concept set can be referenced within a cohort by selecting Add New Criteria and selecting Add Condition Criteria, Add Observation Criteria, or Add Procedure Criteria and then referring to the concept set within each domain. | ||
| - | ===== Closing ===== | + | ===== A note on use of 'at most' vs. 'exactly' in definition of concept set occurrence ===== |
| + | When defining a criteria, at most or exactly can be used to refer to the number of times a given concept set occurs. If at most 0 or exactly 0 is used, the question of how they differ may arise. There is really no difference in the use of them, it is more a preference of style. It is advised to be consistent within a given study to use one convention vs. the other. | ||
| ---- | ---- | ||
| - | When you are done using the concept set, you can use the close button in the top-right of the page to close it out. This will also remove the reference in your left-hand menu. | ||
documentation/software/atlas/concept_sets.txt · Last modified: 2019/05/30 20:43 by anthonysena
Page Tools
