<tool id="get_terms_by_relationship_type" name="Get the terms that are related by a concrete relationship type" version="1.22">
  <description>Collects the terms that are related by a concrete relationship type</description>
  <command interpreter="perl">/usr/bin/get_terms_by_relationship_type.pl $input_ontology $rel_id > $output</command>
  <inputs>
    <param format="text" name="input_ontology" type="data" label="Source file"/>
    <param name="rel_id" type="text" size="30" value="" label="Rel ID" />
  </inputs>
  <outputs>
    <data format="tabular" name="output" />
  </outputs>

  <tests>
    <test>
      <param name="input" value="pre_cco.obo"/>
      <param name="rel_id" value="participates_in"/>
      <output name="out_file" file="terms_rel_filtered.txt"/>
    </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
  ...
  ...
  
**More information**

  ONTO-PERL: An API supporting the development and analysis of bio-ontologies
  E. Antezana; M. Egana; B. De Baets; M. Kuiper; V. Mironov
  Bioinformatics 2008; doi: 10.1093/bioinformatics/btn042

  </help>

</tool>