This section contains general instructions for a variety of editing scenarios. Although it may not be possible to capture every possible scenario, the ones listed below should cover the most common editing situations that will arise.
Before adding new terms, you must first determine whether it should be created de novo or imported from the ISF or another ontology, and in which file to place it. Because of this, it is important to understand the underlying structure of how the eagle-i ontology is organized and generated. See the section on Ontology File Structure for more details.
Scenario 1: Adding a new term to the ISF
If a term is reusable (i.e. not specific to eagle-i) and cannot be imported from an existing ontology, it can be created in the ISF. If the term is a child of an existing hierarchy in the ISF, then it should be added in the same file in the ISF. Terms should never be added directly to the generated eagle-i owl files in the public folder.
- Update the ontology trunk in your SVN repository to get the latest changes: https://open.med.harvard.edu/svn/eagle-i-dev/datamodel/trunk.
- Open the isf-dev.owl file from the ISF folder.
- See which file is currently used for the parent class and make that file the active ontology.
- Search for the parent term.
- Right click on the label.
- Select switch to the defining ontology. For example, for a technique, this will be the research-resource.owl file
- Add the term.
- Review and save changes.
- Commit changes to the ISF from the src\isf folder.
- Add the term to the IDs.xlsx file found in the docs folder in the eagle-i SVN.
- Use the module scripts to generate the local ontology following the steps outlined above.
- Open the ero-extended-app.owl file and find the corresponding app file.
- Search for the term. Hover over the label to see the name of the generated eagle-i file. The technique hierarchy lives in the ero.owl file.
- Switch to the corresponding app file (For techniques: ero-app.owl.)
- Add any application specific axioms that are needed.
- Review and save changes.
- Commit changes to the Harvard SVN from the trunk.