{ "info": { "author": "Aaron Schlegel", "author_email": "aaron@aaronschlegel.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 2 - Pre-Alpha", "Environment :: Console", "Intended Audience :: Developers", "Intended Audience :: End Users/Desktop", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Topic :: Software Development :: Libraries :: Python Modules" ], "description": "# Hubblepy - Python wrapper for the Hubblesite.org API\n\n[![Build Status](https://travis-ci.org/aschleg/hubblepy.svg?branch=master)](https://travis-ci.org/aschleg/hubblepy)\n[![Build status](https://ci.appveyor.com/api/projects/status/h4arxow3ord4njd7?svg=true)](https://ci.appveyor.com/project/aschleg/hubblepy)\n[![Coverage Status](https://coveralls.io/repos/github/aschleg/hubblepy/badge.svg?branch=master)](https://coveralls.io/github/aschleg/hubblepy?branch=master)\n[![Codacy Badge](https://api.codacy.com/project/badge/Grade/586d9f157a2248bf951a5d392f5ebbef)](https://www.codacy.com/app/aschleg/hubblepy?utm_source=github.com&utm_medium=referral&utm_content=aschleg/hubblepy&utm_campaign=Badge_Grade)\n[![Documentation Status](https://readthedocs.org/projects/hubblepy/badge/?version=latest)](https://hubblepy.readthedocs.io/en/latest/?badge=latest)\n![Python versions](https://img.shields.io/badge/python-3.4%2C%203.5%2C%203.6-blue.svg)\n\n`hubblepy` is a straightforward and easy-to-use API wrapper for the [Hubblesite](http://hubblesite.org/) API.\n\n## Requirements\n\n* Python 3.4+\n* `requests >= 2.18`\n\n## Installation\n\n## Documentation\n\n* [Hubblesite.org API Documentation](http://hubblesite.org/api/documentation)\n\n## Examples\n\nThe following are some short examples outlining the capabilities and functionality of `hubblepy`.\n\n### Getting most recent news articles\n\n~~~ python\nhubblepy.news()[0:3]\n\n[{'name': 'Hubble Uncovers Never Before Seen Features Around a Neutron Star',\n 'news_id': '2018-43',\n 'url': 'http://hubblesite.org/news_release/news/2018-43'},\n {'name': 'Hubble Goes Wide to Seek Out Far-Flung Galaxies',\n 'news_id': '2018-39',\n 'url': 'http://hubblesite.org/news_release/news/2018-39'},\n {'name': \"Success in Critical Communications Tests for NASA's James Webb Space Telescope\",\n 'news_id': '2018-31',\n 'url': 'http://webbtelescope.org/articles/2018-31'}]\n~~~\n\n### Finding more specific details of a published news article\n\nReturn the abstract and more information on the most recent published article.\n\n~~~ python\nhubblepy.news_release('last')\n\n{'abstract': 'Imagine crushing more than 50,000 aircraft carriers into the size of a baseball. This describes neutron \n stars. They are among the strangest objects in the universe. Neutron stars are a case of extreme physics produced by \n the unforgiving force of gravity. The entire core of an exploded star has been squeezed into a solid ball of neutrons \n with the density of an atom\u2019s nucleus. Neutron stars spin as fast as a blender on puree. Some spit out death-star \n beams of intense radiation \u2014 like interstellar lighthouses. These are called pulsars.\\r\\n\\r\\nThese beams are normally \n seen in X-rays, gamma-rays, and radio waves. But astronomers used Hubble\\'s near-infrared (IR) vision to look at a \n nearby neutron star cataloged RX J0806.4-4123. They were surprised to see a gush of IR light coming from a region \n around the neutron star. That infrared light might come from a circumstellar disk 18 billion miles across. Another \n idea is that a wind of subatomic particles from the pulsar\u2019s magnetic field is slamming into interstellar gas. \n Hubble\\'s IR vision opens a new window into understanding how these \"infernal machines\" work.\\r\\n',\n 'credits': 'NASA, ESA, and B. Posselt \n (Pennsylania State University)',\n 'keystone_image_1x': 'https://media.stsci.edu/uploads/story/display_image/1243/low_STSCI-H-p1843a-k-1340x520.png',\n 'keystone_image_2x': 'https://media.stsci.edu/uploads/story/display_image/1243/STSCI-H-p1843a-k-1340x520.png',\n 'mission': 'hubble',\n 'name': 'Hubble Uncovers Never Before Seen Features Around a Neutron Star',\n 'news_id': '2018-43',\n 'publication': '2018-09-17T11:00:00.000-04:00',\n 'release_images': [4231, 4232, 4233],\n 'thumbnail': 'https://media.stsci.edu/uploads/story/thumbnail/1243/low_STSCI-H-p1843a-t-400x400.png',\n 'thumbnail_1x': 'https://media.stsci.edu/uploads/story/thumbnail/1243/low_STSCI-H-p1843a-t-400x400.png',\n 'thumbnail_2x': 'https://media.stsci.edu/uploads/story/thumbnail/1243/STSCI-H-p1843a-t-400x400.png',\n 'thumbnail_retina': 'https://media.stsci.edu/uploads/story/thumbnail/1243/STSCI-H-p1843a-t-400x400.png',\n 'url': 'http://hubblesite.org/news_release/news/2018-43'}\n~~~\n\nOr, using a `news_id` returned from the `news()` function, we can get more specific information about any other \narticle published.\n\n~~~ python\nhubblepy.news_release('2018-31')\n\n{'abstract': 'When NASA\u2019s James Webb Space Telescope is en route to and in orbit nearly a million miles from Earth, \n continuous communications with its Mission Operations Center (MOC) in Baltimore will be essential. Recently, at the \n Space Telescope Science Institute\u2014home of the MOC\u2014Webb\u2019s Flight Operations Team successfully completed two critical \n communications tests. The first demonstrated that from the moment Webb launches through the first six hours of flight, \n complex exchanges could be accomplished among the five different service providers around the world who will \n alternately convey command and telemetry communications. The second test showed that the MOC could successfully \n command the telescope.',\n 'keystone_image_1x': 'https://media.stsci.edu/uploads/story/display_image/1239/low_STSCI-J-p1831a-k-1340x520.png',\n 'keystone_image_2x': 'https://media.stsci.edu/uploads/story/display_image/1239/STSCI-J-p1831a-k-1340x520.png',\n 'mission': 'james_webb',\n 'name': \"Success in Critical Communications Tests for NASA's James Webb Space Telescope\",\n 'news_id': '2018-31',\n 'publication': '2018-09-05T10:00:00.000-04:00',\n 'release_images': [4225],\n 'thumbnail': 'https://media.stsci.edu/uploads/story/thumbnail/1239/low_STSCI-J-p1831a-t800x800.png',\n 'thumbnail_1x': 'https://media.stsci.edu/uploads/story/thumbnail/1239/low_STSCI-J-p1831a-t800x800.png',\n 'thumbnail_2x': 'https://media.stsci.edu/uploads/story/thumbnail/1239/STSCI-J-p1831a-t800x800.png',\n 'thumbnail_retina': 'https://media.stsci.edu/uploads/story/thumbnail/1239/STSCI-J-p1831a-t800x800.png',\n 'url': 'http://webbtelescope.org/articles/2018-31'}\n~~~\n\n### Returning image collections produced by the HubbleSite and other agencies\n\n~~~ python\nhubblepy.image_collections(collection_name='spacecraft')\n\n[{'id': 3814, 'name': 'Grappling Hubble (2009)'},\n {'id': 3813, 'name': 'Bidding Hubble Farewell (2009)'},\n {'id': 3812, 'name': 'Hubble From Behind (2009)'},\n {'id': 3811, 'name': 'Installing Wide Field Camera 3 (2009)'},\n {'id': 3810, 'name': 'Final Release Over Earth (2009)'},\n {'id': 3809, 'name': 'Reflecting on Work (2009)'},\n {'id': 3808, 'name': \"In a Day's Work (2009)\"},\n {'id': 3807, 'name': 'Going Up? (2009)'},\n {'id': 3806, 'name': 'Getting in Position (2009)'},\n {'id': 3805, 'name': 'Hanging Out With Hubble (2009)'},\n {'id': 3804, 'name': \"Lifting Hubble from Atlantis' Cargo Bay (2009)\"},\n {'id': 3836,\n 'name': 'Hubble Control Center, Goddard Space Flight Center (1999)'},\n {'id': 3835,\n 'name': 'Working at the Hubble Control Center, Space Telescope Science Institute (2005)'},\n {'id': 3834, 'name': 'Hubble in Flight (1997) '},\n {'id': 3833, 'name': \"Hubble Restored: The Telescope's Latest Look (2002)\"},\n {'id': 3832, 'name': 'Hubble Floating Free (2002)'},\n {'id': 3831, 'name': \"Hubble Against Earth's Horizon (1997)\"},\n {'id': 3830, 'name': 'Repairing Hubble (1997)'},\n {'id': 3829, 'name': 'Camera Crew: Taking Pictures of the Mission (1997)'},\n {'id': 3828, 'name': 'Hubble Docked with the Shuttle Endeavor (1993)'},\n {'id': 3827, 'name': 'Hubble Docked with Discovery (1999)'},\n {'id': 3826,\n 'name': 'Giving Guidance: Replacing the Fine Guidance Sensors (1997)'},\n {'id': 3825, 'name': 'Cast-off: Releasing a Solar Array (1993)'},\n {'id': 3824,\n 'name': 'Out with the Old: Replacing the High Resolution Spectrograph (1997)'},\n {'id': 3823,\n 'name': 'A Second Look: Replacing the Wide Field and Planetary Camera (1993)'}]\n~~~\n\n### Get metadata and other information on images within collections\n\n~~~ python\nhubblepy.images([3814, 3813])\n\n[{'collection': 'spacecraft',\n 'credits': 'NASA',\n 'description': 'The Hubble Space Telescope in a picture snapped by a Servicing Mission 4 crewmember just after the \n Space Shuttle Atlantis captured Hubble with its robotic arm on May 13, 2009, beginning the mission to upgrade and \n repair the telescope.',\n 'image_files': [{'file_size': 4987706,\n 'file_url': 'https://media.stsci.edu/uploads/image_file/image_attachment/29291/STScI-H-spacecraft24-title.pdf',\n 'height': 792,\n 'width': 612},\n {'file_size': 1256136,\n 'file_url': 'https://media.stsci.edu/uploads/image_file/image_attachment/29290/STScI-H-spacecraft24-title-2400x3000.jpg',\n 'height': 3000,\n 'width': 2400},\n {'file_size': 2051306,\n 'file_url': 'https://media.stsci.edu/uploads/image_file/image_attachment/29288/STScI-H-spacecraft24-3072x2040.jpg',\n 'height': 2040,\n 'width': 3072},\n {'file_size': 18842624,\n 'file_url': 'https://media.stsci.edu/uploads/image_file/image_attachment/29289/STScI-H-spacecraft24-3072x2040.tif',\n 'height': 2040,\n 'width': 3072}],\n 'mission': 'hubble',\n 'name': 'Grappling Hubble (2009)'},\n {'collection': 'spacecraft',\n 'credits': 'NASA',\n 'description': 'Hubble, released by the Space Shuttle Atlantis after Servicing Mission 4 in May 2009, floats against \n the background of space. The shuttle and telescope had been linked for the better part of a week while astronauts \n conducted five spacewalks. The mission is expected to be the last astronaut visit to the telescope.',\n 'image_files': [{'file_size': 2694334,\n 'file_url': 'https://media.stsci.edu/uploads/image_file/image_attachment/29287/STScI-H-spacecraft25-title.pdf',\n 'height': 792,\n 'width': 612},\n {'file_size': 1029841,\n 'file_url': 'https://media.stsci.edu/uploads/image_file/image_attachment/29286/STScI-H-spacecraft25-title-2400x3000.jpg',\n 'height': 3000,\n 'width': 2400},\n {'file_size': 5850609,\n 'file_url': 'https://media.stsci.edu/uploads/image_file/image_attachment/29284/STScI-H-spacecraft25-3744x2952.jpg',\n 'height': 2952,\n 'width': 3744},\n {'file_size': 33200652,\n 'file_url': 'https://media.stsci.edu/uploads/image_file/image_attachment/29285/STScI-H-spacecraft25-3744x2952.tif',\n 'height': 2952,\n 'width': 3744}],\n 'mission': 'hubble',\n 'name': 'Bidding Hubble Farewell (2009)'}]\n~~~\n\n### Returning video collections\n\nSimilar to collections of images curated by HubbleSite, video collections can also be found and explored.\n\n~~~ python\nhubblepy.video_collections('space')[0:3]\n\n[{'collection': 'science',\n 'id': 1046,\n 'image': 'https://media.stsci.edu/uploads/video/image_attachment/1046/thumb_low_STScI-H-MWC_t420x236.png',\n 'name': 'Milky Way Center in Multiple Wavelengths'},\n {'collection': 'news',\n 'id': 1171,\n 'image': 'https://media.stsci.edu/uploads/video/image_attachment/1171/thumb_low_STScI-H-v1839a-t420x236.png',\n 'name': 'Video zoom into Abell 370',\n 'news_name': 'a'},\n {'collection': 'science',\n 'id': 1141,\n 'image': 'https://media.stsci.edu/uploads/video/image_attachment/1141/thumb_low_arp273-example_frame-1920x1080.jpg',\n 'name': 'A Rose of Galaxies: Interacting Galaxies Arp 273'}]\n~~~\n\n### Returning metadata of a particular video or videos\n\n~~~ python\nhubblepy.videos(1046)\n\n{'collection': 'science',\n 'credits': 'Video: NASA, ESA, and \n G. Bacon (STScI)\\r\\n\\r\\nImage Credits: NASA, \n ESA, CXC, SSC and STScI',\n 'image': 'https://media.stsci.edu/uploads/video/image_attachment/1046/low_STScI-H-MWC_t420x236.png',\n 'image_retina': 'https://media.stsci.edu/uploads/video/image_attachment/1046/STScI-H-MWC_t420x236.png',\n 'mission': 'hubble',\n 'name': 'Milky Way Center in Multiple Wavelengths',\n 'short_description': 'This animation reveals the center of our Milky Way galaxy, first in near-infrared, then \n mid-infrared, then X-ray light, and then all three in combination.',\n 'video_files': [{'file_size': 16428379,\n 'file_url': 'https://media.stsci.edu/uploads/video_file/video_attachment/4694/STScI-H-MWC_1x-3840x2160.mp4',\n 'format': 'MPEG-4 4K-UHD',\n 'frame_rate': '29.97',\n 'height': 2160,\n 'width': 3840},\n {'file_size': 11292487,\n 'file_url': 'https://media.stsci.edu/uploads/video_file/video_attachment/4698/STScI-H-MWC_2x-3840x2160.mp4',\n 'format': 'MPEG-4 4K-UHD',\n 'frame_rate': '29.97',\n 'height': 2160,\n 'width': 3840},\n {'file_size': 18985331,\n 'file_url': 'https://media.stsci.edu/uploads/video_file/video_attachment/4693/STScI-H-MWC_1x-1920x1080.mp4',\n 'format': 'MPEG-4 (H.264)',\n 'frame_rate': '29.97',\n 'height': 1080,\n 'width': 1920},\n {'file_size': 11551183,\n 'file_url': 'https://media.stsci.edu/uploads/video_file/video_attachment/4697/STScI-H-MWC_2x-1920x1080.mp4',\n 'format': 'MPEG-4 (H.264)',\n 'frame_rate': '29.97',\n 'height': 1080,\n 'width': 1920},\n {'file_size': 8758378,\n 'file_url': 'https://media.stsci.edu/uploads/video_file/video_attachment/4692/STScI-H-MWC_1x-1280x720.mp4',\n 'format': 'MPEG-4 (H.264)',\n 'frame_rate': '29.97',\n 'height': 720,\n 'width': 1280},\n {'file_size': 5539118,\n 'file_url': 'https://media.stsci.edu/uploads/video_file/video_attachment/4696/STScI-H-MWC_2x-1280x720.mp4',\n 'format': 'MPEG-4 (H.264)',\n 'frame_rate': '29.97',\n 'height': 720,\n 'width': 1280},\n {'file_size': 2908461,\n 'file_url': 'https://media.stsci.edu/uploads/video_file/video_attachment/4691/STScI-H-MWC_1x-640x360.mp4',\n 'format': 'MPEG-4 (H.264)',\n 'frame_rate': '29.97',\n 'height': 360,\n 'width': 640},\n {'file_size': 1803284,\n 'file_url': 'https://media.stsci.edu/uploads/video_file/video_attachment/4695/STScI-H-MWC_2x-640x360.mp4',\n 'format': 'MPEG-4 (H.264)',\n 'frame_rate': '29.97',\n 'height': 360,\n 'width': 640}],\n 'youtube_id': 'mUQ0yl0w0iQ'}\n~~~\n\n\n## Notes\n\nPlease note I am in no way affiliated with the HubbleSite, I simply found the content and the API interesting so I \nwanted to write an API wrapper to hopefully increase awareness and get others excited about space and astronomy! \n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "", "keywords": "", "license": "", "maintainer": "", "maintainer_email": "", "name": "hubblepy", "package_url": "https://pypi.org/project/hubblepy/", "platform": "", "project_url": "https://pypi.org/project/hubblepy/", "project_urls": null, "release_url": "https://pypi.org/project/hubblepy/1.0.0/", "requires_dist": [ "requests (>=2.18)" ], "requires_python": "", "summary": "Python wrapper of the Hubble Telescope API.", "version": "1.0.0" }, "last_serial": 4301836, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "f34ac57151e63d95e22430be48039912", "sha256": "70e2f6ad6c9ffda4f8d3a5e0f26a6900043436eafa9ea05723391c67f14ff4de" }, "downloads": -1, "filename": "hubblepy-0.1.0-py3.6.egg", "has_sig": false, "md5_digest": "f34ac57151e63d95e22430be48039912", "packagetype": "bdist_egg", "python_version": "3.6", "requires_python": null, "size": 4770, "upload_time": "2018-09-23T13:50:23", "url": "https://files.pythonhosted.org/packages/a8/49/f2c88ab485e8dc041c3894590d951eba9a85f11f3a5ad994bed7f1132ea9/hubblepy-0.1.0-py3.6.egg" } ], "1.0.0": [ { "comment_text": "", "digests": { "md5": "a69bf38c582b1b800229cc7defe81de8", "sha256": "509693de55bea71acf0177b09eb7e83dc1dd131efc69850eec37d768c2542a4f" }, "downloads": -1, "filename": "hubblepy-1.0.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "a69bf38c582b1b800229cc7defe81de8", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 19116, "upload_time": "2018-09-23T13:50:21", "url": "https://files.pythonhosted.org/packages/af/c1/a8761e7b1bbefac29a2ea4f279cd8935175360c4930eb99d0af12ef3e82c/hubblepy-1.0.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "11299d2b755e48f41e5bb1bdb9854ab4", "sha256": "90353292ddb415ddb050bc68b8dc5afb83cb94682b8650bd8fcedb5131a909c7" }, "downloads": -1, "filename": "hubblepy-1.0.0.tar.gz", "has_sig": false, "md5_digest": "11299d2b755e48f41e5bb1bdb9854ab4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14929, "upload_time": "2018-09-23T13:50:24", "url": "https://files.pythonhosted.org/packages/6c/29/5dc1600f3b74fe50045eddf821ca287c6a58f36c47600e9b23aa27a25ec5/hubblepy-1.0.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "a69bf38c582b1b800229cc7defe81de8", "sha256": "509693de55bea71acf0177b09eb7e83dc1dd131efc69850eec37d768c2542a4f" }, "downloads": -1, "filename": "hubblepy-1.0.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "a69bf38c582b1b800229cc7defe81de8", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 19116, "upload_time": "2018-09-23T13:50:21", "url": "https://files.pythonhosted.org/packages/af/c1/a8761e7b1bbefac29a2ea4f279cd8935175360c4930eb99d0af12ef3e82c/hubblepy-1.0.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "11299d2b755e48f41e5bb1bdb9854ab4", "sha256": "90353292ddb415ddb050bc68b8dc5afb83cb94682b8650bd8fcedb5131a909c7" }, "downloads": -1, "filename": "hubblepy-1.0.0.tar.gz", "has_sig": false, "md5_digest": "11299d2b755e48f41e5bb1bdb9854ab4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14929, "upload_time": "2018-09-23T13:50:24", "url": "https://files.pythonhosted.org/packages/6c/29/5dc1600f3b74fe50045eddf821ca287c6a58f36c47600e9b23aa27a25ec5/hubblepy-1.0.0.tar.gz" } ] }