LICENSE

Copyright [1999-2015] Wellcome Trust Sanger Institute and the EMBL-European Bioinformatics Institute Copyright [2016-2024] EMBL-European Bioinformatics Institute

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

CONTACT

Please email comments or questions to the public Ensembl
developers list at <http://lists.ensembl.org/mailman/listinfo/dev>.

Questions may also be sent to the Ensembl help desk at
<http://www.ensembl.org/Help/Contact>.

NAME

Bio::EnsEMBL::OperonTranscript - Object representing a polycistronic transcript that is part of an operon

SYNOPSIS

my $operon_transcript = Bio::EnsEMBL::OperonTranscript->new( -START => $start, -END => $end, -STRAND => $strand, -SLICE => $slice ); $operon->add_OperonTranscript($operon_transcript);

DESCRIPTION

A representation of a polycistronic transcript from an operon within the Ensembl system. An operon is a collection of one or more polycistronic transcripts, which contain one or more genes.

METHODS

new

Arg [-START]  : 
     int - start postion of the operon transcript
Arg [-END]    : 
     int - end position of the operon transcript
Arg [-STRAND] : 
     int - 1,-1 tehe strand the operon transcript is on
Arg [-SLICE]  : 
     Bio::EnsEMBL::Slice - the slice the operon transcript is on
Arg [-STABLE_ID] :
      string - the stable identifier of this operon transcript
Arg [-VERSION] :
      int - the version of the stable identifier of this operon transcript
Arg [-CREATED_DATE]:
      string - the date the operon transcript was created
Arg [-MODIFIED_DATE]:
      string - the date the operon transcript was last modified

Example    : $gene = Bio::EnsEMBL::OperonTranscript->new(...);
Description: Creates a new operon transcript object
Returntype : Bio::EnsEMBL::OperonTranscript
Exceptions : none
Caller     : general
Status     : Stable

created_date

Arg [1]    : (optional) String - created date to set (as a UNIX time int)
Example    : $gene->created_date('1141948800');
Description: Getter/setter for attribute created_date
Returntype : String
Exceptions : none
Caller     : general
Status     : Stable

modified_date

Arg [1]    : (optional) String - modified date to set (as a UNIX time int)
Example    : $gene->modified_date('1141948800');
Description: Getter/setter for attribute modified_date
Returntype : String
Exceptions : none
Caller     : general
Status     : Stable

display_label

Arg [1]    : (optional) String - the name/label to set
Example    : $operon->name('accBCD');
Description: Getter/setter for attribute name.
Returntype : String or undef
Exceptions : none
Caller     : general
Status     : Stable

stable_id

Arg [1]    : (optional) String - the stable ID to set
Example    : $operon->stable_id("accR2A");
Description: Getter/setter for stable id for this operon transcript.
Returntype : String
Exceptions : none
Caller     : general
Status     : Stable

version

Arg [1]    : (optional) Int - the stable ID version to set
Example    : $operon->version(1);
Description: Getter/setter for stable id version for this operon transcript.
Returntype : Int
Exceptions : none
Caller     : general
Status     : Stable

stable_id_version

Arg [1]    : (optional) String - the stable ID with version to set
Example    : $operon->stable_id("accR2A.3");
Description: Getter/setter for stable id with version.
Returntype : String
Exceptions : none
Caller     : general
Status     : Stable

operon

Example    : $operon = $ot->operon();
Description: getter for the operon to which this transcript belongs
Returntype : Bio::EnsEMBL::Operon
Exceptions : none
Caller     : general
Status     : Stable

get_all_Genes

Example    : $genes = $ot->get_all_Genes();
Description: get all the genes that are attached to this operon transcript
Returntype : Arrayref of Bio::EnsEMBL::Gene
Exceptions : none
Caller     : general
Status     : Stable

add_Gene

Arg [1]    : Bio::EnsEMBL::Gene - gene to attach to this polycistronic transcript
Example    : $operon->add_gene($gene);
Description: Attach a gene to this polycistronic transcript
Exceptions : if argument is not Bio::EnsEMBL::Gene
Caller     : general
Status     : Stable

add_DBEntry

Arg [1]    : Bio::EnsEMBL::DBEntry $dbe
             The dbEntry to be added
Example    : my $dbe = Bio::EnsEMBL::DBEntery->new(...);
             $operon->add_DBEntry($dbe);
Description: Associates a DBEntry with this operon. Note that adding DBEntries
             will prevent future lazy-loading of DBEntries for this operon
             (see get_all_DBEntries).
Returntype : none
Exceptions : thrown on incorrect argument type
Caller     : general
Status     : Stable

get_all_Attributes

Arg [1]    : (optional) String $attrib_code
             The code of the attribute type to retrieve values for
Example    : my ($author) = @{ $ot->get_all_Attributes('author') };
             my @ot_attributes = @{ $ot->get_all_Attributes };
Description: Gets a list of Attributes of this operon transcript.
             Optionally just get Attributes for given code.
Returntype : Listref of Bio::EnsEMBL::Attribute
Exceptions : warning if gene does not have attached adaptor and attempts lazy
             load.
Caller     : general
Status     : Stable

get_all_DBEntries

Arg [1]    : (optional) String, external database name

Arg [2]    : (optional) String, external_db type

Example    : @dbentries = @{ $gene->get_all_DBEntries() };

Description: Retrieves DBEntries (xrefs) for this operon transcript.  This does
             *not* include DBEntries that are associated with the
             transcripts and corresponding translations of this
             gene (see get_all_DBLinks()).

             This method will attempt to lazy-load DBEntries
             from a database if an adaptor is available and no
             DBEntries are present on the gene (i.e. they have not
             already been added or loaded).

Return type: Listref of Bio::EnsEMBL::DBEntry objects
Exceptions : none
Caller     : get_all_DBLinks, OperontTranscriptAdaptor::store
Status     : Stable