sakethramanujam / percy-image-downloader

Unofficial image downloader for Nasa Perseverance Raw Images website in Python

⬇️ percy-image-downloader

Unofficial image downloader for Nasa Perseverance Raw Images website Image credits: NASA/JPL-Caltech unless otherwise noted.

🌠 Updates in v0.2

• The downloader has basic tests setup.
• Fixes a bug with respect to page number specification.
• Image Format issues for full scale images are now resolved.

Installation

Requires python>=3.6

Download the zip and execute the following in your terminal

python setup.py install

Usage Instructions

Currently supports downloading images of chosen resolution type from a specific page, defaults to 0th page.

percy [OPTIONS] COMMAND [ARGS]...

  Image Downloader for Percy, the Mars Rover

Options:
  --version  Show the version and exit.
  --help     Show this message and exit.

Commands:
  download

Downloading Images

percy download [OPTIONS]

Options:
  -r, --resolution TEXT  Parameter for left column  [required]
  -p, --path TEXT        Parameter for left column  [required]
  -n, --number INTEGER   Page Number from which images are to be downloaded,
                         defaults to 0

  --help                 Show this message and exit.

Supported Resolution Tags

Keyword	Resolution as per NASA Website
full	Full Size Image
large	Large Scale Image
medium	Medium Scale Image
small	Small/Thumbnail Image

Example

percy download -r large -p ./ -n 1

Found an bug/need a feature?

• Report/Request, raise an issue here

percy-image-downloader's Issues

Add command/argument to download metadata

Add a feature in the form of a command/argument to download the metadata of images on a current page as csv/excel.

Add Tests

Add tests to the client and cli

Image format for full scale images is not JPEG

Currently the saving function in the percy class tries saving a png image to jpg/jpeg which is a terrible mistake and needs to be corrected ASAP.

Add args to `download` command to allow downloading w.r.t Camera/Page

Is your feature request related to a problem? Please describe.
No

Describe the solution you'd like
There might be that might need access to images from a specific page and there may be others that need to download by a specific instrument. So, adding arguments to the existing download command would be a good feature to have.

The current scenario is

percy download -r full -n 1 -p something

Suggested improvement

percy download [ARG] -r full -p something -c/-n

Describe alternatives you've considered
None yet

Remove upper limit on page number

There's a hard upper limit on the page number from which the image can be downloaded and needs to be addressed.
It's very likely to fail/prevent from downloading images starting tomorrow.