/ 
Astro-ADS-1.90
River stage zero No dependents
/ Astro::ADS::Search

NAME

Astro::ADS::Search - Queries the ADS Search endpoint and collects the results

VERSION

version 1.90

SYNOPSIS

my $search = Astro::ADS::Search->new({
    q  => '...', # initial search query
    fl => '...', # return list of attributes
});

my $result = $search->query();
my @papers = $result->papers();

while ( my $t = $result->next_query() ) {
    $result = $search->query( $t );
    push @papers, $result->get_papers();
}

while ( my $t = $result->next_query() ) {
    push @papers, $result->more_papers( $t );
}

while ( push @papers, $result->next_query()->more_papers() ) {
}

DESCRIPTION

Search for papers in the Harvard ADS

You can put base terms in the creation of the object and use the query method to add new terms to that query only

Methods

query

Adding a field key +q to the query method adds the query term to the existing query terms, whereas specifying a value for q in the query method overwrites the query terms and neglects gathering other search attributes, such as authors or objects.

add_authors

Add a list of authors to a search query. Authors added here will not be deleted if the query attribute is updated.

add_objects

Add a list of objects to a search query. Objects added here will not be deleted if the query attribute is updated.

query_tree

Not implemented yet

Will return the Abstract Syntax Tree for the query.

bigquery

Not implemented yet

Accepts a list of many IDs and supports paging.

Notes

From the ADS API, the "=" sign turns off the synonym expansion feature available with the author and title fields

See Also

*Astro::ADS
*Astro::ADS::Result
*ADS API
*Search Syntax

AUTHOR

Boyd Duffee <duffee@cpan.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2025 by Boyd Duffee.

This is free software, licensed under:

The MIT (X11) License