DOKK / manpages / debian 12 / libbio-perl-run-perl / Bio::DB::SoapEUtilities::DocSumAdaptor.3pm.en
Bio::DB::SoapEUtilities::DocSumAdaptor(3pm) User Contributed Perl Documentation Bio::DB::SoapEUtilities::DocSumAdaptor(3pm)

Bio::DB::SoapEUtilities::DocSumAdaptor - Handle for Entrez SOAP DocSums

 my $fac = Bio::DB::SoapEUtilities->new();
 # run a query, returning a DocSumAdaptor
 my $docs = $fac->esummary( -db => 'taxonomy',
                            -id => 527031 )->run(-auto_adapt=>1);
 # iterate over docsums
 while (my $d = $docs->next_docsum) {
    @available_items = $docsum->item_names;
    # any available item can be called as an accessor
    # from the docsum object...watch your case...
    $sci_name = $d->ScientificName;
    $taxid = $d->TaxId;
 }

This adaptor provides an iterator ("next_docsum()") and other convenience functions for parsing NCBI Entrez EUtility "esummary" SOAP results.

User feedback is an integral part of the evolution of this and other Bioperl modules. Send your comments and suggestions preferably to the Bioperl mailing list. Your participation is much appreciated.

  bioperl-l@bioperl.org                  - General discussion
http://bioperl.org/wiki/Mailing_lists  - About the mailing lists

Please direct usage questions or support issues to the mailing list:

bioperl-l@bioperl.org

rather than to the module maintainer directly. Many experienced and reponsive experts will be able look at the problem and quickly address it. Please include a thorough description of the problem with code and data examples if at all possible.

Report bugs to the Bioperl bug tracking system to help us keep track of the bugs and their resolution. Bug reports can be submitted via the web:

  http://redmine.open-bio.org/projects/bioperl/

Email maj -at- fortinbras -dot- us

The rest of the documentation details each of the object methods. Internal methods are usually preceded with a _

 Title   : new
 Usage   : my $obj = new Bio::DB::SoapEUtilities::DocSumAdaptor();
 Function: Builds a new Bio::DB::SoapEUtilities::DocSumAdaptor object
 Returns : an instance of Bio::DB::SoapEUtilities::DocSumAdaptor
 Args    :

next_docsum()

 Title   : next_docsum
 Usage   : 
 Function: return the next DocSum from the attached Result
 Returns : 
 Args    :

item_names()

 Title   : item_names
 Usage   : @accs = $docsum->item_names
 Function: Return a list of items accessible from the 
           object
 Returns : array of scalar strings
 Args    : none
2023-01-22 perl v5.36.0