spherical#

A figure fishing a planet out of the sky above the four VLT unit telescopes, with the word spherical below

Find SPHERE observations in the archive and reduce IFS and IRDIS data to companion spectra and astrometry.

Install

First query

New to spherical

Install it, download the observation database and run a first query in Getting started. Then read How spherical works.

Reducing data

Follow a reduction of 51 Eri with IRDIS or IFS, then start from a reduction template and adjust it with the configuration reference and the TRAP settings. The How-to guides cover surveys, re-runs and long runs on a server.

Looking something up

Steps, commands, conventions and the Python API are in the Reference.

What spherical is and is not#

spherical has two halves. The first is a database of every SPHERE Observation sequence in the ESO archive, built from the file headers and matched to Gaia DR3 and the MOCA database of young stars. It holds metadata, such as the target, observing mode, conditions and quality flags, but no reduced data.

The second is a reduction pipeline for IFS data and for IRDIS dual-band imaging. It downloads a sequence, calibrates it, runs TRAP and measures the spectra and positions of companions. You run it from a Python script with execute_targets; there is no command-line tool for reductions. IRDIS polarimetry and sparse aperture masking are in the database for finding and downloading data, but the pipeline does not reduce them. Single-channel IRDIS modes run but are untested.

Citing#

If spherical supports your research, cite Samland (2025) and the papers listed on Citing.