space-classy 0.8.2

classification tool for minor bodies using reflectance spectra and visual albedos

Features - Install - Documentation

Features

• Classify asteroid reflectance spectra in the taxonomic scheme by Mahlke, Carry, and Mattei 2022.

• Add spectra from public repositories for comparison

• Explore data via the command line, build an analysis with the python interface

• Simple syntax: specify the asteroid to analyse, classy takes care of the rest

$ classy spectra juno --classify

or

>>> import classy
>>> spectra = classy.Spectra(3)
... [classy] Found 1 spectrum in Gaia
... [classy] Found 5 spectra in SMASS
>>> spectra.classify()
... [classy] [(3) Juno] - [Gaia]: S
... [classy] [(3) Juno] - [spex/sp96]: S
... [classy] [(3) Juno] - [smass/smassir]: S
... [classy] [(3) Juno] - [smass/smass1]: S
... [classy] [(3) Juno] - [smass/smass2]: S
... [classy] [(3) Juno] - [smass/smass2]: S
>>> spectra.to_csv('class_juno.csv')

Install

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

$ pip install space-classy

To use interactive GUI features, you'll also need to install one of these packages to work with pyqtgraph: PyQt5, PyQt6, PySide2, or PySide6. Running pip install space-classy[gui] will automatically install space-classy alone with one of the necessary GUI libraries.

Documentation

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

 $ classy docs

Data

The following data files are provided in this repository (format csv and txt) and at the CDS (format txt):

File csv	File txt	Content	Description
class_templates.csv	template.txt	Class templates	Mean and standard deviation of the VisNIR spectra and visual albedos for each class.
class_visnir.csv	classvni.txt	Classifications of the VisNIR sample.	Classes derived for the 2983 input observations used to derive the taxonomy.
class_vis.csv	classvis.txt	Classifications of the vis-only sample.	Classes derived for the 2923 input observations containing only visible spectra and albedos.
class_asteroid.csv	asteroid.txt	Class per asteroid	Aggregated classifications in VisNIR and vis-only samples with one class per asteroid.
ref_spectra.csv	refspect.txt	References of spectra	The key to the spectra references used in the classification tables.
ref_albedo.csv	refalbed.txt	References of albedos	The key to the albedo references used in the classification tables.

More information on each file can be found in the data/mahlke2022/ReadMe.