trackhub.Genome

digraph inheritance30c3775cc1 { bgcolor=transparent; rankdir=LR; size="8.0, 12.0"; "trackhub.base.HubComponent" [URL="trackhub.base.HubComponent.html#trackhub.base.HubComponent",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Base class for various track hub components. Several methods must be"]; "trackhub.genome.Genome" [URL="#trackhub.Genome",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top"]; "trackhub.base.HubComponent" -> "trackhub.genome.Genome" [arrowsize=0.5,style="setlinewidth(0.5)"]; }
class trackhub.Genome(genome, trackdb=None, genome_file_obj=None, **kwargs)[source]

Bases: HubComponent

Represents a 2-line genome stanza within a “genomes.txt” file.

The file itself is represented by a GenomesFile object.

Parameters:
  • genome (str) – One of the UCSC-supported assembly names (e.g., “hg38”)

  • trackdb (TrackDb object) – If not None, this object will be attached as the child track db

  • genome_file (GenomesFile object) – If not None, this object will be attached as the parent GenomesFile

Methods

__init__(genome[, trackdb, genome_file_obj])

Represents a 2-line genome stanza within a "genomes.txt" file.

add_child(child)

Adds self as parent to child, and then adds child.

add_params(**kw)

Add [possibly many] parameters to the Genome.

add_parent(parent)

Adds self as child of parent, then adds parent.

add_trackdb(trackdb)

leaves(cls[, level, intermediate])

Returns an iterator of the HubComponent leaves that are of class cls.

makedirs(fn)

remove_params(*args)

Remove [possibly many] parameters from the Genome.

render([staging])

Renders the object to file, returning a list of created files.

root([cls, level])

Returns the top-most HubComponent in the hierarchy.

validate()

Runs validation, raising exceptions as needed.

__init__(genome, trackdb=None, genome_file_obj=None, **kwargs)[source]

Represents a 2-line genome stanza within a “genomes.txt” file.

The file itself is represented by a GenomesFile object.

Parameters:
  • genome (str) – One of the UCSC-supported assembly names (e.g., “hg38”)

  • trackdb (TrackDb object) – If not None, this object will be attached as the child track db

  • genome_file (GenomesFile object) – If not None, this object will be attached as the parent GenomesFile

add_child(child)

Adds self as parent to child, and then adds child.

add_params(**kw)[source]

Add [possibly many] parameters to the Genome.

Parameters will be checked against known UCSC parameters and their supported formats.

add_parent(parent)

Adds self as child of parent, then adds parent.

leaves(cls, level=0, intermediate=False)

Returns an iterator of the HubComponent leaves that are of class cls.

If intermediate is True, then return any intermediate classes as well.

remove_params(*args)[source]

Remove [possibly many] parameters from the Genome.

E.g.,

remove_params(‘color’, ‘visibility’)

render(staging=None)

Renders the object to file, returning a list of created files.

Calls validation code, and, as long as each child is also a subclass of HubComponent, the rendering is recursive.

root(cls=None, level=0)

Returns the top-most HubComponent in the hierarchy.

If cls is not None, then return the top-most attribute HubComponent that is an instance of class cls.

For a fully-constructed track hub (and cls=None), this should return a a Hub object for every component in the hierarchy.

validate()[source]

Runs validation, raising exceptions as needed. Must be overridden by subclass.