ESO-DOWNLOAD(1)

NAME
eso-download - Query and download data from the ESO Science Archive

SYNOPSIS
eso-download [global-options] raw [options]
eso-download [global-options] phase3 [options]

DESCRIPTION
eso-download is a command-line interface for querying and downloading data from the ESO (European Southern Observatory) Science Archive. It supports:

raw Queries and downloads raw observational data.

phase3
    Queries and downloads Phase 3 (processed, science-ready) data products. The tool uses the astroquery ESO module and supports authenticated access to proprietary data via the ESO User Portal.

REQUIREMENTS

•   Python >= 3.10

•   astroquery >= 0.4.12.dev10525

GLOBAL OPTIONS

--user USERNAME
    ESO User Portal username. Enables authenticated queries.

--deauthenticate
    Remove stored credentials for the given user from the keyring.

--max-rows N
    Maximum number of records returned (default: 100).

--with-calib raw|processed
    Download associated calibration files.

--count-only
    Print number of matching records and exit.

--metadata-only
    Write query results to CSV and exit without downloading data.

--outdir DIR
    Output directory for downloaded files (default: eso_downloads).

RAW OPTIONS

--run-id ID
    ESO Run ID (e.g. 090.C-0733(A)).

--instrument NAME
    Instrument name (e.g. FORS2).

--target-name NAME
    Target name substring match.

--ra DEG
    Right Ascension in degrees.

--dec DEG
    Declination in degrees.

--file-cat SCIENCE|CALIB|ACQUISITION
    Filter by data product category.

--start-date YYYY-MM-DD
    Start of observation date range.

--end-date YYYY-MM-DD
    End of observation date range.

PHASE3 OPTIONS

--proposal-id ID
    ESO Proposal ID (e.g. 094.B-0345(A)).

--collection NAME
    Survey/collection name (e.g. MUSE).

--instrument NAME
    Instrument name.

--facility NAME
    Facility name (e.g. ESO-VLT-U4).

--target-name NAME
    Target name substring match.

--ra DEG
    Right Ascension in degrees.

--dec DEG
    Declination in degrees.

--release-date-start YYYY-MM-DD
    Release date range start.

--release-date-end YYYY-MM-DD
    Release date range end.

--publication-date-start YYYY-MM-DD
    Publication date range start.

--publication-date-end YYYY-MM-DD
    Publication date range end.

AUTHENTICATION
If --user is provided, the tool prompts for the ESO password and stores it securely using the system keyring. To remove stored credentials:
    eso-download raw --user USERNAME --deauthenticate

OUTPUT
Query results are written to:
    query_results.csv in the specified output directory. Downloaded datasets are retrieved using astroquery and automatically uncompressed.

EXAMPLES
Count raw datasets:
    eso-download raw --run-id 090.C-0733(A) --count-only Download Phase3 data by target:
    eso-download phase3 --target-name "NGC 253" Query by sky position:
    eso-download raw --ra 129.0629 --dec -26.4093 --max-rows 20

EXIT STATUS
Returns 0 on success. Non-zero on authentication failure, version mismatch, or runtime errors.

AUTHOR
ESO Science Archive Group Man page written by ChatGPT (OpenAI)