ads.Document¶
- class ads.Document(*args, **kwargs)[source]¶
A document in the SAO/NASA Astrophysics Data System.
- __init__(*args, **kwargs)¶
Methods
__init__
(*args, **kwargs)add_index
(*fields, **kwargs)alias
([alias])bind
(database[, bind_refs, bind_backrefs, ...])bind_ctx
(database[, bind_refs, bind_backrefs])bulk_create
(model_list[, batch_size])bulk_update
(model_list, fields[, batch_size])citations
(expression)Return documents that cite documents returned by the given expression.
citis
(expression)A different implementation of
ads.Document.citations
that uses less memory, but is slower.classic_relevance
(expression)A toy implementation of the ADS Classic relevance score algorithm.
clone
()coerce
([_coerce])copy
(method)create
(**query)create_table
([safe])delete
()delete_by_id
(pk)delete_instance
([recursive, delete_nullable])dependencies
([search_nullable])drop_table
([safe, drop_sequences])filter
(*dq_nodes, **filters)get
(*query, **filters)get_by_id
(pk)get_id
()get_or_create
(**kwargs)get_or_none
(*query, **filters)index
(*fields, **kwargs)insert
([_Model__data])insert_from
(query, fields)insert_many
(rows[, fields])instructive
(expression)Return documents that are the synonymn of
ads.Document.reviews
.is_alias
()is_dirty
()join_citations
(expression)This operator is the equivalent of
ads.Document.citations
but using a Lucene block-join.join_references
(expression)This operator is the equivalent of
ads.Document.references
but using a Lucene block-join.noop
()pos
(expression, position[, end_position])Return documents where the given expression is matched only by an item in a given position, or range of positions (e.g., author or affiliation position).
raw
(sql, *params)references
(expression)Return documents that are cited by documents in the given expression.
replace
([_Model__data])replace_many
(rows[, fields])reviews
(expression)The reviews operator takes the list of articles which cited the papers in the given expression, combines them, and returns this list sorted by how frequently a citing paper appears in the combined list.
reviews2
(expression)The original implementation of the
ads.Document.reviews
operator.save
([force_insert, only])select
(*fields)set_by_id
(key, value)similar
(expression)Return documents that have abstracts similar in wording to documents returned by the given expression.
table_exists
()top_n
(n, expression[, order_by])Return the top n documents matching the given expression.
trending
(expression)Query documents that are most read by users who read recent papers on the topic being researched.
truncate_table
(**options)unwrap
()update
([_Model__data])useful
(expression)Return documents frequently cited by the most relevant papers returned by the given expression.
useful2
(expression)The original implementation of the
ads.Document.useful
operator.validate_model
()Attributes
Search for a word or phrase in
ads.Document.abstract
,ads.Document.title
, andads.Document.keyword
.The document abstract.
Search for a word or phrase in the acknowledgements extracted from fulltexts.
The raw, provided affiliation field.
Curated affiliation identifier, parsed from the given affiliation string.
Any
ads.Affiliation
objects associated with the record, parsed from theads.Document.aff_id
field.Search by
ads.Document.author_norm
,ads.Document.alternate_title
,ads.Document.bibcode
,ads.Document.doi
, andads.Document.identifier
.An alternate bibcode.
Alternate title, usually present when the original title is not in English.
Search by arXiv identifier.
The arXiv class a document was submitted to.
Author name.
The number of authors.
Author name in the form 'Lastname, F'.
Document bibliographic code.
Records by bibliographic groups, curated by staff outside of ADS.
Abbreviated name of the journal or publication (e.g., ApJ).
Search for a word or phrase in (only) the full text.
The number of citations to this document.
Normalised citation count.
The normalized boost factor.
A classic prestige score, designed to more highly rank papers that are relevant and popular now.
Related data sources.
The database the document resides in (e.g., astronomy or physics).
Publication date, represented by a time format and used for indexing.
dirty_fields
Document type (e.g., article, thesis, etc.
Digital object identifier
Electronic identifier of the paper, which is the equivalent of a page number.
Email addresses of the authors.
Creation date of the ADS record.
Types of electronic sources available for a record (e.g.,
PUB_HTML
,EPRINT_PDF
).Facilities declared in a record, based on a controlled list by AAS journals.
Search by
ads.Document.title
,ads.Document.abstract
,ads.Document.body
,ads.Document.keyword
, andads.Document.ack
.Search by grant identifiers and grant agencies (
ads.Document.grant_id
andads.Document.grant_agencies
).A field with just the grant agencies name (e.g., NASA).
Search by grant identifier.
A unique identifier for the document, curated by ADS.
Search by an array of alternative identifiers for a record.
Datetime when the document was last index by the ADS Solr service.
Find records that contain a curated (ADS-identified) affiliation or institution.
International Standard Book Number
International Standard Serial NUmber
Issue number of the journal that includes the article.
The
ads.Journal
associated with the record, parsed from theads.Document.bibcode
field.An array of normalized and non-normalized keyword values associated with the record.
The language of the main title.
library_set
Information on what linked documents are available.
List of NED IDs for a record.
Keywords used to describe the NED type (e.g., galaxy, star).
Search by ORCID identifier, from all possible sources:
ads.Document.orcid_other
,ads.Document.orcid_pub
, andads.Document.orcid_user
.ORCID claims from users who used the ADS claiming interface.
ORCIDs supplied by publishers.
ORCID claims from users who gave ADS consent to expose their public profile.
Page number of a record.
The difference between the first and last page numbers in
ads.Document.page_range
.An array of miscellaneous flags associated with a record.
The canonical name of the publication that the record appeared in.
Name of the publisher, but also includes the volume, page, and issue if exists.
Publication date in the form YYYY-MM-DD, where DD will always be '00'.
The number of times the record has been viewed within a 90 day window.
The closeness of the document to the query match.
List of SIMBAD IDs within a document.
Keywords used to describe the SIMBAD type.
The title of the record.
Keywords, 'subject' tags from Vizier.
The journal volume.
Year of publication.
- id = <IntegerField: Document.id>¶
A unique identifier for the document, curated by ADS.
- abstract = <TextField: Document.abstract>¶
The document abstract.
- ack = <VirtualField: Document.ack>¶
Search for a word or phrase in the acknowledgements extracted from fulltexts.
- aff = <ArrayField: Document.aff>¶
The raw, provided affiliation field.
- aff_id = <ArrayField: Document.aff_id>¶
Curated affiliation identifier, parsed from the given affiliation string. See https://ui.adsabs.harvard.edu/blog/affils-update for more details.
- alternate_bibcode = <ArrayField: Document.alternate_bibcode>¶
An alternate bibcode.
- alternate_title = <TextField: Document.alternate_title>¶
Alternate title, usually present when the original title is not in English.
- arxiv_class = <TextField: Document.arxiv_class>¶
The arXiv class a document was submitted to.
- author = <ArrayField: Document.author>¶
Author name.
- author_count = <IntegerField: Document.author_count>¶
The number of authors.
- author_norm = <ArrayField: Document.author_norm>¶
Author name in the form ‘Lastname, F’.
- bibcode = <TextField: Document.bibcode>¶
Document bibliographic code. See https://ui.adsabs.harvard.edu/help/actions/bibcode for more information.
- bibgroup = <TextField: Document.bibgroup>¶
Records by bibliographic groups, curated by staff outside of ADS.
- bibstem = <ArrayField: Document.bibstem>¶
Abbreviated name of the journal or publication (e.g., ApJ).
- body = <VirtualField: Document.body>¶
Search for a word or phrase in (only) the full text.
- citation_count = <IntegerField: Document.citation_count>¶
The number of citations to this document.
- citation_count_norm = <FloatField: Document.citation_count_norm>¶
Normalised citation count.
- cite_read_boost = <IntegerField: Document.cite_read_boost>¶
The normalized boost factor.
- classic_factor = <FloatField: Document.classic_factor>¶
A classic prestige score, designed to more highly rank papers that are relevant and popular now.
- data = <TextField: Document.data>¶
Related data sources.
- database = <ArrayField: Document.database>¶
The database the document resides in (e.g., astronomy or physics).
- date = <DateTimeField: Document.date>¶
Publication date, represented by a time format and used for indexing.
- doctype = <TextField: Document.doctype>¶
Document type (e.g., article, thesis, etc.
- doi = <ArrayField: Document.doi>¶
Digital object identifier
- eid = <TextField: Document.eid>¶
Electronic identifier of the paper, which is the equivalent of a page number.
- email = <ArrayField: Document.email>¶
Email addresses of the authors.
- entry_date = <DateTimeField: Document.entry_date>¶
Creation date of the ADS record.
- esources = <ArrayField: Document.esources>¶
Types of electronic sources available for a record (e.g.,
PUB_HTML
,EPRINT_PDF
).
- facility = <ArrayField: Document.facility>¶
Facilities declared in a record, based on a controlled list by AAS journals.
- grant = <TextField: Document.grant>¶
Search by grant identifiers and grant agencies (
ads.Document.grant_id
andads.Document.grant_agencies
).
- grant_agencies = <TextField: Document.grant_agencies>¶
A field with just the grant agencies name (e.g., NASA).
- grant_id = <TextField: Document.grant_id>¶
Search by grant identifier.
- identifier = <ArrayField: Document.identifier>¶
Search by an array of alternative identifiers for a record. May contain alternative bibcodes, DOIs, and/or arXiv identifiers.
- indexstamp = <DateTimeField: Document.indexstamp>¶
Datetime when the document was last index by the ADS Solr service.
- inst = <VirtualField: Document.inst>¶
Find records that contain a curated (ADS-identified) affiliation or institution. See also:
ads.Document.affiliation
.
- isbn = <TextField: Document.isbn>¶
International Standard Book Number
- issn = <ArrayField: Document.issn>¶
International Standard Serial NUmber
- issue = <TextField: Document.issue>¶
Issue number of the journal that includes the article.
- keyword = <TextField: Document.keyword>¶
An array of normalized and non-normalized keyword values associated with the record.
- lang = <TextField: Document.lang>¶
The language of the main title.
- links_data = <TextField: Document.links_data>¶
Information on what linked documents are available.
- nedid = <ArrayField: Document.nedid>¶
List of NED IDs for a record.
- nedtype = <ArrayField: Document.nedtype>¶
Keywords used to describe the NED type (e.g., galaxy, star).
- orcid_other = <ArrayField: Document.orcid_other>¶
ORCID claims from users who used the ADS claiming interface.
- orcid_pub = <ArrayField: Document.orcid_pub>¶
ORCIDs supplied by publishers.
- orcid_user = <ArrayField: Document.orcid_user>¶
ORCID claims from users who gave ADS consent to expose their public profile.
- page = <ArrayField: Document.page>¶
Page number of a record.
- page_count = <IntegerField: Document.page_count>¶
The difference between the first and last page numbers in
ads.Document.page_range
.
- property = <ArrayField: Document.property>¶
An array of miscellaneous flags associated with a record. Examples include: refereed, notrefereed, article, nonarticle, ads_openaccess, eprint_openaccess, pub_openaccess, openaccess, ocrabstract.
- pub = <TextField: Document.pub>¶
The canonical name of the publication that the record appeared in.
- pub_raw = <TextField: Document.pub_raw>¶
Name of the publisher, but also includes the volume, page, and issue if exists.
- pubdate = <DateField: Document.pubdate>¶
Publication date in the form YYYY-MM-DD, where DD will always be ‘00’.
- read_count = <IntegerField: Document.read_count>¶
The number of times the record has been viewed within a 90 day window.
- score = <FloatField: Document.score>¶
The closeness of the document to the query match.
- simbid = <ArrayField: Document.simbid>¶
List of SIMBAD IDs within a document. This field has privacy restrictions.
- simbtype = <ArrayField: Document.simbtype>¶
Keywords used to describe the SIMBAD type.
- title = <ArrayField: Document.title>¶
The title of the record.
- vizier = <TextField: Document.vizier>¶
Keywords, ‘subject’ tags from Vizier.
- volume = <IntegerField: Document.volume>¶
The journal volume.
- year = <IntegerField: Document.year>¶
Year of publication.
- affiliation = <AffiliationField: Document.affiliation>¶
Any
ads.Affiliation
objects associated with the record, parsed from theads.Document.aff_id
field.
- journal = <JournalField: Document.journal>¶
The
ads.Journal
associated with the record, parsed from theads.Document.bibcode
field.
- abs = <VirtualField: Document.abs>¶
Search for a word or phrase in
ads.Document.abstract
,ads.Document.title
, andads.Document.keyword
.
- all = <VirtualField: Document.all>¶
Search by
ads.Document.author_norm
,ads.Document.alternate_title
,ads.Document.bibcode
,ads.Document.doi
, andads.Document.identifier
.
- arxiv = <VirtualField: Document.arxiv>¶
Search by arXiv identifier.
- full = <VirtualField: Document.full>¶
Search by
ads.Document.title
,ads.Document.abstract
,ads.Document.body
,ads.Document.keyword
, andads.Document.ack
.
- orcid = <VirtualField: Document.orcid>¶
Search by ORCID identifier, from all possible sources:
ads.Document.orcid_other
,ads.Document.orcid_pub
, andads.Document.orcid_user
.
- classmethod citations(expression)[source]¶
Return documents that cite documents returned by the given expression.
Do you want
ads.Document.citations
orads.Document.references
?citations(Document.bibcode == "2003AJ....125..525J")
returns documents that cite the document with bibcode2003AJ....125..525J
.references(Document.bibcode == "2003AJ....125..525J")
returns documents that are cited by the document with bibcode2003AJ....125..525J
.
See https://ui.adsabs.harvard.edu/help/search/citations-and-references for more details.
- Parameters
expression – The expression to search for. Documents that cite documents returned by this expression will be returned.
- classmethod citis(expression)[source]¶
A different implementation of
ads.Document.citations
that uses less memory, but is slower.- Parameters
expression – The expression to search for. Documents that cite documents returned by this expression will be returned.
- classmethod classic_relevance(expression)[source]¶
A toy implementation of the ADS Classic relevance score algorithm. You can wrap any query in this operator and obtain the hits sorted (almost) in the ADS Classic way.
- Parameters
expression – The search expression.
- classmethod instructive(expression)[source]¶
Return documents that are the synonymn of
ads.Document.reviews
.- Parameters
expression – The expression to search for instructive papers.
- classmethod join_citations(expression)[source]¶
This operator is the equivalent of
ads.Document.citations
but using a Lucene block-join.In Solr syntax, this operator is called
joincitations()
, notjoin_citations()
.- Parameters
expression – The expression to join citations for.
- classmethod join_references(expression)[source]¶
This operator is the equivalent of
ads.Document.references
but using a Lucene block-join.In Solr syntax, this operator is called
joinreferences()
, notjoin_references()
.- Parameters
expression – The expression to join references for.
- classmethod pos(expression, position, end_position=None)[source]¶
Return documents where the given expression is matched only by an item in a given position, or range of positions (e.g., author or affiliation position).
- Parameters
expression – The search expression to match against.
position – The start position (1-indexed) to match against. For example, if searching by author name then use
position=1
for first author.end_position – [optional] The end position value. If
None
is given (default) then it defaults toposition
.
- classmethod references(expression)[source]¶
Return documents that are cited by documents in the given expression.
Do you want
ads.Document.citations
orads.Document.references
?citations(Document.bibcode == "2003AJ....125..525J")
returns documents that cite the document with bibcode2003AJ....125..525J
.references(Document.bibcode == "2003AJ....125..525J")
returns documents that are cited by the document with bibcode2003AJ....125..525J
.
See https://ui.adsabs.harvard.edu/help/search/citations-and-references for more details.
- Parameters
expression – The search expression to find references for.
- classmethod reviews(expression)[source]¶
The reviews operator takes the list of articles which cited the papers in the given expression, combines them, and returns this list sorted by how frequently a citing paper appears in the combined list.
The documents returned cite the most relevant papers on the topic being researched; these are papers containing the most extensive reviews of the field.
See https://ui.adsabs.harvard.edu/help/search/second-order for more details.
- Parameters
expression – The expression to find reviews articles for.
- classmethod reviews2(expression)[source]¶
The original implementation of the
ads.Document.reviews
operator.- Parameters
expression – The expression to find reviews articles for.
- classmethod similar(expression)[source]¶
Return documents that have abstracts similar in wording to documents returned by the given expression.
See https://ui.adsabs.harvard.edu/help/search/second-order for more details.
- Parameters
expression – The expression to use to find documents to compare against.
- classmethod top_n(n, expression, order_by=None)[source]¶
Return the top n documents matching the given expression.
In Solr syntax, this operator is called
topn()
, nottop_n()
.- Parameters
n – The number of documents to return.
expression – The expression to query documents.
- classmethod trending(expression)[source]¶
Query documents that are most read by users who read recent papers on the topic being researched. These are papers currently being read by people interested in this field.
See https://ui.adsabs.harvard.edu/help/search/second-order for more details.
- Parameters
expression – The expression to search for trending documents.
- classmethod useful(expression)[source]¶
Return documents frequently cited by the most relevant papers returned by the given expression.
These are usually studies that discuss methods and techniques useful to conduct research in the field.
- Parameters
expression – The search expression to find useful articles for.
- classmethod useful2(expression)[source]¶
The original implementation of the
ads.Document.useful
operator.- Parameters
expression – The expression to search for useful documents.
- DoesNotExist¶
alias of
ads.models.document.DocumentDoesNotExist