isisdl

Start the synchronization process

$ isisdl

$ isisdl --download-rate [20] --max-num-threads [5]

$ isisdl --init

$ isisdl --config

$ isisdl --sync

$ isisdl --compress

isisdl [options] [product_id ...]
isisdl --search-... [criteria]
isisdl --download-... [criteria]
isisdl --list-...

-h, --help
    Displays the help message and exits.

-l, --list-instruments
    Lists all available instruments in the archive.

-m, --list-missions
    Lists all available missions in the archive.

-t, --list-targets
    Lists all available targets (planets, moons, etc.) in the archive.

-p, --list-product-types
    Lists all available product types (e.g., CUBE, NAV) in the archive.

--list-paths
    Lists all available data paths in the archive.

-s ID, --search-product-id ID
    Searches for products matching the given product ID.

-M MISSION, --search-mission MISSION
    Searches for products associated with the specified mission.

-T TARGET, --search-target TARGET
    Searches for products associated with the specified target.

-I INSTRUMENT, --search-instrument INSTRUMENT
    Searches for products associated with the specified instrument.

-P TYPE, --search-product-type TYPE
    Searches for products of the specified type.

--search-path PATH
    Searches for products under the specified archive path.

-D DESC, --search-description DESC
    Searches for products whose description contains the given text.

-A, --search-all
    Performs a search across all searchable fields for matching products.

-d ID, --download-product-id ID
    Downloads the product(s) specified by ID(s).

-DM MISSION, --download-mission MISSION
    Downloads products associated with the specified mission.

-DT TARGET, --download-target TARGET
    Downloads products associated with the specified target.

-DI INSTRUMENT, --download-instrument INSTRUMENT
    Downloads products associated with the specified instrument.

-DP TYPE, --download-product-type TYPE
    Downloads products of the specified type.

--download-path PATH
    Downloads products under the specified archive path.

-DD DESC, --download-description DESC
    Downloads products whose description contains the given text.

-DA, --download-all
    Downloads all products found matching previous search criteria.

-o DIR, --output-directory DIR
    Specifies the directory where downloaded files will be saved. Defaults to current directory.

-f, --force
    Forces overwrite of existing files without prompting.

-v, --verbose
    Enables verbose output, showing more details about the download process.

--no-checksum
    Disables checksum verification of downloaded files.

--update-database
    Forces an update of the local product database from the USGS server.

--cache-directory DIR
    Specifies an alternative directory for the local database and cache files.

--no-cache
    Prevents the use of any local cache files for database or downloads.

--parallel N
    Sets the number of parallel downloads to N. Default is 1.

--no-progress
    Disables the display of the download progress bar.

--log-file FILE
    Redirects log messages to the specified file.

--proxy PROXY_URL
    Specifies an HTTP/HTTPS proxy server to use for downloads.

--timeout SECONDS
    Sets the maximum time in seconds to wait for a server response.

--retries N
    Sets the number of times to retry a failed download.

--no-verify-ssl
    Disables SSL certificate verification, useful for certain network configurations.

--version
    Shows the program's version number and exits.

The isisdl command is a specialized utility within the USGS ISIS (Integrated Software for Imagers and Spectrometers) software suite, designed for downloading planetary remote sensing data. It enables users to directly access and retrieve ISIS-formatted products, such as imagery, instrument information, and related kernels, from the extensive USGS PDS (Planetary Data System) archives.

Users can search for and download data by specifying criteria like mission, target, instrument, or product ID. This tool is essential for planetary scientists, researchers, and anyone working with high-quality, calibrated planetary image data, providing a streamlined way to acquire the necessary datasets for processing and analysis within the ISIS environment.

isisdl requires active internet access to connect to USGS PDS archives. The local database, used for search operations, may need periodic updates using the --update-database option to reflect the latest available products. Large downloads can consume significant disk space and network bandwidth. Users behind restrictive firewalls or with complex proxy configurations might need to use the --proxy or --no-verify-ssl options.

isisdl primarily downloads data from the USGS PDS (Planetary Data System) archives, which are official repositories for planetary science mission data.

The command is tailored to download data in the proprietary ISIS cube format (.cub) along with its associated support files, which are crucial for processing within the ISIS environment.

To enhance search performance and manage available products, isisdl maintains a local database. This database can be manually refreshed with --update-database to ensure it reflects the most current archive contents.

The ISIS (Integrated Software for Imagers and Spectrometers) suite, including isisdl, was developed by the Astrogeology Science Center of the U.S. Geological Survey (USGS). It originated from the need to process and analyze planetary image data from various NASA and international missions. isisdl specifically addresses the challenge of directly accessing and standardizing the acquisition of ISIS-formatted data from the vast PDS (Planetary Data System) archives, becoming an indispensable tool for planetary scientists in their research workflows.

isis(1), qview(1), catlab(1), wget(1), curl(1)