documentation:software:usagi
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
documentation:software:usagi [2018/08/24 06:42] schuemie [Scope and purpose] |
documentation:software:usagi [2021/04/09 18:56] (current) maximmoinat |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ====== Usagi ====== | ====== Usagi ====== | ||
| + | **NOTICE APRIL 2021: this page is not updated anymore, the most recent documentation can be found on Github http://ohdsi.github.io/Usagi** | ||
| {{ :documentation:usagi_logo.png |}} | {{ :documentation:usagi_logo.png |}} | ||
| Line 59: | Line 60: | ||
| Finally you can set some restrictions for Usagi when mapping. For example, in Figure 3, the user is mapping the source codes only to concepts in the Condition domain. By default, Usagi only maps to Standard Concepts, but if the the option 'Filter standard concepts' is turned off, Usagi will also consider Classification Concepts. Hover your mouse over the different filters for additional information about the filter. | Finally you can set some restrictions for Usagi when mapping. For example, in Figure 3, the user is mapping the source codes only to concepts in the Condition domain. By default, Usagi only maps to Standard Concepts, but if the the option 'Filter standard concepts' is turned off, Usagi will also consider Classification Concepts. Hover your mouse over the different filters for additional information about the filter. | ||
| - | One special filter is //Filter by automatically selected concepts//. If there is information that you can use to restrict the search, you can do so by providing a list of CONCEPT_IDs in the column indicated in the //Auto concept ID column// (semicolon-delimited). For example, in the case of drugs there might be a mapping available to ATC codes. Even though an ATC code does not uniquely identify a single RxNorm drug code, it does help limit the search space to only those concepts that fall under the ATC code in the Vocabulary. By providing this list of CONCEPT_IDs in the //Auto concept ID column//, and turning on //Filter by automatically selected concepts//, Usagi will make use of this information. In the example above, we used a partial mapping derived from UMLS to restrict Usagi to this mapping when available. | + | One special filter is //Filter by automatically selected concepts / ATC code//. If there is information that you can use to restrict the search, you can do so by providing a list of CONCEPT_IDs or an ATC code in the column indicated in the //Auto concept ID column// (semicolon-delimited). For example, in the case of drugs there might already be ATC codes assigned to each drug. Even though an ATC code does not uniquely identify a single RxNorm drug code, it does help limit the search space to only those concepts that fall under the ATC code in the Vocabulary. To use the ATC code, follow these steps: |
| + | |||
| + | - In the Column mapping section, switch from 'Auto concept ID column' to 'ATC column' | ||
| + | - In the Column mapping section, select the column containing the ATC code as 'ATC column'. | ||
| + | - Turn on the 'Filter by user selected concepts / ATC code' on in the Filters section. | ||
| + | |||
| + | You can also use other sources of information than the ATC code to restrict as well. In the example shown in the figure above, we used a partial mapping derived from UMLS to restrict the Usagi searh. In that case we will need to use 'Auto concept ID column'. | ||
| {{ :documentation:software:usagiimport3.png?direct |}} | {{ :documentation:software:usagiimport3.png?direct |}} | ||
| Line 135: | Line 142: | ||
| When the set of source codes is updated the following steps can be followed to support the update: | When the set of source codes is updated the following steps can be followed to support the update: | ||
| - | 1. Import the new source code file | + | - Import the new source code file |
| - | 2. Choose //File// --> //Apply previous mapping//, and select the old Usagi mapping file | + | - Choose //File// --> //Apply previous mapping//, and select the old Usagi mapping file. Note that the format of the previous mapping should be as created by //Save// or //Save As//. Other formats do not work. |
| - | 3. Identify codes that haven't inherited approved mappings from the old mapping, and map them as usual. | + | - Identify codes that haven't inherited approved mappings from the old mapping, and map them as usual. |
| When the vocabulary is updated, follow these steps: | When the vocabulary is updated, follow these steps: | ||
| - | 1. Download the new vocabulary files from Athena | + | |
| - | 2. Rebuild the Usagi index (//Help// --> //Rebuild index//) | + | - Download the new vocabulary files from Athena |
| - | 3. Open the mapping file | + | - Rebuild the Usagi index (//Help// --> //Rebuild index//) |
| - | 4. Identify codes that map to concepts that in the new vocabulary version no longer are Standard concepts, and find more appropriate target concepts. | + | - Open the mapping file |
| + | - Identify codes that map to concepts that in the new vocabulary version no longer are Standard concepts, and find more appropriate target concepts. | ||
| ==== Menu Options ==== | ==== Menu Options ==== | ||
documentation/software/usagi.1535092930.txt.gz · Last modified: 2018/08/24 06:42 by schuemie
Page Tools
