<tool id="onto_tk_get_terms_by_relationship_type" name="Get the terms that are related" version="@VERSION@.0">
    <description>by a concrete relationship type</description>
    <macros>
        <import>onto_macros.xml</import>
    </macros>
    <expand macro="requirements" />
    <command detect_errors="aggressive">
    perl '$__tool_directory__/get_terms_by_relationship_type.pl'
        '$input'
        '$rel_id' | sort > '$output'
    </command>
    <inputs>
        <expand macro="input_ontology" />
        <expand macro="rel_id" />
    </inputs>
    <outputs>
        <data format="tabular" name="output">
            <actions>
                <action name="column_names" type="metadata" default="term name,relationship type,term name" />
            </actions>
        </data>
    </outputs>
    <tests>
        <test>
            <param name="input" value="pre_cco_core.obo"/>
            <param name="rel_id" value="is_a"/>
            <output name="output" file="terms_rel_filtered.tab" sort="true"/>
        </test>
    </tests>
    <help>

.. class:: infomark

Collects the terms that are related by a concrete relationship type (e.g. is_a)

**Example**

If you ask for terms related by the relationship type 'participates_in' you will get tab delimited records like::

  PR:0000001	participates_in	GO:0000023
  PR:0000002	participates_in	GO:0033224
  PR:0000003	participates_in	GO:0021109
  PR:0000004	participates_in	GO:0034099
  ...
  ...
  
    </help>
    <expand macro="citations" />
</tool>