A Python Wrapper for NASA's Mars Rover Photos API
Project description
Marstuff
API Wrapper for NASA's Mars Rover Photos API
📝 Description
This is a Work-In-Progress Python API Wrapper for NASA's Mars Rover Photos API which provides both Synchronous and Asynchronous support.
🔥 Getting Started
-
⬇️ Installation
- Via pip
pip install marstuff
- Via pip
-
✨ Getting a NASA Developer Key
- Goto https://api.nasa.gov/
- Navigate to
Generate API Key
at the top navbar. - Fill in your details, and tap
Signup
- Copy Your API Key
-
⚡ Quickstart
- Asynchronously getting, Viewing and Saving the
Latest Photo
of NASA'sCuriosity
Roverfrom marstuff import Client # Import the Client class client = Client("Your API Token") # Make a new Client # Get the latest Photo photo = client.get_latest_photo(client.curiosity) # OR photo = client.curiosity.get_latest_photo() # Display the Photo photo.show() # Save the Photo photo.save("Latest photo of Curiosity.png")
- Asynchronously getting all the photos taken by the
Rear Hazard Avoidance Camera
of NASA'sCuriosity
Rover on sol3259
from marstuff import AsyncClient # Import the AsyncClient class from marstuff.objects.camera import CAMERAS # Import the list of all CAMERAS import asyncio # Import asyncio client = AsyncClient("Your API Token") # Make a new Client # Make a function for running asyncio async def get_photos(): # Get the photo by Curiosity on sol 3259 with the RHAZ camera photos = client.curiosity.get_all_photos_by_sol(3259, CAMERAS.RHAZ) # OR photos = client.curiosity.rhaz.get_all_photos_by_sol(3259) print(photos) asyncio.run(get_photos)
- Asynchronously getting, Viewing and Saving the
-
🧠 General Need-to-Know Stuff!!
This API currently provides access to 4 NASA Rovers (
Perseverance
,Curiosity
,Opportunity
, andSpirit
) Each rover, takes photos of the surface of mars via different cameras-
The cameras of the
Perseverance
Rover areAbbreviation Camera EDL_RUCAM Rover Up-Look Camera EDL_RDCAM Rover Down-Look Camera EDL_DDCAM Descent Stage Down-Look Camera EDL_PUCAM1 Parachute Up-Look Camera A EDL_PUCAM2 Parachute Up-Look Camera B NAVCAM_LEFT Navigation Camera - Left NAVCAM_RIGHT Navigation Camera - Right MCZ_RIGHT Mast Camera Zoom - Right MCZ_LEFT Mast Camera Zoom - Left FRONT_HAZCAM_LEFT_A Front Hazard Avoidance Camera - Left FRONT_HAZCAM_RIGHT_A Front Hazard Avoidance Camera - Right REAR_HAZCAM_LEFT Rear Hazard Avoidance Camera - Left REAR_HAZCAM_RIGHT Rear Hazard Avoidance Camera - Right SKYCAM MEDA Skycam SHERLOC_WATSON SHERLOC WATSON Camera -
Cameras of other Rovers are
Abbreviation Camera Curiosity Opportunity Spirit FHAZ Front Hazard Avoidance Camera ✔ ✔ ✔ RHAZ Rear Hazard Avoidance Camera ✔ ✔ ✔ MAST Mast Camera ✔ CHEMCAM Chemistry and Camera Complex ✔ MAHLI Mars Hand Lens Imager ✔ MARDI Mars Descent Imager ✔ NAVCAM Navigation Camera ✔ ✔ ✔ PANCAM Panoramic Camera ✔ ✔ MINITES Miniature Thermal Emission Spectrometer (Mini-TES) ✔ ✔
You can query via
sol
orearth_date
sol
meansMartian rotation or day
which can be (0 toCurrent Sol of Rover
)earth_date
is in the format ofYYYY-MM-DD
-
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
marstuff-0.1.19.tar.gz
(13.9 kB
view hashes)
Built Distribution
marstuff-0.1.19-py3-none-any.whl
(10.7 kB
view hashes)
Close
Hashes for marstuff-0.1.19-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 12d33518b2b0aadb28e2b64869ca092f1285cc99b61a09363a775172d579af73 |
|
MD5 | 1eb1b7b2869a031593624149c0ec38f3 |
|
BLAKE2b-256 | 91c745e1282abe6b9060281c6d761718fb32e716343907662f170fc55f0dcb07 |