Provided by: gbrowse_2.56+dfsg-11_all bug

NAME

       Bio::Graphics::Browser2::DataSource -- DataSource to access data

SYNOPSIS

DESCRIPTION

   METHODS
         $path = $source->userdata(@path_components)

         Returns a path to somewhere in the tmp file system for the
         indicated userdata.

   global_setting()
         $setting = $source->global_setting('option')

       Like code_setting() except that it is only for 'general' options. If the option is not
       found in the datasource config file, then looks in the global file.

   $section_setting = $data_source->section_setting($section_name)
       Returns "open" "closed" or "off" for the named section. Named sections are:

        instructions
        search
        overview
        details
        tracks
        display
        upload_tracks

   add_scale_tracks()
       This is called at initialization time to add track configs for the automatic "scale"
       (arrow) tracks for details, overview and regionview

       $db = $dsn->databases
           Return all named databases from [name:database] tracks.

       ($adaptor,@argv) = $dsn->db2args('databasename')
           Given a database named by ['databasename':database], return its adaptor and arguments.

       ($dbid,$adaptor,@argv) = $dsn->db_settings('track_label')
           Return the adaptor and arguments suitable for the database identified by the given
           track label. If no track label is given then the "general" default database is used.

       $db = $dsn->open_database('track')
           Return the database handle specified by the given track label or 'general' if not
           given. The databases are cached and so it is ok to call repeatedly.

       @ids   = $dsn->db2id($db)
       $dbid  = $dsn->db2id($db)
           Given a database handle, return all dbids that correspond to that database. In a
           scalar context, returns just the first dbid that uses it. It is less confusing to call
           in a scalar context.

       @ids   = $dsn->dbs
           Return the names of all the sections that define dbs in the datasource: both track
           sections that define dbargs and named database sections. Note that we do not uniquify
           the case in which the same adaptor and dbargs are defined twice in two different
           sections.

       $dsn->clear_cache
           Empty out our cache of database settings and fetch anew from config file

   generate_image
         ($url,$path) = generate_image($gd);

       Given a GD::Image object, this method calls its png() or gif() methods (depending on GD
       version), stores the output into the temporary "images" subdirectory of the directory
       given by the "tmp_base" option in the configuration file. It returns a two element list
       consisting of the URL to the image and the physical path of the image.

   $source->add_dbid_to_feature($feature,$dbid_hashref)
       This adds a new method called gbrowse_dbid() to a feature. Do not call it if the method is
       already in the feature's class. The hashref should be populated by feature memory
       locations (overload::StrVal($feature)) as keys and database symbolic IDs as values.

   @labels = $source->data_source_to_label(@data_sources)
       Search through all stanzas for those with a matching "data source" option. Data sources
       look like this:

        [stanzaLabel1]
        data source = FlyBase

        [stanzaLabel2]
        data source = FlyBase

       Now searching for $source->data_source_to_label('FlyBase') will return "stanzaLabel1" and
       "stanzaLabel2" along with others that match. A track may have several data sources,
       separated by spaces.

   @labels = $source->track_source_to_label(@track_sources)
       Search through all stanzas for those with a matching "track source" option. Track sources
       look like this:

        [stanzaLabel]
        track source = UCSC EBI NCBI

       Now searching for $source->track_source_to_label('UCSC','EBI') will return "stanzaLabel"
       along with others that match. A track may have several space-delimited track sources.

   $boolean = $source->use_inline_imagemap($label=>$length)
       Given a track label and length (for semantic zooming) return true if we should generate an
       inline clickable imagemap vs one in which the actions are generated by Ajax callbacks