The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

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.

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

phenotypeprops

Type: has_many

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

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,
         }