A tool to explore, download, analyse, and classify asteroid reflectance spectra. Originally designed for classification in the taxonomy of Mahlke, Carry, and Mattei 2022, it now offers multiple taxonomic systems and a suite of quality-of-life features for spectroscopic analysis.

Showcase

Things that classy tries to do well. All functionality is available via the command line and the python interface. Some functionality is available via the web interface.

Explore and compare.

Quickly find and download spectra in public repositories.

Example: List all spectra of asteroids in the Themis family with albedos up to 0.06 that cover the 0.45-1.8μm range.

$ classy spectra --wave_min 0.45 --wave_max 1.8 --family Themis --albedo ,0.06
+-----------+--------+----------+----------+--------+---------------------+--------+--------+-----------------+
| name      | number | wave_min | wave_max | phase  | date_obs            | family | albedo | shortbib        |
+-----------+--------+----------+----------+--------+---------------------+--------+--------+-----------------+
| Themis    | 24     | 0.435    | 2.49     | 12.917 | 2005-10-08T05:28:30 | Themis | 0.051  | MITHNEOS Unpub. |
| Themis    | 24     | 0.45     | 2.4      | -      | -                   | Themis | 0.051  | Fornasier+ 2016 |
| Themis    | 24     | 0.435    | 2.49     | 12.876 | 2005-10-08T00:00:00 | Themis | 0.051  | DeMeo+ 2009     |
| Adorea    | 268    | 0.44     | 2.4      | -      | -                   | Themis | 0.039  | Fornasier+ 2016 |
| Lipperta  | 846    | 0.45     | 2.39     | -      | -                   | Themis | 0.05   | Fornasier+ 2016 |
| Lermontov | 2222   | 0.45     | 2.38     | -      | -                   | Themis | 0.051  | Fornasier+ 2016 |
+-----------+--------+----------+----------+--------+---------------------+--------+--------+-----------------+
                                                    6 Spectra

Analyse and classify.

Persistent preprocessing and feature recognition for quick classification.

Example: Classify the spectra above following Mahlke+ 2022, DeMeo+ 2009, and Tholen 1984.

$ classy classify --wave_min 0.45 --wave_max 1.8 --family Themis --albedo ,0.06
+-----------+--------+----------+----------+--------+--------------+-------------+--------------+-----------------+
| name      | number | wave_min | wave_max | albedo | class_mahlke | class_demeo | class_tholen | shortbib        |
+-----------+--------+----------+----------+--------+--------------+-------------+--------------+-----------------+
| Themis    | 24     | 0.435    | 2.490    | 0.0507 | C            | C           | G            | MITHNEOS Unpub. |
| Themis    | 24     | 0.450    | 2.400    | 0.0507 | C            | C           |              | Fornasier+ 2016 |
| Themis    | 24     | 0.435    | 2.490    | 0.0507 | C            | C           | G            | DeMeo+ 2009     |
| Adorea    | 268    | 0.440    | 2.400    | 0.0389 | S            |             |              | Fornasier+ 2016 |
| Lipperta  | 846    | 0.450    | 2.390    | 0.0504 | P            | X           |              | Fornasier+ 2016 |
| Lermontov | 2222   | 0.450    | 2.380    | 0.0513 | P            | C           |              | Fornasier+ 2016 |
+-----------+--------+----------+----------+--------+--------------+-------------+--------------+-----------------+
                                                      6 Spectra

Visualise and export.

Quick-look plots at any step to verify your analysis.

Example: Show the spectra and the classification results.

$ classy classify --wave_min 0.45 --wave_max 1.8 --family Themis --albedo ,0.06 --plot

Classified spectra

Install

classy is available on the python package index as space-classy:

$ pip install space-classy[gui]

Documentation

Check out the documentation at classy.readthedocs.io or run

 $ classy docs

Metadata

Release files for space-classy 0.8.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for space-classy 0.8.8
File	Size	Uploaded
space_classy-0.8.8.tar.gz	11.6 MB	Feb 5, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for space-classy 0.8.8
File	Interpreter	ABI	Platform	Reset
space_classy-0.8.8-py3-none-any.whl 11.6 MB Feb 5, 2026	Python 3	none	any	Details

Total release size: 23.2 MB

Release files / space_classy-0.8.8.tar.gz

Download URL	space_classy-0.8.8.tar.gz
Size	11.6 MB
Tags	Source
SHA-256 checksum How to use checksums	`b10daee7313a3ed5dd336d1d44dac726c1a59359bb14a9d740e096696cd41721`
BLAKE2b-256 checksum How to use checksums	`59b903a57ec02930bfedeb034fde4f8a68a261f9ffbbd8cdee50ed6ae87706b4`
Upload date	Feb 5, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.1.1 CPython/3.12.3 Linux/6.5.0-44-generic`

Release files / space_classy-0.8.8-py3-none-any.whl

Download URL	space_classy-0.8.8-py3-none-any.whl
Size	11.6 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`6b2ac1a7fb17b788f359a4847fae09fb4f387a4152fd513fa470671434f48be9`
BLAKE2b-256 checksum How to use checksums	`7ccea51fd420d5e16d1ed5ce9fcb190e4bd5e01d1355a8bbb882fd948f97c4e7`
Upload date	Feb 5, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.1.1 CPython/3.12.3 Linux/6.5.0-44-generic`