https://github.com/maxmahlke/rocks
for space-rocks :new_moon:
https://github.com/maxmahlke/rocks
asteroids astronomy planetary-science python
Last synced: 5 months ago
JSON representation
for space-rocks :new_moon:
- Host: GitHub
- URL: https://github.com/maxmahlke/rocks
- Owner: maxmahlke
- License: mit
- Created: 2020-05-10T11:03:47.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2025-10-16T14:17:23.000Z (8 months ago)
- Last Synced: 2025-10-17T17:21:06.420Z (8 months ago)
- Topics: asteroids, astronomy, planetary-science, python
- Language: Python
- Homepage: https://rocks.readthedocs.io/en/latest/
- Size: 70.5 MB
- Stars: 21
- Watchers: 4
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
Features - Install - Documentation
## Features
Explore asteroid data on the command-line...
``` sh
$ rocks id 221
(221) Eos
$ rocks class Eos
MB>Outer
$ rocks albedo Eos
0.136 +- 0.004
$ rocks taxonomy Eos
K
$ rocks density Eos
4.559e+03 +- 1.139e+03 kg/m$^3$
```
... and in a `python` script.
``` python
>>> import rocks
>>> rocks.identify("1902ug")
('Fortuna', 19)
>>> ceres = rocks.Rock("ceres")
>>> ceres.diameter.value
848.4
>>> ceres.diameter.unit
'km'
>>> ceres.mass.value
9.384e+20
>>> ceres.mass.error
6.711e+17
```
## Install
Install from PyPi using `pip`:
$ pip install space-rocks
The minimum required `python` version is 3.8.
## Documentation
Check out the documentation at [rocks.readthedocs.io](https://rocks.readthedocs.io/en/latest/) or run
$ rocks docs
For a quick overview, check out the jupyter notebooks:
[Basic Usage](https://github.com/maxmahlke/rocks/blob/master/docs/tutorials/rocks_basic_usage.ipynb) - [Bibliography Management](https://github.com/maxmahlke/rocks/blob/master/docs/tutorials/literature.ipynb)