Skip to main content

pyXiver

pyXiver (pyCHIver) is a wrapper for the arXiv public API.

Thank you to arXiv for use of its open access interoperability.

This project is NOT connected to arXiv (arxiv.org) and Cornell University.

Install

pip install pyxiver

Example

import pyxiver
import pprint

printer = pprint.PrettyPrinter()

# Provide query - all params are optional except for the search string (e.g. "black hole")
query = pyxiver.get_all('black hole',
                        search_field="ti",
                        max_results=2,
                        sort_by='submittedDate',
                        sort_order='descending')

# Verbose content - multiple papers
verbose_content = query.verbose
printer.pprint(verbose_content)

# Minimal content - provides only the title, summary, id, and category
minimal_content = query.minimal
printer.pprint(minimal_content)


# Provide the abstract URL found as the "id" key from the list of articles fetched through get_all()
query_one = pyxiver.get_one('http://arxiv.org/abs/2106.05901v1')

# Verbose content - single paper
verbose_content = query_one.verbose
printer.pprint(verbose_content)

# Minimal content - provides only the title, authors, published date, and summary
minimal_content = query_one.minimal
printer.pprint(minimal_content)

Query Params

Get multiple papers

  • query: Query string to search arXiv

  • search_field: Search fields listed below

Prefix Explanation
ti title
au author
all all fields (default)

For more fields, please visit https://arxiv.org/help/api/user-manual#query_details

  • max_results: Count of articles to be returned (default is 10)

  • sort_by: Sort by "relevance", "lastUpdatedDate", "submittedDate" (default is relevance)

  • sort_order: Order by "ascending" or "descending" (default is descending)

Example response for multiple papers

VERBOSE

[{'arxiv:comment': {'#text': 'Submitted to MNRAS. 30 pages, 26 figures. '
                             'Trinity code available at:\n'
                             '  https://github.com/HaowenZhang/TRINITY '
                             'Comments welcome!',
                    '@xmlns:arxiv': 'http://arxiv.org/schemas/atom'},
  'arxiv:primary_category': {'@scheme': 'http://arxiv.org/schemas/atom',
                             '@term': 'astro-ph.GA',
                             '@xmlns:arxiv': 'http://arxiv.org/schemas/atom'},
  'author': [{'name': 'Haowen Zhang'},
             {'name': 'Peter Behroozi'},
             {'name': 'Marta Volonteri'},
             {'name': 'Joseph Silk'},
             {'name': 'Xiaohui Fan'},
             {'name': 'Philip F. Hopkins'},
             {'name': 'Jinyi Yang'},
             {'name': 'James Aird'}],
  'category': {'@scheme': 'http://arxiv.org/schemas/atom',
               '@term': 'astro-ph.GA'},
  'id': 'http://arxiv.org/abs/2105.10474v1',
  'link': [{'@href': 'http://arxiv.org/abs/2105.10474v1',
            '@rel': 'alternate',
            '@type': 'text/html'},
           {'@href': 'http://arxiv.org/pdf/2105.10474v1',
            '@rel': 'related',
            '@title': 'pdf',
            '@type': 'application/pdf'}],
  'published': '2021-05-21T17:26:51Z',
  'summary': 'We present Trinity, a flexible empirical model that '
             'self-consistently infers\n'
             'the statistical connection between dark matter haloes, galaxies, '
             'and\n'
             'supermassive black holes (SMBHs). Trinity is constrained by '
             'galaxy observables\n'
             "from $0 < z < 10$ (galaxies' stellar mass functions, specific "
             'and cosmic SFRs,\n'
             'quenched fractions, and UV luminosity functions) and SMBH '
             'observables from $0 <\n'
             'z < 6.5$ (quasar luminosity functions, quasar probability '
             'distribution\n'
             'functions, active black hole mass functions, local SMBH '
             'mass-bulge mass\n'
             'relations, and the observed SMBH mass distributions of high '
             'redshift bright\n'
             'quasars). The model includes full treatment of observational '
             'systematics (e.g.,\n'
             'AGN obscuration and errors in stellar masses). From these data, '
             'Trinity infers\n'
             'the average SMBH mass, SMBH accretion rate, merger rate, and '
             'Eddington ratio\n'
             'distribution as functions of halo mass, galaxy stellar mass, and '
             'redshift. Key\n'
             'findings include: 1) the normalization of the SMBH mass-bulge '
             'mass relation\n'
             'increases only mildly from $z=0$ to $z=3$, but decreases more '
             'strongly from\n'
             '$z=3$ to $z=10$; 2) The AGN radiative$+$kinetic efficiency is '
             '$\\sim$0.04-0.07,\n'
             'and does not show significant redshift dependence given the '
             'existing data\n'
             'constraints; 3) AGNs show downsizing, i.e., the Eddington ratios '
             'of more\n'
             'massive SMBHs start to decrease earlier than those of lower-mass '
             'objects; 4)\n'
             'The average ratio between average SMBH accretion rate and SFR is '
             '$\\sim10^{-3}$\n'
             'for low-mass galaxies, which are primarily star-forming. This '
             'ratio increases\n'
             'to $\\sim10^{-1}$ for the most massive haloes below $z\\sim1$, '
             'where star\n'
             'formation is quenched but SMBHs continue to accrete.',
  'title': 'Trinity I: Self-Consistently Modeling the Dark Matter\n'
           '  Halo-Galaxy-Supermassive Black Hole Connection from $z=0-10$',
  'updated': '2021-05-21T17:26:51Z'},
 {'arxiv:comment': {'#text': 'PhD thesis, The University of Edinburgh, 195 '
                             'pages, 2 figures.\n'
                             '  Includes: integrated discussion of colour '
                             'states and impulse observables; new\n'
                             '  discussion of wavefunctions; new results for '
                             'radiation kernels for\n'
                             '  Reissner-Nordstr\\"{o}m black holes; '
                             'corrections of minor typos from published\n'
                             '  papers',
                    '@xmlns:arxiv': 'http://arxiv.org/schemas/atom'},
  'arxiv:primary_category': {'@scheme': 'http://arxiv.org/schemas/atom',
                             '@term': 'hep-th',
                             '@xmlns:arxiv': 'http://arxiv.org/schemas/atom'},
  'author': {'name': 'Ben Maybee'},
  'category': [{'@scheme': 'http://arxiv.org/schemas/atom', '@term': 'hep-th'},
               {'@scheme': 'http://arxiv.org/schemas/atom', '@term': 'gr-qc'}],
  'id': 'http://arxiv.org/abs/2105.10268v1',
  'link': [{'@href': 'http://arxiv.org/abs/2105.10268v1',
            '@rel': 'alternate',
            '@type': 'text/html'},
           {'@href': 'http://arxiv.org/pdf/2105.10268v1',
            '@rel': 'related',
            '@title': 'pdf',
            '@type': 'application/pdf'}],
  'published': '2021-05-21T10:39:18Z',
  'summary': 'On-shell scattering amplitudes have proven to be useful tools '
             'for tackling\n'
             'the two-body problem in general relativity. This thesis outlines '
             'how to compute\n'
             'relevant classical observables that are themselves on-shell, '
             'directly from\n'
             'amplitudes; examples considered are the momentum impulse, total '
             'radiated\n'
             'momentum, and angular impulse for spinning particles. As '
             'applications we derive\n'
             'results relevant for black hole physics, computing in the '
             'post-Minkowskian\n'
             'expansion of GR, and construct a worldsheet effective action for '
             'the leading\n'
             'spin interactions of Kerr black holes.',
  'title': 'On-Shell Physics of Black Holes',
  'updated': '2021-05-21T10:39:18Z'}]

***************************************************************************************************

MINIMAL  

[{'category': 'astro-ph.GA',
  'id': 'http://arxiv.org/abs/2105.10474v1',
  'summary': 'We present Trinity, a flexible empirical model that '
             'self-consistently infers\n'
             'the statistical connection between dark matter haloes, galaxies, '
             'and\n'
             'supermassive black holes (SMBHs). Trinity is constrained by '
             'galaxy observables\n'
             "from $0 < z < 10$ (galaxies' stellar mass functions, specific "
             'and cosmic SFRs,\n'
             'quenched fractions, and UV luminosity functions) and SMBH '
             'observables from $0 <\n'
             'z < 6.5$ (quasar luminosity functions, quasar probability '
             'distribution\n'
             'functions, active black hole mass functions, local SMBH '
             'mass-bulge mass\n'
             'relations, and the observed SMBH mass distributions of high '
             'redshift bright\n'
             'quasars). The model includes full treatment of observational '
             'systematics (e.g.,\n'
             'AGN obscuration and errors in stellar masses). From these data, '
             'Trinity infers\n'
             'the average SMBH mass, SMBH accretion rate, merger rate, and '
             'Eddington ratio\n'
             'distribution as functions of halo mass, galaxy stellar mass, and '
             'redshift. Key\n'
             'findings include: 1) the normalization of the SMBH mass-bulge '
             'mass relation\n'
             'increases only mildly from $z=0$ to $z=3$, but decreases more '
             'strongly from\n'
             '$z=3$ to $z=10$; 2) The AGN radiative$+$kinetic efficiency is '
             '$\\sim$0.04-0.07,\n'
             'and does not show significant redshift dependence given the '
             'existing data\n'
             'constraints; 3) AGNs show downsizing, i.e., the Eddington ratios '
             'of more\n'
             'massive SMBHs start to decrease earlier than those of lower-mass '
             'objects; 4)\n'
             'The average ratio between average SMBH accretion rate and SFR is '
             '$\\sim10^{-3}$\n'
             'for low-mass galaxies, which are primarily star-forming. This '
             'ratio increases\n'
             'to $\\sim10^{-1}$ for the most massive haloes below $z\\sim1$, '
             'where star\n'
             'formation is quenched but SMBHs continue to accrete.',
  'title': 'Trinity I: Self-Consistently Modeling the Dark Matter\n'
           '  Halo-Galaxy-Supermassive Black Hole Connection from $z=0-10$'},
 {'category': 'hep-th',
  'id': 'http://arxiv.org/abs/2105.10268v1',
  'summary': 'On-shell scattering amplitudes have proven to be useful tools '
             'for tackling\n'
             'the two-body problem in general relativity. This thesis outlines '
             'how to compute\n'
             'relevant classical observables that are themselves on-shell, '
             'directly from\n'
             'amplitudes; examples considered are the momentum impulse, total '
             'radiated\n'
             'momentum, and angular impulse for spinning particles. As '
             'applications we derive\n'
             'results relevant for black hole physics, computing in the '
             'post-Minkowskian\n'
             'expansion of GR, and construct a worldsheet effective action for '
             'the leading\n'
             'spin interactions of Kerr black holes.',
  'title': 'On-Shell Physics of Black Holes'}]

Get a single paper

  • arxiv_url: this is the abstract URL of the paper. This can be found as the 'id' key of a paper from the list of papers fetched using the pyxiver.get_all() method.

Example response for a single paper

VERBOSE

{'arxiv:comment': {'#text': '15 pages, 4 figures, one appendix. Comments are '
                            'welcome',
                   '@xmlns:arxiv': 'http://arxiv.org/schemas/atom'},
 'arxiv:primary_category': {'@scheme': 'http://arxiv.org/schemas/atom',
                            '@term': 'hep-ph',
                            '@xmlns:arxiv': 'http://arxiv.org/schemas/atom'},
 'author': [{'name': 'Guan-Wen Yuan'},
            {'name': 'Zhan-Fang Chen'},
            {'name': 'Zhao-Qiang Shen'},
            {'name': 'Wen-Qing Guo'},
            {'name': 'Ran Ding'},
            {'name': 'Xiaoyuan Huang'},
            {'name': 'Qiang Yuan'}],
 'category': [{'@scheme': 'http://arxiv.org/schemas/atom', '@term': 'hep-ph'},
              {'@scheme': 'http://arxiv.org/schemas/atom',
               '@term': 'astro-ph.HE'}],
 'id': 'http://arxiv.org/abs/2106.05901v1',
 'link': [{'@href': 'http://arxiv.org/abs/2106.05901v1',
           '@rel': 'alternate',
           '@type': 'text/html'},
          {'@href': 'http://arxiv.org/pdf/2106.05901v1',
           '@rel': 'related',
           '@title': 'pdf',
           '@type': 'application/pdf'}],
 'published': '2021-06-10T16:29:25Z',
 'summary': 'The fast developments of radio astronomy open a new window to '
            'explore the\n'
            'properties of Dark Matter (DM). The recent direct imaging of the '
            'supermassive\n'
            'black hole (SMBH) at the center of M87 radio galaxy by the Event '
            'Horizon\n'
            'Telescope (EHT) collaboration is expected to be very useful to '
            'search for\n'
            'possible new physics. In this work, we illustrate that such '
            'results can be used\n'
            'to detect the possible synchrotron radiation signature produced '
            'by DM\n'
            'annihilation from the innermost region of the SMBH. Assuming the '
            'existence of a\n'
            'spiky DM density profile, we obtain the flux density due to DM '
            'annihilation\n'
            'induced electrons and positrons, and derive new limits on the DM '
            'annihilation\n'
            'cross section via the comparison with the EHT integral flux '
            'density at 230 GHz.\n'
            'Our results show that the parameter space can be probed by the '
            'EHT observations\n'
            'is largely complementary to other experiments. For DM with '
            'typical mass regions\n'
            'of being weakly interacting massive particles, the annihilation '
            'cross section\n'
            'several orders of magnitude below the thermal production level '
            'can be excluded\n'
            'by the EHT observations under the density spike assumption. '
            'Future EHT\n'
            'observations may further improve the sensitivity on the DM '
            'searches, and may\n'
            'also provide a unique opportunity to test the interplay between '
            'DM and the\n'
            'SMBH.',
 'title': 'Strong Limits on Dark Matter Annihilation from the Event Horizon\n'
          '  Telescope Observations of M87$^\\star$',
 'updated': '2021-06-10T16:29:25Z'}
 
 ***************************************************************************************************
 
 MINIMAL
 
 {'author': [{'name': 'Guan-Wen Yuan'},
            {'name': 'Zhan-Fang Chen'},
            {'name': 'Zhao-Qiang Shen'},
            {'name': 'Wen-Qing Guo'},
            {'name': 'Ran Ding'},
            {'name': 'Xiaoyuan Huang'},
            {'name': 'Qiang Yuan'}],
 'published': '2021-06-10T16:29:25Z',
 'summary': 'The fast developments of radio astronomy open a new window to '
            'explore the\n'
            'properties of Dark Matter (DM). The recent direct imaging of the '
            'supermassive\n'
            'black hole (SMBH) at the center of M87 radio galaxy by the Event '
            'Horizon\n'
            'Telescope (EHT) collaboration is expected to be very useful to '
            'search for\n'
            'possible new physics. In this work, we illustrate that such '
            'results can be used\n'
            'to detect the possible synchrotron radiation signature produced '
            'by DM\n'
            'annihilation from the innermost region of the SMBH. Assuming the '
            'existence of a\n'
            'spiky DM density profile, we obtain the flux density due to DM '
            'annihilation\n'
            'induced electrons and positrons, and derive new limits on the DM '
            'annihilation\n'
            'cross section via the comparison with the EHT integral flux '
            'density at 230 GHz.\n'
            'Our results show that the parameter space can be probed by the '
            'EHT observations\n'
            'is largely complementary to other experiments. For DM with '
            'typical mass regions\n'
            'of being weakly interacting massive particles, the annihilation '
            'cross section\n'
            'several orders of magnitude below the thermal production level '
            'can be excluded\n'
            'by the EHT observations under the density spike assumption. '
            'Future EHT\n'
            'observations may further improve the sensitivity on the DM '
            'searches, and may\n'
            'also provide a unique opportunity to test the interplay between '
            'DM and the\n'
            'SMBH.',
 'title': 'Strong Limits on Dark Matter Annihilation from the Event Horizon\n'
          '  Telescope Observations of M87$^\\star$'}

Development

The project uses poetry to package and manage dependencies:

poetry install

Run tests:

poetry run pytest

License

MIT License

Copyright (c) 2021 Neil Van

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Metadata

Release files for pyxiver 1.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pyxiver 1.0.3
File Size Uploaded Provenance Actions
pyxiver-1.0.3.tar.gz 12.5 kB Without provenance Details for pyxiver-1.0.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for pyxiver 1.0.3
File Interpreter ABI Platform Actions
pyxiver-1.0.3-py3-none-any.whl Python 3 none any Details for pyxiver-1.0.3-py3-none-any.whl

Total release size: 21.1 kB

Release files / pyxiver-1.0.3.tar.gz

Download URL pyxiver-1.0.3.tar.gz
Size 12.5 kB
Tags Source
SHA-256 checksum
How to use checksums
06470bbbd5728f4bcdf0b88c5b084bd022a45abb892800cd64beb4522e4fda1b
BLAKE2b-256 checksum
How to use checksums
b335a285e0c28614d6b6e44dc37a3def265bdcafe400b27361928f38c4e34e53
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.1.7 CPython/3.8.10 Linux/5.11.0-27-generic

Release files / pyxiver-1.0.3-py3-none-any.whl

Download URL pyxiver-1.0.3-py3-none-any.whl
Size 8.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6c7dc9104088c891c119dd2b628206908ec226d764363e002034aa832283377f
BLAKE2b-256 checksum
How to use checksums
1be9004aee56a2deae3fdb166553ce5b9e5658ef3b013adbfeb2b6d74b20e9b5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.1.7 CPython/3.8.10 Linux/5.11.0-27-generic

Security for pyxiver 1.0.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.3 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page