ROBOT rename command

The rename command provided by the SSSOM plugin does a similar thing as the standard rename command in ROBOT: it renames entities in the source ontology. The difference with the standard command is that it uses a SSSOM mapping set as source of truth for which entity should be renamed into what, instead of the ad-hoc, dual-column TSV format used by the standard command.

1. Usage

The command just needs the --sssom option, which indicates the file containing the mapping set to use for renaming. Any entity within the ontology that has an IRI that is the subject of one of the mappings will be renamed to the IRI of the object of that same mapping.

The --sssom option may be repeated as many times as needed to read mappings from more than one file. All mapping sets will be combined before the renaming operation is performed.

2. Selecting mappings to use

By default, only mappings whose mapping predicate is http://purl.obolibrary.org/obo/IAO_0100001 (“term replaced by”) will be considered.

To explicitly specify another mapping predicate, use the --predicate option. That option may be repeated as many times as desired to select mappings based on several predicates.

To use all mappings regardless of their mapping predicate, use the special value all (or any) to the --predicate option.

3. Updating labels

If the --labels option is used, and the mapping set contains object_label metadata, then in addition to changing the IRI the command will also update the label of the class or property that is being renamed, using the object_label slot of the mapping as the new label.