Class: Bio::PhyloXML::Date

Inherits:
Object
  • Object
show all
Defined in:
lib/bio/phyloxml/elements.rb

Overview

Description

A date associated with a clade/node. Its value can be numerical by using the ‘value’ element and/or free text with the ‘desc’ element’ (e.g. ‘Silurian’). If a numerical value is used, it is recommended to employ the ‘unit’ attribute to indicate the type of the numerical value (e.g. ‘mya’ for ‘million years ago’).

Instance Attribute Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#descObject

Free text description of the date.



790
791
792
# File 'lib/bio/phyloxml/elements.rb', line 790

def desc
  @desc
end

#maximumObject

Integer. Minimum and maximum of the value.



793
794
795
# File 'lib/bio/phyloxml/elements.rb', line 793

def maximum
  @maximum
end

#minimumObject

Integer. Minimum and maximum of the value.



793
794
795
# File 'lib/bio/phyloxml/elements.rb', line 793

def minimum
  @minimum
end

#unitObject

String. Units in which value is stored.



787
788
789
# File 'lib/bio/phyloxml/elements.rb', line 787

def unit
  @unit
end

#valueObject

Integer. Value of the date.



796
797
798
# File 'lib/bio/phyloxml/elements.rb', line 796

def value
  @value
end

Instance Method Details

#to_sObject

Returns value + unit, for exampe “7 mya”



811
812
813
# File 'lib/bio/phyloxml/elements.rb', line 811

def to_s
  return "#{value} #{unit}"
end

#to_xmlObject

Converts elements to xml representation. Called by PhyloXML::Writer class.



816
817
818
819
820
821
822
823
824
825
# File 'lib/bio/phyloxml/elements.rb', line 816

def to_xml
  date = LibXML::XML::Node.new('date')
  PhyloXML::Writer.generate_xml(date, self, [
      [:attr, 'unit'],
      [:simple, 'desc', @desc],
      [:simple, 'value', @value],
      [:simple, 'minimum', @minimum],
      [:simple, 'maximum', @maximum]])
  return date
end