From d1b8f7f58111a8389d6692cecc6c7e09379c70a5 Mon Sep 17 00:00:00 2001 From: Ian Longden <ianl@sanger.ac.uk> Date: Fri, 12 Aug 2005 13:45:13 +0000 Subject: [PATCH] status reports added plus some tiding up of docs --- modules/Bio/EnsEMBL/AffyArray.pm | 15 +- modules/Bio/EnsEMBL/AffyFeature.pm | 43 +++-- modules/Bio/EnsEMBL/AffyProbe.pm | 32 ++-- modules/Bio/EnsEMBL/Analysis.pm | 18 ++ modules/Bio/EnsEMBL/ArchiveStableId.pm | 16 ++ .../Bio/EnsEMBL/AssemblyExceptionFeature.pm | 14 ++ modules/Bio/EnsEMBL/AssemblyMapper.pm | 50 ++++++ modules/Bio/EnsEMBL/Attribute.pm | 5 + modules/Bio/EnsEMBL/BaseAlignFeature.pm | 11 ++ modules/Bio/EnsEMBL/ChainedAssemblyMapper.pm | 156 ++++++++++++++++++ modules/Bio/EnsEMBL/CoordSystem.pm | 8 + modules/Bio/EnsEMBL/DBEntry.pm | 27 ++- modules/Bio/EnsEMBL/DBLoader.pm | 1 + modules/Bio/EnsEMBL/DBSQL/AffyArrayAdaptor.pm | 14 ++ .../Bio/EnsEMBL/DBSQL/AffyFeatureAdaptor.pm | 17 +- modules/Bio/EnsEMBL/DBSQL/AffyProbeAdaptor.pm | 22 ++- modules/Bio/EnsEMBL/DBSQL/AnalysisAdaptor.pm | 11 ++ .../EnsEMBL/DBSQL/ArchiveStableIdAdaptor.pm | 27 ++- .../DBSQL/AssemblyExceptionFeatureAdaptor.pm | 3 + .../EnsEMBL/DBSQL/AssemblyMapperAdaptor.pm | 9 +- modules/Bio/EnsEMBL/DBSQL/AttributeAdaptor.pm | 11 ++ modules/Bio/EnsEMBL/DBSQL/BaseAdaptor.pm | 9 +- .../EnsEMBL/DBSQL/BaseAlignFeatureAdaptor.pm | 2 + .../Bio/EnsEMBL/DBSQL/BaseFeatureAdaptor.pm | 14 +- .../Bio/EnsEMBL/DBSQL/BaseMetaContainer.pm | 4 + .../DBSQL/CompressedSequenceAdaptor.pm | 1 + .../Bio/EnsEMBL/DBSQL/CoordSystemAdaptor.pm | 10 ++ modules/Bio/EnsEMBL/DBSQL/DBConnection.pm | 17 ++ modules/Bio/EnsEMBL/DBSQL/DBEntryAdaptor.pm | 19 ++- .../EnsEMBL/DBSQL/DensityFeatureAdaptor.pm | 5 + .../Bio/EnsEMBL/DBSQL/DensityTypeAdaptor.pm | 7 +- .../EnsEMBL/DBSQL/DnaAlignFeatureAdaptor.pm | 5 + modules/Bio/EnsEMBL/DBSQL/ExonAdaptor.pm | 8 +- modules/Bio/EnsEMBL/DBSQL/GeneAdaptor.pm | 20 +++ .../Bio/EnsEMBL/DBSQL/KaryotypeBandAdaptor.pm | 5 +- modules/Bio/EnsEMBL/DBSQL/MetaContainer.pm | 3 + .../Bio/EnsEMBL/DBSQL/MetaCoordContainer.pm | 3 + .../Bio/EnsEMBL/DBSQL/MiscFeatureAdaptor.pm | 4 + modules/Bio/EnsEMBL/DBSQL/MiscSetAdaptor.pm | 5 + .../EnsEMBL/DBSQL/PredictionExonAdaptor.pm | 6 +- .../DBSQL/PredictionTranscriptAdaptor.pm | 30 ++-- .../DBSQL/ProteinAlignFeatureAdaptor.pm | 3 + .../EnsEMBL/DBSQL/ProteinFeatureAdaptor.pm | 3 + .../EnsEMBL/DBSQL/RegulatoryFactorAdaptor.pm | 10 ++ .../EnsEMBL/DBSQL/RegulatoryFeatureAdaptor.pm | 16 ++ .../EnsEMBL/DBSQL/RepeatConsensusAdaptor.pm | 6 + .../Bio/EnsEMBL/DBSQL/RepeatFeatureAdaptor.pm | 7 +- modules/Bio/EnsEMBL/DBSQL/SequenceAdaptor.pm | 3 + .../Bio/EnsEMBL/DBSQL/SimpleFeatureAdaptor.pm | 9 +- modules/Bio/EnsEMBL/DBSQL/SliceAdaptor.pm | 20 ++- .../EnsEMBL/DBSQL/SupportingFeatureAdaptor.pm | 1 + .../Bio/EnsEMBL/DBSQL/TranscriptAdaptor.pm | 18 +- .../TranscriptSupportingFeatureAdaptor.pm | 1 + .../Bio/EnsEMBL/DBSQL/TranslationAdaptor.pm | 21 ++- modules/Bio/EnsEMBL/DensityFeature.pm | 20 +++ modules/Bio/EnsEMBL/DensityFeatureSet.pm | 12 +- modules/Bio/EnsEMBL/DensityType.pm | 10 +- modules/Bio/EnsEMBL/DnaDnaAlignFeature.pm | 5 + modules/Bio/EnsEMBL/DnaPepAlignFeature.pm | 5 + modules/Bio/EnsEMBL/Exon.pm | 93 ++++++++++- modules/Bio/EnsEMBL/Feature.pm | 39 ++++- modules/Bio/EnsEMBL/FeaturePair.pm | 24 ++- modules/Bio/EnsEMBL/Gene.pm | 90 +++++++++- modules/Bio/EnsEMBL/GoXref.pm | 3 + modules/Bio/EnsEMBL/IdentityXref.pm | 32 +++- modules/Bio/EnsEMBL/Intron.pm | 5 +- modules/Bio/EnsEMBL/KaryotypeBand.pm | 6 + modules/Bio/EnsEMBL/Mapper.pm | 78 +++++---- modules/Bio/EnsEMBL/MiscFeature.pm | 81 ++++++++- modules/Bio/EnsEMBL/MiscSet.pm | 5 + modules/Bio/EnsEMBL/PepDnaAlignFeature.pm | 38 +++++ modules/Bio/EnsEMBL/PredictionExon.pm | 13 +- modules/Bio/EnsEMBL/PredictionTranscript.pm | 15 +- modules/Bio/EnsEMBL/ProjectionSegment.pm | 3 + modules/Bio/EnsEMBL/ProteinFeature.pm | 12 ++ modules/Bio/EnsEMBL/Registry.pm | 63 +++++-- modules/Bio/EnsEMBL/RegulatoryFactor.pm | 6 + modules/Bio/EnsEMBL/RegulatoryFeature.pm | 10 ++ modules/Bio/EnsEMBL/RepeatConsensus.pm | 22 ++- modules/Bio/EnsEMBL/RepeatFeature.pm | 9 +- modules/Bio/EnsEMBL/RepeatMaskedSlice.pm | 6 + modules/Bio/EnsEMBL/SeqEdit.pm | 15 +- modules/Bio/EnsEMBL/SimpleFeature.pm | 16 ++ modules/Bio/EnsEMBL/Slice.pm | 87 ++++++++-- modules/Bio/EnsEMBL/Storable.pm | 29 ++-- modules/Bio/EnsEMBL/TopLevelAssemblyMapper.pm | 104 ++++++++++++ modules/Bio/EnsEMBL/Transcript.pm | 135 +++++++++++++-- modules/Bio/EnsEMBL/TranscriptMapper.pm | 32 +++- modules/Bio/EnsEMBL/Translation.pm | 57 ++++++- modules/Bio/EnsEMBL/Upstream.pm | 14 ++ 90 files changed, 1784 insertions(+), 215 deletions(-) diff --git a/modules/Bio/EnsEMBL/AffyArray.pm b/modules/Bio/EnsEMBL/AffyArray.pm index 425d33898b..b3a1056442 100644 --- a/modules/Bio/EnsEMBL/AffyArray.pm +++ b/modules/Bio/EnsEMBL/AffyArray.pm @@ -66,7 +66,8 @@ use Bio::EnsEMBL::Storable; Returntype : Exceptions : none Caller : - + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -101,7 +102,8 @@ sub new { Returntype : listref of Bio::EnsEMBL::AffyProbe Exceptions : none Caller : general - + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -129,7 +131,8 @@ sub get_all_AffyProbes { Returntype : string Exceptions : none Caller : general - + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -153,7 +156,8 @@ sub name { Returntype : listref of Bio::EnsEMBL::AffyFeature Exceptions : none Caller : general - + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -179,7 +183,8 @@ sub setsize { Returntype : Bio::EnsEMBL::AffyArray Exceptions : none Caller : general - + Status : Medium Risk + : may be replaced with none affy specific methods =cut diff --git a/modules/Bio/EnsEMBL/AffyFeature.pm b/modules/Bio/EnsEMBL/AffyFeature.pm index ec25ce71f8..c416a2f966 100644 --- a/modules/Bio/EnsEMBL/AffyFeature.pm +++ b/modules/Bio/EnsEMBL/AffyFeature.pm @@ -58,11 +58,24 @@ use vars qw(@ISA); =head2 new - Arg [PROBE] : - Every AffyFeature needs an AffyProbe on construction. This should be already - stored if you plan to store this feature. - Arg [MISMATCHCOUNT] : - How many mismatches over the length of the probe? (0,1) + Arg [PROBE] : Every AffyFeature needs an AffyProbe on construction. This should be already + stored if you plan to store this feature. + Arg [MISMATCHCOUNT] : How many mismatches over the length of the probe? (0,1) + Arg [-SLICE]: Bio::EnsEMBL::SLice - Represents the sequence that this + feature is on. The coordinates of the created feature are + relative to the start of the slice. + Arg [-START]: The start coordinate of this feature relative to the start + of the slice it is sitting on. Coordinates start at 1 and + are inclusive. + Arg [-END] : The end coordinate of this feature relative to the start of + the slice it is sitting on. Coordinates start at 1 and are + inclusive. + Arg [-STRAND]: The orientation of this feature. Valid values are 1,-1,0. + Arg [-SEQNAME] : A seqname to be used instead of the default name of the + of the slice. Useful for features that do not have an + attached slice such as protein features. + Arg [-dbID] : (optional) internal database id + Arg [-ADAPTOR]: (optional) Bio::EnsEMBL::DBSQL::BaseAdaptor Example : my $feature = Bio::EnsEMBL::AffyFeature->new( -PROBE => $affyProbe, -MISMATCHCOUNT => 0, @@ -75,7 +88,8 @@ use vars qw(@ISA); Returntype : Bio::EnsEMBL::AffyFeature Exceptions : none Caller : general - + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -108,7 +122,8 @@ sub new { Returntype : Bio::EnsEMBL::AffyFeature Exceptions : none Caller : general - + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -130,7 +145,8 @@ sub new_fast { Returntype : string Exceptions : none Caller : general - + Status : At Risk + : This maybe removed. Use $feature->probe->probeset() to be safe =cut @@ -153,7 +169,8 @@ sub probeset { Returntype : int Exceptions : none Caller : general - + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -174,7 +191,8 @@ sub mismatchcount { Returntype : int Exceptions : none Caller : general - + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -196,7 +214,8 @@ sub probelength { Returntype : Bio::EnsEMBL::AffyProbe Exceptions : none Caller : general - + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -220,7 +239,7 @@ sub probe { return $self->{'probe'}; } - +1; diff --git a/modules/Bio/EnsEMBL/AffyProbe.pm b/modules/Bio/EnsEMBL/AffyProbe.pm index b193d001a5..c959a6ccde 100644 --- a/modules/Bio/EnsEMBL/AffyProbe.pm +++ b/modules/Bio/EnsEMBL/AffyProbe.pm @@ -69,9 +69,10 @@ use vars qw(@ISA); Example : none Description: Constructor for an array probe Returntype : Bio::EnsEMBL::AffyProbe - Exceptions : none + Exceptions : throws if each probe does not have a name Caller : general - + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -104,7 +105,7 @@ sub new { throw( "Provide array or arrayname with probename" ); } } else { - throw( "You need to provide probenames to generat a probe" ); + throw( "You need to provide probenames to generate a probe" ); } # check the parameters and fill internal data structures @@ -145,7 +146,8 @@ sub new { Returntype : none Exceptions : none Caller : general, constructor, AffyProbeAdaptor->_obj_from_sth() - + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -168,7 +170,8 @@ sub add_Array_probename { Returntype : listref Bio::EnsEMBL:AffyFeature Exceptions : none Caller : general - + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -194,7 +197,8 @@ sub get_all_AffyFeatures { Returntype : listref Bio::EnsEMBL::AffyArray Exceptions : none Caller : general - + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -224,6 +228,8 @@ sub get_all_AffyArrays { Returntype : listref of strings Exceptions : none Caller : general + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -248,6 +254,8 @@ sub get_all_complete_names { Returntype : string Exceptions : throws if the arrayname is not known in this probe Caller : general + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -274,7 +282,8 @@ sub get_complete_name { Returntype : listref of strings Exceptions : none Caller : general - + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -292,7 +301,8 @@ sub get_all_probenames { Returntype : string Exceptions : throw if arrayname is not known for this probe Caller : general - + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -318,7 +328,8 @@ sub get_probename { Returntype : none Exceptions : none Caller : general - + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -337,7 +348,8 @@ sub add_arrayname_probename { Returntype : string Exceptions : none Caller : general - + Status : Medium Risk + : may be replaced with none affy specific methods =cut diff --git a/modules/Bio/EnsEMBL/Analysis.pm b/modules/Bio/EnsEMBL/Analysis.pm index 16ebe373e1..1dc0aaa7bc 100755 --- a/modules/Bio/EnsEMBL/Analysis.pm +++ b/modules/Bio/EnsEMBL/Analysis.pm @@ -83,6 +83,7 @@ use Bio::EnsEMBL::Utils::Argument qw(rearrange); Returntype : Bio::EnsEMBL::Analysis Exceptions : none Caller : general + Status : Stable =cut @@ -143,6 +144,7 @@ sub new { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -165,6 +167,7 @@ sub db { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -187,6 +190,7 @@ sub db_version { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -210,6 +214,7 @@ sub db_file { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -232,6 +237,7 @@ sub program { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -254,6 +260,7 @@ sub program_version { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -277,6 +284,7 @@ sub program_file { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -299,6 +307,7 @@ sub module { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -321,6 +330,7 @@ sub module_version { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -343,6 +353,7 @@ sub gff_source { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -366,6 +377,7 @@ sub gff_feature { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -388,6 +400,7 @@ sub parameters { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -411,6 +424,7 @@ sub created { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -431,6 +445,7 @@ sub logic_name { Returntype : int 0,1 Exceptions : none Caller : general + Status : Stable =cut @@ -450,6 +465,7 @@ sub has_database{ Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -472,6 +488,7 @@ sub description { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -496,6 +513,7 @@ sub display_label { Returntype : int -1,0,1 Exceptions : none Caller : unknown + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/ArchiveStableId.pm b/modules/Bio/EnsEMBL/ArchiveStableId.pm index 14c7430a30..00fa469865 100644 --- a/modules/Bio/EnsEMBL/ArchiveStableId.pm +++ b/modules/Bio/EnsEMBL/ArchiveStableId.pm @@ -33,6 +33,8 @@ ArchiveStableId objects are the main workunit for retrieving stable id archived get_components: + Status: At Risk. This module is in development. + =cut @@ -64,6 +66,8 @@ use vars qw(@ISA); Returntype : Bio::EnsEMBL::ArchiveStableId Exceptions : none Caller : Adaptor + Status : At Risk + : under development =cut @@ -100,6 +104,8 @@ sub new { Returntype : Bio::EnsEMBL::ArchiveStableId Exceptions : none Caller : general, Adaptor + Status : At Risk + : under development =cut @@ -128,6 +134,8 @@ sub new_fast { Returntype : listref Bio::EnsEMBL::ArchiveStableId Exceptions : none Caller : general + Status : At Risk + : under development =cut @@ -146,6 +154,8 @@ sub get_all_predecessors { Returntype : listref Bio::EnsEMBL::ArchiveStableId Exceptions : none Caller : general + Status : At Risk + : under development =cut @@ -166,6 +176,8 @@ sub get_all_successors { Returntype : string Exceptions : none Caller : general + Status : At Risk + : under development =cut @@ -189,6 +201,8 @@ sub get_peptide { Returntype : listref Bio::EnsEMBL::ArchiveStableId Exceptions : empty if not a gene stable id or not in database Caller : general + Status : At Risk + : under development =cut @@ -214,6 +228,8 @@ sub get_all_transcript_archive_ids { Returntype : Bio::EnsEMBL::ArchiveStableId Exceptions : undef if not in db or not a Transcript Caller : general + Status : At Risk + : under development =cut diff --git a/modules/Bio/EnsEMBL/AssemblyExceptionFeature.pm b/modules/Bio/EnsEMBL/AssemblyExceptionFeature.pm index f8cc0125d1..b8347ee913 100644 --- a/modules/Bio/EnsEMBL/AssemblyExceptionFeature.pm +++ b/modules/Bio/EnsEMBL/AssemblyExceptionFeature.pm @@ -71,6 +71,7 @@ use Bio::EnsEMBL::Utils::Argument qw(rearrange); Returntype : Bio::EnsEMBL::Feature Exceptions : Thrown on invalid -SLICE arguments Caller : general, subclass constructors + Status : Stable =cut @@ -89,6 +90,16 @@ sub new { return $self; } +=head2 new_fast + + Arg [1] : hashref to be blessed + Description: Construct a new Bio::EnsEMBL::Feature using the hashref. + Exceptions : none + Returntype : Bio::EnsEMBL::Feature + Caller : general, subclass constructors + Status : Stable + +=cut sub new_fast { my $class = shift; @@ -106,6 +117,7 @@ sub new_fast { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -128,6 +140,7 @@ sub type { Returntype : Bio::EnsEMBL::Slice Exceptions : none Caller : general + Status : Stable =cut @@ -153,6 +166,7 @@ sub alternate_slice { Returntype : string Exceptions : none Caller : web drawing code + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/AssemblyMapper.pm b/modules/Bio/EnsEMBL/AssemblyMapper.pm index 8f3ec9f763..15be05cf37 100644 --- a/modules/Bio/EnsEMBL/AssemblyMapper.pm +++ b/modules/Bio/EnsEMBL/AssemblyMapper.pm @@ -82,6 +82,7 @@ my $DEFAULT_MAX_PAIR_COUNT = 1000; Returntype : Bio::EnsEMBL::DBSQL::AssemblyMapperAdaptor Exceptions : thrown if multiple coord_systems are provided Caller : AssemblyMapperAdaptor + Status : Stable =cut @@ -131,6 +132,7 @@ sub new { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -157,6 +159,7 @@ sub max_pair_count { Returntype : none Exceptions : none Caller : specialised programs doing a lot of mapping + Status : Stable =cut @@ -190,6 +193,7 @@ sub register_all { Exceptions : thrown if if the specified TO coordinat system is not one of the coordinate systems associated with this assembly mapper Caller : general + Status : Stable =cut @@ -244,6 +248,7 @@ sub map { Returntype : none Exceptions : none Caller : AssemblyMapperAdaptor + Status : Stable =cut @@ -255,12 +260,47 @@ sub flush { $self->{'asm_register'} = {}; } +=head2 size + + Args : none + Example : $num_of_pairs = $mapper->size(); + Description: return the number of pairs currently stored. + Returntype : int + Exceptions : none + Caller : general + Status : Stable + +=cut sub size { my $self = shift; return $self->{'mapper'}->{'pair_count'}; } +=head2 fastmap + + Arg [1] : string $frm_seq_region + The name of the sequence region to transform FROM + Arg [2] : int $frm_start + The start of the region to transform FROM + Arg [3] : int $frm_end + The end of the region to transform FROM + Arg [4] : int $strand + The strand of the region to transform FROM + Arg [5] : Bio::EnsEMBL::CoordSystem + The coordinate system to transform FROM + Example : @coords = $asm_mapper->map('X', 1_000_000, 2_000_000, + 1, $chr_cs); + Description: Transforms coordinates from one coordinate system + to another. + Returntype : List of Bio::EnsEMBL::Mapper::Coordinate and/or + Bio::EnsEMBL::Mapper:Gap objects + Exceptions : thrown if if the specified TO coordinat system is not one + of the coordinate systems associated with this assembly mapper + Caller : general + Status : Stable + +=cut sub fastmap { @@ -323,6 +363,7 @@ sub fastmap { Returntype : List of strings Exceptions : none Caller : general + Status : Stable =cut @@ -381,6 +422,7 @@ sub list_seq_regions { Returntype : List of ints Exceptions : none Caller : general + Status : Stable =cut @@ -420,6 +462,7 @@ sub list_ids { Returntype : 0 or 1 Exceptions : throw on incorrect arguments Caller : internal, AssemblyMapperAdaptor + Status : Stable =cut @@ -454,6 +497,7 @@ sub have_registered_component { Returntype : 0 or 1 Exceptions : throw on incorrect arguments Caller : internal, AssemblyMapperAdaptor + Status : Stable =cut @@ -484,6 +528,7 @@ sub have_registered_assembled { Returntype : none Exceptions : throw on incorrect arguments Caller : internal, AssemblyMapperAdaptor + Status : Stable =cut @@ -511,6 +556,7 @@ sub register_component { Returntype : none Exceptions : throw on incorrect arguments Caller : internal, AssemblyMapperAdaptor + Status : Stable =cut @@ -537,6 +583,7 @@ sub register_assembled { Returntype : Bio::EnsEMBL::Mapper Exceptions : none Caller : internal, AssemblyMapperAdaptor + Status : Stable =cut @@ -554,6 +601,7 @@ sub mapper { Returntype : Bio::EnsEMBL::CoordSystem Exceptions : none Caller : internal, AssemblyMapperAdaptor + Status : Stable =cut @@ -571,6 +619,7 @@ sub assembled_CoordSystem { Returntype : Bio::EnsEMBL::CoordSystem Exceptions : none Caller : internal, AssemblyMapperAdaptor + Status : Stable =cut @@ -588,6 +637,7 @@ sub component_CoordSystem { Returntype : Bio::EnsEMBL::DBSQL::AssemblyMapperAdaptor Exceptions : none Caller : general + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/Attribute.pm b/modules/Bio/EnsEMBL/Attribute.pm index 5c927f449b..8a92cb720b 100644 --- a/modules/Bio/EnsEMBL/Attribute.pm +++ b/modules/Bio/EnsEMBL/Attribute.pm @@ -67,6 +67,7 @@ use Bio::EnsEMBL::Utils::Argument qw(rearrange); Returntype : Bio::EnsEMBL::Attribute Exceptions : none Caller : general + Status : Stable =cut @@ -95,6 +96,7 @@ sub new { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -113,6 +115,7 @@ sub code { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -130,6 +133,7 @@ sub name { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -148,6 +152,7 @@ sub description { Returntype : string Exceptions : none Caller : general + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/BaseAlignFeature.pm b/modules/Bio/EnsEMBL/BaseAlignFeature.pm index e4759db1e0..d97dfc1677 100644 --- a/modules/Bio/EnsEMBL/BaseAlignFeature.pm +++ b/modules/Bio/EnsEMBL/BaseAlignFeature.pm @@ -109,6 +109,7 @@ use strict; Exceptions : thrown if both feature and cigar string args are provided thrown if neither feature nor cigar string args are provided Caller : general + Status : Stable =cut @@ -151,6 +152,7 @@ sub new { Returntype : Bio::EnsEMBL::BaseAlignFeature Exceptions : none Caller : none currently + Status : Stable =cut @@ -173,6 +175,7 @@ sub new_fast { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -191,6 +194,7 @@ sub cigar_string { Returntype : int Exceptions : Caller : + Status : Stable =cut @@ -225,6 +229,7 @@ sub alignment_length { Returntype : list of Bio::EnsEMBL::FeaturePair Exceptions : cigar_string not set internally Caller : general + Status : Stable =cut @@ -252,6 +257,7 @@ sub ungapped_features { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -276,6 +282,7 @@ sub strands_reversed { Returntype : none Exceptions : none Caller : general + Status : Stable =cut @@ -317,6 +324,7 @@ sub reverse_complement { Returntype : list of Bio::EnsEMBL::FeaturePair Exceptions : none Caller : ungapped_features + Status : Stable =cut @@ -463,6 +471,7 @@ sub _parse_cigar { Exceptions : argument list undergoes many sanity checks - throws under many invalid conditions Caller : new + Status : Stable =cut @@ -764,6 +773,7 @@ sub _parse_features { Returntype : int 1,3 Exceptions : none Caller : internal + Status : Stable =cut @@ -783,6 +793,7 @@ sub _hit_unit { Returntype : int 1,3 Exceptions : none Caller : internal + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/ChainedAssemblyMapper.pm b/modules/Bio/EnsEMBL/ChainedAssemblyMapper.pm index 3fbf3fd863..58a6ef0ba5 100644 --- a/modules/Bio/EnsEMBL/ChainedAssemblyMapper.pm +++ b/modules/Bio/EnsEMBL/ChainedAssemblyMapper.pm @@ -92,6 +92,7 @@ my $DEFAULT_MAX_PAIR_COUNT = 6000; Returntype : Bio::EnsEMBL::DBSQL::AssemblyMapperAdaptor Exceptions : thrown if wrong number of coord_systems are provided Caller : AssemblyMapperAdaptor + Status : Stable =cut @@ -150,6 +151,7 @@ sub new { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -177,6 +179,7 @@ sub max_pair_count { Returntype : none Exceptions : none Caller : specialised programs doing a lot of mapping + Status : Stable =cut @@ -199,6 +202,18 @@ sub flush { $self->{'first_last_mapper'}->flush(); } +=head2 size + + Args : none + Example : $num_of_pairs = $mapper->size(); + Description: return the number of pairs currently stored. + Returntype : int + Exceptions : none + Caller : general + Status : Stable + +=cut + sub size { my $self = shift; return ( $self->{'first_last_mapper'}->{'pair_count'} + @@ -229,6 +244,7 @@ sub size { Exceptions : thrown if the specified TO coordinat system is not one of the coordinate systems associated with this assembly mapper Caller : general + Status : Stable =cut @@ -345,6 +361,7 @@ sub fastmap { Returntype : List of strings Exceptions : none Caller : general + Status : Stable =cut @@ -436,6 +453,7 @@ sub list_seq_regions { Returntype : List of ints Exceptions : none Caller : general + Status : Stable =cut @@ -465,43 +483,140 @@ sub list_ids { +=head2 first_last_mapper + + Args : none + Example : $mapper = $cam->first_last_mapper(); + Description: return the mapper. + Returntype : Bio::EnsEMBL::Mapper + Exceptions : none + Caller : internal + Status : Stable + +=cut + sub first_last_mapper { my $self = shift; return $self->{'first_last_mapper'}; } +=head2 first_middle_mapper + + Args : none + Example : $mapper = $cam->first_middle_mapper(); + Description: return the mapper. + Returntype : Bio::EnsEMBL::Mapper + Exceptions : none + Caller : internal + Status : Stable + +=cut + + sub first_middle_mapper { my $self = shift; return $self->{'first_mid_mapper'}; } +=head2 last_middle_mapper + + Args : none + Example : $mapper = $cam->last_middle_mapper(); + Description: return the mapper. + Returntype : Bio::EnsEMBL::Mapper + Exceptions : none + Caller : internal + Status : Stable + +=cut + sub last_middle_mapper { my $self = shift; return $self->{'last_mid_mapper'}; } +=head2 first_CoordSystem + + Args : none + Example : $coordsys = $cam->first_CoordSystem(); + Description: return the CoordSystem. + Returntype : Bio::EnsEMBL::CoordSystem + Exceptions : none + Caller : internal + Status : Stable + +=cut + sub first_CoordSystem { my $self = shift; return $self->{'first_cs'}; } +=head2 middle_CoordSystem + + Args : none + Example : $coordsys = $cam->middle_CoordSystem(); + Description: return the CoordSystem. + Returntype : Bio::EnsEMBL::CoordSystem + Exceptions : none + Caller : internal + Status : Stable + +=cut + sub middle_CoordSystem { my $self = shift; return $self->{'mid_cs'}; } +=head2 last_CoordSystem + + Args : none + Example : $coordsys = $cam->last_CoordSystem(); + Description: return the CoordSystem. + Returntype : Bio::EnsEMBL::CoordSystem + Exceptions : none + Caller : internal + Status : Stable + +=cut + sub last_CoordSystem { my $self = shift; return $self->{'last_cs'}; } +=head2 first_registry + + Args : none + Example : $coordsys = $cam->first_registry(); + Description: return the Registry. + Returntype : Bio::EnsEMBL::Mapper::RangeRegistry + Exceptions : none + Caller : internal + Status : Stable + +=cut + sub first_registry { my $self = shift; return $self->{'first_registry'}; } +=head2 lsst_registry + + Args : none + Example : $coordsys = $cam->lsst_registry(); + Description: return the Registry. + Returntype : Bio::EnsEMBL::Mapper::RangeRegistry + Exceptions : none + Caller : internal + Status : Stable + +=cut + sub last_registry { my $self = shift; return $self->{'last_registry'}; @@ -517,14 +632,54 @@ sub last_registry { # ordering is arbitrary and both ends might actually be assembled, but these # methods provide convenient synonyms # + +=head2 mapper + + Args : none + Example : $mapper = $cam->mapper(); + Description: return the first_last_mapper. + Returntype : Bio::EnsEMBL::Mapper + Exceptions : none + Caller : internal + Status : Stable + +=cut + sub mapper { my $self = shift; return $self->first_last_mapper(); } + +=head2 assembled_CoordSystem + + Args : none + Example : $coordsys = $cam->assembled_CoordSystem(); + Description: return the first CoordSystem. + Returntype : Bio::EnsEMBL::CoordSystem + Exceptions : none + Caller : internal + Status : Stable + +=cut + + sub assembled_CoordSystem { my $self = shift; return $self->{'first_cs'}; } + +=head2 component_CoordSystem + + Args : none + Example : $coordsys = $cam->component_CoordSystem(); + Description: return the last CoordSystem. + Returntype : Bio::EnsEMBL::CoordSystem + Exceptions : none + Caller : internal + Status : Stable + +=cut + sub component_CoordSystem { my $self = shift; return $self->{'last_cs'}; @@ -539,6 +694,7 @@ sub component_CoordSystem { Returntype : Bio::EnsEMBL::DBSQL::AssemblyMapperAdaptor Exceptions : none Caller : general + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/CoordSystem.pm b/modules/Bio/EnsEMBL/CoordSystem.pm index 03d8146d6e..53d7c2e394 100644 --- a/modules/Bio/EnsEMBL/CoordSystem.pm +++ b/modules/Bio/EnsEMBL/CoordSystem.pm @@ -99,6 +99,7 @@ use vars qw(@ISA); Returntype : Bio::EnsEMBL::CoordSystem Exceptions : none Caller : general + Status : Stable =cut @@ -172,6 +173,7 @@ sub new { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -192,6 +194,7 @@ sub name { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -214,6 +217,7 @@ sub version { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -247,6 +251,7 @@ sub equals { Returntype : 0 or 1 Exceptions : none Caller : general + Status : Stable =cut @@ -264,6 +269,7 @@ sub is_top_level { Returntype : 0 or 1 Exceptions : none Caller : general + Status : Stable =cut @@ -282,6 +288,7 @@ sub is_sequence_level { Returntype : 0 or 1 Exceptions : none Caller : general + Status : Stable =cut @@ -307,6 +314,7 @@ sub is_default { Returntype : int Exceptions : none Caller : general + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBEntry.pm b/modules/Bio/EnsEMBL/DBEntry.pm index abc1c6c630..971cae42c7 100644 --- a/modules/Bio/EnsEMBL/DBEntry.pm +++ b/modules/Bio/EnsEMBL/DBEntry.pm @@ -46,6 +46,7 @@ use strict; @ISA = qw( Bio::EnsEMBL::Storable Bio::Annotation::DBLink ); + =head2 new_fast Arg [1] : hash reference $hashref @@ -56,6 +57,7 @@ use strict; Returntype : Bio::EnsEMBL::DBEntry Exceptions : none Caller : ? + Status : Stable =cut @@ -88,6 +90,10 @@ sub new_fast { Returntype : Bio::EnsEMBL::DBEntry Exceptions : none Caller : Bio::EnsEMBL::DBEntryAdaptor + Status : At Risk + : due to 'PRIMARY_ID_LINKABLE','DISPLAY_ID_LINKABLE','PRIORITY' + : being under development + : If you don't use any of these the sub can be considered Stable =cut @@ -134,6 +140,7 @@ sub new { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -157,6 +164,7 @@ sub primary_id { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -179,6 +187,7 @@ sub display_id{ Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -201,6 +210,7 @@ sub dbname { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -220,6 +230,7 @@ sub database { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -238,6 +249,7 @@ sub optional_id { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -258,6 +270,7 @@ sub release { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -280,6 +293,7 @@ sub version { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -300,6 +314,8 @@ sub description { Returntype : string Exceptions : none Caller : general + Status : At Risk + : due to it being under development =cut @@ -319,6 +335,8 @@ sub primary_id_linkable { Returntype : string Exceptions : none Caller : general + Status : At Risk + : due to it being under development =cut @@ -335,10 +353,12 @@ sub display_id_linkable { Arg [1] : int $priority Example : none - Priority: get/set for attribute priority + Priority : get/set for attribute priority Returntype : string Exceptions : none Caller : general + Status : At Risk + : due to it being under development =cut @@ -379,6 +399,7 @@ sub db_display_name { Returntype : none Exceptions : none Caller : general + Status : Stable =cut @@ -399,6 +420,7 @@ sub add_synonym { Returntype : list reference of strings Exceptions : none Caller : general + Status : Stable =cut @@ -416,6 +438,7 @@ sub get_all_synonyms { Returntype : none Exceptions : none Caller : general + Status : Stable =cut @@ -433,6 +456,7 @@ sub flush_synonyms { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -455,6 +479,7 @@ sub status{ Returntype : string Exceptions : none Caller : general + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBLoader.pm b/modules/Bio/EnsEMBL/DBLoader.pm index 85ddfdc78a..66f78ce3fc 100755 --- a/modules/Bio/EnsEMBL/DBLoader.pm +++ b/modules/Bio/EnsEMBL/DBLoader.pm @@ -64,6 +64,7 @@ use strict; Exceptions : thrown if the specified module cannot be instantiated or the locator string cannot be parsed Caller : ? + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/AffyArrayAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/AffyArrayAdaptor.pm index 8fcc82d552..8a0043433d 100644 --- a/modules/Bio/EnsEMBL/DBSQL/AffyArrayAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/AffyArrayAdaptor.pm @@ -48,6 +48,8 @@ use Bio::EnsEMBL::Utils::Exception qw(throw warning); Returntype : string Exceptions : none Caller : general + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -73,6 +75,8 @@ sub fetch_by_name { Returntype : none Exceptions : none Caller : lazy load Array attributes into empty array from AffyArray object + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -94,6 +98,8 @@ sub fetch_attributes { Returntype : list of listrefs of strings Exceptions : none Caller : internal + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -113,6 +119,8 @@ sub _tables { Returntype : list of strings Exceptions : none Caller : internal + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -133,6 +141,8 @@ sub _columns { Returntype : list reference to Bio::EnsEMBL::AffyFeature objects Exceptions : none Caller : internal + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -173,6 +183,8 @@ sub _objs_from_sth { Returntype : none Exceptions : none Caller : affy feature calculating scripts + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -222,6 +234,8 @@ sub store { Returntype : list of ints Exceptions : none Caller : ? + Status : Medium Risk + : may be replaced with none affy specific methods =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/AffyFeatureAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/AffyFeatureAdaptor.pm index 4e55b371ef..53fa5caf02 100644 --- a/modules/Bio/EnsEMBL/DBSQL/AffyFeatureAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/AffyFeatureAdaptor.pm @@ -50,7 +50,8 @@ use Bio::EnsEMBL::Utils::Exception qw(throw warning); Returntype : listref of Bio::EnsEMBL::AffyFeature Exceptions : none Caller : AffyProbe->get_all_AffyFeatures() - + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -78,8 +79,10 @@ sub fetch_all_by_AffyProbe { Arrays that are given by their names. If none is given, all features on that Slice are returned. Returntype : listref of Bio::EnsEMBL::AffyFeature - Exceptions : none + Exceptions : throws if arraynames passed Caller : slice->get_all_AffyFeatures() + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -111,6 +114,8 @@ sub fetch_all_by_Slice_arrayname { have an attached slice or atached probe. or if any elements of @afs are not Bio::EnsEMBL::AffyFeatures Caller : general + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -174,6 +179,8 @@ sub store{ Returntype : list of listrefs of strings Exceptions : none Caller : internal + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -201,6 +208,8 @@ sub _default_where_clause { Returntype : list of strings Exceptions : none Caller : internal + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -224,6 +233,8 @@ sub _columns { Returntype : list reference to Bio::EnsEMBL::AffyFeature objects Exceptions : none Caller : internal + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -375,6 +386,8 @@ sub _objs_from_sth { Returntype : list of ints Exceptions : none Caller : ? + Status : Medium Risk + : may be replaced with none affy specific methods =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/AffyProbeAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/AffyProbeAdaptor.pm index d6efea45e1..b3d3a9e26c 100644 --- a/modules/Bio/EnsEMBL/DBSQL/AffyProbeAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/AffyProbeAdaptor.pm @@ -41,6 +41,8 @@ use Bio::EnsEMBL::Utils::Exception qw(throw warning); Returntype : none Exceptions : throw on arong argument type Caller : general + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -111,7 +113,8 @@ PROBE: Returntype : a single Bio::EnsEMBL::AffyProbe Exceptions : none Caller : general - + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -147,7 +150,8 @@ sub fetch_by_array_probeset_probe { Returntype : listref of Bio::EnsEMBL::AffyProbe Exceptions : none Caller : general - + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -166,7 +170,8 @@ sub fetch_all_by_probeset { Returntype : listref of Bio::EnsEMBL::AffyFeature Exceptions : none Caller : AffyProbe->get_all_AffyFeatures() - + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -195,7 +200,8 @@ sub fetch_by_AffyArray { Returntype : listref of Bio::EnsEMBL::AffyFeature Exceptions : none Caller : AffyProbe->get_all_AffyFeatures() - + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -222,6 +228,8 @@ sub fetch_by_AffyFeature { Returntype : list of listrefs of strings Exceptions : none Caller : internal + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -240,6 +248,8 @@ sub _tables { Returntype : list of strings Exceptions : none Caller : internal + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -259,6 +269,8 @@ sub _columns { Returntype : list reference to Bio::EnsEMBL::AffyFeature objects Exceptions : none Caller : internal + Status : Medium Risk + : may be replaced with none affy specific methods =cut @@ -294,6 +306,8 @@ sub _objs_from_sth { Returntype : list of ints Exceptions : none Caller : ? + Status : Medium Risk + : may be replaced with none affy specific methods =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/AnalysisAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/AnalysisAdaptor.pm index e8d343fdf2..50628c0697 100755 --- a/modules/Bio/EnsEMBL/DBSQL/AnalysisAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/AnalysisAdaptor.pm @@ -61,6 +61,7 @@ use strict; Returntype : Bio::EnsEMBL::DBSQL::AnalysisAdaptor Exceptions : none Caller : Bio::EnsEMBL::DBSQL::DBAdaptor + Status : Stable =cut @@ -85,6 +86,7 @@ sub new { Returntype : listref of Bio::EnsEMBL::Analysis retrieved from the database Exceptions : none Caller : AnalysisAdaptor::new + Status : Stable =cut @@ -130,6 +132,7 @@ sub fetch_all { Returntype : Listref of Bio::EnsEMBL::Analysis Exceptions : none Caller : general + Status : Stable =cut @@ -171,6 +174,7 @@ WHERE a.analysis_id=f.analysis_id |; Returntype : List of feature classes Exceptions : none Caller : general + Status : Stable =cut @@ -201,6 +205,7 @@ sub feature_classes{ Returntype : Bio::EnsEMBL::Analysis Exceptions : none Caller : general + Status : Stable =cut @@ -247,6 +252,7 @@ sub fetch_by_dbID { Returntype : Bio::EnsEMBL::Analysis Exceptions : none Caller : general + Status : Stable =cut @@ -304,6 +310,7 @@ sub fetch_by_logic_name { Exceptions : throw on incorrect argument throw if analysis argument does not have a logic name Caller : general + Status : Stable =cut @@ -452,6 +459,7 @@ sub store { Returntype : int 1 if update is performed, undef if it is not Exceptions : throw if arg is not an analysis object Caller : ? + Status : Stable =cut @@ -503,6 +511,7 @@ sub update { Returntype : none Exceptions : thrown if $anal arg is not an analysis object Caller : ? + Status : Stable =cut @@ -549,6 +558,7 @@ sub remove { Returntype : int dbID if analysis is found, otherwise returns undef Exceptions : thrown if $anal arg is not an analysis object Caller : store + Status : Stable =cut @@ -586,6 +596,7 @@ sub exists { Returntype : Bio::EnsEMBL::Analysis Exceptions : none Caller : Bio::EnsEMBL::DBSQL::AnalsisAdaptor::fetch_* methods + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/ArchiveStableIdAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/ArchiveStableIdAdaptor.pm index a78b25d7c4..7eeb3d5ddb 100644 --- a/modules/Bio/EnsEMBL/DBSQL/ArchiveStableIdAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/ArchiveStableIdAdaptor.pm @@ -31,6 +31,8 @@ tables inside EnsEMBL core. _resolve_type +This whole module has a status of At Risk as it is under development. + =head1 DESCRIPTION @@ -61,14 +63,11 @@ use vars qw(@ISA); Returntype : Bio::EnsEMBL::ArchiveStableId Exceptions : none Caller : general + Status : At Risk + : under development =cut -# sub prepare { -# my $self = shift; -# warn @_; -# $self->SUPER::prepare( @_ ); -# } sub fetch_by_stable_id { my $self = shift; @@ -100,6 +99,8 @@ sub fetch_by_stable_id { Returntype : Bio::EnsEMBL::ArchiveStableId Exceptions : none Caller : general + Status : At Risk + : under development =cut @@ -134,6 +135,8 @@ sub fetch_by_stable_id_version { Returntype : Bio::EnsEMBL::ArchiveStableId Exceptions : none Caller : general + Status : At Risk + : under development =cut @@ -170,6 +173,8 @@ sub fetch_by_stable_id_dbname { Returntype : listref Bio::EnsEMBL::ArchiveStableId Exceptions : empty if not a gene stable id or not in database Caller : ArchiveStableId->get_all_transcripts() + Status : At Risk + : under development =cut @@ -224,6 +229,8 @@ sub fetch_all_by_gene_archive_id { Returntype : Bio::EnsEMBL::ArchiveStableId Exceptions : undef if not in db or not a Transcript Caller : Bio::EnsEMBL::ArchiveStableId->get_translation_archive_id + Status : At Risk + : under development =cut @@ -279,6 +286,8 @@ sub fetch_by_transcript_archive_id { Returntype : listref Bio::EnsEMBL::ArchiveStableId Exceptions : none Caller : Bio::EnsEMBL::ArchiveStableId->get_all_predecessors + Status : At Risk + : under development =cut @@ -336,6 +345,8 @@ sub fetch_pre_by_arch_id { Returntype : listref Bio::EnsEMBL::ArchiveStableId Exceptions : none Caller : webcode for archive + Status : At Risk + : under development =cut @@ -393,6 +404,8 @@ sub fetch_all_currently_related { Returntype : listref Bio::EnsEMBL::ArchiveStableId Exceptions : none Caller : Bio::EnsEMBL::ArchiveStableId->get_all_successors + Status : At Risk + : under development =cut @@ -448,6 +461,8 @@ sub fetch_succ_by_arch_id { Returntype : listref string Exceptions : none Caller : general + Status : At Risk + : under development =cut @@ -499,6 +514,8 @@ sub list_dbnames { Returntype : string Exceptions : none Caller : ArchiveStableId->get_peptide or general + Status : At Risk + : under development =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/AssemblyExceptionFeatureAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/AssemblyExceptionFeatureAdaptor.pm index 7efb14d22c..7a1c06a6f4 100644 --- a/modules/Bio/EnsEMBL/DBSQL/AssemblyExceptionFeatureAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/AssemblyExceptionFeatureAdaptor.pm @@ -50,6 +50,7 @@ use Bio::EnsEMBL::Utils::Exception qw(throw warning); Returntype : reference to list of Bio::EnsEMBL::AssemblyExceptionFeatures Exceptions : none Caller : fetch_by_dbID, fetch_by_Slice + Status : Stable =cut @@ -129,6 +130,7 @@ sub fetch_all { Returntype : Bio::EnsEMBL::AssemblyExceptionFeature Exceptions : none Caller : general + Status : Stable =cut @@ -155,6 +157,7 @@ sub fetch_by_dbID { Returntype : reference to list of Bio::EnsEMBL::AssemblyException features Exceptions : none Caller : Feature::get_all_alt_locations, general + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/AssemblyMapperAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/AssemblyMapperAdaptor.pm index 03e9be092d..0e54bf9f50 100644 --- a/modules/Bio/EnsEMBL/DBSQL/AssemblyMapperAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/AssemblyMapperAdaptor.pm @@ -88,6 +88,7 @@ my $CHUNKFACTOR = 20; # 2^20 = approx. 10^6 Returntype : Bio::EnsEMBL::DBSQL::AssemblyMapperAdaptor Exceptions : none Caller : Bio::EnsEMBL::DBSQL::DBAdaptor + Status : Stable =cut @@ -129,6 +130,7 @@ sub new { Returntype : Bio::EnsEMBL::AssemblyMapper Exceptions : wrong argument types Caller : general + Status : Stable =cut @@ -238,6 +240,7 @@ sub fetch_by_CoordSystems { or if it associated with multiple assembled pieces (bad data in assembly table) Caller : Bio::EnsEMBL::AssemblyMapper + Status : Stable =cut @@ -445,6 +448,7 @@ sub _seq_region_name_to_id { or if it associated with multiple assembled pieces (bad data in assembly table) Caller : Bio::EnsEMBL::AssemblyMapper + Status : Stable =cut @@ -559,7 +563,7 @@ sub register_component { error in the data in the meta table or in the code that creates the mapping paths. Caller : Bio::EnsEMBL::AssemblyMapper - + Status : Stable =cut @@ -863,6 +867,7 @@ sub register_chained { Returntype : none Exceptions : none Caller : specialised prograhsm + Status : Stable =cut @@ -972,6 +977,7 @@ sub register_all { Exceptions : throw if mapper is between coord systems with unexpected mapping paths Caller : specialised programs doing a lot of genome-wide mapping + Status : Stable =cut @@ -1242,6 +1248,7 @@ sub _build_combined_mapper { Returntype : listref of ints Exceptions : throw if a non-existant seqregion is provided Caller : general + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/AttributeAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/AttributeAdaptor.pm index 5b49533f97..9322e37531 100644 --- a/modules/Bio/EnsEMBL/DBSQL/AttributeAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/AttributeAdaptor.pm @@ -61,6 +61,7 @@ use vars qw(@ISA); Returntype : Bio::EnsEMBL::AttributeAdaptor Exceptions : none Caller : DBAdaptor + Status : Stable =cut @@ -86,6 +87,7 @@ sub new { Exceptions : throw if incorrect arguments throw if provided MiscFeature does not have a dbID Caller : MiscFeature + Status : Stable =cut @@ -128,6 +130,7 @@ sub fetch_all_by_MiscFeature { Exceptions : throw if incorrect arguments throw if provided MiscFeature does not have a dbID Caller : Transcript + Status : Stable =cut @@ -170,6 +173,7 @@ sub fetch_all_by_Transcript { Exceptions : throw if incorrect arguments throw if provided Translation does not have a dbID Caller : Transcript + Status : Stable =cut @@ -215,6 +219,7 @@ sub fetch_all_by_Translation { Exceptions : throw if incorrect arguments throw if cannot get seq_region_id from provided Slice Caller : Slice + Status : Stable =cut @@ -261,6 +266,7 @@ sub fetch_all_by_Slice { Returntype : none Exceptions : throw if $slice argument not provided Caller : general + Status : Stable =cut @@ -314,6 +320,7 @@ sub store_on_Slice { Exceptions : throw on incorrect arguments throw if provided feature is not stored in this database Caller : general, MiscFeatureAdaptor + Status : Stable =cut @@ -367,6 +374,7 @@ sub store_on_MiscFeature { Exceptions : throw on incorrect arguments throw if provided Transcript is not stored in this database Caller : general, TranscriptAdaptor + Status : Stable =cut @@ -421,6 +429,7 @@ sub store_on_Transcript { Exceptions : throw on incorrect arguments throw if provided Translation is not stored in this database Caller : general, TranslationAdaptor + Status : Stable =cut @@ -473,6 +482,7 @@ sub store_on_Translation { Exceptions : throw on incorrect arguments throw if cannot obtain seq_region_id from provided Slice Caller : general + Status : Stable =cut @@ -518,6 +528,7 @@ sub remove_from_Slice { Exceptions : throw on incorrect arguments throw if MiscFeature is not stored in this database Caller : general + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/BaseAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/BaseAdaptor.pm index 30ad3ed31f..c87ac7b503 100755 --- a/modules/Bio/EnsEMBL/DBSQL/BaseAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/BaseAdaptor.pm @@ -90,10 +90,8 @@ Internal methods are usually preceded with a _ package Bio::EnsEMBL::DBSQL::BaseAdaptor; use vars qw(@ISA); use strict; -use Bio::EnsEMBL::Root; use Bio::EnsEMBL::Utils::Exception qw(throw); -@ISA = qw(Bio::EnsEMBL::Root); =head2 new @@ -107,6 +105,7 @@ use Bio::EnsEMBL::Utils::Exception qw(throw); Returntype : Bio::EnsEMBL::DBSQL::BaseAdaptor Exceptions : none Caller : Bio::EnsEMBL::DBSQL::DBConnection + Status : Stable =cut @@ -149,6 +148,7 @@ sub new { Returntype : DBI::StatementHandle Exceptions : none Caller : Adaptors inherited from BaseAdaptor + Status : Stable =cut @@ -169,6 +169,7 @@ sub prepare{ Returntype : Bio::EnsEMBL::DBSQL::DBAdaptor Exceptions : none Caller : Adaptors inherited fro BaseAdaptor + Status : Stable =cut @@ -190,6 +191,7 @@ sub db{ Returntype : Bio::EnsEMBL::DBSQL::DBConnection Exceptions : none Caller : Adaptors inherited fro BaseAdaptor + Status : Stable =cut @@ -263,6 +265,7 @@ sub _straight_join { Returntype : listref of Bio::EnsEMBL::SeqFeature in contig coordinates Exceptions : none Caller : BaseFeatureAdaptor, ProxyDnaAlignFeatureAdaptor::generic_fetch + Status : Stable =cut @@ -348,6 +351,7 @@ sub generic_fetch { Exceptions : thrown if $id arg is not provided does not exist Caller : general + Status : Stable =cut @@ -387,6 +391,7 @@ sub fetch_by_dbID{ Exceptions : thrown if $id arg is not provided does not exist Caller : general + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/BaseAlignFeatureAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/BaseAlignFeatureAdaptor.pm index 87b8dcfbd7..4ada51f69f 100644 --- a/modules/Bio/EnsEMBL/DBSQL/BaseAlignFeatureAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/BaseAlignFeatureAdaptor.pm @@ -56,6 +56,7 @@ use Bio::EnsEMBL::DBSQL::BaseFeatureAdaptor; Returntype : listref of Bio::EnsEMBL::BaseAlignFeatures in Slice coordinates Exceptions : thrown if pid is not defined Caller : general + Status : Stable =cut @@ -95,6 +96,7 @@ sub fetch_all_by_Slice_and_pid { Returntype : listref of Bio::EnsEMBL::BaseAlignFeatures Exceptions : thrown if hit_name is not defined Caller : general + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/BaseFeatureAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/BaseFeatureAdaptor.pm index a4743b35de..d40b22b811 100644 --- a/modules/Bio/EnsEMBL/DBSQL/BaseFeatureAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/BaseFeatureAdaptor.pm @@ -52,6 +52,7 @@ our $MAX_SPLIT_QUERY_SEQ_REGIONS = 3; Returntype : Bio::EnsEMBL::BaseFeatureAdaptor Exceptions : none Caller : implementing subclass constructors + Status : Stable =cut @@ -85,6 +86,7 @@ sub new { Returntype : listref of Bio::EnsEMBL::SeqFeatures in Slice coordinates Exceptions : none Caller : Bio::EnsEMBL::Slice + Status : Stable =cut @@ -103,15 +105,16 @@ sub fetch_all_by_Slice { lower bound of the the score of the features retrieved Arg [3] : (optional) string $logic_name the logic name of the type of features to obtain - Example : $fts = $a->fetch_all_by_Slice($slice, 'Swall'); + Example : $fts = $a->fetch_all_by_Slice_and_score($slice,90,'Swall'); Description: Returns a list of features created from the database which are are on the Slice defined by $slice and which have a score - greated than $score. If $logic_name is defined, + greater than $score. If $logic_name is defined, only features with an analysis of type $logic_name will be returned. Returntype : listref of Bio::EnsEMBL::SeqFeatures in Slice coordinates Exceptions : none Caller : Bio::EnsEMBL::Slice + Status : Stable =cut @@ -147,6 +150,7 @@ sub fetch_all_by_Slice_and_score { Returntype : listref of Bio::EnsEMBL::SeqFeatures in Slice coordinates Exceptions : thrown if $slice is not defined Caller : Bio::EnsEMBL::Slice + Status : Stable =cut @@ -615,6 +619,8 @@ sub _logic_name_to_constraint { Returntype : none Exceptions : thrown method is not implemented by subclass Caller : general + Status : At Risk + : throws if called. =cut @@ -640,6 +646,7 @@ sub store{ Exceptions : thrown if $feature arg does not implement dbID(), or if $feature->dbID is not a true value Caller : general + Status : Stable =cut @@ -672,7 +679,7 @@ sub remove { =head2 remove_by_Slice Arg [1] : Bio::Ensembl::Slice $slice - Example : $feature_adaptor->remove_by_RawContig($slice); + Example : $feature_adaptor->remove_by_Slice($slice); Description: This removes features from the database which lie on a region represented by the passed in slice. Only features which are fully contained by the slice are deleted; features which overlap @@ -682,6 +689,7 @@ sub remove { Returntype : none Exceptions : thrown if no slice is supplied Caller : general + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/BaseMetaContainer.pm b/modules/Bio/EnsEMBL/DBSQL/BaseMetaContainer.pm index bc655cc53e..c7d91f3784 100644 --- a/modules/Bio/EnsEMBL/DBSQL/BaseMetaContainer.pm +++ b/modules/Bio/EnsEMBL/DBSQL/BaseMetaContainer.pm @@ -53,6 +53,7 @@ use Bio::EnsEMBL::Utils::Exception qw(deprecate); Returntype : listref of strings Exceptions : none Caller : ? + Status : Stable =cut @@ -89,6 +90,7 @@ sub list_value_by_key { Returntype : none Exceptions : none Caller : ? + Status : Stable =cut @@ -118,6 +120,7 @@ sub store_key_value { Returntype : none Exceptions : none Caller : ? + Status : Stable =cut @@ -141,6 +144,7 @@ sub update_key_value { Returntype : none Exceptions : none Caller : dna_compress script, general + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/CompressedSequenceAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/CompressedSequenceAdaptor.pm index 4f75755998..3a39e484d7 100644 --- a/modules/Bio/EnsEMBL/DBSQL/CompressedSequenceAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/CompressedSequenceAdaptor.pm @@ -111,6 +111,7 @@ sub _fetch_seq { Returntype : int Exceptions : none Caller : Bio::EnsEMBL::DBSQL::RawContigAdaptor::store + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/CoordSystemAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/CoordSystemAdaptor.pm index dd72103b0a..5640cb9819 100644 --- a/modules/Bio/EnsEMBL/DBSQL/CoordSystemAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/CoordSystemAdaptor.pm @@ -115,6 +115,7 @@ use vars qw(@ISA); Returntype : Bio::EnsEMBL::DBSQL::CoordSystemAdaptor Exceptions : none Caller : + Status : Stable =cut @@ -269,6 +270,7 @@ sub new { Returntype : listref of Bio::EnsEMBL::CoordSystems Exceptions : none Caller : general + Status : Stable =cut @@ -298,6 +300,7 @@ sub fetch_all { Returntype : Bio::EnsEMBL::CoordSystem Exceptions : none Caller : general + Status : Stable =cut @@ -339,6 +342,7 @@ sub fetch_by_rank { Exceptions : throw if no name argument provided warning if no version provided and default does not exist Caller : general + Status : Stable =cut @@ -405,6 +409,7 @@ sub fetch_by_name { Returntype : listref of Bio::EnsEMBL::CoordSystem objects Exceptions : throw if no name argument provided Caller : general + Status : Stable =cut @@ -437,6 +442,7 @@ sub fetch_all_by_name { Returntype : Bio::EnsEMBL::CoordSystem or undef Exceptions : thrown if no coord_system exists for specified dbID Caller : general + Status : Stable =cut @@ -463,6 +469,7 @@ sub fetch_by_dbID { Returntype : a Bio::EnsEMBL::CoordSystem object Exceptions : none Caller : general + Status : Stable =cut @@ -483,6 +490,7 @@ sub fetch_top_level { Exceptions : throw if no sequence_level coord system exists at all throw if multiple sequence_level coord systems exists Caller : general + Status : Stable =cut @@ -556,6 +564,7 @@ sub fetch_sequence_level { Exceptions : none Caller : general + Status : Stable =cut @@ -715,6 +724,7 @@ sub _fetch_all_by_attrib { Returntype : none Exceptions : Warning if CoordSystem is already stored in this database. Caller : none + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/DBConnection.pm b/modules/Bio/EnsEMBL/DBSQL/DBConnection.pm index 935db287f2..3618e7e203 100644 --- a/modules/Bio/EnsEMBL/DBSQL/DBConnection.pm +++ b/modules/Bio/EnsEMBL/DBSQL/DBConnection.pm @@ -102,6 +102,7 @@ use Bio::EnsEMBL::Utils::Argument qw(rearrange); cannot be connected to. Caller : Bio::EnsEMBL::::Utils::ConfigRegistry ( for newer code using the registry) Bio::EnsEMBL::DBSQL::DBAdaptor ( for old style code) + Status : Stable =cut @@ -170,6 +171,7 @@ sub new { Returntype : none Exceptions : none Caller : new, db_handle + Status : Stable =cut @@ -207,12 +209,15 @@ sub connect { =head2 connected + Example : $dbcon->connected() Description: Boolean which tells if DBConnection is connected or not. State is set internally, and external processes should not alter state. Returntype : undef or 1 Exceptions : none Caller : db_handle, connect, disconnect_if_idle, user processes + Status : Stable + =cut sub connected { @@ -268,6 +273,7 @@ sub equals{ Returntype : string Exceptions : none Caller : new + Status : Stable =cut @@ -292,6 +298,7 @@ sub driver { Returntype : string Exceptions : none Caller : new + Status : Stable =cut @@ -316,6 +323,7 @@ sub port { Returntype : string Exceptions : none Caller : new + Status : Stable =cut @@ -339,6 +347,7 @@ sub dbname { Returntype : string Exceptions : none Caller : new + Status : Stable =cut @@ -362,6 +371,7 @@ sub username { Returntype : string Exceptions : none Caller : new + Status : Stable =cut @@ -385,6 +395,7 @@ sub host { Returntype : string Exceptions : none Caller : new + Status : Stable =cut @@ -409,6 +420,7 @@ sub password { Returntype : boolean Exceptions : none Caller : Pipeline + Status : Stable =cut @@ -437,6 +449,7 @@ sub disconnect_when_inactive { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -460,6 +473,7 @@ sub locator { Returntype : DBI Database Handle Exceptions : none Caller : new, DESTROY + Status : Stable =cut @@ -489,6 +503,7 @@ sub db_handle { Exceptions : thrown if the SQL statement is empty, or if the internal database handle is not present Caller : Adaptor modules + Status : Stable =cut @@ -524,6 +539,7 @@ sub prepare { Exceptions : thrown if the SQL statement is empty, or if the internal database handle is not present. Caller : Adaptor modules + Status : Stable =cut @@ -568,6 +584,7 @@ sub do { Exceptions : none Caller : Bio::EnsEMBL::DBSQL::SQL::StatementHandle::DESTROY Bio::EnsEMBL::DBSQL::DBConnection::do + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/DBEntryAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/DBEntryAdaptor.pm index f43c9b5094..611e592539 100644 --- a/modules/Bio/EnsEMBL/DBSQL/DBEntryAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/DBEntryAdaptor.pm @@ -55,6 +55,7 @@ use strict; Returntype : Bio::EnsEMBL::DBEntry Exceptions : none Caller : general + Status : Stable =cut @@ -122,6 +123,7 @@ sub fetch_by_dbID { Returntype : Bio::EnsEMBL::DBSQL::DBEntry Exceptions : thrown if arguments are incorrect Caller : general, domainview + Status : Stable =cut @@ -208,6 +210,7 @@ sub fetch_by_db_accession { Returntype : int - the identifier of the newly created external refernce Exceptions : none Caller : scripts which load Xrefs and ObjectXrefs, etc. into EnsEMBL. + Status : Stable =cut @@ -375,6 +378,7 @@ sub store { Returntype : int Exceptions : thrown on incorrect args Caller : GeneAdaptor::store, TranscriptAdaptor::store + Status : Stable =cut @@ -413,8 +417,9 @@ sub exists { all of the gene, transcript, and translation xrefs associated with this gene. Returntype : listref of Bio::EnsEMBL::DBEntries - Exceptions : none + Exceptions : thows if gene object not passed Caller : Bio::EnsEMBL::Gene + Status : Stable =cut @@ -439,8 +444,9 @@ sub fetch_all_by_Gene { to contain all of the gene, transcript, and translation xrefs associated with this gene. Returntype : listref of Bio::EnsEMBL::DBEntries - Exceptions : none + Exceptions : throes if transcript argument not passed Caller : Bio::EnsEMBL::Gene + Status : Stable =cut @@ -462,8 +468,9 @@ sub fetch_all_by_Transcript { Example : @db_entries = @{$db_entry_adptr->fetch_by_Translation($trans)}; Description: Retrieves external database entries for an EnsEMBL translation Returntype : listref of Bio::EnsEMBL::DBEntries - Exceptions : none + Exceptions : throws if translation object not passed Caller : general + Status : Stable =cut @@ -503,6 +510,7 @@ sub fetch_all_by_Translation { Warning if object or dbentry is not stored in this database. Caller : TranscriptAdaptor::remove, GeneAdaptor::remove, TranslationAdaptor::remove + Status : Stable =cut @@ -587,6 +595,7 @@ sub remove_from_object { Caller : fetch_all_by_Gene fetch_all_by_Translation fetch_all_by_Transcript + Status : Stable =cut @@ -713,6 +722,7 @@ sub _fetch_by_object_type { Returntype : list of ints Exceptions : none Caller : unknown + Status : Stable =cut @@ -738,6 +748,7 @@ sub list_gene_ids_by_extids{ Returntype : list of ints Exceptions : none Caller : unknown + Status : Stable =cut @@ -760,6 +771,7 @@ sub list_transcript_ids_by_extids{ Returntype : list of Ints Exceptions : none Caller : unknown + Status : Stable =cut @@ -783,6 +795,7 @@ sub list_translation_ids_by_extids{ Caller : list_translation_ids_by_extids translationids_by_extids geneids_by_extids + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/DensityFeatureAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/DensityFeatureAdaptor.pm index 02521140f4..2f92d8d5ca 100644 --- a/modules/Bio/EnsEMBL/DBSQL/DensityFeatureAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/DensityFeatureAdaptor.pm @@ -60,6 +60,7 @@ our $DENSITY_FEATURE_CACHE_SIZE = 20; Returntype : Bio::EnsEMBL::DBSQL::DensityFeatureAdaptor Exceptions : none Caller : implementing subclass constructors + Status : Stable =cut @@ -122,6 +123,7 @@ sub new { warning if no features with logic_name $logic_name exist warning if density_type table has invalid block_size value Caller : general + Status : Stable =cut @@ -454,6 +456,7 @@ sub _objs_from_sth { Returntype : list of ints Exceptions : none Caller : ? + Status : Stable =cut @@ -475,6 +478,7 @@ sub list_dbIDs { have an attached slice. or if any elements of @df are not Bio::EnsEMBL::SeqFeatures Caller : general + Status : Stable =cut @@ -554,6 +558,7 @@ sub store{ Returntype : Bio::EnsEMBL::DensityFeatureSet Exceptions : none Caller : general + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/DensityTypeAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/DensityTypeAdaptor.pm index ad76b5771f..20266cdb6a 100644 --- a/modules/Bio/EnsEMBL/DBSQL/DensityTypeAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/DensityTypeAdaptor.pm @@ -48,6 +48,7 @@ use Bio::EnsEMBL::Utils::Exception qw(throw warning); Returntype : Bio::EnsEMBL::DBSQL::DensityTypeAdaptor Exceptions : none Caller : DBAdaptor + Status : Stable =cut @@ -71,6 +72,7 @@ sub new { Returntype : reference to list of Bio::EnsEMBL::DensityType objects Exceptions : none Caller : general, new + Status : Stable =cut @@ -122,6 +124,7 @@ sub fetch_all { Returntype : Bio::EnsEMBL::DensityType Exceptions : throw if dbID argument not defined Caller : general + Status : Stable =cut @@ -152,6 +155,7 @@ sub fetch_by_dbID { Returntype : reference to list of Bio::EnsEMBL::DensityTypes Exceptions : thrown if logic_name argument is not provided Caller : general + Status : Stable =cut @@ -205,12 +209,13 @@ sub fetch_all_by_logic_name { Arg [1] : list of Bio::EnsEMBL::DensityType @dt the density types to store in the database - Example : $density_type->store(1234, @density_types); + Example : $density_type->store(@density_types); Description: Stores a list of density type objects in the database Returntype : none Exceptions : thrown if @dt is not defined or if any elements of @dt are not Bio::EnsEMBL::DensityType Caller : general + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/DnaAlignFeatureAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/DnaAlignFeatureAdaptor.pm index 8d9742590d..68b4e7ca51 100644 --- a/modules/Bio/EnsEMBL/DBSQL/DnaAlignFeatureAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/DnaAlignFeatureAdaptor.pm @@ -51,6 +51,7 @@ use Bio::EnsEMBL::Utils::Exception qw(throw warning); Returntype : list of listrefs of strings Exceptions : none Caller : Bio::EnsEMBL::DBSQL::BaseFeatureAdaptor::generic_fetch + Status : Stable =cut @@ -70,6 +71,7 @@ sub _tables { Returntype : list of strings Exceptions : none Caller : Bio::EnsEMBL::DBSQL::BaseFeatureAdaptor::generic_fetch + Status : Stable =cut @@ -110,6 +112,7 @@ sub _columns { A warning is given if: * The feature has already been stored in this db Caller : Pipeline + Status : Stable =cut @@ -198,6 +201,7 @@ sub store { Returntype : listref of Bio::EnsEMBL::DnaDnaAlignFeatures Exceptions : none Caller : Bio::EnsEMBL::BaseFeatureAdaptor::generic_fetch + Status : Stable =cut @@ -355,6 +359,7 @@ sub _objs_from_sth { Returntype : list of ints Exceptions : none Caller : ? + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/ExonAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/ExonAdaptor.pm index 25eb57e830..3e63406f00 100644 --- a/modules/Bio/EnsEMBL/DBSQL/ExonAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/ExonAdaptor.pm @@ -119,6 +119,7 @@ sub _final_clause { Returntype : Bio::EnsEMBL::Exon in contig coordinates Exceptions : none Caller : general + Status : Stable =cut @@ -142,8 +143,9 @@ sub fetch_by_stable_id { Example : none Description: Retrieves all Exons for the Transcript in 5-3 order Returntype : listref Bio::EnsEMBL::Exon on Transcript slice - Exceptions : none + Exceptions : throws if transcript has no slice Caller : Transcript->get_all_Exons() + Status : Stable =cut @@ -204,6 +206,7 @@ sub fetch_all_by_Transcript { or if $exon->start, $exon->end, $exon->strand, or $exon->phase are not defined or if $exon is not a Bio::EnsEMBL::Exon Caller : general + Status : Stable =cut @@ -331,6 +334,7 @@ sub store { Returntype : none Exceptions : none Caller : general + Status : Stable =cut @@ -412,6 +416,7 @@ sub remove { Returntype : list of ints Exceptions : none Caller : ? + Status : Stable =cut @@ -429,6 +434,7 @@ sub list_dbIDs { Returntype : list of ints Exceptions : none Caller : ? + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/GeneAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/GeneAdaptor.pm index 07eb77901f..308d35ccbd 100644 --- a/modules/Bio/EnsEMBL/DBSQL/GeneAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/GeneAdaptor.pm @@ -66,6 +66,7 @@ use vars '@ISA'; # Returntype : list of listrefs of strings # Exceptions : none # Caller : internal +# Status : Stable sub _tables { my $self = shift; @@ -85,6 +86,7 @@ sub _tables { # Returntype : list of strings # Exceptions : none # Caller : internal +# Status : Stable sub _columns { my $self = shift; @@ -115,6 +117,7 @@ sub _left_join { Returntype : list of ints Exceptions : none Caller : ? + Status : Stable =cut @@ -132,6 +135,7 @@ sub list_dbIDs { Returntype : reference to a list of strings Exceptions : none Caller : ? + Status : Stable =cut @@ -151,6 +155,7 @@ sub list_stable_ids { Returntype : Bio::EnsEMBL::Gene Exceptions : none Caller : general + Status : Stable =cut @@ -178,6 +183,7 @@ sub fetch_by_display_label { Returntype : Bio::EnsEMBL::Gene in given coordinate system Exceptions : if we cant get the gene in given coord system Caller : general + Status : Stable =cut @@ -215,6 +221,7 @@ sub fetch_by_stable_id { Returntype : Bio::EnsEMBL::Gene (or undef) Exceptions : none Caller : general + Status : Stable =cut @@ -256,6 +263,7 @@ sub fetch_by_exon_stable_id{ Returntype : list of Bio::EnsEMBL::Genes Exceptions : none Caller : domainview + Status : Stable =cut @@ -304,6 +312,7 @@ sub fetch_all_by_domain { Returntype : reference to list of transcripts Exceptions : thrown if exon cannot be placed on transcript slice Caller : Slice::get_all_Transcripts + Status : Stable =cut @@ -418,6 +427,7 @@ sub fetch_all_by_Slice { Returntype : Bio::EnsEMBL::Gene Exceptions : none Caller : ? + Status : Stable =cut @@ -452,6 +462,7 @@ sub fetch_by_transcript_id { Returntype : Bio::EnsEMBL::Gene Exceptions : none Caller : ? + Status : Stable =cut @@ -490,6 +501,7 @@ sub fetch_by_transcript_stable_id { Returntype : Bio::EnsEMBL::Gene Exceptions : none Caller : geneview + Status : Stable =cut @@ -532,6 +544,7 @@ sub fetch_by_translation_stable_id { Returntype : listref of Bio::EnsEMBL::Genes Exceptions : none Caller : goview + Status : Stable =cut @@ -569,6 +582,7 @@ sub fetch_all_by_external_name { Exceptions : throw if incorrect arg provided warning if gene arg does not have dbID Caller : Gene::get_all_alt_alleles + Status : Stable =cut @@ -627,6 +641,7 @@ sub fetch_all_alt_alleles { Exceptions : throw on incorrect arguments throw on sql error (e.g. duplicate unique id) Caller : ? + Status : Stable =cut @@ -724,6 +739,7 @@ sub store_alt_alleles { Exceptions : thrown if the $gene is not a Bio::EnsEMBL::Gene or if $gene does not have an analysis object Caller : general + Status : Stable =cut @@ -910,6 +926,7 @@ sub store { Exceptions : throw on incorrect arguments warning if gene is not stored in this database Caller : general + Status : Stable =cut @@ -979,6 +996,7 @@ sub remove { Returntype : listref of strings Exceptions : none Caller : domainview? + Status : Stable =cut @@ -1029,6 +1047,7 @@ sub get_Interpro_by_geneid { Returntype : None Exceptions : thrown if the $gene is not a Bio::EnsEMBL::Gene Caller : general + Status : Stable =cut @@ -1078,6 +1097,7 @@ sub update { # Returntype : listref of Bio::EnsEMBL::Genes in target coordinate system # Exceptions : none # Caller : internal +# Status : Stable sub _objs_from_sth { my ($self, $sth, $mapper, $dest_slice) = @_; diff --git a/modules/Bio/EnsEMBL/DBSQL/KaryotypeBandAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/KaryotypeBandAdaptor.pm index 7d326404c2..c721af4953 100644 --- a/modules/Bio/EnsEMBL/DBSQL/KaryotypeBandAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/KaryotypeBandAdaptor.pm @@ -146,6 +146,7 @@ sub _objs_from_sth { (assembly) coordinates Exceptions : none Caller : general + Status : Stable =cut @@ -177,8 +178,9 @@ sub fetch_all_by_chr_name { matching of the band name. For example the bands 'q23.1' and 'q23.4' could be matched by fetch_all_by_chr_band('20', 'q23'); Returntype : Bio::EnsEMBL::KaryotypeBand in chromosomal coordinates. - Exceptions : none + Exceptions : throws if chr or band is missing in arguments Caller : general + Status : Stable =cut @@ -215,6 +217,7 @@ sub fetch_by_chr_band { Returntype : reference to a list of ints Exceptions : none Caller : ? + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/MetaContainer.pm b/modules/Bio/EnsEMBL/DBSQL/MetaContainer.pm index 1bd7728e73..c281b9ba70 100644 --- a/modules/Bio/EnsEMBL/DBSQL/MetaContainer.pm +++ b/modules/Bio/EnsEMBL/DBSQL/MetaContainer.pm @@ -55,6 +55,7 @@ use Bio::Species; Returntype : Bio::Species Exceptions : none Caller : ? + Status : Stable =cut @@ -90,6 +91,7 @@ sub get_Species { Returntype : string Exceptions : none Caller : ? + Status : Stable =cut @@ -157,6 +159,7 @@ sub get_max_assembly_contig { Returntype : string Exceptions : none Caller : ? + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/MetaCoordContainer.pm b/modules/Bio/EnsEMBL/DBSQL/MetaCoordContainer.pm index b5d8dc7c5a..d121a19f3e 100644 --- a/modules/Bio/EnsEMBL/DBSQL/MetaCoordContainer.pm +++ b/modules/Bio/EnsEMBL/DBSQL/MetaCoordContainer.pm @@ -52,6 +52,7 @@ sub new { Returntype : listref of Bio::EnsEMBL::CoordSystem objects Exceptions : throw if name argument not provided Caller : BaseFeatureAdaptor + Status : Stable =cut @@ -96,6 +97,7 @@ sub fetch_all_CoordSystems_by_feature_type { Returntype : int or undef Exceptions : throw on incorrect argument Caller : BaseFeatureAdaptor + Status : Stable =cut @@ -133,6 +135,7 @@ sub fetch_max_length_by_CoordSystem_feature_type { Returntype : none Exceptions : none Caller : BaseFeatureAdaptor + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/MiscFeatureAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/MiscFeatureAdaptor.pm index f6d7634605..0e59091921 100644 --- a/modules/Bio/EnsEMBL/DBSQL/MiscFeatureAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/MiscFeatureAdaptor.pm @@ -76,6 +76,7 @@ use vars qw(@ISA); Exceptions : throw if set_code is not provided warning if no set for provided set code exists Caller : general + Status : Stable =cut @@ -136,6 +137,7 @@ sub fetch_all_by_Slice_and_set_code { Returntype : listref of Bio::EnsEMBL::MiscFeatures Exceptions : throw if attrib_type code arg is not provided Caller : general + Status : Stable =cut @@ -507,6 +509,7 @@ sub _objs_from_sth { Returntype : list of ints Exceptions : none Caller : ? + Status : Stable =cut @@ -528,6 +531,7 @@ sub list_dbIDs { warning if misc feature is already stored in this database throw if start/end/strand attribs are not valid Caller : general + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/MiscSetAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/MiscSetAdaptor.pm index 0a1fa1488a..18dd35016a 100644 --- a/modules/Bio/EnsEMBL/DBSQL/MiscSetAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/MiscSetAdaptor.pm @@ -60,6 +60,7 @@ use vars qw(@ISA); Returntype : Bio::EnsEMBL::MiscSet Exceptions : none Caller : MiscFeatureAdaptor + Status : Stable =cut @@ -94,6 +95,7 @@ sub new { Returntype : listref of Bio::EnsEMBL::MiscSets Exceptions : none Caller : general + Status : Stable =cut @@ -140,6 +142,7 @@ sub fetch_all { Returntype : Bio::EnsEMBL::MiscSet Exceptions : none Caller : general + Status : Stable =cut @@ -166,6 +169,7 @@ sub fetch_by_dbID { Returntype : Bio::EnsEMBL::MiscSet Exceptions : none Caller : general + Status : Stable =cut @@ -193,6 +197,7 @@ sub fetch_by_code { Exceptions : throw on incorrect arguments warning if a feature is already stored in this database Caller : MiscFeatureAdaptor::store + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/PredictionExonAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/PredictionExonAdaptor.pm index 934d98f86f..95e0a08aa8 100644 --- a/modules/Bio/EnsEMBL/DBSQL/PredictionExonAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/PredictionExonAdaptor.pm @@ -107,8 +107,9 @@ sub _final_clause { Example : none Description: Retrieves all Exons for the Transcript in 5-3 order Returntype : listref Bio::EnsEMBL::Exon on Transcript slice - Exceptions : none + Exceptions : throws if transcript does not have a slice Caller : Transcript->get_all_Exons() + Status : Stable =cut @@ -160,6 +161,7 @@ sub fetch_all_by_PredictionTranscript { or if $exon->start, $exon->end, $exon->strand, or $exon->phase are not defined or if $exon is not a Bio::EnsEMBL::PredictionExon Caller : general + Status : Stable =cut @@ -227,6 +229,7 @@ sub store { Returntype : none Exceptions : none Caller : general + Status : Stable =cut @@ -258,6 +261,7 @@ sub remove { Returntype : list of ints Exceptions : none Caller : ? + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/PredictionTranscriptAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/PredictionTranscriptAdaptor.pm index b9843c4ff6..193e456d16 100644 --- a/modules/Bio/EnsEMBL/DBSQL/PredictionTranscriptAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/PredictionTranscriptAdaptor.pm @@ -86,17 +86,18 @@ sub _columns { =head2 fetch_by_stable_id -Arg [1] : string $stable_id - The stable id of the transcript to retrieve -Example : $trans = $trans_adptr->fetch_by_stable_id('GENSCAN00000001234'); -Description: Retrieves a prediction transcript via its display_label. - This method is called fetch_by_stable_id for polymorphism with - the TranscriptAdaptor. Prediction transcript display_labels are - not necessarily stable in that the same identifier may be reused - for a completely different prediction transcript in a subsequent - database release. -Returntype : Bio::EnsEMBL::PredictionTranscript -Caller : general + Arg [1] : string $stable_id + The stable id of the transcript to retrieve + Example : $trans = $trans_adptr->fetch_by_stable_id('GENSCAN00000001234'); + Description: Retrieves a prediction transcript via its display_label. + This method is called fetch_by_stable_id for polymorphism with + the TranscriptAdaptor. Prediction transcript display_labels are + not necessarily stable in that the same identifier may be reused + for a completely different prediction transcript in a subsequent + database release. + Returntype : Bio::EnsEMBL::PredictionTranscript + Caller : general + Status : Stable =cut @@ -130,6 +131,7 @@ sub fetch_by_stable_id { Returntype : reference to list of transcripts Exceptions : thrown if exon cannot be placed on transcript slice Caller : Slice::get_all_Transcripts + Status : Stable =cut @@ -244,6 +246,7 @@ sub fetch_all_by_Slice { Returntype : reference to a list of Bio::EnsEMBL::PredictionTranscripts Exceptions : none Caller : superclass generic_fetch + Status : Stable =cut @@ -404,6 +407,7 @@ sub _objs_from_sth { Returntype : none Exceptions : on wrong argument type Caller : general + Status : Stable =cut @@ -489,8 +493,9 @@ sub store { Example : $prediction_transcript_adaptor->remove($pt); Description: removes given prediction transcript $pt from database. Returntype : none - Exceptions : none + Exceptions : throws if argument not a Bio::EnsEMBL::PredictionTranscript Caller : general + Status : Stable =cut @@ -533,6 +538,7 @@ sub remove { Returntype : list of ints Exceptions : none Caller : ? + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/ProteinAlignFeatureAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/ProteinAlignFeatureAdaptor.pm index faba67da36..85b756a52d 100644 --- a/modules/Bio/EnsEMBL/DBSQL/ProteinAlignFeatureAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/ProteinAlignFeatureAdaptor.pm @@ -58,6 +58,7 @@ use Bio::EnsEMBL::Utils::Exception qw(throw warning); A warning is given if: * The feature has already been stored in this db Caller : Pipeline + Status : Stable =cut @@ -152,6 +153,7 @@ sub store{ Returntype : listref of Bio::EnsEMBL::ProteinAlignFeatures Exceptions : none Caller : Bio::EnsEMBL::BaseFeatureAdaptor::generic_fetch + Status : Stable =cut @@ -336,6 +338,7 @@ sub _columns { Returntype : listref of ints Exceptions : none Caller : ? + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/ProteinFeatureAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/ProteinFeatureAdaptor.pm index 5efb65ecca..dbf7c4ec11 100755 --- a/modules/Bio/EnsEMBL/DBSQL/ProteinFeatureAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/ProteinFeatureAdaptor.pm @@ -69,6 +69,7 @@ use vars qw(@ISA); Returntype : listref of Bio::EnsEMBL::ProteinFeatures Exceptions : none Caller : ? + Status : Stable =cut @@ -138,6 +139,7 @@ sub fetch_all_by_translation_id { Returntype : Bio::EnsEMBL::ProteinFeauture Exceptions : none Caller : ? + Status : Stable =cut @@ -198,6 +200,7 @@ sub fetch_by_dbID{ Returntype : int - the new internal identifier of the stored protein feature Exceptions : thrown if arg is not a Bio::EnsEMBL: Caller : none + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/RegulatoryFactorAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/RegulatoryFactorAdaptor.pm index 7608718d7f..1122f7c7a7 100644 --- a/modules/Bio/EnsEMBL/DBSQL/RegulatoryFactorAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/RegulatoryFactorAdaptor.pm @@ -58,6 +58,8 @@ use vars qw(@ISA); Returntype : Bio::EnsEMBL::RegulatoryFactor Exceptions : none Caller : general, Bio::EnsEMBL::RegulatoryFactorAdaptor + Status : At Risk + : under development =cut @@ -80,6 +82,8 @@ sub fetch_by_dbID { Returntype : Bio::EnsEMBL::RegulatoryFactor Exceptions : none Caller : general + Status : At Risk + : under development =cut @@ -101,6 +105,8 @@ sub fetch_by_name { Returntype : listREF of Bio::EnsEMBL::RegulatoryFactors Exceptions : none Caller : general + Status : At Risk + : under development =cut @@ -121,6 +127,8 @@ sub fetch_all_by_type { Returntype : listref of Bio::EnsEMBL::RegulatoryFactor objects Exceptions : none Caller : internal + Status : At Risk + : under development =cut @@ -156,6 +164,8 @@ sub _generic_fetch { Returntype : none Exceptions : none Caller : ? + Status : At Risk + : under development =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/RegulatoryFeatureAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/RegulatoryFeatureAdaptor.pm index 359971ffc4..c1b76cea9a 100644 --- a/modules/Bio/EnsEMBL/DBSQL/RegulatoryFeatureAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/RegulatoryFeatureAdaptor.pm @@ -61,6 +61,8 @@ use vars qw(@ISA); Returntype : reference to a list of Bio::EnsEMBL::RegulatoryFeatures. Exceptions : throw on bad argument Caller : Slice::get_all_RegulatoryFeatures + Status : At Risk + : under development =cut @@ -299,6 +301,8 @@ sub _objs_from_sth { Returntype : listREF of Bio::EnsEMBL::RegulatoryFeatures Exceptions : none Caller : general + Status : At Risk + : under development =cut @@ -328,6 +332,8 @@ sub fetch_all_by_factor { Returntype : none Exceptions : Caller : general + Status : At Risk + : under development =cut @@ -412,6 +418,8 @@ sub store { Returntype : list of ints Exceptions : none Caller : ? + Status : At Risk + : under development =cut @@ -432,6 +440,8 @@ sub list_dbIDs { Returntype : Listref of Bio::EnsEMBL::RegulatoryFeature Exceptions : none Caller : ? + Status : At Risk + : under development =cut @@ -472,6 +482,8 @@ sub fetch_all_by_ensembl_object_type { Returntype : Listref of Bio::EnsEMBL::RegulatoryFeature Exceptions : If arg is not of correct type. Caller : ? + Status : At Risk + : under development =cut @@ -499,6 +511,8 @@ sub fetch_all_by_transcript { Returntype : Listref of Bio::EnsEMBL::RegulatoryFeature Exceptions : If arg is not of correct type. Caller : ? + Status : At Risk + : under development =cut @@ -529,6 +543,8 @@ sub fetch_all_by_translation { Returntype : Listref of Bio::EnsEMBL::RegulatoryFeature Exceptions : If arg is not of correct type. Caller : ? + Status : At Risk + : under development =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/RepeatConsensusAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/RepeatConsensusAdaptor.pm index df4b933308..332f5e2530 100644 --- a/modules/Bio/EnsEMBL/DBSQL/RepeatConsensusAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/RepeatConsensusAdaptor.pm @@ -57,6 +57,7 @@ use vars qw(@ISA); Returntype : Bio::EnsEMBL::RepeatConsensus Exceptions : none Caller : general, Bio::EnsEMBL::RepeatFeatureAdaptor + Status : Stable =cut @@ -79,6 +80,7 @@ sub fetch_by_dbID { Returntype : Bio::EnsEMBL::RepeatConsensus Exceptions : none Caller : general + Status : Stable =cut @@ -104,6 +106,7 @@ sub fetch_by_name { Returntype : Bio::EnsEMBL::RepeatConsensus Exceptions : none Caller : general + Status : Stable =cut @@ -133,6 +136,7 @@ sub fetch_by_name_class { Returntype : listREF of Bio::EnsEMBL::RepeatConsensus Exceptions : none Caller : general + Status : Stable =cut @@ -161,6 +165,7 @@ sub fetch_by_class_seq { Returntype : listref of Bio::EnsEMBL::RepeatConsensus objects Exceptions : none Caller : internal + Status : Stable =cut @@ -218,6 +223,7 @@ sub _generic_fetch { Returntype : none Exceptions : none Caller : ? + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/RepeatFeatureAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/RepeatFeatureAdaptor.pm index b89c18d762..eb59521f06 100644 --- a/modules/Bio/EnsEMBL/DBSQL/RepeatFeatureAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/RepeatFeatureAdaptor.pm @@ -21,7 +21,7 @@ my @repeats = @{$rfa->fetch_all_by_Slice($slice)}; =head1 DESCRIPTION This is an adaptor for the retrieval and storage of RepeatFeature objects -from the RepeatFeature database. Most of the implementation is in the +from the database. Most of the implementation is in the superclass BaseFeatureAdaptor. =head1 AUTHOR - James Gilbert @@ -65,6 +65,7 @@ use vars qw(@ISA); Returntype : reference to a list of Bio::EnsEMBL::RepeatFeatures. Exceptions : throw on bad argument Caller : Slice::get_all_RepeatFeatures + Status : Stable =cut @@ -325,12 +326,13 @@ sub _objs_from_sth { Arg [1] : list of Bio::EnsEMBL::RepeatFeatures $repeat_feature_id the list of repeat features to store in the database - Example : $repeat_feature_adaptor->store(1234, @repeat_features); + Example : $repeat_feature_adaptor->store(@repeat_features); Description: stores a repeat feature in the database Returntype : none Exceptions : if the repeat features do not have attached sequences or if repeat_consensus are not present Caller : general + Status : Stable =cut @@ -460,6 +462,7 @@ sub store { Returntype : list of ints Exceptions : none Caller : ? + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/SequenceAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/SequenceAdaptor.pm index 486ec2955c..f51f3af04e 100644 --- a/modules/Bio/EnsEMBL/DBSQL/SequenceAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/SequenceAdaptor.pm @@ -56,6 +56,7 @@ our $SEQ_CACHE_MAX = (2 ** $SEQ_CHUNK_PWR) * $SEQ_CACHE_SZ; Returntype : Bio::EnsEMBL:DBSQL::SequenceAdaptor Exceptions : none Caller : DBAdaptor::get_SequenceAdaptor + Status : Stable =cut @@ -100,6 +101,7 @@ sub new { Returntype : string Exceptions : endBasePair should be less or equal to length of slice Caller : Bio::EnsEMBL::Slice::seq(), Slice::subseq() + Status : Stable =cut @@ -292,6 +294,7 @@ sub _fetch_seq { Returntype : none Exceptions : throw if the database insert fails Caller : sequence loading scripts + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/SimpleFeatureAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/SimpleFeatureAdaptor.pm index 93f69dfc9f..de698999b8 100644 --- a/modules/Bio/EnsEMBL/DBSQL/SimpleFeatureAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/SimpleFeatureAdaptor.pm @@ -42,13 +42,14 @@ use Bio::EnsEMBL::Utils::Exception qw(throw warning); Arg [1] : list of Bio::EnsEMBL::SimpleFeatures @sf the simple features to store in the database - Example : $simple_feature_adaptor->store(1234, @simple_feats); + Example : $simple_feature_adaptor->store(@simple_feats); Description: Stores a list of simple feature objects in the database Returntype : none Exceptions : thrown if @sf is not defined, if any of the features do not have an attached slice. - or if any elements of @sf are not Bio::EnsEMBL::SeqFeatures + or if any elements of @sf are not Bio::EnsEMBL::SimpleFeatures Caller : general + Status : Stable =cut @@ -112,6 +113,7 @@ sub store{ Returntype : list of listrefs of strings Exceptions : none Caller : internal + Status : Stable =cut @@ -131,6 +133,7 @@ sub _tables { Returntype : list of strings Exceptions : none Caller : internal + Status : Stable =cut @@ -152,6 +155,7 @@ sub _columns { Returntype : list reference to Bio::EnsEMBL::SimpleFeature objects Exceptions : none Caller : internal + Status : Stable =cut @@ -300,6 +304,7 @@ sub _objs_from_sth { Returntype : list of ints Exceptions : none Caller : ? + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/SliceAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/SliceAdaptor.pm index 84df4a3d80..4a8cf533a3 100644 --- a/modules/Bio/EnsEMBL/DBSQL/SliceAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/SliceAdaptor.pm @@ -163,6 +163,7 @@ sub new { throw if invalid coord_system_name is provided throw if start > end is provided Caller : general + Status : Stable =cut @@ -341,6 +342,7 @@ sub fetch_by_region { Returntype : Bio::EnsEMBL::Slice or undef Exceptions : throw if incorrent arg provided Caller : Pipeline + Status : Stable =cut @@ -386,6 +388,7 @@ sub fetch_by_name { Returntype : Bio::EnsEMBL::Slice or undef Exceptions : none Caller : general + Status : Stable =cut @@ -445,6 +448,7 @@ sub fetch_by_seq_region_id { Exceptions : throw if the seq_region of the slice is not in the db throw if incorrect arg provided Caller : BaseFeatureAdaptor + Status : Stable =cut @@ -535,6 +539,7 @@ sub get_seq_region_id { Returntype : listref of Bio::EnsEMBL::Slices Exceptions : none Caller : general + Status : Stable =cut @@ -666,8 +671,9 @@ sub fetch_all { Usage : Function: create a Slice representing a series of bands Example : - Returns : + Returns : Bio::EnsEMBL::Slice Args : the band name + Status : Stable =cut @@ -696,8 +702,9 @@ sub fetch_by_band { Usage : Function: create a Slice representing a series of bands Example : - Returns : + Returns : Bio::EnsEMBL::Slice Args : the band name + Status : Stable =cut @@ -740,6 +747,7 @@ sub fetch_by_chr_band { Returntype : Bio::EnsEMBL::Slice Exceptions : Thrown if the exon is not in the database. Caller : general + Status : Stable =cut @@ -772,6 +780,7 @@ sub fetch_by_exon_stable_id{ Returntype : Bio::EnsEMBL::Slice Exceptions : Thrown if the transcript is not in the database. Caller : general + Status : Stable =cut @@ -807,6 +816,7 @@ sub fetch_by_transcript_stable_id{ Exceptions : throw on incorrect args throw if transcript is not in database Caller : general + Status : Stable =cut @@ -842,6 +852,7 @@ sub fetch_by_transcript_id { Exceptions : throw on incorrect args throw if transcript does not exist Caller : general + Status : Stable =cut @@ -879,6 +890,7 @@ sub fetch_by_gene_stable_id { throw if feature argument is not provided Caller : fetch_by_gene_stable_id, fetch_by_transcript_stable_id, fetch_by_gene_id, fetch_by_transcript_id + Status : Stable =cut @@ -962,6 +974,7 @@ sub fetch_by_Feature{ Warning if multiple features with the specified attribute type and value exist in the database. Caller : webcode + Status : Stable =cut @@ -999,6 +1012,7 @@ sub fetch_by_misc_feature_attribute { Returntype : [[start,end,$slice][]] Exceptions : none Caller : BaseFeatureAdaptor + Status : Stable =cut @@ -1163,6 +1177,7 @@ sub fetch_normalized_slice_projection { throw if slice argument is not passed throw if the slice end is not equal to seq_region_length Caller : database loading scripts + Status : Stable =cut @@ -1258,6 +1273,7 @@ sub store { Returntype : DBD::sth Exceptions : none Caller : internal, convenience method + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/SupportingFeatureAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/SupportingFeatureAdaptor.pm index c2b6b57f1a..661e45e34a 100644 --- a/modules/Bio/EnsEMBL/DBSQL/SupportingFeatureAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/SupportingFeatureAdaptor.pm @@ -48,6 +48,7 @@ use vars qw(@ISA); Exceptions : warning if $exon is not in the database (i.e. dbID not defined) throw if a retrieved supporting feature is of unknown type Caller : Bio::EnsEMBL::Exon + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/TranscriptAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/TranscriptAdaptor.pm index e984a9549e..29dc358d70 100644 --- a/modules/Bio/EnsEMBL/DBSQL/TranscriptAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/TranscriptAdaptor.pm @@ -74,7 +74,7 @@ use Bio::EnsEMBL::Utils::Exception qw( deprecate throw warning ); # Returntype : list of listrefs of strings # Exceptions : none # Caller : internal - +# Status : Stable sub _tables { my $self = shift; @@ -93,6 +93,7 @@ sub _tables { # Returntype : list of strings # Exceptions : none # Caller : internal +# Status : Stable sub _columns { my $self = shift; @@ -122,6 +123,7 @@ sub _left_join { Returntype : Bio::EnsEMBL::Transcript Exceptions : none Caller : general + Status : Stable =cut @@ -156,6 +158,7 @@ sub fetch_by_stable_id{ Returntype : Bio::EnsEMBL::Transcript Exceptions : none Caller : general + Status : Stable =cut @@ -191,6 +194,7 @@ sub fetch_by_translation_stable_id { Returntype : Bio::EnsEMBL::Transcript or undef Exceptions : none Caller : general + Status : Stable =cut @@ -226,6 +230,7 @@ sub fetch_by_translation_id { Returntype : listref Bio::EnsEMBL::Transcript Exceptions : none Caller : Gene->get_all_Transcripts() + Status : Stable =cut @@ -288,6 +293,7 @@ sub fetch_all_by_Gene { Returntype : reference to list of transcripts Exceptions : thrown if exon cannot be placed on transcript slice Caller : Slice::get_all_Transcripts + Status : Stable =cut @@ -406,6 +412,7 @@ sub fetch_all_by_Slice { Returntype : reference to a list of transcripts Exceptions : none Caller : general + Status : Stable =cut @@ -431,6 +438,7 @@ sub fetch_all_by_external_name { Returntype : Bio::EnsEMBL::Transcript Exceptions : none Caller : general + Status : Stable =cut @@ -452,6 +460,7 @@ sub fetch_by_display_label { Returntype : Bio::EnsEMBL::Transcript Exceptions : none Caller : general + Status : Stable =cut @@ -491,6 +500,7 @@ sub fetch_all_by_exon_stable_id { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -751,6 +761,7 @@ sub store { Returntype : listref of strings Exceptions : none Caller : domainview? , GeneView + Status : Stable =cut @@ -802,6 +813,7 @@ sub get_Interpro_by_transid { Exceptions : throw on incorrect arguments warning if transcript is not in this database Caller : GeneAdaptor::remove + Status : Stable =cut @@ -895,6 +907,7 @@ sub remove { warn if the method is called on a transcript that does not exist in the database. Caller : general + Status : Stable =cut @@ -938,6 +951,7 @@ sub update { Returntype : list of ints Exceptions : none Caller : ? + Status : Stable =cut @@ -956,6 +970,7 @@ sub list_dbIDs { Returntype : listref of ints Exceptions : none Caller : ? + Status : Stable =cut @@ -975,6 +990,7 @@ sub list_stable_ids { # Returntype : listref of Bio::EnsEMBL::Transcripts in target coord system # Exceptions : none # Caller : internal +# Status : Stable sub _objs_from_sth { my ($self, $sth, $mapper, $dest_slice) = @_; diff --git a/modules/Bio/EnsEMBL/DBSQL/TranscriptSupportingFeatureAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/TranscriptSupportingFeatureAdaptor.pm index 2f6cd1c4b8..337f41c2e0 100644 --- a/modules/Bio/EnsEMBL/DBSQL/TranscriptSupportingFeatureAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/TranscriptSupportingFeatureAdaptor.pm @@ -48,6 +48,7 @@ use vars qw(@ISA); Exceptions : warning if $transcript is not in the database (i.e. dbID not defined) throw if a retrieved supporting feature is of unknown type Caller : Bio::EnsEMBL::Transcript + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DBSQL/TranslationAdaptor.pm b/modules/Bio/EnsEMBL/DBSQL/TranslationAdaptor.pm index 84dec0d084..26435c945c 100644 --- a/modules/Bio/EnsEMBL/DBSQL/TranslationAdaptor.pm +++ b/modules/Bio/EnsEMBL/DBSQL/TranslationAdaptor.pm @@ -65,6 +65,7 @@ use Bio::EnsEMBL::Utils::Exception qw( throw warning deprecate ); Returntype : Bio::EnsEMBL::Translation Exceptions : throw on incorrect argument Caller : Transcript + Status : Stable =cut @@ -149,6 +150,9 @@ sub fetch_by_Transcript { Returntype : reference to a list of Translations Exceptions : none Caller : general + Status : Medium Risk + : At some time may be deprecated to instead use + : TranscriptAdaptor::fetch_all_by_external_name =cut @@ -187,6 +191,7 @@ sub fetch_all_by_external_name { thrown if only partial stable id information is present (e.g. identifier but not version number) Caller : Transcript::store + Status : Stable =cut @@ -291,6 +296,7 @@ sub store { Exceptions : throw on incorrect arguments warning if translation is not in this database Caller : TranscriptAdaptor::remove + Status : Stable =cut @@ -348,6 +354,7 @@ sub remove { Returntype : list of ints Exceptions : none Caller : ? + Status : Stable =cut @@ -367,6 +374,7 @@ sub list_dbIDs { Returntype : reference to a list of strings Exceptions : none Caller : general + Status : Stable =cut @@ -392,6 +400,7 @@ sub list_stable_ids { Exceptions : warning if an additional (old style) Transcript argument is provided Caller : ? + Status : Stable =cut @@ -416,12 +425,12 @@ sub fetch_by_dbID { } -=head2 fetch_by_dbID +=head2 fetch_by_stable_id - Arg [1] : int $dbID - The internal identifier of the Translation to obtain - Example : $translation = $translation_adaptor->fetch_by_dbID(1234); - Description: This fetches a Translation object via its internal id. This + Arg [1] : string $stable_id + The stable identifier of the Translation to obtain + Example : $translation = $translation_adaptor->fetch_by_stable_id("ENSP00001"); + Description: This fetches a Translation object via its stable id. This is only debatably useful since translations do not make much sense outside of the context of their Translation. Consider using fetch_by_Transcript instead. @@ -430,6 +439,7 @@ sub fetch_by_dbID { Exceptions : warning if an additional (old style) Transcript argument is provided Caller : ? + Status : Stable =cut @@ -461,6 +471,7 @@ sub fetch_by_stable_id { Returntype : Reference to list of Bio::EnsEMBL::Translations Exceptions : None Caller : general + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DensityFeature.pm b/modules/Bio/EnsEMBL/DensityFeature.pm index bb44014c55..962e89bbf4 100644 --- a/modules/Bio/EnsEMBL/DensityFeature.pm +++ b/modules/Bio/EnsEMBL/DensityFeature.pm @@ -75,6 +75,7 @@ use vars qw(@ISA); Returntype : Bio::EnsEMBL::DensityFeature Exceptions : throw if invalid density value type is provided Caller : general + Status : Stable =cut @@ -107,6 +108,19 @@ sub new { return $self; } + +=head2 new_fast + + Arg [...] : none + Example : $feature = Bio::EnsEMBL::DensityFeature->new_fast(); + Description: Creates a new density feature. + Returntype : Bio::EnsEMBL::DensityFeature + Exceptions : none + Caller : general + Status : Stable + +=cut + sub new_fast{ my $caller = shift; @@ -128,6 +142,7 @@ sub new_fast{ Returntype : int (always 0) Exceptions : warning if an attempt is made to set the strand Caller : general + Status : Stable =cut @@ -149,6 +164,7 @@ sub strand { Returntype : float Exceptions : throw if a negative density value is provided Caller : general + Status : Stable =cut @@ -176,6 +192,7 @@ sub density_value { Returntype : Bio::EnsEMBL::Analysis Exceptions : none Caller : general + Status : Stable =cut @@ -200,6 +217,7 @@ sub analysis { Returntype : Bio::EnsEMBL::DensityType Exceptions : if object passed is not of type DensityType Caller : general + Status : Stable =cut @@ -228,6 +246,7 @@ sub density_type{ Function: Returns : this objects scaled value Args : newvalue (optional) + Status : Stable =cut @@ -249,6 +268,7 @@ sub scaledvalue{ Function: Returns : this object's url Args : newvalue (optional) + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DensityFeatureSet.pm b/modules/Bio/EnsEMBL/DensityFeatureSet.pm index bf89efc5d1..cb8b07e449 100644 --- a/modules/Bio/EnsEMBL/DensityFeatureSet.pm +++ b/modules/Bio/EnsEMBL/DensityFeatureSet.pm @@ -52,6 +52,8 @@ use Data::Dumper; Returntype : Bio::EnsEMBL::DensityFeatureSet Exceptions : throw if invalid density value type is provided Caller : general + Status : Stable + =cut sub new { @@ -84,7 +86,7 @@ sub new { range (i.e. from min to max rather than absolute numbers). Returns : value of _stretch Args : newvalue (optional) - + Status : Stable =cut @@ -104,6 +106,7 @@ sub stretch{ scaled in proportion. Returns : scale_to_fit value Args : newvalue (optional) + Status : Stable =cut @@ -122,6 +125,7 @@ sub scale_to_fit{ Function: Returns : value of colour Args : newvalue (optional) + Status : Stable =cut @@ -141,6 +145,7 @@ sub colour{ Function: Returns : value of label Args : newvalue (optional) + Status : Stable =cut @@ -160,6 +165,7 @@ sub label{ Function: Returns : value of label2 Args : newvalue (optional) + Status : Stable =cut @@ -181,6 +187,7 @@ sub label2{ Returntype : reference to a list of DensityFeatures Exceptions : none Caller : general + Status : Stable =cut @@ -225,6 +232,7 @@ sub get_all_binvalues{ Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -240,6 +248,7 @@ sub max_value{ $_[0]->{'max_value'};} Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -256,6 +265,7 @@ sub min_value{ $_[0]->{'min_value'};} Returntype : int Exceptions : none Caller : general + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DensityType.pm b/modules/Bio/EnsEMBL/DensityType.pm index 68edb7d89c..e9ca13a4a0 100644 --- a/modules/Bio/EnsEMBL/DensityType.pm +++ b/modules/Bio/EnsEMBL/DensityType.pm @@ -7,7 +7,7 @@ =head1 NAME -Bio::EnsEMBL::DensityType - A type representing a density, or precentage +Bio::EnsEMBL::DensityType - A type representing a density, or percentage coverage etc. in a given region. =head1 SYNOPSIS @@ -16,11 +16,11 @@ use Bio::EnsEMBL::DensityType; $type = Bio::EnsEMBL::DensityType->new(-analysis => $analysis, -blocksize => 1000000, - -vlaue_type => $type); + -value_type => $type); =head1 DESCRIPTION -A density type represents a density, or precentage +A density type represents a density, or percentage coverage etc. in a given region. @@ -61,6 +61,7 @@ use vars qw(@ISA); valuetype must be 'sum' or 'ratio', valid analysis object must be passed Caller : general + Status : Stable =cut @@ -104,6 +105,7 @@ sub new { Returntype : Bio::EnsEMBL::Analysis Exceptions : none Caller : general + Status : Stable =cut @@ -128,6 +130,7 @@ sub analysis{ Returntype : float Exceptions : none Caller : general + Status : Stable =cut @@ -146,6 +149,7 @@ sub value_type{ Returntype : int Exceptions : none Caller : general + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DnaDnaAlignFeature.pm b/modules/Bio/EnsEMBL/DnaDnaAlignFeature.pm index 7948e4d8d8..a458ed4e0c 100644 --- a/modules/Bio/EnsEMBL/DnaDnaAlignFeature.pm +++ b/modules/Bio/EnsEMBL/DnaDnaAlignFeature.pm @@ -38,6 +38,7 @@ use Bio::LocatableSeq; Returntype : int Exceptions : none Caller : Bio::EnsEMBL::BaseAlignFeature + Status : Stable =cut @@ -56,6 +57,7 @@ sub _hit_unit { Returntype : int Exceptions : none Caller : Bio::EnsEMBL::BaseAlignFeature + Status : Stable =cut @@ -79,6 +81,7 @@ sub _query_unit { Returntype : Bio::EnsEMBL::DnaDnaAlignFeature object Exceptions : Caller : + Status : Stable =cut @@ -196,6 +199,7 @@ sub restrict_between_positions { the second corresponds to hseq Exceptions : Caller : + Status : Stable =cut @@ -272,6 +276,7 @@ sub alignment_strings { Returntype : a Bio::SimpleAlign object Exceptions : Caller : + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/DnaPepAlignFeature.pm b/modules/Bio/EnsEMBL/DnaPepAlignFeature.pm index 63a124ef0c..3952b5ae35 100644 --- a/modules/Bio/EnsEMBL/DnaPepAlignFeature.pm +++ b/modules/Bio/EnsEMBL/DnaPepAlignFeature.pm @@ -41,6 +41,7 @@ use strict; Returntype : Bio::EnsEMBL::DnaPepAlignFeature Exceptions : none Caller : Bio::EnsEMBL::DBSQL::ProteinAlignFeatureAdaptor + Status : Stable =cut @@ -60,6 +61,8 @@ sub new_fast { Returntype : int Exceptions : none Caller : Bio::EnsEMBL::BaseAlignFeature + Status : Stable + =cut @@ -77,6 +80,8 @@ sub _hit_unit { Returntype : int Exceptions : none Caller : Bio::EnsEMBL::BaseAlignFeature + Status : Stable + =cut diff --git a/modules/Bio/EnsEMBL/Exon.pm b/modules/Bio/EnsEMBL/Exon.pm index 112e97336d..4b1a88e4b1 100755 --- a/modules/Bio/EnsEMBL/Exon.pm +++ b/modules/Bio/EnsEMBL/Exon.pm @@ -65,12 +65,34 @@ use Bio::EnsEMBL::Utils::Argument qw( rearrange ); =head2 new - Args : see SUPERCLASS B<Bio::EnsEMBL::Feature> + Arg [-SLICE]: Bio::EnsEMBL::SLice - Represents the sequence that this + feature is on. The coordinates of the created feature are + relative to the start of the slice. + Arg [-START]: The start coordinate of this feature relative to the start + of the slice it is sitting on. Coordinates start at 1 and + are inclusive. + Arg [-END] : The end coordinate of this feature relative to the start of + the slice it is sitting on. Coordinates start at 1 and are + inclusive. + Arg [-STRAND]: The orientation of this feature. Valid values are 1,-1,0. + Arg [-SEQNAME] : A seqname to be used instead of the default name of the + of the slice. Useful for features that do not have an + attached slice such as protein features. + Arg [-dbID] : (optional) internal database id + Arg [-ADAPTOR]: (optional) Bio::EnsEMBL::DBSQL::BaseAdaptor + Arg [-PHASE] :(optional) the phase. + Arg [-END_PHASE]:(optional) the end phase + Arg [-STABLE_ID]:(optional) the stable id of the exon + Arg [-VERSION] :(optional) the version + Arg [-CREATED_DATE] :(optional) the created date + Arg [-MODIFIED_DATE]:(optional) the last midifeid date + Example : none Description: create an Exon object Returntype : Bio::EnsEMBL::Exon - Exceptions : none + Exceptions : if phase is not valid (i.e. 0,1, 2 -1) Caller : general + Status : Stable =cut @@ -85,7 +107,7 @@ sub new { rearrange( [ "PHASE", "END_PHASE", "STABLE_ID", "VERSION", "CREATED_DATE", "MODIFIED_DATE" ], @_ ); - $self->{'phase'} = $phase; + $self->phase($phase) if (defined $phase); # make sure phase is valid. $self->{'end_phase'} = $end_phase; $self->{'stable_id'} = $stable_id; $self->{'version'} = $version; @@ -106,8 +128,9 @@ sub new { Example : none Description: create an Exon object Returntype : Bio::EnsEMBL::Exon - Exceptions : none + Exceptions : throws if end < start Caller : general, creation in Bio::EnsEMBL::Lite::GeneAdaptor + Status : Stable =cut @@ -148,6 +171,7 @@ sub new_fast { Exceptions : warning if end_phase is called without an argument and the value is not set. Caller : general + Status : Stable =cut @@ -170,8 +194,15 @@ sub end_phase { =head2 phase - my $phase = $exon->phase; - $exon->phase(2); + Arg [1] : (optional) int $phase + Example : my $phase = $exon->phase; + $exon->phase(2); + Description: Gets/Sets the phase of the exon. + Returntype : int + Exceptions : throws if phase is not (0, 1 2 or -1). + Caller : general + Status : Stable + Get or set the phase of the Exon, which tells the translation machinery, which makes a peptide from @@ -229,6 +260,7 @@ sub phase { Exceptions : thrown if an arg is passed thrown if frame cannot be calculated due to a bad phase value Caller : general + Status : Stable =cut @@ -273,6 +305,7 @@ sub frame { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -294,6 +327,7 @@ sub start { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -315,6 +349,7 @@ sub end { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -336,6 +371,7 @@ sub strand { Returntype : Bio::EnsEMBL::Slice Exceptions : none Caller : general + Status : Stable =cut @@ -363,6 +399,7 @@ sub slice { Returntype : none Exceptions : Thrown is invalid arguments are provided Caller : general + Status : Stable =cut @@ -384,6 +421,7 @@ sub move { Returntype : Bio::EnsEMBL::Exon Exceptions : wrong parameters Caller : general + Status : Stable =cut @@ -426,6 +464,7 @@ sub transform { Returntype : Bio::EnsEMBL::Gene Exceptions : none Caller : general + Status : Stable =cut @@ -454,7 +493,7 @@ sub transfer { =head2 add_supporting_features - Arg [1] : Bio::EnsEMBL::SeqFeatureI $feature + Arg [1] : Bio::EnsEMBL::Feature $feature Example : $exon->add_supporting_features(@features); Description: Adds a list of supporting features to this exon. Duplicate features are not added. @@ -463,10 +502,11 @@ sub transfer { get_all_supporting_features call will not retrieve supporting features from the database. Returntype : none - Exceptions : throw if any of the features are not SeqFeatureIs + Exceptions : throw if any of the features are not Feature throw if any of the features are not in the same coordinate system as the exon Caller : general + Status : Stable =cut @@ -516,6 +556,7 @@ sub add_supporting_features { Returntype : listreference of Bio::EnsEMBL::BaseAlignFeature objects Exceptions : none Caller : general + Status : Stable =cut @@ -535,7 +576,10 @@ sub get_all_supporting_features { =head2 find_supporting_evidence - Arg [1] : Bio::EnsEMBL::SeqFeatureI $features +# This method is only for genebuild backwards compatibility. +# Avoid using it if possible + + Arg [1] : Bio::EnsEMBL::Feature $features The list of features to search for supporting (i.e. overlapping) evidence. Arg [2] : (optional) boolean $sorted @@ -549,6 +593,7 @@ sub get_all_supporting_features { Returntype : none Exceptions : none Caller : general + Status : Medium Risk =cut @@ -583,6 +628,7 @@ sub find_supporting_evidence { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -593,12 +639,35 @@ sub stable_id { } +=head2 created_date + + Arg [1] : string $created_date + Example : none + Description: get/set for attribute created_date + Returntype : string + Exceptions : none + Caller : general + Status : Stable + +=cut + sub created_date { my $self = shift; $self->{'created_date'} = shift if ( @_ ); return $self->{'created_date'}; } +=head2 modified_date + + Arg [1] : string $modified_date + Example : none + Description: get/set for attribute modified_date + Returntype : string + Exceptions : none + Caller : general + Status : Stable + +=cut sub modified_date { my $self = shift; @@ -616,6 +685,7 @@ sub modified_date { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -635,6 +705,7 @@ sub version { Returntype : Bio::EnsEMBL::Exon Exceptions : none Caller : Transcript->get_all_translateable_Exons() + Status : Stable =cut @@ -677,6 +748,7 @@ sub adjust_start_end { Returntype : Bio::Seq Exceptions : thrown if transcript argument is not provided Caller : general + Status : Stable =cut @@ -738,6 +810,7 @@ sub peptide { warning if exon does not have attatched slice warning if exon strand is not defined (or 0) Caller : general + Status : Stable =cut @@ -789,6 +862,7 @@ sub seq { a unique hash value are set set Caller : general + Status : Stable =cut @@ -841,6 +915,7 @@ sub hashkey { Returntype : string Exceptions : none Caller : web drawing code + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/Feature.pm b/modules/Bio/EnsEMBL/Feature.pm index a797a34b5e..df971dab04 100644 --- a/modules/Bio/EnsEMBL/Feature.pm +++ b/modules/Bio/EnsEMBL/Feature.pm @@ -78,6 +78,8 @@ use vars qw(@ISA); Arg [-SEQNAME] : A seqname to be used instead of the default name of the of the slice. Useful for features that do not have an attached slice such as protein features. + Arg [-dbID] : (optional) internal database id + Arg [-ADAPTOR]: (optional) Bio::EnsEMBL::DBSQL::BaseAdaptor Example : $feature = Bio::EnsEMBL::Feature->new(-start => 1, -end => 100, -strand => 1, @@ -86,8 +88,9 @@ use vars qw(@ISA); Description: Constructs a new Bio::EnsEMBL::Feature. Generally subclasses of this method are instantiated, rather than this class itself. Returntype : Bio::EnsEMBL::Feature - Exceptions : Thrown on invalid -SLICE, -ANALYSIS, -STRAND arguments + Exceptions : Thrown on invalid -SLICE, -ANALYSIS, -STRAND ,-ADAPTOR arguments Caller : general, subclass constructors + Status : Stable =cut @@ -152,6 +155,7 @@ sub new { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -176,6 +180,7 @@ sub start { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -199,6 +204,7 @@ sub end { Returntype : int Exceptions : thrown if an invalid strand argument is passed Caller : general + Status : Stable =cut @@ -232,6 +238,7 @@ sub strand { Returntype : none Exceptions : Thrown is invalid arguments are provided Caller : general + Status : Stable =cut @@ -266,6 +273,7 @@ sub move { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -287,6 +295,7 @@ sub length { Returntype : Bio::EnsEMBL::Analysis Exceptions : thrown if an invalid argument is passed Caller : general + Status : Stable =cut @@ -318,6 +327,7 @@ sub analysis { Returntype : Bio::EnsEMBL::Slice Exceptions : thrown if an invalid argument is passed Caller : general + Status : Stable =cut @@ -363,6 +373,7 @@ sub slice { Exceptions : thrown if an invalid coordinate system is provided warning if Feature is not attached to a slice Caller : general, transfer() + Status : Stable =cut @@ -466,6 +477,7 @@ sub transform { Exceptions : throw on incorrect argument throw if feature does not have attached slice Caller : general, transform() + Status : Stable =cut @@ -563,7 +575,7 @@ sub transfer { } Description: Returns the results of 'projecting' this feature onto another coordinate system. This is useful to see where a feature - where a feature would lie in a coordinate system in which it + would lie in a coordinate system in which it crosses a boundary. This method returns a reference to a list of @@ -584,8 +596,9 @@ sub transfer { Returntype : list reference of Bio::EnsEMBL::ProjectionSegments which can also be used as [$start,$end,$slice] triplets - Exceptions : none + Exceptions : slice does not have an adaptor Caller : general + Status : Stable =cut @@ -633,6 +646,7 @@ sub project { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -665,6 +679,7 @@ sub seqname { Returntype : string Exceptions : none Caller : web drawing code + Status : Stable =cut @@ -685,6 +700,7 @@ sub display_id { Slice. Exceptions : warning if Feature does not have attached slice. Caller : web drawing code + Status : Stable =cut @@ -720,6 +736,7 @@ sub feature_Slice { Returntype : string or undef Exceptions : none Caller : general + Status : Stable =cut @@ -740,6 +757,7 @@ sub seq_region_name { Returntype : unsigned int or undef Exceptions : none Caller : general + Status : Stable =cut @@ -762,6 +780,7 @@ sub seq_region_length { Returntype : 1,0,-1 or undef Exceptions : none Caller : general + Status : Stable =cut @@ -786,6 +805,7 @@ sub seq_region_strand { Returntype : int or undef Exceptions : none Caller : general + Status : Stable =cut @@ -817,6 +837,7 @@ sub seq_region_start { Returntype : int or undef Exceptions : none Caller : general + Status : Stable =cut @@ -842,10 +863,10 @@ sub seq_region_end { Example : print $feature->coord_system_name() Description: Gets the name of the coord_system which this feature is on. Returns undef if this Feature is not on a slice. - Function : - Returntype: - Exceptions: - Caller : + Returntype : string or undef + Exceptions : none + Caller : general + Status : Stable =cut @@ -867,6 +888,7 @@ sub coord_system_name { Returntype : undef or string Exceptions : warning if this feature is not stranded Caller : general + Status : Stable =cut @@ -917,6 +939,7 @@ sub seq { Returntype : reference to list of features of the same type of this feature. Exceptions : none Caller : general + Status : Stable =cut @@ -1144,7 +1167,7 @@ sub id { favour and use a simple one line comparison instead: $overlaps = ($f1->end() >= $f2->start() && $f1->start() <= $f2->end()); - + Status : At Risk =cut sub overlaps { diff --git a/modules/Bio/EnsEMBL/FeaturePair.pm b/modules/Bio/EnsEMBL/FeaturePair.pm index 25806ddc6f..36bb07afbc 100755 --- a/modules/Bio/EnsEMBL/FeaturePair.pm +++ b/modules/Bio/EnsEMBL/FeaturePair.pm @@ -102,11 +102,12 @@ use Bio::EnsEMBL::Utils::Exception qw(throw deprecate warning); -percent_id => 92.0, -hseqname => 'ALUSX10.1', -analysis => $analysis); -Description: Creates a new Bio::EnsEMBL::FeaturePair object + Description: Creates a new Bio::EnsEMBL::FeaturePair object Returntype : Bio::EnsEMBL::FeaturePair Exceptions : throw if start > end throw if invalid strand is provided Caller : general + Status : Stable =cut @@ -188,6 +189,7 @@ sub new { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -207,6 +209,7 @@ sub hseqname { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -225,6 +228,7 @@ sub hstart{ Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -244,6 +248,7 @@ sub hend{ Returntype : 0,1,-1 Exceptions : thrown Caller : general + Status : Stable =cut @@ -273,6 +278,7 @@ sub hstrand{ Returntype : Bio::EnsEMBL::Slice Exceptions : thrown if an invalid argument is passed Caller : general + Status : Stable =cut @@ -300,6 +306,7 @@ sub hslice { Returntype : string or undef Exceptions : none Caller : general + Status : Stable =cut @@ -321,6 +328,7 @@ sub hseq_region_name { Returntype : 1,0,-1 or undef Exceptions : none Caller : general + Status : Stable =cut @@ -344,6 +352,7 @@ sub hseq_region_strand { Returntype : int or undef Exceptions : none Caller : general + Status : Stable =cut @@ -375,6 +384,7 @@ sub hseq_region_start { Returntype : int or undef Exceptions : none Caller : general + Status : Stable =cut @@ -401,6 +411,7 @@ sub hseq_region_end { Returntype : float Exceptions : none Caller : general + Status : Stable =cut @@ -420,6 +431,7 @@ sub score{ Returntype : float Exceptions : none Caller : general + Status : Stable =cut @@ -440,6 +452,7 @@ sub percent_id { Returntype : string Execeptions: none Caller : general + Status : Stable =cut @@ -459,6 +472,7 @@ sub species{ Returntype : string Execeptions: none Caller : general + Status : Stable =cut @@ -477,6 +491,7 @@ sub hspecies{ Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -495,6 +510,7 @@ sub coverage { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -513,6 +529,7 @@ sub hcoverage { Returntype : float Exceptions : none Caller : general + Status : Stable =cut @@ -534,6 +551,7 @@ sub p_value{ Returntype : string Exceptions : none Caller : web drawing code + Status : Stable =cut @@ -551,6 +569,7 @@ sub display_id { Returntype : int Execeptions: none Caller : general + Status : Stable =cut @@ -571,6 +590,7 @@ sub identical_matches{ Returntype : int Execeptions: none Caller : general + Status : Stable =cut @@ -591,6 +611,7 @@ sub positive_matches{ Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -611,6 +632,7 @@ sub group_id { Returntype : int Exceptions : none Caller : general + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/Gene.pm b/modules/Bio/EnsEMBL/Gene.pm index 05d0590105..0d15e5bc19 100755 --- a/modules/Bio/EnsEMBL/Gene.pm +++ b/modules/Bio/EnsEMBL/Gene.pm @@ -40,15 +40,43 @@ use Bio::EnsEMBL::Utils::Exception qw(throw warning deprecate); =head2 new - Arg [start] : int $start - Arg [end] : int $end - Arg [strand] : 1,-1 $strand - Arg [slice] : Bio::EnsEMBL::Slice $slice + Arg [-START] : + int - start postion of the gene + Arg [-END] : + int - end position of the gene + Arg [-STRAND] : + int - 1,-1 tehe strand the gene is on + Arg [-SLICE] : + Bio::EnsEMBL::Slice - the slice the gene is on + Arg [-STABLE_ID] : + string - the stable identifier of this gene + Arg [-VERSION] : + int - the version of the stable identifier of this gene + Arg [-EXTERNAL_NAME] : + string - the external database name associated with this gene + Arg [-EXTERNAL_DB] : + string - the name of the database the external name is from + Arg [-EXTERNAL_STATUS]: + string - the status of the external identifier + Arg [-DISPLAY_XREF]: + Bio::EnsEMBL::DBEntry - The external database entry that is used + to label this gene when it is displayed. + Arg [-CREATED_DATE]: + string - the date the gene was created + Arg [-MODIFIED_DATE]: + string - the date the gene was last modified + Arg [-DESCRIPTION]: + string - the genes description + Arg [-BIOTYPE]: + string - the biotype e.g. "protein_coding" + Arg [-CONFIDENCE]: + string - the gene confidence i.e. "KNOWN","NOVEL" Example : $gene = Bio::EnsEMBL::Gene->new(); Description: Creates a new gene object Returntype : Bio::EnsEMBL::Gene Exceptions : none Caller : general + Status : Stable =cut @@ -98,6 +126,7 @@ sub new { Returntype : 0,1 Exceptions : none Caller : general + Status : Stable =cut @@ -116,6 +145,7 @@ sub is_known{ Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -146,6 +176,7 @@ sub external_name { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -165,6 +196,7 @@ sub confidence { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -185,6 +217,7 @@ sub source { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -215,6 +248,7 @@ sub external_db { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -243,6 +277,7 @@ sub external_status { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -265,6 +300,7 @@ sub description { Returntype : none Exceptions : thrown on incorrect argument type Caller : general + Status : Stable =cut @@ -295,6 +331,7 @@ sub add_DBEntry { Returntype : list reference to Bio::EnsEMBL::DBEntry objects Exceptions : none Caller : get_all_DBLinks, GeneAdaptor::store + Status : Stable =cut @@ -327,6 +364,7 @@ sub get_all_DBEntries { Returntype : list reference to Bio::EnsEMBL::DBEntry objects Exceptions : none Caller : general + Status : Stable =cut @@ -355,6 +393,7 @@ sub get_all_DBLinks { Returntype : listref Bio::EnsEMBL::Exon Exceptions : none Caller : general + Status : Stable =cut @@ -390,6 +429,7 @@ sub get_all_Exons { ] Exceptions : none Caller : general + Status : Stable =cut @@ -456,6 +496,7 @@ sub get_all_homologous_Genes{ Returntype : string Exceptions : none Caller : general + Status : At Risk =cut @@ -507,6 +548,7 @@ sub type { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -529,6 +571,7 @@ sub biotype { Returntype : none Exceptions : none Caller : general + Status : Stable =cut @@ -556,6 +599,7 @@ sub add_Transcript { Returntype : listref Bio::EnsEMBL::Transcript Exceptions : none Caller : general + Status : Stable =cut @@ -585,6 +629,7 @@ sub get_all_Transcripts { Returntype : listref of Bio::EnsEMBL::Gene Exceptions : none Caller : general + Status : Stable =cut @@ -605,6 +650,7 @@ sub get_all_alt_alleles { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -623,6 +669,7 @@ sub version{ Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -633,12 +680,36 @@ sub stable_id{ } +=head2 created_date + + Arg [1] : (optional) string to be used for the created date + Example : none + Description: get/set for attribute created date + Returntype : string + Exceptions : none + Caller : general + Status : Stable + +=cut + sub created_date { my $self = shift; $self->{'created_date'} = shift if ( @_ ); return $self->{'created_date'}; } +=head2 modified_date + + Arg [1] : (optional) string to be used for the modified date + Example : none + Description: get/set for attribute modified date + Returntype : string + Exceptions : none + Caller : general + Status : Stable + +=cut + sub modified_date { my $self = shift; @@ -656,6 +727,7 @@ sub modified_date { Returntype : Bio::EnsEMBL::Gene Exceptions : wrong parameters Caller : general + Status : Stable =cut @@ -695,6 +767,7 @@ sub transform { Returntype : Bio::EnsEMBL::Gene Exceptions : none Caller : general + Status : Stable =cut @@ -724,6 +797,7 @@ sub transfer { Returntype : Bio::EnsEMBL::DBEntry Exceptions : none Caller : general + Status : Stable =cut @@ -743,6 +817,7 @@ sub display_xref { Returntype : none Exceptions : none Caller : internal + Status : Stable =cut @@ -800,6 +875,7 @@ sub recalculate_coordinates { Returntype : string Exceptions : none Caller : web drawing code + Status : Stable =cut @@ -820,6 +896,7 @@ sub display_id { Exceptions: Caller : Example : $dasref = $prot->get_all_DASFactories + Status : Stable =cut @@ -841,6 +918,7 @@ sub get_all_DASFactories { Returntype : hashref of Bio::SeqFeatures Exceptions : ? Caller : webcode + Status : Stable =cut @@ -906,7 +984,7 @@ sub get_all_DASFeatures_by_slice{ Returntype : hashref of Bio::SeqFeatures Exceptions : ? Caller : webcode - + Status : Stable =cut @@ -949,6 +1027,8 @@ sub get_all_DAS_Features{ Returntype : Listref of Bio::EnsEMBL::RegulatoryFeature Exceptions : If arg is not of correct type. Caller : ? + Status : At Risk + : regulatory features are under development =cut diff --git a/modules/Bio/EnsEMBL/GoXref.pm b/modules/Bio/EnsEMBL/GoXref.pm index 404a057000..c5eb19e684 100644 --- a/modules/Bio/EnsEMBL/GoXref.pm +++ b/modules/Bio/EnsEMBL/GoXref.pm @@ -75,6 +75,7 @@ use strict; Returntype : string Exceptions : thrown if $linkage_type argument not supplied Caller : DBEntryAdaptor + Status : Stable =cut @@ -97,6 +98,7 @@ sub add_linkage_type { Returntype : none Exceptions : none Caller : geneview? general + Status : Stable =cut @@ -115,6 +117,7 @@ sub get_all_linkage_types { Returntype : none Exceptions : none Caller : general + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/IdentityXref.pm b/modules/Bio/EnsEMBL/IdentityXref.pm index 01b908235e..98cfd3f078 100644 --- a/modules/Bio/EnsEMBL/IdentityXref.pm +++ b/modules/Bio/EnsEMBL/IdentityXref.pm @@ -42,19 +42,22 @@ Post questions to the ensembl development list: <ensembl-dev@ebi.ac.uk> package Bio::EnsEMBL::IdentityXref; use vars qw(@ISA $AUTOLOAD); use strict; - +use Bio::EnsEMBL::Utils::Argument qw( rearrange ); @ISA = qw( Bio::EnsEMBL::DBEntry ); =head2 new - Arg [1] : - Example : - Description: - Returntype : - Exceptions : - Caller : + Arg [...] : QUERY_IDENTITY TARGET_IDENTITY SCORE EVALUE CIGAR_LINE + : QUERY_START QUERY_END TRANSLATION_START TRANSLATION_END + : ANALYSIS pairs + Example : see synopsis + Description: Create a new Bio::EnsEMBL::IdentityXref object + Returntype : Bio::EnsEMBL::IdentityXref + Exceptions : none + Caller : general + Status : Stable =cut @@ -63,7 +66,7 @@ sub new { my $self = $class->SUPER::new(@args); my ($query_identity, $target_identity, $score, $evalue, $cigar_line, $query_start, $query_end, $translation_start, - $translation_end, $analysis ) = $self->_rearrange( + $translation_end, $analysis ) = rearrange( [qw(QUERY_IDENTITY TARGET_IDENTITY SCORE EVALUE CIGAR_LINE QUERY_START QUERY_END TRANSLATION_START TRANSLATION_END ANALYSIS)], @args); @@ -90,6 +93,7 @@ sub new { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -112,6 +116,7 @@ sub query_identity{ Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -135,6 +140,7 @@ sub target_identity{ Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -153,6 +159,7 @@ sub cigar_line { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -171,6 +178,7 @@ sub translation_start { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -189,6 +197,7 @@ sub translation_end { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -207,6 +216,7 @@ sub query_start { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -225,6 +235,7 @@ sub query_end { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -243,6 +254,7 @@ sub score { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -261,6 +273,7 @@ sub evalue { Returntype : Bio::EnsEMBL::Analysis Exceptions : none Caller : general + Status : Stable =cut @@ -283,6 +296,7 @@ sub analysis { Returntype : Bio::EnsEMBL::Mapper Exceptions : none Caller : general, ProteinDAS subsystem + Status : Stable =cut @@ -353,6 +367,7 @@ sub get_mapper { Returntype : listref of whatever was put in Exceptions : none Caller : general, ProteinDAS subsystem + Status : Stable =cut @@ -395,6 +410,7 @@ sub transform_feature { Returntype : list of Coordinates/Gaps which represents the mapping Exceptions : none Caller : another way of doing ProteinDAS + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/Intron.pm b/modules/Bio/EnsEMBL/Intron.pm index 71424598ee..af2fb46a46 100644 --- a/modules/Bio/EnsEMBL/Intron.pm +++ b/modules/Bio/EnsEMBL/Intron.pm @@ -37,10 +37,11 @@ use Bio::EnsEMBL::Utils::Argument qw( rearrange ); Args : exon1, exon2. The two exons to build the Intron from. Example : $intron = new Bio::EnsEMBL::Intron($exon1, $exon2) - Description: create an Intron object + Description: create an Intron object from two exons. Returntype : Bio::EnsEMBL::Intron Exceptions : exons not on the same strand or slice. Caller : general + Status : Stable =cut @@ -89,6 +90,7 @@ sub new { Returntype : Bio::EnsEMBL::Exon Exceptions : none Caller : general + Status : Stable =cut @@ -107,6 +109,7 @@ sub prev_Exon { Returntype : Bio::EnsEMBL::Exon Exceptions : none Caller : general + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/KaryotypeBand.pm b/modules/Bio/EnsEMBL/KaryotypeBand.pm index 3811182a95..be88d7ad4a 100644 --- a/modules/Bio/EnsEMBL/KaryotypeBand.pm +++ b/modules/Bio/EnsEMBL/KaryotypeBand.pm @@ -85,6 +85,7 @@ use Bio::EnsEMBL::Utils::Exception qw(deprecate warning); Returntype : Bio::EnsEMBL::KarytotypeBand Exceptions : none Caller : Bio::EnsEMBL::KaryotypeBandAdaptor + Status : Stable =cut @@ -110,6 +111,7 @@ sub new { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -129,6 +131,7 @@ sub name{ Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -149,6 +152,7 @@ sub stain{ Returntype : int (always 0) Exceptions : none Caller : general + Status : Stable =cut @@ -169,6 +173,7 @@ sub strand { Returntype : none Exceptions : none Caller : general + Status : Stable =cut @@ -190,6 +195,7 @@ sub move { Returntype : string Exceptions : none Caller : web drawing code + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/Mapper.pm b/modules/Bio/EnsEMBL/Mapper.pm index 87aad593cd..77f7ed7b74 100644 --- a/modules/Bio/EnsEMBL/Mapper.pm +++ b/modules/Bio/EnsEMBL/Mapper.pm @@ -71,6 +71,7 @@ use Bio::EnsEMBL::Utils::Exception qw(throw); Returntype : Bio::EnsEMBL::Mapper Exceptions : none Caller : general + Status : Stable =cut @@ -112,6 +113,7 @@ sub new { Returntype : none Exceptions : none Caller : AssemblyMapper, ChainedAssemblyMapper + Status : Stable =cut @@ -144,8 +146,10 @@ sub flush { Function generic map method Returntype array of Bio::EnsEMBL::Mapper::Coordinate and/or Bio::EnsEMBL::Mapper::Gap - Exceptions none + Exceptions throw if start,end,strand,id or type are missing + or type not one of the coord systems Caller Bio::EnsEMBL::Mapper + Status : Stable =cut @@ -320,6 +324,7 @@ sub map_coordinates{ Returntype : list of Bio::EnsEMBL::Mapper::Coordinate and/or Gap objects Exceptions : none Caller : map_coordinates() + Status : Stable =cut @@ -402,8 +407,9 @@ sub map_insert { Function inferior map method. Will only do ungapped unsplit mapping. Will return id, start, end strand in a list. Returntype list of results - Exceptions none + Exceptions throws if type is neither to or from coordinate systems Caller Bio::EnsEMBL::AssemblyMapper + Status : Stable =cut @@ -482,8 +488,9 @@ sub fastmap { 'source' and 'target'. Returns 1 if the pair was added, 0 if it was already in. Returntype int 0,1 - Exceptions none + Exceptions throws if one or more of the 7 arguments are missing Caller Bio::EnsEMBL::Mapper + Status : Stable =cut @@ -534,6 +541,7 @@ sub add_map_coordinates{ Exceptions throw if 'to' and 'from' from both Bio::EnsEMBL::Mappers are incompatible Caller $mapper->methodname() + Status : Stable =cut @@ -584,8 +592,10 @@ sub add_Mapper{ coordinates to be transformed *from* Function list all pairs of mappings in a region Returntype list of Bio::EnsEMBL::Mapper::Pair - Exceptions none + Exceptions throws if one or more of the 4 arguments are missing + throws if start > end Caller Bio::EnsEMBL::Mapper + Status : Stable =cut @@ -656,6 +666,7 @@ sub list_pairs{ Returntype Bio::EnsEMBL::Mapper::Unit Exceptions none Caller Bio::EnsEMBL::Mapper + Status : Stable =cut @@ -678,15 +689,17 @@ sub from{ } -# _dump -# -# Arg 1 *FileHandle $fh -# Function convenience dump function -# possibly useful for debugging -# Returntype none -# Exceptions none -# Caller internal -# +=head2 _dump + + Arg 1 : *FileHandle $fh + Description : convenience dump function + : possibly useful for debugging + Returntype : none + Exceptions : none + Caller : internal + Status : Medium Risk + +=cut sub _dump{ my ($self,$fh) = @_; @@ -705,15 +718,16 @@ sub _dump{ } -# _sort -# -# Function sort function so that all -# mappings are sorted by -# chromosome start -# Returntype none -# Exceptions none -# Caller internal -# +=head2 _sort + + Description: sort function so that all mappings are sorted by + chromosome start + Returntype : none + Exceptions : none + Caller : internal + Status : Stable + +=cut sub _sort{ my ($self) = @_; @@ -804,15 +818,17 @@ sub _merge_pairs { } -# _is_sorted -# -# Arg 1 int $sorted -# Function toggle for whether the (internal) -# map data are sorted -# Returntype int -# Exceptions none -# Caller internal -# +=head2 _is_sorted + + Arg 1 : (optional) int $sorted + Description: getter.setter for togglewhether the (internal) + : map data are sorted + Returntype : int + Exceptions : none + Caller : internal + Status : Stable + +=cut sub _is_sorted { my ($self, $value) = @_; diff --git a/modules/Bio/EnsEMBL/MiscFeature.pm b/modules/Bio/EnsEMBL/MiscFeature.pm index ec41942076..e6e79e1713 100644 --- a/modules/Bio/EnsEMBL/MiscFeature.pm +++ b/modules/Bio/EnsEMBL/MiscFeature.pm @@ -100,6 +100,36 @@ use vars qw(@ISA); @ISA = qw(Bio::EnsEMBL::Feature); +=head2 new + + Arg [-SLICE]: Bio::EnsEMBL::SLice - Represents the sequence that this + feature is on. The coordinates of the created feature are + relative to the start of the slice. + Arg [-START]: The start coordinate of this feature relative to the start + of the slice it is sitting on. Coordinates start at 1 and + are inclusive. + Arg [-END] : The end coordinate of this feature relative to the start of + the slice it is sitting on. Coordinates start at 1 and are + inclusive. + Arg [-STRAND]: The orientation of this feature. Valid values are 1,-1,0. + Arg [-SEQNAME] : A seqname to be used instead of the default name of the + of the slice. Useful for features that do not have an + attached slice such as protein features. + Arg [-dbID] : (optional) internal database id + Arg [-ADAPTOR]: (optional) Bio::EnsEMBL::DBSQL::BaseAdaptor + Example : $feature = Bio::EnsEMBL::MiscFeature->new(-start => 1, + -end => 100, + -strand => 1, + -slice => $slice, + -analysis => $analysis); + Description: Constructs a new Bio::EnsEMBL::Feature. Generally subclasses + of this method are instantiated, rather than this class itself. + Returntype : Bio::EnsEMBL::MiscFeature + Exceptions : Thrown on invalid -SLICE, -ANALYSIS, -STRAND ,-ADAPTOR arguments + Caller : general, subclass constructors + Status : Stable + +=cut sub new { @@ -113,6 +143,18 @@ sub new { } +=head2 new_fast + + Arg [...] : hashref to bless as new MiscFeature + Example : $miscfeature = Bio::EnsEMBL::MiscFeature->new_fast(); + Description: Creates a new Miscfeature. + Returntype : Bio::EnsEMBL::MiscFeature + Exceptions : none + Caller : general + Status : Stable + +=cut + sub new_fast { my $class = shift; @@ -133,6 +175,7 @@ sub new_fast { Returntype : none Exceptions : throw on wrong argument type Caller : general + Status : Stable =cut @@ -159,6 +202,7 @@ sub add_Attribute { Exceptions : throw if the set arg is not provided, throw if the set to be added does not have a code Caller : general + Status : Stable =cut @@ -188,6 +232,7 @@ sub add_MiscSet { Returntype : listref of Bio::EnsEMBL::MiscSet Exceptions : throw if the code arg is not provided Caller : general + Status : Stable =cut @@ -216,6 +261,7 @@ sub get_all_MiscSets { Returntype : listref of Bio::EnsEMBL::Attribute Exceptions : Caller : general + Status : Stable =cut @@ -234,12 +280,44 @@ sub get_all_Attributes { } } +=head2 get_all_attribute_values + + Arg [1] : string $code + The code of the Attribute object values to retrieve + Example : @attributes_vals = @{$misc_feature->get_all_attribute_values('name')}; + Description: Retrieves a list of Attribute object values for given code or all + of the associated Attributes. + Returntype : listref of values + Exceptions : + Caller : general + Status : Stable + +=cut + sub get_all_attribute_values { my $self = shift; my $code = shift; - my @results = map { uc( $_->code() ) eq uc( $code ) ? $_->value : () } @{$self->{'attributes'}}; + my @results = map { uc( $_->code() ) eq uc( $code ) ? $_->value : () } + @{$self->{'attributes'}}; return \@results; } + +=head2 get_scalar_attribute + + Arg [1] : string $code + The code of the Attribute object values to retrieve + Example : $vals = $misc_feature->get_scalar_attribute('name'); + Description: Retrieves a value for given code or all + of the associated Attributes. + Returntype : scalar value + Exceptions : + Caller : general + Status : Stable + + +=cut + + sub get_scalar_attribute { my $self = shift; my $code = shift; @@ -257,6 +335,7 @@ sub get_scalar_attribute { Returntype : string Exceptions : none Caller : web drawing code + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/MiscSet.pm b/modules/Bio/EnsEMBL/MiscSet.pm index b92315033f..c1b04f88dd 100644 --- a/modules/Bio/EnsEMBL/MiscSet.pm +++ b/modules/Bio/EnsEMBL/MiscSet.pm @@ -77,6 +77,7 @@ use vars qw(@ISA); Returntype : Bio::EnsEMBL::MiscSet Exceptions : none Caller : MiscFeatureAdaptor + Status : Stable =cut @@ -107,6 +108,7 @@ sub new { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -126,6 +128,7 @@ sub code{ Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -145,6 +148,7 @@ sub name { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -164,6 +168,7 @@ sub description{ Returntype : int Exceptions : none Caller : general + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/PepDnaAlignFeature.pm b/modules/Bio/EnsEMBL/PepDnaAlignFeature.pm index d2787d441d..3a2dbd4d01 100644 --- a/modules/Bio/EnsEMBL/PepDnaAlignFeature.pm +++ b/modules/Bio/EnsEMBL/PepDnaAlignFeature.pm @@ -24,6 +24,16 @@ use strict; @ISA = qw( Bio::EnsEMBL::BaseAlignFeature ); +=head2 transform + + Arg [1] : none + Example : none + Description: Overwrites Bio:EnsEMBL:Feature->transform as + to give error message + Status : Stable + +=cut + sub transform { my $self = shift; @@ -31,10 +41,38 @@ sub transform { " they are not on EnsEMBL coord system" ); } +=head2 _hit_unit + + Arg [1] : none + Example : none + Description: PRIVATE implementation of abstract superclass method. Returns + 3 as the 'unit' used for the hit sequence. + Returntype : int + Exceptions : none + Caller : Bio::EnsEMBL::BaseAlignFeature + Status : Stable + + +=cut + sub _hit_unit { return 3; } +=head2 _query_unit + + Arg [1] : none + Example : none + Description: PRIVATE implementation of abstract superclass method. Returns + 1 as the 'unit' used for the query sequence. + Returntype : int + Exceptions : none + Caller : Bio::EnsEMBL::BaseAlignFeature + Status : Stable + + +=cut + sub _query_unit { return 1; } diff --git a/modules/Bio/EnsEMBL/PredictionExon.pm b/modules/Bio/EnsEMBL/PredictionExon.pm index ae103db062..cfdd0083b0 100644 --- a/modules/Bio/EnsEMBL/PredictionExon.pm +++ b/modules/Bio/EnsEMBL/PredictionExon.pm @@ -15,7 +15,7 @@ ab initio prediction method =head1 SYNOPSIS - $ex = new Bio::EnsEMBL::Exon(-START => 100, + $exon = new Bio::EnsEMBL::PredictionExon(-START => 100, -END => 200, -STRAND => 1, -SLICE => $slice, @@ -69,9 +69,10 @@ use Bio::EnsEMBL::Utils::Argument qw( rearrange ); Args : see SUPERCLASS Bio::EnsEMBL::Exon Example : none Description: create an Exon object - Returntype : Bio::EnsEMBL::Exon + Returntype : Bio::EnsEMBL::PredictionExon Exceptions : none Caller : general + Status : Stable =cut @@ -101,6 +102,7 @@ sub new { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -121,6 +123,7 @@ sub score{ Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -145,6 +148,7 @@ sub p_value{ Exceptions : warning if end_phase is called without an argument and the value is not set. Caller : general + Status : Stable =cut @@ -168,6 +172,7 @@ sub end_phase { Returntype : Bio::EnsEMBL::Exon Exceptions : wrong parameters Caller : general + Status : Stable =cut @@ -201,6 +206,7 @@ sub transform { Returntype : Bio::EnsEMBL::Gene Exceptions : none Caller : general + Status : Stable =cut @@ -222,6 +228,7 @@ sub transfer { Description: For compatibility with Bio::EnsEMBL::Exon Does nothing. Returntype : none + Status : Stable =cut @@ -233,6 +240,7 @@ sub add_supporting_features { } Description: For compatibility with Bio::EnsEMBL::Exon Does nothing and returns empty list Returntype : empty list. + Status : Stable =cut @@ -244,6 +252,7 @@ sub get_all_supporting_features { return []; } Description: For compatibility with Bio::EnsEMBL::Exon Does nothing. Returntype : empty list. + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/PredictionTranscript.pm b/modules/Bio/EnsEMBL/PredictionTranscript.pm index 9a3ad61f69..5b451085f9 100644 --- a/modules/Bio/EnsEMBL/PredictionTranscript.pm +++ b/modules/Bio/EnsEMBL/PredictionTranscript.pm @@ -78,6 +78,7 @@ use Bio::EnsEMBL::Utils::Argument qw( rearrange ); Returntype : Bio::EnsEMBL::PredictionTranscript Exceptions : none Caller : general + Status : Stable =cut @@ -109,6 +110,7 @@ sub new { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -133,6 +135,7 @@ sub coding_region_start { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -153,6 +156,7 @@ sub coding_region_end { Returntype : listref of Bio::EnsEMBL::PredictionExons Exceptions : none Caller : general + Status : Stable =cut @@ -172,6 +176,7 @@ sub get_all_translateable_Exons { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -195,12 +200,12 @@ sub display_label{ Returntype : string Exceptions : none Caller : general + Status : Stable =cut sub stable_id { return display_label(@_); } - sub get_all_DBEntries { return []; } sub get_all_DBLinks { return []; } @@ -228,6 +233,7 @@ sub is_known { return 0;} Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -279,6 +285,7 @@ sub translation { Returntype: a Bio::Seq as in transcript->translate() Exceptions: none Caller : general + Status : Stable =cut @@ -313,6 +320,7 @@ sub translate { Returntype : int Exceptions : none Caller : five_prime_utr, get_all_snps, general + Status : Stable =cut @@ -332,6 +340,7 @@ sub cdna_coding_start { return 1; } Returntype : int Exceptions : none Caller : five_prime_utr, get_all_snps, general + Status : Stable =cut @@ -354,6 +363,7 @@ sub cdna_coding_end { Returntype : Bio::EnsEMBL::PredictionTranscript Exceptions : wrong parameters Caller : general + Status : Stable =cut @@ -395,6 +405,7 @@ sub transform { Returntype : Bio::EnsEMBL::PredictionTranscript Exceptions : none Caller : general + Status : Stable =cut @@ -427,6 +438,7 @@ sub transfer { Returntype : a list reference to Bio::EnsEMBL::Exon objects Exceptions : none Caller : general + Status : Stable =cut @@ -450,6 +462,7 @@ sub get_all_Exons { Returntype : string Exceptions : none Caller : web drawing code + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/ProjectionSegment.pm b/modules/Bio/EnsEMBL/ProjectionSegment.pm index af780d1eea..03f64a321e 100644 --- a/modules/Bio/EnsEMBL/ProjectionSegment.pm +++ b/modules/Bio/EnsEMBL/ProjectionSegment.pm @@ -67,6 +67,7 @@ package Bio::EnsEMBL::ProjectionSegment; Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -85,6 +86,7 @@ sub from_start { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -104,6 +106,7 @@ sub from_end { Returntype : Bio::EnsEMBL::Slice Exceptions : none Caller : general + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/ProteinFeature.pm b/modules/Bio/EnsEMBL/ProteinFeature.pm index f72aacdeed..9155e18edb 100755 --- a/modules/Bio/EnsEMBL/ProteinFeature.pm +++ b/modules/Bio/EnsEMBL/ProteinFeature.pm @@ -59,6 +59,7 @@ use vars qw(@ISA); Returntype : Bio::EnsEMBL::FeaturePair Exceptions : none Caller : general + Status : Stable =cut @@ -80,6 +81,15 @@ sub new { } +=head2 strand + + Arg [1] : Ignored + Description: Overwrites Bio::EnsEMBL::Feature->strand to not allow + : the strand to be set. + Returntype : int + Status : Stable + +=cut #do not allow the strand to be set sub strand { @@ -98,6 +108,7 @@ sub strand { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -118,6 +129,7 @@ sub idesc{ Returntype : string Exceptions : none Caller : general + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/Registry.pm b/modules/Bio/EnsEMBL/Registry.pm index 87f784ed07..b227d97c4d 100644 --- a/modules/Bio/EnsEMBL/Registry.pm +++ b/modules/Bio/EnsEMBL/Registry.pm @@ -50,9 +50,6 @@ So if before we had my $sfa = $self->adaptor()->db()->get_db_adaptor('blast'); We now want to change this to - my $sfa = Bio::EnsEMBL::Registry->get_db($self->adaptor->db,'blast'); - -OR preferably if the blast adaptor was set up in configure my $sfa = Bio::EnsEMBL::Registry->get_adaptor("Human","core","blast"); @@ -125,27 +122,27 @@ use vars qw(%registry_register); Example : Bio::EnsEMBL::Registry->load_all(); Returntype : none Exceptions : none - + Status : Stable =cut sub load_all{ my $class = shift; - my $web_reg = shift; + my $conf_file = shift; if(defined($registry_register{'seen'})){ print STDERR "Clearing previuosly loaded configuration from Registry\n"; $class->clear(); } $registry_register{'seen'}=1; - if(defined($web_reg)){ - print STDERR "Loading conf from site defs file ".$web_reg."\n"; - if(-e $web_reg){ - unless (my $return = do $web_reg ){ + if(defined($conf_file)){ + print STDERR "Loading conf from site defs file ".$conf_file."\n"; + if(-e $conf_file){ + unless (my $return = do $conf_file ){ throw "Error in Configuration\n $!\n"; } # other wise it gets done again by the web initialisation stuff - delete $INC{$web_reg}; + delete $INC{$conf_file}; } } elsif(defined($ENV{ENSEMBL_REGISTRY}) and -e $ENV{ENSEMBL_REGISTRY}){ @@ -181,7 +178,7 @@ sub load_all{ Example : Bio::EnsEMBL::Registry->clear(); Returntype : none Exceptions : none - + Status : Stable =cut @@ -197,7 +194,7 @@ sub clear{ } # -# add ons. +# db adaptors. (for backwards compatibillity) # =head2 add_db @@ -208,7 +205,11 @@ sub clear{ Example : Bio::EnsEMBL::Registry->add_db($db, "lite", $dba); Returntype : none Exceptions : none - + Status : At Risk. + : This is here for backwards compatibillity only and may be removed + : eventually. Solution is to make sure the db and the adaptor have + : the same species and the call is then no longer needed. + =cut sub add_db{ @@ -227,6 +228,10 @@ sub add_db{ Example : my $db = Bio::EnsEMBL::Registry->remove_db($db, "lite"); Returntype : adaptor Exceptions : none + Status : At Risk. + : This is here for backwards compatibillity only and may be removed + : eventually. Solution is to make sure the db and the adaptor have + : the same species and the call is then no longer needed. =cut @@ -246,6 +251,10 @@ sub remove_db{ Example : my $db = Bio::EnsEMBL::Registry->get_db("Human", "core", "lite"); Returntype : adaptor Exceptions : none + Status : At Risk. + : This is here for backwards compatibillity only and may be removed + : eventually. Solution is to make sure the db and the adaptor have + : the same species then call get_DBAdaptor instead. =cut @@ -266,6 +275,11 @@ sub get_db{ Example : my $db = Bio::EnsEMBL::Registry->get_all_db_adaptors($db); Returntype : adaptor Exceptions : none + Status : At Risk. + : This is here for backwards compatibillity only and may be removed + : eventually. Solution is to make sure the dbs all have + : the same species then call get_all_DBAdaptors(-species => "human"); + =cut @@ -302,6 +316,8 @@ sub get_all_db_adaptors{ Example : Bio::EnsEMBL::Registry->add_DBAdaptor("Human", "core", $dba); Returntype : none Exceptions : none + caller : internal + Status : Stable =cut @@ -337,6 +353,7 @@ sub add_DBAdaptor{ Example : $dba = Bio::EnsEMBL::Registry->get_DBAdaptor("Human", "core"); Returntype : DBAdaptor Exceptions : none + Status : Stable =cut @@ -359,6 +376,7 @@ sub get_DBAdaptor{ : @human_dbas = @{Bio::EnsEMBL::Registry->get_all_DBAdaptors(-species => 'human')}; Returntype : list of DBAdaptors Exceptions : none + Status : Stable =cut @@ -389,6 +407,7 @@ sub get_all_DBAdaptors{ Returntype : reference to list of DBAdaptors Exceptions : none. Example : @dba = @{Bio::EnsEMBL::Registry->get_all_DBAdaptors_by_connection($dbc); + Status : Stable =cut @@ -418,6 +437,7 @@ sub get_all_DBAdaptors_by_connection{ Example : Bio::EnsEMBL::Registry->add_DNAAdaptor("Human", "core", $dnaAdap); Returntype : none Exceptions : none + Status : Stable =cut @@ -442,6 +462,7 @@ sub add_DNAAdaptor{ Example : $dnaAdap = Bio::EnsEMBL::Registry->get_DNAAdaptor("Human", "core"); Returntype : adaptor Exceptions : none + Status : Stable =cut @@ -472,6 +493,8 @@ sub get_DNAAdaptor{ Example : Bio::EnsEMBL::Registry->add_adaptor("Human", "core", "Gene", $adap); Returntype : none Exceptions : none + Caller : internal + Status : Stable =cut @@ -531,6 +554,7 @@ sub add_adaptor{ Example : $adap = Bio::EnsEMBL::Registry->get_adaptor("Human", "core", "Gene"); Returntype : adaptor Exceptions : none + Status : Stable =cut @@ -577,8 +601,9 @@ sub get_adaptor{ Arg [TYPE] : (optional) string type to get adaptors for Example : @adaps = @{Bio::EnsEMBL::Registry->get_all_adaptors()}; - Returntype : list of adaptors + Returntype : ref to list of adaptors Exceptions : none + Status : Stable =cut @@ -650,6 +675,7 @@ sub get_all_adaptors{ Description: add alternative name for the species. Returntype : none Exceptions : none + Status : Stable =cut @@ -666,6 +692,7 @@ sub add_alias{ Description: get proper species name. Returntype : species name Exceptions : none + Status : Stable =cut @@ -686,6 +713,7 @@ sub get_alias{ Description: does the species name exist. Returntype : 1 if exists else 0 Exceptions : none + Status : Stable =cut @@ -705,6 +733,7 @@ sub alias_exists{ not being used on each database. Returntype : none Exceptions : none + Status : Stable =cut @@ -724,6 +753,7 @@ sub set_disconnect_when_inactive{ Description: disconnect from all the databases. Returntype : none Exceptions : none + Status : Stable =cut @@ -754,6 +784,7 @@ sub disconnect_all { Description: change username and password on one or more databases Returntype : none Exceptions : none + Status : Stable =cut @@ -799,6 +830,7 @@ my $self = shift; can find on a database instance into the registry. Exceptions : None. + Status : Stable =cut @@ -1005,6 +1037,7 @@ sub load_registry_with_web_adaptors{ Example : $merged = Bio::EnsEMBL::Registry->set_default_track("Human","core"); Returntype : none Exceptions : none + Status : At Risk. =cut @@ -1024,6 +1057,7 @@ sub set_default_track{ Example : $merged = Bio::EnsEMBL::Registry->set_default_track("Human","core"); Returntype : int Exceptions : none + Status : At Risk. =cut @@ -1048,6 +1082,7 @@ sub default_track{ Returntype : none Exceptions : none Called by : UserConfig.pm + Status : At Risk. =cut diff --git a/modules/Bio/EnsEMBL/RegulatoryFactor.pm b/modules/Bio/EnsEMBL/RegulatoryFactor.pm index 9227cfca25..f8edfee8f5 100644 --- a/modules/Bio/EnsEMBL/RegulatoryFactor.pm +++ b/modules/Bio/EnsEMBL/RegulatoryFactor.pm @@ -26,6 +26,8 @@ use vars qw(@ISA); Returntype : Bio::EnsEMBL::RegulatoryFactor Exceptions : none Caller : RegulatoryFactor + Status : At Risk + : under development =cut @@ -61,6 +63,8 @@ sub new_fast { Returntype : string Exceptions : none Caller : general + Status : At Risk + : under development =cut @@ -79,6 +83,8 @@ sub name { Returntype : int Exceptions : none Caller : general + Status : At Risk + : under development =cut diff --git a/modules/Bio/EnsEMBL/RegulatoryFeature.pm b/modules/Bio/EnsEMBL/RegulatoryFeature.pm index ec463c3a2e..f39814313f 100644 --- a/modules/Bio/EnsEMBL/RegulatoryFeature.pm +++ b/modules/Bio/EnsEMBL/RegulatoryFeature.pm @@ -67,6 +67,8 @@ use Bio::EnsEMBL::Utils::Argument qw(rearrange); Description: Constructs a new Bio::EnsEMBL::RegulatoryFeature. Exceptions : Thrown on invalid -SLICE, -ANALYSIS, -STRAND arguments Caller : general, subclass constructors + Status : At Risk + : under development =cut @@ -101,6 +103,8 @@ sub new_fast { Returntype : Bio::EnsEMBL::RegulatoryFactor Exceptions : none Caller : general + Status : At Risk + : under development =cut @@ -130,6 +134,8 @@ sub factor { Returntype : string Exceptions : none Caller : web drawing code + Status : At Risk + : under development =cut @@ -148,6 +154,8 @@ sub name { Returntype : listREF of Bio::EnsEMBL::RegulatoryFeatures Exceptions : none Caller : ? + Status : At Risk + : under development =cut @@ -188,6 +196,8 @@ sub regulated_transcripts { Returntype : listREF of Bio::EnsEMBL::RegulatoryFeatures Exceptions : none Caller : ? + Status : At Risk + : under development =cut diff --git a/modules/Bio/EnsEMBL/RepeatConsensus.pm b/modules/Bio/EnsEMBL/RepeatConsensus.pm index 7212ddd4a9..590bc02894 100644 --- a/modules/Bio/EnsEMBL/RepeatConsensus.pm +++ b/modules/Bio/EnsEMBL/RepeatConsensus.pm @@ -30,10 +30,11 @@ use vars qw(@ISA); -LENGTH => '4', -DBID => 1023, -ADAPTOR => $rc_adaptor); - Description: Creates a new Bio::EnsEMBL::RepeatFeature object - Returntype : Bio::EnsEMBL::RepeatFeature + Description: Creates a new Bio::EnsEMBL::RepeatConsensus object + Returntype : Bio::EnsEMBL::RepeatConsensus Exceptions : none Caller : RepeatFeatureAdaptors + Status : Stable =cut @@ -57,6 +58,18 @@ sub new { } +=head2 new_fast + + Arg [1] : hashref to bless as a new RepeatConsensus + + Description: Creates a new Bio::EnsEMBL::RepeatConsensus object + Returntype : Bio::EnsEMBL::RepeatConsensus + Exceptions : none + Caller : internal + Status : Stable + +=cut + sub new_fast { my $class = shift; my $hashref = shift; @@ -72,6 +85,7 @@ sub new_fast { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -90,6 +104,7 @@ sub name { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -109,6 +124,7 @@ sub length { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -146,6 +162,7 @@ sub repeat_type { Returntype : string Exceptions : none Caller : general + Status : Medium risk =cut @@ -186,6 +203,7 @@ sub repeat_consensus { Returntype : string Exceptions : none Caller : general + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/RepeatFeature.pm b/modules/Bio/EnsEMBL/RepeatFeature.pm index fe0f40fe17..3be6842dc3 100644 --- a/modules/Bio/EnsEMBL/RepeatFeature.pm +++ b/modules/Bio/EnsEMBL/RepeatFeature.pm @@ -110,6 +110,7 @@ sub new_fast { Returntype : Bio::EnsEMBL::RepeatFeature Exceptions : none Caller : RepeatFeatureAdaptors + Status : Stable =cut @@ -140,6 +141,7 @@ sub new { Returntype : Bio::EnsEMBL::RepeatConsensus Exceptions : none Caller : general + Status : Stable =cut @@ -170,6 +172,7 @@ sub repeat_consensus { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -188,6 +191,7 @@ sub hstart { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -208,6 +212,7 @@ sub score { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -227,7 +232,8 @@ sub hend { features. Returntype : int Exceptions : none - Caller : + Caller : general + Status : Stable =cut @@ -247,6 +253,7 @@ sub hstrand { Returntype : string Exceptions : none Caller : web drawing code + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/RepeatMaskedSlice.pm b/modules/Bio/EnsEMBL/RepeatMaskedSlice.pm index 8c32e05b2f..6995c1a72c 100644 --- a/modules/Bio/EnsEMBL/RepeatMaskedSlice.pm +++ b/modules/Bio/EnsEMBL/RepeatMaskedSlice.pm @@ -82,6 +82,7 @@ use vars qw(@ISA); Returntype : Bio::EnsEMBL::RepeatMaskedSlice Exceptions : none Caller : RawComputes (PredictionTranscript creation code). + Status : Stable =cut @@ -119,6 +120,7 @@ sub new { Returntype : reference to list of strings Exceptions : none Caller : seq() method + Status : Stable =cut @@ -145,6 +147,7 @@ sub repeat_mask_logic_names { Returntype : boolean Exceptions : none Caller : seq() method + Status : Stable =cut @@ -176,6 +179,7 @@ sub soft_mask { Returntype : hash reference Exceptions : none Caller : seq() and subseq() methods + Status : Stable =cut @@ -195,6 +199,7 @@ sub not_default_masking_cases { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -237,6 +242,7 @@ sub seq { Returntype : string Exceptions : none Caller : general + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/SeqEdit.pm b/modules/Bio/EnsEMBL/SeqEdit.pm index 726f1f7dfa..cdd3d7abc8 100644 --- a/modules/Bio/EnsEMBL/SeqEdit.pm +++ b/modules/Bio/EnsEMBL/SeqEdit.pm @@ -101,8 +101,10 @@ use Bio::EnsEMBL::Utils::Exception qw(throw); Description: Constructs a SeqEdit representing a single edit to a sequence, such as an rna modification or a selenocysteine. Returntype : Bio::EnsEMBL::SeqEdit - Exceptions : none + Exceptions : throws if attribute set and other args aswell + throws if start and end not set correctly of attribure not set Caller : general + Status : Stable =cut @@ -177,6 +179,7 @@ sub new { Returntype : int Exceptions : none Caller : Transcript, Translation + Status : Stable =cut @@ -209,8 +212,9 @@ sub start { E.g. start = 1, end = 1 is a replacement of the first base but start = 1, end = 0 is an insert BEFORE the first base. Returntype : int - Exceptions : none + Exceptions : throws if end <= 0 Caller : Transcript, Translation + Status : Stable =cut @@ -243,6 +247,7 @@ sub end { Returntype : string Exceptions : none Caller : Transcript, Translation + Status : Stable =cut @@ -265,6 +270,7 @@ sub alt_seq { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -286,6 +292,7 @@ sub length_diff { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -306,6 +313,7 @@ sub name { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -325,6 +333,7 @@ sub code { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -348,6 +357,7 @@ sub description { Returntype : Bio::EnsEMBL::Attribute Exceptions : warning if start/end or alt_seq properties are not defined Caller : general + Status : Stable =cut @@ -390,6 +400,7 @@ sub get_Attribute { Returntype : reference to the same sequence that was passed in Exceptions : none Caller : Transcript, Translation + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/SimpleFeature.pm b/modules/Bio/EnsEMBL/SimpleFeature.pm index 29ce41214a..5d3debb60e 100644 --- a/modules/Bio/EnsEMBL/SimpleFeature.pm +++ b/modules/Bio/EnsEMBL/SimpleFeature.pm @@ -73,6 +73,7 @@ use Bio::EnsEMBL::Utils::Argument qw(rearrange); Returntype : Bio::EnsEMBL::Feature Exceptions : Thrown on invalid -SLICE, -ANALYSIS, -STRAND arguments Caller : general, subclass constructors + Status : Stable =cut @@ -92,6 +93,18 @@ sub new { } +=head2 new_fast + + Arg [1] : hashref to be blessed + Description: Construct a new Bio::EnsEMBL::Feature using the hashref. + Exceptions : none + Returntype : Bio::EnsEMBL::Feature + Caller : general, subclass constructors + Status : Stable + +=cut + + sub new_fast { my $class = shift; my $hashref = shift; @@ -108,6 +121,7 @@ sub new_fast { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -131,6 +145,7 @@ sub display_label{ Returntype : string Exceptions : none Caller : web drawing code + Status : Stable =cut @@ -150,6 +165,7 @@ sub display_id { Returntype : string Exceptions : none Caller : general + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/Slice.pm b/modules/Bio/EnsEMBL/Slice.pm index 6b2ebb168d..e509f926a3 100644 --- a/modules/Bio/EnsEMBL/Slice.pm +++ b/modules/Bio/EnsEMBL/Slice.pm @@ -58,24 +58,19 @@ package Bio::EnsEMBL::Slice; use vars qw(@ISA); use strict; -use Bio::EnsEMBL::Root; # included for backwards compatibility - use Bio::PrimarySeqI; use Bio::EnsEMBL::Utils::Argument qw(rearrange); use Bio::EnsEMBL::Utils::Exception qw(throw deprecate warning stack_trace_dump); - use Bio::EnsEMBL::RepeatMaskedSlice; use Bio::EnsEMBL::Utils::Sequence qw(reverse_comp); - use Bio::EnsEMBL::ProjectionSegment; use Bio::EnsEMBL::Registry; my $reg = "Bio::EnsEMBL::Registry"; -# inheritance to Bio::EnsEMBL::Root will eventually be removed -@ISA = qw(Bio::EnsEMBL::Root Bio::PrimarySeqI); +@ISA = qw(Bio::PrimarySeqI); =head2 new @@ -85,7 +80,8 @@ my $reg = "Bio::EnsEMBL::Registry"; string SEQ_REGION_NAME, int START, int END, - string VERSION (optional, defaults to '') + int SEQ_REGION_LENGTH, (optional) + string SEQ (optional) int STRAND, (optional, defaults to 1) Bio::EnsEMBL::DBSQL::SliceAdaptor ADAPTOR (optional) Example : $slice = Bio::EnsEMBL::Slice->new(-coord_system => $cs, @@ -109,8 +105,9 @@ my $reg = "Bio::EnsEMBL::Registry"; (with the exception of the adaptor) may not be altered. To change the attributes a new slice must be created. Returntype : Bio::EnsEMBL::Slice - Exceptions : none + Exceptions : throws if start, end, coordsystem or seq_region_name not specified or not of the correct type Caller : general, Bio::EnsEMBL::SliceAdaptor + Status : Stable =cut @@ -188,8 +185,9 @@ sub new { Description: Getter/Setter for the slice object adaptor used by this slice for database interaction. Returntype : Bio::EnsEMBL::DBSQL::SliceAdaptor - Exceptions : none + Exceptions : thorws if argument passed is not a SliceAdaptor Caller : general + Status : Stable =cut @@ -225,6 +223,7 @@ sub adaptor{ Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -245,6 +244,7 @@ sub seq_region_name { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -262,6 +262,7 @@ sub seq_region_length { Returntype : Bio::EnsEMBL::CoordSystem Exceptions : none Caller : general + Status : Stable =cut @@ -281,6 +282,7 @@ sub coord_system { Returntype: string or undef Exceptions: none Caller : general + Status : Stable =cut @@ -301,6 +303,7 @@ sub coord_system_name { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -322,6 +325,7 @@ sub centrepoint { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -345,6 +349,7 @@ sub start { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -364,6 +369,7 @@ sub end { Returntype : int (either 1 or -1) Exceptions : none Caller : general, invert + Status : Stable =cut @@ -389,6 +395,7 @@ sub strand{ Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -416,6 +423,7 @@ sub name { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -436,6 +444,7 @@ sub length { Returntype : Bio::EnsEMBL::Slice Exceptions : none Caller : general + Status : Stable =cut @@ -464,6 +473,7 @@ sub invert { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -500,6 +510,7 @@ sub seq { Exceptions : end should be at least as big as start strand must be set Caller : general + Status : Stable =cut @@ -565,6 +576,7 @@ sub subseq { Returntype : hashref Exceptions : none Caller : general + Status : Stable =cut @@ -638,6 +650,7 @@ sub get_base_count { can also be used as [$start,$end,$slice] triplets Exceptions : none Caller : general + Status : Stable =cut @@ -831,6 +844,7 @@ sub _constrain_to_region { Returntype : Bio::EnsEMBL::Slice Exceptions : warning if an attempt is made to contract the slice below 1bp Caller : general + Status : Stable =cut @@ -907,6 +921,7 @@ sub expand { Returntype : Bio::EnsEMBL::Slice or undef if arguments are wrong Exceptions : none Caller : general + Status : Stable =cut @@ -969,6 +984,7 @@ sub sub_Slice { Returntype : Bio::EnsEMBL::Slice Exceptions : warning if called when sequence of Slice has been set manually. Caller : general + Status : Stable =cut @@ -1008,6 +1024,7 @@ sub seq_region_Slice { Returntype : int or undef if slices does not have attached adaptor Exceptions : warning if slice is not associated with a SliceAdaptor Caller : assembly loading scripts, general + Status : Stable =cut @@ -1034,6 +1051,7 @@ sub get_seq_region_id { Returntype : listref Bio::EnsEMBL::Attribute Exceptions : warning if slice does not have attached adaptor Caller : general + Status : Stable =cut @@ -1080,6 +1098,7 @@ sub get_all_Attributes { Returntype : listref of Bio::EnsEMBL::PredictionTranscript Exceptions : warning if slice does not have attached adaptor Caller : none + Status : Stable =cut @@ -1115,6 +1134,7 @@ sub get_all_PredictionTranscripts { Returntype : listref of Bio::EnsEMBL::DnaDnaAlignFeatures Exceptions : warning if slice does not have attached adaptor Caller : general + Status : Stable =cut @@ -1153,7 +1173,7 @@ sub get_all_DnaAlignFeatures { Arg [2] : (optional) float $score The mimimum score of the features to retrieve Arg [3] : (optional) string $dbtype - The name of an attached datbase to retrieve features from + The name of an attached database to retrieve features from instead. Example : @dna_pep_align_feats = @{$slice->get_all_ProteinAlignFeatures}; Description: Retrieves the DnaPepAlignFeatures which overlap this slice with @@ -1164,6 +1184,7 @@ sub get_all_DnaAlignFeatures { Returntype : listref of Bio::EnsEMBL::DnaPepAlignFeatures Exceptions : warning if slice does not have attached adaptor Caller : general + Status : Stable =cut @@ -1210,6 +1231,7 @@ sub get_all_ProteinAlignFeatures { Returntype : listref of Bio::EnsEMBL::BaseAlignFeatures Exceptions : warning if slice does not have attached adaptor Caller : general + Status : Stable =cut @@ -1242,6 +1264,7 @@ sub get_all_SimilarityFeatures { Returntype : listref of Bio::EnsEMBL::SimpleFeatures Exceptions : warning if slice does not have attached adaptor Caller : general + Status : Stable =cut @@ -1275,6 +1298,7 @@ sub get_all_SimpleFeatures { Returntype : listref of Bio::EnsEMBL::RepeatFeatures Exceptions : warning if slice does not have attached adaptor Caller : general + Status : Stable =cut @@ -1300,6 +1324,8 @@ sub get_all_RepeatFeatures { ReturnType : Bio::EnsEMBL::Variation::LDFeatureContainer Exceptions : none Caller : contigview, snpview + Status : At Risk + : Variation database is under development. =cut @@ -1337,6 +1363,8 @@ sub get_all_LD_values{ ReturnType : listref of Bio::EnsEMBL::Variation::VariationFeature Exceptions : none Caller : contigview, snpview + Status : At Risk + : Variation database is under development. =cut @@ -1373,6 +1401,8 @@ sub get_all_VariationFeatures{ ReturnType : listref of Bio::EnsEMBL::Variation::VariationFeature Exceptions : none Caller : contigview, snpview, ldview + Status : At Risk + : Variation database is under development. =cut @@ -1479,6 +1509,7 @@ sub get_all_SNPs_transcripts { Returntype : listref of Bio::EnsEMBL::Genes Exceptions : none Caller : none + Status : Stable =cut @@ -1531,6 +1562,7 @@ sub get_all_Genes{ Returntype : listref of Bio::EnsEMBL::Genes Exceptions : none Caller : genebuilder + Status : Stable =cut @@ -1563,6 +1595,7 @@ sub get_all_Genes_by_type{ Returntype : reference to a list of Bio::EnsEMBL::Transcripts Exceptions : none Caller : general + Status : Stable =cut @@ -1590,6 +1623,7 @@ sub get_all_Transcripts { Returntype : reference to a list of Bio::EnsEMBL::Exons Exceptions : none Caller : general + Status : Stable =cut @@ -1614,6 +1648,7 @@ sub get_all_Exons { Returntype : listref Bio::EnsEMBL::Map::QtlFeature Exceptions : none Caller : general + Status : Stable =cut @@ -1646,6 +1681,7 @@ sub get_all_QtlFeatures { Returntype : listref oif Bio::EnsEMBL::KaryotypeBands Exceptions : none Caller : general, contigview + Status : Stable =cut @@ -1695,6 +1731,7 @@ sub get_all_KaryotypeBands { Returntype : Bio::EnsEMBL::RepeatMaskedSlice Exceptions : none Caller : general + Status : Stable =cut @@ -1748,6 +1785,7 @@ sub get_repeatmasked_seq { Returntype : none Exceptions : none Caller : seq + Status : Stable =cut @@ -1821,6 +1859,7 @@ sub _mask_features { Returntype : listref of Bio::EnsEMBL::SeqFeatures Exceptions : none Caller : general (webby!) + Status : Stable =cut @@ -1860,6 +1899,7 @@ sub get_all_SearchFeatures { Returntype : listref of Bio::EnsEMBL::AssemblyExceptionFeatures Exceptions : none Caller : general + Status : Stable =cut @@ -1891,6 +1931,7 @@ sub get_all_AssemblyExceptionFeatures { Returntype : listref of Bio::EnsEMBL::MiscFeatures Exceptions : none Caller : general + Status : Stable =cut @@ -1916,6 +1957,17 @@ sub get_all_MiscFeatures { +=head2 get_all_AffyFeatures + + Arg [1] : (optional) array of names + Example : $slice->get_all_AffyFeatures(); + Description: Retreives all affy features which overlap this slice. + Returntype : listref of Bio::EnsEMBL::AffyFeatures + Exceptions : none + Caller : general + Status : Stable + +=cut sub get_all_AffyFeatures { my $self = shift; @@ -1953,6 +2005,7 @@ sub get_all_AffyFeatures { Returntype : reference to a list of Bio::EnsEMBL::MarkerFeatures Exceptions : none Caller : contigview, general + Status : Stable =cut @@ -1995,6 +2048,7 @@ sub get_all_MarkerFeatures { Returntype : reference to a list of Bio::EnsEMBL::DnaDnaAlignFeatures Exceptions : warning if compara database is not available Caller : contigview + Status : Stable =cut @@ -2023,6 +2077,15 @@ sub get_all_compara_DnaAlignFeatures { return $dafa->fetch_all_by_Slice($self, $qy_species, $qy_assembly, $alignment_type); } +=head2 get_all_compara_Syntenies + + Arg [1] : query species + Description: gets al the conpara syntenys fro a specfic species + Returns : arrayref of Bio::EnsEMBL::Compara::SyntenyRegion + Status : Stable + +=cut + sub get_all_compara_Syntenies { my ($self, $qy_species ) = @_; @@ -2060,6 +2123,7 @@ sub get_all_compara_Syntenies { Returntype : listref of Bio::EnsEMBL::External::Haplotype::Haplotypes Exceptions : warning is Haplotype database is not available Caller : contigview, general + Status : Stable =cut @@ -2100,6 +2164,7 @@ sub get_all_Haplotypes { Returntype : hashref of Bio::SeqFeatures Exceptions : ? Caller : webcode + Status : Stable =cut @@ -2132,6 +2197,7 @@ sub get_all_DASFeatures{ coordinates Exceptions : none Caller : general + Status : Stable =cut @@ -2184,6 +2250,7 @@ sub get_all_ExternalFeatures { Returntype : Hash of named features. Exceptions : none Caller : none + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/Storable.pm b/modules/Bio/EnsEMBL/Storable.pm index 69d198a6a3..b46b600474 100644 --- a/modules/Bio/EnsEMBL/Storable.pm +++ b/modules/Bio/EnsEMBL/Storable.pm @@ -35,18 +35,23 @@ use warnings; package Bio::EnsEMBL::Storable; -use Bio::EnsEMBL::Root; -use vars qw(@ISA); - -# -# will eventually remove unneeded inheritance to Root -# -@ISA = qw(Bio::EnsEMBL::Root); - use Bio::EnsEMBL::Utils::Exception qw(throw warning); use Bio::EnsEMBL::Utils::Argument qw(rearrange); +=head2 new + + Arg [-ADAPTOR] : Bio::EnsEMBL::DBSQL::BaseAdaptor + Arg [-dbID] : database internal id + Example : none + Caller : internal calls + Description : create a new Storable object + Returntype : Bio::EnsEMBL::Storable + Exceptions : Adaptor not a Bio::EnsEMBL::DBSQL::BaseAdaptor + Status : Stable + +=cut + sub new { my $caller = shift; my $class = ref($caller) || $caller; @@ -71,6 +76,7 @@ sub new { Returntype : int Exceptions : none Caller : general, set from adaptor on store + Status : Stable =cut @@ -87,9 +93,10 @@ sub dbID { Arg [1] : Bio::EnsEMBL::DBSQL::BaseAdaptor $adaptor Example : none Description: get/set for this objects Adaptor - Returntype : Bio::EnsEMBL::DBSQL::ChromsomeAdaptor + Returntype : Bio::EnsEMBL::DBSQL::BaseAdaptor Exceptions : none Caller : general, set from adaptor on store + Status : Stable =cut @@ -110,7 +117,8 @@ sub adaptor { =head2 is_stored - Arg [1] : Bio::EnsEMBL::DBSQL::DBConnection + Arg [1] : Bio::EnsEMBL::DBSQL::DBConnection + : or Bio::EnsEMBL::DBSQL::DBAdaptor Example : do_something if($object->is_stored($db)); Description: Returns true if this object is stored in the provided database. This works under the assumption that if the adaptor and dbID are @@ -122,6 +130,7 @@ sub adaptor { throw if adaptor is set but dbID is not throw if incorrect argument is passed Caller : store methods + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/TopLevelAssemblyMapper.pm b/modules/Bio/EnsEMBL/TopLevelAssemblyMapper.pm index e7bc1354c4..ea24ab7b0a 100644 --- a/modules/Bio/EnsEMBL/TopLevelAssemblyMapper.pm +++ b/modules/Bio/EnsEMBL/TopLevelAssemblyMapper.pm @@ -56,6 +56,22 @@ use Bio::EnsEMBL::Utils::Exception qw(throw); use Bio::EnsEMBL::Mapper; use Bio::EnsEMBL::CoordSystem; +=head2 new + + Arg [1] : Bio::EnsEMBL::DBAdaptor $dbadaptor the adaptor for + the database this mapper is using. + Arg [2] : Toplevel CoordSystem + Arg [3] : Other CoordSystem + Description: Creates a new TopLevelAssemblyMapper object + Returntype : Bio::EnsEMBL::DBSQL::TopLevelAssemblyMapper + Exceptions : throws if any of the 3 arguments are missing/ not + : of the correct type. + Caller : Bio::EnsEMBL::DBSQL::AssemblyMapperAdaptor + Status : Stable + +=cut + + sub new { my ($caller, $adaptor, $toplevel_cs, $other_cs) = @_; @@ -92,6 +108,32 @@ sub adaptor { return $self->{'adaptor'}; } +=head2 map + + Arg [1] : string $frm_seq_region + The name of the sequence region to transform FROM + Arg [2] : int $frm_start + The start of the region to transform FROM + Arg [3] : int $frm_end + The end of the region to transform FROM + Arg [4] : int $strand + The strand of the region to transform FROM + Arg [5] : Bio::EnsEMBL::CoordSystem + The coordinate system to transform FROM + Arg [6] : if set will do a fastmap + Example : @coords = $mapper->map('X', 1_000_000, 2_000_000, + 1, $chr_cs); + Description: Transforms coordinates from one coordinate system + to another. + Returntype : List of Bio::EnsEMBL::Mapper::Coordinate and/or + Bio::EnsEMBL::Mapper:Gap objects + Exceptions : thrown if if the specified TO coordinate system is not one + of the coordinate systems associated with this mapper + Caller : general + Status : Stable + +=cut + sub map { throw('Incorrect number of arguments.') if(@_ != 6 && @_ != 7); @@ -160,18 +202,78 @@ sub map { # # for polymorphism with AssemblyMapper # +=head2 flush + + Args : none + Example : none + Description: polymorphism with AssemblyMapper, does nothing + Returntype : none + Exceptions : none + Status : Stable + +=cut + sub flush {} +=head2 fastmap + + Arg [1] : string $frm_seq_region + The name of the sequence region to transform FROM + Arg [2] : int $frm_start + The start of the region to transform FROM + Arg [3] : int $frm_end + The end of the region to transform FROM + Arg [4] : int $strand + The strand of the region to transform FROM + Arg [5] : Bio::EnsEMBL::CoordSystem + The coordinate system to transform FROM + Example : @coords = $mapper->fastmap('X', 1_000_000, 2_000_000, + 1, $chr_cs); + Description: Transforms coordinates from one coordinate system + to another. + Returntype : List of Bio::EnsEMBL::Mapper::Coordinate and/or + Bio::EnsEMBL::Mapper:Gap objects + Exceptions : thrown if if the specified TO coordinate system is not one + of the coordinate systems associated with this mapper + Caller : general + Status : Stable + +=cut + sub fastmap { my $self = shift; return $self->map(@_,1); } +=head2 assembled_CoordSystem + + Arg [1] : none + Example : $cs = $mapper->assembled_CoordSystem + Description: Retrieves the assembled CoordSystem from this mapper + Returntype : Bio::EnsEMBL::CoordSystem + Exceptions : none + Caller : internal, AssemblyMapperAdaptor + Status : Stable + +=cut + sub assembled_CoordSystem { my $self = shift; return $self->{'toplevel_cs'}; } +=head2 component_CoordSystem + + Arg [1] : none + Example : $cs = $mapper->component_CoordSystem + Description: Retrieves the component CoordSystem from this mapper + Returntype : Bio::EnsEMBL::CoordSystem + Exceptions : none + Caller : internal, AssemblyMapperAdaptor + Status : Stable + +=cut + sub component_CoordSystem { my $self = shift; return $self->{'other_cs'}; @@ -265,6 +367,7 @@ sub _list { Returntype : List of strings Exceptions : none Caller : general + Status : Stable =cut @@ -293,6 +396,7 @@ sub list_seq_regions { Exceptions : thrown if the from CoordSystem is the toplevel coord system thrown if the from CoordSystem is not the one used in the mapper Caller : general + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/Transcript.pm b/modules/Bio/EnsEMBL/Transcript.pm index eeb43a8116..946b69a97d 100755 --- a/modules/Bio/EnsEMBL/Transcript.pm +++ b/modules/Bio/EnsEMBL/Transcript.pm @@ -80,11 +80,22 @@ use Bio::EnsEMBL::Utils::Exception qw( deprecate warning throw ); Arg [-DISPLAY_XREF]: Bio::EnsEMBL::DBEntry - The external database entry that is used to label this transcript when it is displayed. + Arg [-CREATED_DATE]: + string - the date the transcript was created + Arg [-MODIFIED_DATE]: + string - the date the transcript was last modified + Arg [-DESCRIPTION]: + string - the transcipts description + Arg [-BIOTYPE]: + string - the biotype e.g. "protein_coding" + Arg [-CONFIDENCE]: + string - the transcripts confidence i.e. "KNOWN","NOVEL" Example : $tran = new Bio::EnsEMBL::Transcript(-EXONS => \@exons); Description: Constructor. Instantiates a Transcript object. Returntype : Bio::EnsEMBL::Transcript Exceptions : throw on bad arguments Caller : general + Status : Stable =cut @@ -158,6 +169,7 @@ sub new { priority (desc), external db name (asc), display_id (asc) Exceptions : none Caller : general + Status : Stable =cut @@ -192,6 +204,7 @@ sub get_all_DBLinks { Returntype : list reference to Bio::EnsEMBL::DBEntry objects Exceptions : none Caller : get_all_DBLinks, TranscriptAdaptor::store + Status : Stable =cut @@ -221,6 +234,7 @@ sub get_all_DBEntries { Returntype : none Exceptions : thrown on incorrect argument type Caller : general + Status : Stable =cut @@ -247,6 +261,7 @@ sub add_DBEntry { Returntype : listreference of Bio::EnsEMBL::FeaturePair Exceptions : none Caller : general + Status : Stable =cut @@ -277,6 +292,7 @@ sub get_all_supporting_features { throw if any of the features are not in the same coordinate system as the Transcript Caller : general + Status : Stable =cut @@ -327,6 +343,7 @@ sub add_supporting_features { Function: external_name if available Returns : the external db link for this transcript Args : new external db (optional) + Status : Stable =cut @@ -359,6 +376,7 @@ sub external_db { Function: external_name if available Returns : the external db link for this transcript Args : new external db (optional) + Status : Stable =cut @@ -392,6 +410,7 @@ sub external_status { Example : Returns : the external name of this transcript Args : new external name (optional) + Status : Stable =cut @@ -425,6 +444,7 @@ sub external_name { Returntype : 0,1 Exceptions : none Caller : general + Status : Stable =cut @@ -443,7 +463,8 @@ sub is_known { Returntype : string Exceptions : none Caller : general - + Status : At Risk + : will be replaced with biotype =cut sub type { @@ -463,6 +484,7 @@ sub type { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -481,6 +503,7 @@ sub confidence { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -501,6 +524,7 @@ sub biotype { Returntype : Bio::EnsEMBL::DBEntry Exceptions : none Caller : general + Status : Stable =cut @@ -528,6 +552,7 @@ sub display_xref { Returntype : Bio::EnsEMBL::Transcript Exceptions : none Caller : general + Status : Stable =cut @@ -559,6 +584,7 @@ sub translation { Returntype : txt Exceptions : none Caller : general + Status : Stable =cut @@ -612,6 +638,7 @@ sub spliced_seq { Returntype : txt Exceptions : none Caller : general + Status : Stable =cut @@ -654,6 +681,7 @@ sub translateable_seq { Returntype : int Exceptions : none Caller : five_prime_utr, get_all_snps, general + Status : Stable =cut @@ -717,6 +745,7 @@ sub cdna_coding_start { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -781,6 +810,7 @@ sub cdna_coding_end { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -826,6 +856,7 @@ sub coding_region_start { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -865,6 +896,7 @@ sub coding_region_end { Returntype : boolean - the current value of the edits Exceptions : none Caller : general, cdna_coding_start, cdna_coding_end, length + Status : Stable =cut @@ -892,6 +924,7 @@ sub edits_enabled { Returntype : Bio::EnsEMBL::SeqEdit Exceptions : none Caller : spliced_seq() + Status : Stable =cut @@ -923,6 +956,7 @@ sub get_all_SeqEdits { Exceptions : warning if transcript does not have attached adaptor and attempts lazy load. Caller : general + Status : Stable =cut @@ -961,6 +995,7 @@ sub get_all_Attributes { Returntype : none Exceptions : throw on incorrect arguments Caller : general + Status : Stable =cut @@ -993,7 +1028,11 @@ sub add_Attributes { Title : add_Exon Usage : $trans->add_Exon($exon) Returns : Nothing - Args : + Args [1]: Bio::EnsEMBL::Exon object to add + Args [2]: rank + Exceptions: throws if not a valid Bio::EnsEMBL::Exon + : or exon clasjes with another one + Status : Stable =cut @@ -1082,6 +1121,7 @@ sub add_Exon{ Returntype : a list reference to Bio::EnsEMBL::Exon objects Exceptions : none Caller : general + Status : Stable =cut @@ -1104,6 +1144,7 @@ sub get_all_Exons { Returntype : a list reference to Bio::EnsEMBL::Intron objects Exceptions : none Caller : general + Status : Stable =cut @@ -1127,11 +1168,13 @@ sub get_all_Introns { =head2 length - - my $t_length = $transcript->length - -Returns the sum of the length of all the exons in -the transcript. + Args : none + Example : my $t_length = $transcript->length + Description: Returns the sum of the length of all the exons in the transcript. + Returntype : int + Exceptions : none + Caller : general + Status : Stable =cut @@ -1166,6 +1209,7 @@ sub length { Returntype : none Exceptions : none Caller : general + Status : Stable =cut @@ -1197,6 +1241,7 @@ sub flush_Exons{ Returntype : Bio::Seq or undef Exceptions : none Caller : general + Status : Stable =cut @@ -1231,6 +1276,7 @@ sub five_prime_utr { Returntype : Bio::Seq or undef Exceptions : none Caller : general + Status : Stable =cut @@ -1269,6 +1315,7 @@ sub three_prime_utr { Returntype : listref Bio::EnsEMBL::Exon Exceptions : throw if translation has invalid information Caller : Genebuild + Status : Stable =cut @@ -1298,7 +1345,6 @@ sub get_all_translateable_Exons { # Adjust to translation start if this is the start exon if ($ex == $start_exon ) { if ($t_start < 1 or $t_start > $length) { -# throw("Translation start '$t_start' is outside exon $ex length=$length"); warn("WARN: Translation start '$t_start' is outside exon $ex length=$length"); return []; } @@ -1342,6 +1388,7 @@ sub get_all_translateable_Exons { Returntype : Bio::Seq or undef Exceptions : If no Translation is set in this Transcript Caller : general + Status : Stable =cut @@ -1402,10 +1449,16 @@ sub translate { =head2 seq -Returns a Bio::Seq object which consists of just -the sequence of the exons concatenated together, -without messing about with padding with N\'s from -Exon phases like B<dna_seq> does. + Description: Returns a Bio::Seq object which consists of just + : the sequence of the exons concatenated together, + : without messing about with padding with N\'s from + : Exon phases like B<dna_seq> does. + Args : none + Example : none + Returntype : Bio::Seq + Exceptions : none + Caller : general + Status : Stable =cut @@ -1475,6 +1528,7 @@ sub genomic2cdna { Returntype : Bio::EnsEMBL::TranscriptMapper Exceptions : none Caller : cdna2genomic, pep2genomic, genomic2cdna, cdna2genomic + Status : Stable =cut @@ -1492,6 +1546,7 @@ sub get_TranscriptMapper { Usage : $start_exon = $transcript->start_Exon; Returns : The first exon in the transcript. Args : NONE + Status : Stable =cut @@ -1506,6 +1561,7 @@ sub start_Exon{ Usage : $end_exon = $transcript->end_Exon; Returns : The last exon in the transcript. Args : NONE + Status : Stable =cut @@ -1523,7 +1579,7 @@ sub end_Exon{ Function: Returns : value of description Args : newvalue (optional) - + Status : Stable =cut @@ -1541,6 +1597,7 @@ sub description{ Function: Returns : value of version Args : + Status : Stable =cut @@ -1558,7 +1615,7 @@ sub version{ Function: Returns : value of stable_id Args : - + Status : Stable =cut @@ -1568,6 +1625,18 @@ sub stable_id{ return $self->{'stable_id'}; } +=head2 created_date + + Arg [1] : (optional) string to be used for the created date + Example : none + Description: get/set for attribute created date + Returntype : string + Exceptions : none + Caller : general + Status : Stable + +=cut + sub created_date { my $self = shift; $self->{'created_date'} = shift if ( @_ ); @@ -1575,6 +1644,18 @@ sub created_date { } +=head2 modified_date + + Arg [1] : (optional) string to be used for the modified date + Example : none + Description: get/set for attribute modified date + Returntype : string + Exceptions : none + Caller : general + Status : Stable + +=cut + sub modified_date { my $self = shift; $self->{'modified_date'} = shift if ( @_ ); @@ -1596,6 +1677,7 @@ sub modified_date { Returntype : none Exceptions : none Caller : GeneAdaptor->store() + Status : Stable =cut @@ -1634,6 +1716,8 @@ sub swap_exons { Returntype : Bio::EnsEMBL::Transcript Exceptions : wrong parameters Caller : general + Status : Medium Risk + : deprecation needs to be removed at some time =cut @@ -1707,6 +1791,7 @@ sub transform { Returntype : Bio::EnsEMBL::Transcript Exceptions : none Caller : general + Status : Stable =cut @@ -1775,6 +1860,7 @@ sub transfer { Returntype : none Exceptions : none Caller : internal + Status : Stable =cut @@ -1847,6 +1933,7 @@ sub recalculate_coordinates { Returntype : string Exceptions : none Caller : web drawing code + Status : Stable =cut @@ -1858,7 +1945,10 @@ sub display_id { =head2 get_all_peptide_variations -Description: See Bio::EnsEMBL::Utils::TranscriptSNPs::get_all_peptide_variations + Description: See Bio::EnsEMBL::Utils::TranscriptSNPs::get_all_peptide_variations + Status : At Risk + : Will be replaced with modules from the ensembl-variation package + =cut @@ -1876,7 +1966,10 @@ sub get_all_peptide_variations { =head2 get_all_SNPs -Description: See Bio::EnsEMBL::Utils::TranscriptSNPs::get_all_SNPs + Description: See Bio::EnsEMBL::Utils::TranscriptSNPs::get_all_SNPs + + Status : At Risk + : Will be replaced with modules from the ensembl-variation package =cut @@ -1884,9 +1977,12 @@ sub get_all_SNPs { return Bio::EnsEMBL::Utils::TranscriptSNPs::get_all_SNPs(@_); } -=head2 get_all_peptide_variations +=head2 get_all_cdna_SNPs -Description: See Bio::EnsEMBL::Utils::TranscriptSNPs::get_all_cdna_SNPs + Description: See Bio::EnsEMBL::Utils::TranscriptSNPs::get_all_cdna_SNPs + + Status : At Risk + : Will be replaced with modules from the ensembl-variation package =cut @@ -1903,6 +1999,7 @@ sub get_all_cdna_SNPs { Exceptions: Caller : Example : $dasref = $prot->get_all_DASFactories + Status : Stable =cut @@ -1923,6 +2020,7 @@ sub get_all_DASFactories { Returntype : hashref of Bio::SeqFeatures Exceptions : ? Caller : webcode + Status : Stable =cut @@ -1963,6 +2061,7 @@ sub get_all_DAS_Features{ Returntype : Listref of Bio::EnsEMBL::RegulatoryFeature Exceptions : If arg is not of correct type. Caller : ? + Status : At Risk =cut diff --git a/modules/Bio/EnsEMBL/TranscriptMapper.pm b/modules/Bio/EnsEMBL/TranscriptMapper.pm index 966bf1a105..d8b6d713b1 100644 --- a/modules/Bio/EnsEMBL/TranscriptMapper.pm +++ b/modules/Bio/EnsEMBL/TranscriptMapper.pm @@ -65,8 +65,9 @@ use Bio::EnsEMBL::Mapper::Coordinate; 'Genomic' coordinates are coordinates which are relative to the slice that the Transcript is on. Returntype : Bio::EnsEMBL::TranscriptMapper - Exceptions : none + Exceptions : throws if a transcript is not an argument Caller : Transcript::get_TranscriptMapper + Status : Stable =cut @@ -99,6 +100,18 @@ sub new { } +=head2 _load_mapper + + Arg [1] : Bio::EnsEMBL::Transcript $transcript + The transcript for which a mapper should be created. + Example : my $mapper = _load_mapper($transcript); + Description: loads the mapper + Returntype : Bio::EnsEMBL::Mapper + Exceptions : none + Caller : Internal + Status : Stable + +=cut sub _load_mapper { my $transcript = shift; @@ -209,8 +222,9 @@ sub _load_mapper { return value is a list of coordinates and gaps. Returntype : list of Bio::EnsEMBL::Mapper::Coordinate and Bio::EnsEMBL::Mapper::Gap objects - Exceptions : none + Exceptions : throws if no start or end Caller : general + Status : Stable =cut @@ -234,7 +248,7 @@ sub cdna2genomic { The start position in genomic coordinates Arg [2] : $end The end position in genomic coordinates - Arg [3] : (optional) $strand + Arg [3] : $strand The strand of the genomic coordinates (default value 1) Example : @coords = $trans_mapper->genomic2cdna($start, $end, $strnd); Description: Converts genomic coordinates to cdna coordinates. The @@ -244,8 +258,9 @@ sub cdna2genomic { represent genomic regions which map to exons (utrs included). Returntype : list of Bio::EnsEMBL::Mapper::Coordinate and Bio::EnsEMBL::Mapper::Gap objects - Exceptions : none + Exceptions : throws if start, end or strand not defined Caller : general + Status : Stable =cut @@ -277,8 +292,9 @@ sub genomic2cdna { transcript used to construct this TranscriptMapper was on. Returntype : list of Bio::EnsEMBL::Mapper::Gap and Bio::EnsEMBL::Mapper::Coordinate objects - Exceptions : none + Exceptions : throws if no end Caller : general + Status : Stable =cut @@ -312,8 +328,9 @@ sub pep2genomic { transcript that was used to create this transcript mapper. Returntype : list of Bio::EnsEMBL::Mapper::Coordinate and Bio::EnsEMBL::Mapper::Gap objects - Exceptions : throw if incorrect arguments + Exceptions : throw if start, end or strand not defined Caller : general + Status : Stable =cut @@ -405,8 +422,9 @@ sub genomic2cds { return value is a list of coordinates and gaps. Returntype : list of Bio::EnsEMBL::Mapper::Coordinate and Bio::EnsEMBL::Mapper::Gap objects - Exceptions : none + Exceptions : throw if start, end or strand not defined Caller : general + Status : Stable =cut diff --git a/modules/Bio/EnsEMBL/Translation.pm b/modules/Bio/EnsEMBL/Translation.pm index b852973482..5726d42e5c 100755 --- a/modules/Bio/EnsEMBL/Translation.pm +++ b/modules/Bio/EnsEMBL/Translation.pm @@ -56,6 +56,8 @@ use Bio::EnsEMBL::Storable; Arg [-SEQ] : Manually sets the peptide sequence of this translation. May be useful if this translation is not stored in a database. + Arg [-CREATED_DATE]: the date the translation was created + Arg [-MODIFIED_DATE]: the date the translation was modified Example : my $tl = Bio::EnsEMBL::Translation->new (-START_EXON => $ex1, -END_EXON => $ex2, @@ -65,6 +67,7 @@ use Bio::EnsEMBL::Storable; Returntype : Bio::EnsEMBL::Translation Exceptions : none Caller : general + Status : Stable =cut @@ -106,7 +109,7 @@ sub new { the exon given by start_exon_id. Returns : value of start Args : newvalue (optional) - + Status : Stable =cut @@ -130,6 +133,7 @@ sub start{ the exon given by end_exon. Returns : value of end Args : newvalue (optional) + Status : Stable =cut @@ -155,6 +159,7 @@ sub end { position indicated by start, see above). Returns : value of start_exon (Exon object) Args : newvalue (optional) + Status : Stable =cut @@ -184,7 +189,7 @@ sub start_Exon { position indicated by end, see above). Returns : value of end_exon (Exon object) Args : newvalue (optional) - + Status : Stable =cut @@ -211,6 +216,7 @@ sub end_Exon { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -229,6 +235,7 @@ sub version { Returntype : string Exceptions : none Caller : general + Status : Stable =cut @@ -238,6 +245,18 @@ sub stable_id { return $self->{'stable_id'}; } +=head2 created_date + + Arg [1] : (optional) string to be used for the created date + Example : none + Description: get/set for attribute created date + Returntype : string + Exceptions : none + Caller : general + Status : Stable + +=cut + sub created_date { my $self = shift; $self->{'created_date'} = shift if ( @_ ); @@ -245,6 +264,18 @@ sub created_date { } +=head2 modified_date + + Arg [1] : (optional) string to be used for the modified date + Example : none + Description: get/set for attribute modified date + Returntype : string + Exceptions : none + Caller : general + Status : Stable + +=cut + sub modified_date { my $self = shift; $self->{'modified_date'} = shift if ( @_ ); @@ -262,6 +293,7 @@ sub modified_date { Returntype: none Exceptions: none Caller : Transcript->transform() + Status : Stable =cut @@ -299,6 +331,7 @@ sub transform { Returntype : list reference to Bio::EnsEMBL::DBEntry objects Exceptions : none Caller : get_all_DBLinks, TranslationAdaptor::store + Status : Stable =cut @@ -333,6 +366,7 @@ sub get_all_DBEntries { Returntype : none Exceptions : thrown on incorrect argument type Caller : general + Status : Stable =cut @@ -358,6 +392,7 @@ sub add_DBEntry { Returntype : see get_all_DBEntries Exceptions : none Caller : general + Status : Stable =cut @@ -382,6 +417,7 @@ sub get_all_DBLinks { Returntype : Bio::EnsEMBL::ProteinFeature Exceptions : none Caller : general + Status : Stable =cut @@ -446,6 +482,7 @@ sub get_all_ProteinFeatures { Returntype : listref of Bio::EnsEMBL::ProteinFeatures Exceptions : none Caller : webcode (protview) + Status : Stable =cut @@ -479,6 +516,7 @@ sub get_all_DomainFeatures{ Returntype : string Exceptions : none Caller : web drawing code + Status : Stable =cut @@ -497,6 +535,7 @@ sub display_id { Returntype : int Exceptions : none Caller : webcode (protview etc.) + Status : Stable =cut @@ -521,6 +560,7 @@ sub length { Exceptions : warning if the sequence is not set and cannot be retrieved from the database. Caller : webcode (protview etc.) + Status : Stable =cut @@ -565,6 +605,7 @@ sub seq { Exceptions : warning if translation does not have attached adaptor and attempts lazy load. Caller : general, modify_translation + Status : Stable =cut @@ -604,6 +645,7 @@ sub get_all_Attributes { Returntype : none Exceptions : throw on incorrect arguments Caller : general + Status : Stable =cut @@ -632,6 +674,7 @@ sub add_Attributes { Returntype : Bio::EnsEMBL::SeqEdit Exceptions : none Caller : spliced_seq() + Status : Stable =cut @@ -660,6 +703,7 @@ sub get_all_SeqEdits { Returntype : Bio::Seq Exceptions : Caller : Bio::EnsEMBL::Transcript->translate + Status : Stable =cut @@ -704,8 +748,9 @@ sub temporary_id { Function : Retrieves a listref of registered DAS objects Returntype: [ DAS_objects ] Exceptions: - Caller : + Caller : webcode Example : $dasref = $prot->get_all_DASFactories + Status : Stable =cut @@ -727,6 +772,7 @@ sub get_all_DASFactories { Returntype : hashref of Bio::SeqFeatures Exceptions : ? Caller : webcode + Status : Stable =cut @@ -763,7 +809,7 @@ sub get_all_DASFeatures{ Returntype : hashref of Bio::SeqFeatures Exceptions : ? Caller : webcode - + Status : Stable =cut @@ -807,6 +853,9 @@ sub get_all_DAS_Features{ Returntype : Listref of Bio::EnsEMBL::RegulatoryFeature Exceptions : If arg is not of correct type. Caller : ? + Status : At Risk + : Regulatory features are currently under development and are + : likely to change. =cut diff --git a/modules/Bio/EnsEMBL/Upstream.pm b/modules/Bio/EnsEMBL/Upstream.pm index 06546eefd3..f467354267 100644 --- a/modules/Bio/EnsEMBL/Upstream.pm +++ b/modules/Bio/EnsEMBL/Upstream.pm @@ -70,6 +70,7 @@ use Bio::EnsEMBL::Utils::Argument qw(rearrange); Returntype : Bio::EnsEMBL::Upstream Exceptions : none Caller : Bio::EnsEMBL::Transcript, general + Status : Stable =cut @@ -100,6 +101,7 @@ sub new { or a Bio::EnsEMBL::Transcript Caller : $self->new, $self->_derive_coords, $self->_first_coding_Exon + Status : Stable =cut @@ -128,6 +130,7 @@ sub transcript { Returntype : int Exceptions : Throws if length is requested before it has been set. Caller : $self->new, $self->_derive_coords + Status : Stable =cut @@ -154,6 +157,7 @@ sub length { Returntype : none Exceptions : none Caller : $self->length, $self->transform + Status : Stable =cut @@ -178,6 +182,7 @@ sub _flush_cache { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -209,6 +214,7 @@ sub upstart { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -238,6 +244,7 @@ sub upend { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -267,6 +274,7 @@ sub downstart { Returntype : int Exceptions : none Caller : general + Status : Stable =cut @@ -293,6 +301,7 @@ sub downend { Returntype : Exceptions : Caller : + Status : At Risk =cut @@ -315,6 +324,7 @@ sub transform { Returntype : arrayref Exceptions : none Caller : general + Status : Stable =cut @@ -334,6 +344,7 @@ sub derive_upstream_coords { Returntype : arrayref Exceptions : none Caller : general + Status : Stable =cut @@ -353,6 +364,7 @@ sub derive_downstream_coords { Exceptions : Throws if argument is not either 'up' or 'down' Caller : $self->upstart, $self->upend, $self->downstart, $self->downend + Status : Stable =cut @@ -449,6 +461,7 @@ sub _derive_coords { Exceptions : Throws if argument is not either 'right_end' or 'left_end' Caller : $self->_derive_coords + Status : Stable =cut @@ -531,6 +544,7 @@ sub _bases_to_trim { Returntype : Bio::EnsEMBL::Exon Exceptions : none Caller : $self->_derive_coords, $self->_bases_to_trim + Status : Stable =cut -- GitLab