https://github.com/neirrek/marsharvester
Mars rovers Perseverance and Curiosity raw images harvester
https://github.com/neirrek/marsharvester
curiosity-rover downloader images java mars mars-rover perseverance-rover
Last synced: 6 months ago
JSON representation
Mars rovers Perseverance and Curiosity raw images harvester
- Host: GitHub
- URL: https://github.com/neirrek/marsharvester
- Owner: neirrek
- License: mit
- Created: 2021-03-06T17:15:22.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-04-22T09:43:02.000Z (6 months ago)
- Last Synced: 2025-04-24T02:04:42.934Z (6 months ago)
- Topics: curiosity-rover, downloader, images, java, mars, mars-rover, perseverance-rover
- Language: Java
- Homepage:
- Size: 110 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
MarsHarvester
=====================
What is it?
-----------
**MarsHarvester** is a **standalone Java program** to download the raw images taken by the Mars rovers **Perseverance** and **Curiosity** which are available on the **NASA** website at the following URL:
- **Perseverance:**
- **Curiosity:**
Requirements
------------
Running **MarsHarvester** requires **Java 17** at least.
Packaging
---------
Create an uber-jar containing all the dependencies by executing the following command:
```
mvn clean package
```
Executing
---------
Launch the harvester by executing the following command:
```
java -jar mars-harvester-X.Y.Z.jar --mission --dir /path/to/save/root/dir
```
Usage
-----
```
NAME
mars-harvester - Mars rovers raw images harvester command
SYNOPSIS
mars-harvester [ --convert-to-jpg ]
[ {-d | --dir} ]
[ {-f | --fromPage} ]
[ --force ]
[ {-h | --help} ]
[ {-m | --mission} ]
[ {-s | --stop-after-already-downloaded-pages} ]
[ {-t | --toPage} ]
[ --threads ]
OPTIONS
--convert-to-jpg
Convert the downloaded images to JPG format with the given
compression ratio (default is not to convert when this option is
missing
This option may occur a maximum of 1 times
This options value must fall in the following range: 1 <= value <= 100
-d , --dir
Root directory in which the images are saved
This option may occur a maximum of 1 times
This options value must be a path to a directory. The provided path
must exist on the file system. The provided path must be readable
and writable.
-f , --fromPage
Harvesting starts from this page (default is page 1 when this
option is missing)
This option may occur a maximum of 1 times
This options value must fall in the following range: value >= 1
--force
Force harvesting already downloaded images
This option may occur a maximum of 1 times
-h, --help
Display help information
-m , --mission
Name of the Mars mission
This options value is restricted to the following set of values:
CURIOSITY
PERSEVERANCE
This option may occur a maximum of 1 times
-s ,
--stop-after-already-downloaded-pages
Harvesting stops after the nth page which is already fully
downloaded (default is not to stop when this option is missing)
This option may occur a maximum of 1 times
This options value must fall in the following range: value >= 1
-t , --toPage
Harvesting stops at this page (default is last page when this
option is missing)
This option may occur a maximum of 1 times
This options value must fall in the following range: value >= 1
--threads
Number of threads to download the images (default is 4 when this
option is missing)
This option may occur a maximum of 1 times
This options value must fall in the following range: value >= 1
```