ensembl-hive
2.1
|
Public Member Functions | |
public | new () |
public | param_init () |
protected | _param_possibly_overridden () |
protected | _param_silent () |
public Any | param_required () |
public Boolean | param_exists () |
public Boolean | param_is_defined () |
public Any | param () |
public | param_substitute () |
public | mysql_conn () |
public | mysql_dbname () |
public | csvq () |
protected | _subst_one_hashpair () |
Most of Compara RunnableDB methods work under assumption that both analysis.parameters and job.input_id fields contain a Perl-style parameter hashref as a string. This module implements a generic param() method that allows to set parameters according to the following parameter precedence rules: (1) Job-Specific parameters defined in job.input_id hash, they have the highest priority and override everything else. (2) Analysis-Wide parameters defined in analysis.parameters hash. Can be overridden by (1). (3) Pipeline-Wide parameters defined in the 'meta' table. Can be overridden by (1) and (2). (4) Module_Defaults that are hard-coded into modules have the lowest precedence. Can be overridden by (1), (2) and (3).
protected Bio::EnsEMBL::Hive::Params::_param_possibly_overridden | ( | ) |
Undocumented method
protected Bio::EnsEMBL::Hive::Params::_param_silent | ( | ) |
Undocumented method
protected Bio::EnsEMBL::Hive::Params::_subst_one_hashpair | ( | ) |
Description: this is a private method that performs one substitution. Called by param_substitute().
public Bio::EnsEMBL::Hive::Params::csvq | ( | ) |
Undocumented method
public Bio::EnsEMBL::Hive::Params::mysql_conn | ( | ) |
Undocumented method
public Bio::EnsEMBL::Hive::Params::mysql_dbname | ( | ) |
Undocumented method
public Bio::EnsEMBL::Hive::Params::new | ( | ) |
public Any Bio::EnsEMBL::Hive::Params::param | ( | ) |
Arg [1] : string $param_name
Arg [2] : (optional) $param_value
Description: A getter/setter method for a job's parameters that are initialized through 4 levels of precedence (see param_init() )
Example 1 : my $source = $self->param('source'); # acting as a getter
Example 2 : $self->param('binpath', '/software/ensembl/compara'); # acting as a setter
Returntype : any Perl structure or object that you dared to store
public Boolean Bio::EnsEMBL::Hive::Params::param_exists | ( | ) |
Arg [1] : string $param_name
Description: A predicate tester for whether the parameter has been initialized (even to undef)
Example :
Returntype : boolean
public Bio::EnsEMBL::Hive::Params::param_init | ( | ) |
Description: First parses the parameters from all sources in the reverse precedence order (supply the lowest precedence hash first), then preforms "total" parameter substitution. Will fail on detecting a substitution loop.
public Boolean Bio::EnsEMBL::Hive::Params::param_is_defined | ( | ) |
Arg [1] : string $param_name
Description: A predicate tester for definedness of a parameter
Example :
Returntype : boolean
public Any Bio::EnsEMBL::Hive::Params::param_required | ( | ) |
Arg [1] : string $param_name
Description: A strict getter method for a job's parameter; will die if the parameter was not set or is undefined
Example :
Returntype : any Perl structure or object that you dared to store
public Bio::EnsEMBL::Hive::Params::param_substitute | ( | ) |
Arg [1] : Perl structure $string_with_templates
Description: Performs parameter substitution on strings that contain templates like " #param_name# followed by #another_param_name# " .
Returntype : *another* Perl structure with matching topology (may be more complex as a result of substituting a substructure for a term)