asteroidsfactory 0.0.3

Asteroid factory — classify, build and catalogue asteroids of any type: near-Earth, main belt, trojan, centaur, binary, rubble pile, metallic, and potentially hazardous.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59

# Changelog

All notable changes to the `asteroidsfactory` crate are documented in this file.

Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).

## [0.0.2] - 2026-04-04

### Added
- Rendering module: mesh.rs (icosphere subdivision, LodLevel, Vertex, MeshData), lod.rs (pixel-precise adaptive LOD), materials.rs (PBR parameters), shaders.rs (shader parameters)
- `documentation` and `homepage` fields in Cargo.toml
- Celestial project link in README.md

## [0.0.1] - 2026-04-04

### Added
- Initial release of the `asteroidsfactory` crate
- **Config**: `parameters` module with AU, solar/Earth constants, sphere mass/volume, orbital helpers
- **Types**: 8 asteroid types with GeneratedAsteroid enum
  - `near_earth` — Apollo/Amor/Aten/Atira NEAs, MOID, Tisserand parameter, equilibrium temperature
  - `main_belt` — C/S/M/B/D/V/X spectral types, Kirkwood gap detection, Hill sphere
  - `trojan` — L4/L5 Lagrange points, libration period, stability parameter
  - `centaur` — Tisserand classification, cometary activity, snow line, dynamical lifetime
  - `binary` — Mutual orbital mechanics, stability, contact binary detection, Roche limit
  - `rubble_pile` — Porosity, spin barrier, YORP timescale, cohesionless strength
  - `metallic` — Iron/nickel fractions, differentiation, core radius, thermal conductivity
  - `pha` — Impact energy, Torino scale, crater diameter, deflection delta-v
- **Physics**: `gravity` (binding energy, Roche limits, tidal force, angular momentum), `thermal` (Yarkovsky, YORP, thermal inertia, skin depth)
- **Engine**: `orbits` (mean motion, synodic period, resonance width, Kozai-Lidov), `evolution` (collisional lifetime, space weathering, regolith), `collisions` (impact velocity, crater scaling, disruption threshold)
- **Observables**: `photometry` (absolute/apparent magnitude, thermal flux), `lightcurve` (amplitude, spin barrier, tumbling damping, binary eclipses)
- **Utils**: `helpers` (coordinate transforms, interpolation), `io` (summary formatting)
- All constructors follow `new()` + `with_*()` builder pattern
- 78 integration tests across types, physics, and engine modules
- 3 runnable examples: generation, physics, observables

---

## What is solid

- Full procedural asteroid generator with 8 types and builder pattern
- Research-grade physics: Yarkovsky effect, YORP spin-up, collisional evolution
- PBR rendering pipeline for asteroid visualisation

## Points to watch

- Rubble pile structural integrity at extreme spin rates
- Binary asteroid tidal evolution over long timescales

## Verdict

Complete procedural asteroid generation engine with rendering endpoints.

---

## Development notes

- Edition 2024, MIT license
- Dependencies use wildcard versions
- See `ComingSoon.md` for the detailed roadmap