NAME

Bio::Chado::Schema::Result::Cv::Cvterm

DESCRIPTION

A term, class, universal or type within an ontology or controlled vocabulary. This table is also used for relations and properties. cvterms constitute nodes in the graph defined by the collection of cvterms and cvterm_relationships.

NAME

Bio::Chado::Schema::Result::Cv::Cvterm

ACCESSORS

cvterm_id

data_type: 'integer'
is_auto_increment: 1
is_nullable: 0
sequence: 'cvterm_cvterm_id_seq'

cv_id

data_type: 'integer'
is_foreign_key: 1
is_nullable: 0

The cv or ontology or namespace to which this cvterm belongs.

name

data_type: 'varchar'
is_nullable: 0
size: 1024

A concise human-readable name or label for the cvterm. Uniquely identifies a cvterm within a cv.

definition

data_type: 'text'
is_nullable: 1

A human-readable text definition.

dbxref_id

data_type: 'integer'
is_foreign_key: 1
is_nullable: 0

Primary identifier dbxref - The unique global OBO identifier for this cvterm. Note that a cvterm may have multiple secondary dbxrefs - see also table: cvterm_dbxref.

is_obsolete

data_type: 'integer'
default_value: 0
is_nullable: 0

Boolean 0=false,1=true; see GO documentation for details of obsoletion. Note that two terms with different primary dbxrefs may exist if one is obsolete.

is_relationshiptype

data_type: 'integer'
default_value: 0
is_nullable: 0

Boolean 0=false,1=true relations or relationship types (also known as Typedefs in OBO format, or as properties or slots) form a cv/ontology in themselves. We use this flag to indicate whether this cvterm is an actual term/class/universal or a relation. Relations may be drawn from the OBO Relations ontology, but are not exclusively drawn from there.

RELATIONS

acquisitionprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Mage::Acquisitionprop

acquisition_relationships

Type: has_many

Related object: Bio::Chado::Schema::Result::Mage::AcquisitionRelationship

analysisfeatureprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Companalysis::Analysisfeatureprop

analysisprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Companalysis::Analysisprop

arraydesign_platformtypes

Type: has_many

Related object: Bio::Chado::Schema::Result::Mage::Arraydesign

arraydesign_substratetypes

Type: has_many

Related object: Bio::Chado::Schema::Result::Mage::Arraydesign

arraydesignprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Mage::Arraydesignprop

assayprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Mage::Assayprop

biomaterialprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Mage::Biomaterialprop

biomaterial_relationships

Type: has_many

Related object: Bio::Chado::Schema::Result::Mage::BiomaterialRelationship

biomaterial_treatments

Type: has_many

Related object: Bio::Chado::Schema::Result::Mage::BiomaterialTreatment

cell_line_cvterms

Type: has_many

Related object: Bio::Chado::Schema::Result::CellLine::CellLineCvterm

cell_line_cvtermprops

Type: has_many

Related object: Bio::Chado::Schema::Result::CellLine::CellLineCvtermprop

cell_lineprops

Type: has_many

Related object: Bio::Chado::Schema::Result::CellLine::CellLineprop

cell_line_relationships

Type: has_many

Related object: Bio::Chado::Schema::Result::CellLine::CellLineRelationship

chadoprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Cv::Chadoprop

contacts

Type: has_many

Related object: Bio::Chado::Schema::Result::Contact::Contact

contact_relationships

Type: has_many

Related object: Bio::Chado::Schema::Result::Contact::ContactRelationship

controls

Type: has_many

Related object: Bio::Chado::Schema::Result::Mage::Control

cvprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Cv::Cvprop

cv

Type: belongs_to

Related object: Bio::Chado::Schema::Result::Cv::Cv

dbxref

Type: belongs_to

Related object: Bio::Chado::Schema::Result::General::Dbxref

cvterm_dbxrefs

Type: has_many

Related object: Bio::Chado::Schema::Result::Cv::CvtermDbxref

cvtermpath_types

Type: has_many

Related object: Bio::Chado::Schema::Result::Cv::Cvtermpath

cvtermpath_objects

Type: has_many

Related object: Bio::Chado::Schema::Result::Cv::Cvtermpath

cvtermpath_subjects

Type: has_many

Related object: Bio::Chado::Schema::Result::Cv::Cvtermpath

cvtermprop_types

Type: has_many

Related object: Bio::Chado::Schema::Result::Cv::Cvtermprop

cvtermprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Cv::Cvtermprop

cvterm_relationship_types

Type: has_many

Related object: Bio::Chado::Schema::Result::Cv::CvtermRelationship

cvterm_relationship_objects

Type: has_many

Related object: Bio::Chado::Schema::Result::Cv::CvtermRelationship

cvterm_relationship_subjects

Type: has_many

Related object: Bio::Chado::Schema::Result::Cv::CvtermRelationship

cvtermsynonym_types

Type: has_many

Related object: Bio::Chado::Schema::Result::Cv::Cvtermsynonym

cvtermsynonyms

Type: has_many

Related object: Bio::Chado::Schema::Result::Cv::Cvtermsynonym

dbxrefprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Cv::Dbxrefprop

elements

Type: has_many

Related object: Bio::Chado::Schema::Result::Mage::Element

element_relationships

Type: has_many

Related object: Bio::Chado::Schema::Result::Mage::ElementRelationship

elementresult_relationships

Type: has_many

Related object: Bio::Chado::Schema::Result::Mage::ElementresultRelationship

environment_cvterms

Type: has_many

Related object: Bio::Chado::Schema::Result::Genetic::EnvironmentCvterm

expression_cvterm_cvterms

Type: has_many

Related object: Bio::Chado::Schema::Result::Expression::ExpressionCvterm

expression_cvterm_cvterm_types

Type: has_many

Related object: Bio::Chado::Schema::Result::Expression::ExpressionCvterm

expression_cvtermprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Expression::ExpressionCvtermprop

expressionprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Expression::Expressionprop

features

Type: has_many

Related object: Bio::Chado::Schema::Result::Sequence::Feature

feature_cvterms

Type: has_many

Related object: Bio::Chado::Schema::Result::Sequence::FeatureCvterm

feature_cvtermprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Sequence::FeatureCvtermprop

feature_expressionprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Expression::FeatureExpressionprop

feature_genotypes

Type: has_many

Related object: Bio::Chado::Schema::Result::Genetic::FeatureGenotype

featuremaps

Type: has_many

Related object: Bio::Chado::Schema::Result::Map::Featuremap

featureprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Sequence::Featureprop

feature_pubprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Sequence::FeaturePubprop

feature_relationships

Type: has_many

Related object: Bio::Chado::Schema::Result::Sequence::FeatureRelationship

feature_relationshipprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Sequence::FeatureRelationshipprop

genotypes

Type: has_many

Related object: Bio::Chado::Schema::Result::Genetic::Genotype

genotypeprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Genetic::Genotypeprop

libraries

Type: has_many

Related object: Bio::Chado::Schema::Result::Library::Library

library_cvterms

Type: has_many

Related object: Bio::Chado::Schema::Result::Library::LibraryCvterm

libraryprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Library::Libraryprop

nd_experiments

Type: has_many

Related object: Bio::Chado::Schema::Result::NaturalDiversity::NdExperiment

nd_experimentprops

Type: has_many

Related object: Bio::Chado::Schema::Result::NaturalDiversity::NdExperimentprop

nd_experiment_stocks

Type: has_many

Related object: Bio::Chado::Schema::Result::NaturalDiversity::NdExperimentStock

nd_experiment_stockprops

Type: has_many

Related object: Bio::Chado::Schema::Result::NaturalDiversity::NdExperimentStockprop

nd_geolocationprops

Type: has_many

Related object: Bio::Chado::Schema::Result::NaturalDiversity::NdGeolocationprop

nd_protocols

Type: has_many

Related object: Bio::Chado::Schema::Result::NaturalDiversity::NdProtocol

nd_protocolprops

Type: has_many

Related object: Bio::Chado::Schema::Result::NaturalDiversity::NdProtocolprop

nd_protocol_reagents

Type: has_many

Related object: Bio::Chado::Schema::Result::NaturalDiversity::NdProtocolReagent

nd_reagents

Type: has_many

Related object: Bio::Chado::Schema::Result::NaturalDiversity::NdReagent

nd_reagentprops

Type: has_many

Related object: Bio::Chado::Schema::Result::NaturalDiversity::NdReagentprop

nd_reagent_relationships

Type: has_many

Related object: Bio::Chado::Schema::Result::NaturalDiversity::NdReagentRelationship

organismprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Organism::Organismprop

phendescs

Type: has_many

Related object: Bio::Chado::Schema::Result::Genetic::Phendesc

phenotype_assays

Type: has_many

Related object: Bio::Chado::Schema::Result::Phenotype::Phenotype

phenotype_attrs

Type: has_many

Related object: Bio::Chado::Schema::Result::Phenotype::Phenotype

phenotype_observables

Type: has_many

Related object: Bio::Chado::Schema::Result::Phenotype::Phenotype

phenotype_cvalues

Type: has_many

Related object: Bio::Chado::Schema::Result::Phenotype::Phenotype

phenotype_comparison_cvterms

Type: has_many

Related object: Bio::Chado::Schema::Result::Genetic::PhenotypeComparisonCvterm

phenotype_cvterms

Type: has_many

Related object: Bio::Chado::Schema::Result::Phenotype::PhenotypeCvterm

phenstatements

Type: has_many

Related object: Bio::Chado::Schema::Result::Genetic::Phenstatement

phylonodes

Type: has_many

Related object: Bio::Chado::Schema::Result::Phylogeny::Phylonode

phylonodeprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Phylogeny::Phylonodeprop

phylonode_relationships

Type: has_many

Related object: Bio::Chado::Schema::Result::Phylogeny::PhylonodeRelationship

phylotrees

Type: has_many

Related object: Bio::Chado::Schema::Result::Phylogeny::Phylotree

projectprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Project::Projectprop

project_relationships

Type: has_many

Related object: Bio::Chado::Schema::Result::Project::ProjectRelationship

protocols

Type: has_many

Related object: Bio::Chado::Schema::Result::Mage::Protocol

protocolparam_unittypes

Type: has_many

Related object: Bio::Chado::Schema::Result::Mage::Protocolparam

protocolparam_datatypes

Type: has_many

Related object: Bio::Chado::Schema::Result::Mage::Protocolparam

pubs

Type: has_many

Related object: Bio::Chado::Schema::Result::Pub::Pub

pubprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Pub::Pubprop

pub_relationships

Type: has_many

Related object: Bio::Chado::Schema::Result::Pub::PubRelationship

quantificationprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Mage::Quantificationprop

quantification_relationships

Type: has_many

Related object: Bio::Chado::Schema::Result::Mage::QuantificationRelationship

stocks

Type: has_many

Related object: Bio::Chado::Schema::Result::Stock::Stock

stockcollections

Type: has_many

Related object: Bio::Chado::Schema::Result::Stock::Stockcollection

stockcollectionprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Stock::Stockcollectionprop

stock_cvterms

Type: has_many

Related object: Bio::Chado::Schema::Result::Stock::StockCvterm

stock_cvtermprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Stock::StockCvtermprop

stock_dbxrefprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Stock::StockDbxrefprop

stockprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Stock::Stockprop

stock_relationships

Type: has_many

Related object: Bio::Chado::Schema::Result::Stock::StockRelationship

stock_relationship_cvterms

Type: has_many

Related object: Bio::Chado::Schema::Result::Stock::StockRelationshipCvterm

studydesignprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Mage::Studydesignprop

studyfactors

Type: has_many

Related object: Bio::Chado::Schema::Result::Mage::Studyfactor

studyprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Mage::Studyprop

studyprop_features

Type: has_many

Related object: Bio::Chado::Schema::Result::Mage::StudypropFeature

synonyms

Type: has_many

Related object: Bio::Chado::Schema::Result::Sequence::Synonym

treatments

Type: has_many

Related object: Bio::Chado::Schema::Result::Mage::Treatment

ADDITIONAL RELATIONS

cvtermprops

Type: has_many

Related object: Bio::Chado::Schema::Result::Cv::Cvtermprop

This cvtermprops relation is a convenient synonym for the autogenerated "cvtermprop_cvterms" above, since most often you want the properties for the cvterm itself.

If you really do want the Cvtermprop rows that have this cvterm as their type, use cvtermprop_types, listed above.

cvtermsynonyms

Type: has_many

Related object: Bio::Chado::Schema::Result::Cv::Cvtermsynonym

ADDITIONAL METHODS

add_synonym

Usage:        $self->add_synonym($synonym , { type => 'exact' , autocreate => 1} );
Desc:         adds the synonym $new_synonym to this cvterm
              If the synonym $new_synonym already exists,
              nothing is added.
Args:         a synonym name  and
   options hashref as:
         {
           synonym_type => [e.g. exact, narrow, broad, related],
           autocreate => 0,
              (optional) boolean, if passed, automatically create cv,
              cvterm, and dbxref rows if one cannot be found for the
              given synonym name.  Default false.

           cv_name => cv.name to use for the given synonym type.
                      Defaults to 'synonym_type',

           db_name => db.name to use for autocreated dbxrefs,
                      default 'null',

           definitions => optional hashref of:
               { cvterm_name => definition,
               }
            to load into the cvterm table when autocreating cvterms
         }
Ret:          a Cvtermsynonym object

delete_synonym

Usage: $self->delete_synonym($synonym)
Desc:  delete synonym $synonym from cvterm object
 Ret:  nothing
Args: $synonym
Side Effects: Will delete all cvtermsynonyms with synonym=$synonym. Case insensitive

get_secondary_dbxrefs

Usage: $self->get_secondary_dbxrefs()
Desc:  find all secondary accessions associated with the cvterm
        These are stored in cvterm_dbxref table as dbxref_ids
Ret:    a list of accessions (e.g. GO:0000123)
Args:   none
Side Effects: none

add_secondary_dbxref

Usage: $self->add_secondary_dbxref(accession, 1)
Desc:  add an alternative id to cvterm. Stores in cvterm_dbxref
Ret:   a CvtermDbxref object
Args:  an alternative id (i.e. "GO:0001234"). A second arg will store a is_for_definition=1 (default = 0)
Side Effects: stores a new dbxref if accession is not found in dbxref table

delete_secondary_dbxref

Usage: $self->delete_secondary_dbxref($accession)
Desc:  delete a cvterm_dbxref from the database
Ret:   nothing
Args:  full accession (db_name:dbxref_accession e.g. PO:0001234)
Side Effects:

create_cvtermprops

Usage: $set->create_cvtermprops({ baz => 2, foo => 'bar' });
Desc : convenience method to create cvterm properties using cvterms
        from the ontology with the given name
Args : hashref of { propname => value, ...},
       options hashref as:
        {
          autocreate => 0,
             (optional) boolean, if passed, automatically create cv,
             cvterm, and dbxref rows if one cannot be found for the
             given cvtermprop name.  Default false.

          cv_name => cv.name to use for the given cvtermprops.
                     Defaults to 'cvterm_property',

          db_name => db.name to use for autocreated dbxrefs,
                     default 'null',

          dbxref_accession_prefix => optional, default
                                     'autocreated:',
          definitions => optional hashref of:
              { cvterm_name => definition,
              }
           to load into the cvterm table when autocreating cvterms

           rank => force numeric rank. Be careful not to pass ranks that already exist
                   for the property type. The function will die in such case.

           allow_duplicate_values => default false.
              If true, allow duplicate instances of the same cvterm
              and value in the properties of the cvterm.  Duplicate
              values will have different ranks.
        }
Ret  : hashref of { propname => new cvtermprop object }

root

Usage: $self->root
Desc:  find the root cvterm
Ret:   Cvterm object
Args:  none

NOTE: This method requires that your cvtermpath table is populated.

children

Usage: $self->children
Desc:  find the direct children of the cvterm

Ret: L<Bio::Chado::Schema::Result::Cv::CvtermRelationship> resultset of the
     fetched child terms (this can be used in your program to find the
      relationship type id of each child term)
Args:  none

direct_children

Usage: $self->direct_children
Desc:  find only the direct children of your term
Ret:   L<Bio::Chado::Schema::Result::Cv::Cvterm>
Args:  none
Side Effects: none

NOTE: This method requires that your cvtermpath table is populated.

recursive_children

Usage: $self->recursive_children
Desc:   find all the descendants of the cvterm (children, children of children, and so on)
Ret: a DBIC resultset of L<Bio::Chado::Schema::Result::Cv::Cvterm>
Args: none
Side Effects: none

NOTE: This method requires that your cvtermpath table is populated.

parents

Usage: my $self->parents
Desc:  Find the direct parents of the cvterm
Ret:  L<Bio::Chado::Schema::Result::Cv::CvtermRelationship> resultset of the parent terms
Args:  none
Side Effects: none

direct_parents

Usage: $self->direct_parents
Desc:  get only the direct parents of the cvterm (from the cvtermpath)
Ret:   L<Bio::Chado::Schema::Result::Cv::Cvterm>
Args:  none
Side Effects: none

NOTE: This method requires that your cvtermpath table is populated.

recursive_parents

Usage: $self->recursive_parents
Desc:   find all the ancestors of the cvterm (parents, parents of parents, and so on)
Ret: L<Bio::Chado::Schema::Result::Cv::Cvterm> resultset
Args: none
Side Effects: none

NOTE: This method requires that your cvtermpath table is populated.

create_with

Usage: $schema->resultset('Cv::Cvterm')->create_with(
                 { name   => 'cvterm name',
                   cv     => $cv  || 'cv name',
                   db     => $db  || 'db name',
                   dbxref => $dbx || 'accession',
                 });

Desc: convenience method to create a cvterm, linking it to the CV and
      DB that you name or provide.  For any cv, db, or dbxref that
      you call only by name, does a find_or_create() using that name.
Ret : a new Cvterm row
Args: hashref of:
        { name   => 'cvterm name',
          cv     => 'cv name' or L<Bio::Chado::Schema::Result::Cv::Cvterm> row,
          db     => 'db name' or L<Bio::Chado::Schema::Result::General::Db> row,
          dbxref => 'accession' or L<Bio::Chado::Schema::Result::General::Dbxref> row,
        }

AUTHOR

Robert Buels <rbuels@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by Robert Buels.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.