LinuxCommandLibrary

isisdl

Download ISIS cubes from online archives

TLDR

Start the synchronization process

$ isisdl
copy

Limit the download rate to 20 MiB/s and download with 5 threads
$ isisdl --download-rate [20] --max-num-threads [5]
copy

Run the initialization configuration wizard
$ isisdl --init
copy

Run the additional configuration wizard
$ isisdl --config
copy

Initiate a full synchronization of the database and compute the checksum of every file
$ isisdl --sync
copy

Start ffmpeg to compress downloaded videos
$ isisdl --compress
copy

SYNOPSIS

isisdl [options]

PARAMETERS

-c | --config
    Specify the path to the configuration file. Defaults to ~/.isisdl.conf.

-l | --list
    List available missions and data products.

-m | --mission
    Specify the mission to download data from (e.g., Voyager, Galileo).

-p | --product
    Specify the data product to download (e.g., EDR, CDR).

-i | --index
    Download only the index file for the specified mission.

-d | --destination
    Specify the destination directory for downloaded files.

-n | --no-download
    Do not download the actual data, only print the URLs.

-q | --quiet
    Suppress non-error output.

-v | --verbose
    Increase verbosity of output.

-h | --help
    Display help message and exit.

-V | --version
    Display version information and exit.

DESCRIPTION

The isisdl command is a powerful tool designed for automated downloading of data products and indices from the Integrated Software for Imagers and Spectrometers (ISIS) server maintained by the United States Geological Survey (USGS). It facilitates retrieval of planetary image data crucial for research and analysis, primarily focusing on missions like Voyager, Galileo, Cassini, and Mars Reconnaissance Orbiter. The tool leverages a configuration file (`.isisdl.conf` usually), allowing users to specify download preferences, like the target mission and data types. By managing downloads effectively, isisdl helps researchers acquire and organize large volumes of planetary data for scientific exploration.
Note that isisdl command requires an `.isisdl.conf` file in the home directory, providing credentials for accessing the ISIS archive. It supports various download options and simplifies the process of obtaining planetary science data from the USGS servers. Without proper configuration, isisdl will fail to operate correctly.

CAVEATS

Requires a properly configured .isisdl.conf file with valid credentials to access the USGS ISIS archive. Failure to configure this file correctly will result in authentication or access errors. Some data products may require specific permissions or agreements to download.

CONFIGURATION FILE FORMAT

The .isisdl.conf file typically includes the following information:
- Username: Your USGS username.
- Password: Your USGS password.
- Server: The URL of the ISIS data server.
This file must have the correct permissions (e.g., 600) to ensure security.

DATA ORGANIZATION

After downloading, it's crucial to organize data by mission and product. Consider creating separate directories for each mission and product type to maintain a structured file system. Use tools to verify the integrity of the downloaded files.

HISTORY

isisdl was developed to simplify the process of downloading data from the ISIS archive. Its development was driven by the need to automate and streamline data acquisition for planetary science researchers, reducing the manual effort required to browse and download large datasets. The tool is regularly updated to support new missions and data products available through the ISIS system.

SEE ALSO

wget(1), curl(1)

Copied to clipboard