space-classy


Namespace-classy JSON
Version 0.8.5 PyPI version JSON
download
home_pagehttps://github.com/maxmahlke/classy
Summaryclassification tool for minor bodies using reflectance spectra and visual albedos
upload_time2024-06-21 07:50:34
maintainerNone
docs_urlNone
authorMax Mahlke
requires_python>=3.8
licenseMIT
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <p align="center">
  <img width="260" src="https://raw.githubusercontent.com/maxmahlke/classy/master/docs/_static/logo_classy.svg">
</p>

<p align="center">
  <a href="https://github.com/maxmahlke/classy#features"> Showcase </a> - <a href="https://github.com/maxmahlke/classy#install"> Install </a> - <a href="https://github.com/maxmahlke/classy#documentation"> Documentation </a>
</p>

<br>

<div align="center">
  <a href="https://img.shields.io/pypi/pyversions/space-classy">
    <img src="https://img.shields.io/pypi/pyversions/space-classy"/>
  </a>
  <a href="https://img.shields.io/pypi/v/space-classy">
    <img src="https://img.shields.io/pypi/v/space-classy"/>
  </a>
  <a href="https://readthedocs.org/projects/classy/badge/?version=latest">
    <img src="https://readthedocs.org/projects/classy/badge/?version=latest"/>
  </a>
  <a href="https://arxiv.org/abs/2203.11229">
    <img src="https://img.shields.io/badge/arXiv-2203.11229-f9f107.svg"/>
  </a>
</div>

<br>

A tool to explore, download, analyse, and classify asteroid reflectance
spectra. Originally designed for classification in the taxonomy of [Mahlke,
Carry, and Mattei 2022](https://arxiv.org/abs/2203.11229), 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](https://classy.streamlit.app).

**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.

```shell
$ 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.

```shell
$ 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.

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

![Classified spectra](https://classy.readthedocs.io/en/latest/_images/spectra_classified_dark.png)

# Install

`classy` is available on the [python package index](https://pypi.org) as `space-classy`:

``` sh
$ pip install space-classy[gui]
```

# Documentation

Check out the documentation at [classy.readthedocs.io](https://classy.readthedocs.io/en/latest/) or run

     $ classy docs

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/maxmahlke/classy",
    "name": "space-classy",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": null,
    "author": "Max Mahlke",
    "author_email": "max.mahlke@oca.eu",
    "download_url": "https://files.pythonhosted.org/packages/82/36/3f5190d6f9330ecbd19b35d9ebdee4112e9bc15e6f06de5c54696b9ba7a3/space_classy-0.8.5.tar.gz",
    "platform": null,
    "description": "<p align=\"center\">\n  <img width=\"260\" src=\"https://raw.githubusercontent.com/maxmahlke/classy/master/docs/_static/logo_classy.svg\">\n</p>\n\n<p align=\"center\">\n  <a href=\"https://github.com/maxmahlke/classy#features\"> Showcase </a> - <a href=\"https://github.com/maxmahlke/classy#install\"> Install </a> - <a href=\"https://github.com/maxmahlke/classy#documentation\"> Documentation </a>\n</p>\n\n<br>\n\n<div align=\"center\">\n  <a href=\"https://img.shields.io/pypi/pyversions/space-classy\">\n    <img src=\"https://img.shields.io/pypi/pyversions/space-classy\"/>\n  </a>\n  <a href=\"https://img.shields.io/pypi/v/space-classy\">\n    <img src=\"https://img.shields.io/pypi/v/space-classy\"/>\n  </a>\n  <a href=\"https://readthedocs.org/projects/classy/badge/?version=latest\">\n    <img src=\"https://readthedocs.org/projects/classy/badge/?version=latest\"/>\n  </a>\n  <a href=\"https://arxiv.org/abs/2203.11229\">\n    <img src=\"https://img.shields.io/badge/arXiv-2203.11229-f9f107.svg\"/>\n  </a>\n</div>\n\n<br>\n\nA tool to explore, download, analyse, and classify asteroid reflectance\nspectra. Originally designed for classification in the taxonomy of [Mahlke,\nCarry, and Mattei 2022](https://arxiv.org/abs/2203.11229), it now offers\nmultiple taxonomic systems and a suite of quality-of-life features for\nspectroscopic analysis.\n\n# Showcase\n\nThings that ``classy`` tries to do well. All functionality is available via the command line and the `python` interface.\nSome functionality is available via the [web interface](https://classy.streamlit.app).\n\n**Explore and compare.**\n\nQuickly find and download spectra in public repositories.\n\n*Example*: List all spectra of asteroids in the Themis family with albedos up to 0.06 that cover the 0.45-1.8\u03bcm range.\n\n```shell\n$ classy spectra --wave_min 0.45 --wave_max 1.8 --family Themis --albedo ,0.06\n+-----------+--------+----------+----------+--------+---------------------+--------+--------+-----------------+\n| name      | number | wave_min | wave_max | phase  | date_obs            | family | albedo | shortbib        |\n+-----------+--------+----------+----------+--------+---------------------+--------+--------+-----------------+\n| Themis    | 24     | 0.435    | 2.49     | 12.917 | 2005-10-08T05:28:30 | Themis | 0.051  | MITHNEOS Unpub. |\n| Themis    | 24     | 0.45     | 2.4      | -      | -                   | Themis | 0.051  | Fornasier+ 2016 |\n| Themis    | 24     | 0.435    | 2.49     | 12.876 | 2005-10-08T00:00:00 | Themis | 0.051  | DeMeo+ 2009     |\n| Adorea    | 268    | 0.44     | 2.4      | -      | -                   | Themis | 0.039  | Fornasier+ 2016 |\n| Lipperta  | 846    | 0.45     | 2.39     | -      | -                   | Themis | 0.05   | Fornasier+ 2016 |\n| Lermontov | 2222   | 0.45     | 2.38     | -      | -                   | Themis | 0.051  | Fornasier+ 2016 |\n+-----------+--------+----------+----------+--------+---------------------+--------+--------+-----------------+\n                                                    6 Spectra\n```\n\n**Analyse and classify.**\n\nPersistent preprocessing and feature recognition for quick classification.\n\n*Example*: Classify the spectra above following Mahlke+ 2022, DeMeo+ 2009, and Tholen 1984.\n\n```shell\n$ classy classify --wave_min 0.45 --wave_max 1.8 --family Themis --albedo ,0.06\n+-----------+--------+----------+----------+--------+--------------+-------------+--------------+-----------------+\n| name      | number | wave_min | wave_max | albedo | class_mahlke | class_demeo | class_tholen | shortbib        |\n+-----------+--------+----------+----------+--------+--------------+-------------+--------------+-----------------+\n| Themis    | 24     | 0.435    | 2.490    | 0.0507 | C            | C           | G            | MITHNEOS Unpub. |\n| Themis    | 24     | 0.450    | 2.400    | 0.0507 | C            | C           |              | Fornasier+ 2016 |\n| Themis    | 24     | 0.435    | 2.490    | 0.0507 | C            | C           | G            | DeMeo+ 2009     |\n| Adorea    | 268    | 0.440    | 2.400    | 0.0389 | S            |             |              | Fornasier+ 2016 |\n| Lipperta  | 846    | 0.450    | 2.390    | 0.0504 | P            | X           |              | Fornasier+ 2016 |\n| Lermontov | 2222   | 0.450    | 2.380    | 0.0513 | P            | C           |              | Fornasier+ 2016 |\n+-----------+--------+----------+----------+--------+--------------+-------------+--------------+-----------------+\n                                                      6 Spectra\n```\n\n**Visualise and export.**\n\nQuick-look plots at any step to verify your analysis.\n\n*Example*: Show the spectra and the classification results.\n\n```shell\n$ classy classify --wave_min 0.45 --wave_max 1.8 --family Themis --albedo ,0.06 --plot\n```\n\n![Classified spectra](https://classy.readthedocs.io/en/latest/_images/spectra_classified_dark.png)\n\n# Install\n\n`classy` is available on the [python package index](https://pypi.org) as `space-classy`:\n\n``` sh\n$ pip install space-classy[gui]\n```\n\n# Documentation\n\nCheck out the documentation at [classy.readthedocs.io](https://classy.readthedocs.io/en/latest/) or run\n\n     $ classy docs\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "classification tool for minor bodies using reflectance spectra and visual albedos",
    "version": "0.8.5",
    "project_urls": {
        "Documentation": "https://classy.readthedocs.io/en/latest/",
        "Homepage": "https://github.com/maxmahlke/classy",
        "Repository": "https://github.com/maxmahlke/classy.git"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "55edf6f51906bb8099dc263d935dd225d970e6c23d18ec33364a3f1f2ddeee5d",
                "md5": "bab78b2a2bdacde8705e94d3b6b4a7e7",
                "sha256": "8cf080528e3ddebf392821c829d8ea9e26b37f7340837b31e6ef94cf12f91965"
            },
            "downloads": -1,
            "filename": "space_classy-0.8.5-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "bab78b2a2bdacde8705e94d3b6b4a7e7",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 11644614,
            "upload_time": "2024-06-21T07:50:29",
            "upload_time_iso_8601": "2024-06-21T07:50:29.970757Z",
            "url": "https://files.pythonhosted.org/packages/55/ed/f6f51906bb8099dc263d935dd225d970e6c23d18ec33364a3f1f2ddeee5d/space_classy-0.8.5-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "82363f5190d6f9330ecbd19b35d9ebdee4112e9bc15e6f06de5c54696b9ba7a3",
                "md5": "5e3378e8a2222c9bf06db12a870083c9",
                "sha256": "31d666da4fcfc8c6a1ba58858acebab8bfb1320ce7b21081ee880ccab77b4be7"
            },
            "downloads": -1,
            "filename": "space_classy-0.8.5.tar.gz",
            "has_sig": false,
            "md5_digest": "5e3378e8a2222c9bf06db12a870083c9",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 11553025,
            "upload_time": "2024-06-21T07:50:34",
            "upload_time_iso_8601": "2024-06-21T07:50:34.104118Z",
            "url": "https://files.pythonhosted.org/packages/82/36/3f5190d6f9330ecbd19b35d9ebdee4112e9bc15e6f06de5c54696b9ba7a3/space_classy-0.8.5.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-06-21 07:50:34",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "maxmahlke",
    "github_project": "classy",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "tox": true,
    "lcname": "space-classy"
}
        
Elapsed time: 0.27837s