suns 0.0.3

Sun celestial simulation crate for the MilkyWay SolarSystem workspace
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
60
61
62
63
64
65
66
67
68
69

# Changelog

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

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

## [0.0.3] - 2026-04-04

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

## [0.0.2] - 2025-04-02

### Added
- Comprehensive test coverage for all modules (267 tests total)
  - `events_tests` — 71 tests (solar flares, CMEs, sunspots)
  - `physics_tests` — 80 tests (energy transport, magnetic fields, nuclear fusion, stellar structure)
  - `plasma_tests` — 51 tests (corona, prominences, solar flare, solar wind)
  - `layers_tests` — 45 tests (chromosphere, convective zone, core, photosphere, radiative zone)
  - `interactions_tests` — 20 tests (radiation, solar wind interaction, tidal forces)
- Tests for `PlanetaryTidalInteraction` struct (`tidal_force_on_sun`, `tidal_dissipation_rate`, `stellar_angular_momentum_loss_rate`)
- Tests for coronal functions (`coronal_euv_flux`, `coronal_loop_density`, `CoronalRegion`)
- Tests for solar wind helpers (`drain_rate`, `bow_shock_standoff`, `parker_solution_speed`, `flare_ribbon_speed`)
- Tests for physics imports (`ConvectiveTransport`, `RadiativeTransfer`, `eddington_flux`, `granulation_power_spectrum`, `MagneticFieldRegion`, `cyclotron_frequency`, `dynamo_number`, `larmor_radius`, `magnetic_helicity`, `FusionReaction`, `hydrogen_consumption_rate`, `total_energy_generation_rate`, `StellarLayer`, `thermal_timescale`)
- Example `energy_transport_demo.rs` — full solar energy transport demonstration
- Example `corona_mapping.rs` — coronal structure mapping
- Example `solar_flare_sim.rs` — solar flare simulation

### Fixed
- All values properly consumed in tests — no `_` prefixed variables, `drop()`, or print macros used to suppress warnings
- Brunt-Väisälä frequency test now asserts `is_finite()` instead of discarding the result
- Clippy strict mode (`-D warnings`) passes with zero warnings

## [0.0.1] - 2025-03-31

### Added
- Initial release of the `suns` crate
- **Layers**: `core`, `radiative_zone`, `convective_zone`, `photosphere`, `chromosphere` modules
- **Physics**: `energy_transport`, `magnetic_fields`, `nuclear_fusion`, `stellar_structure` modules
- **Plasma**: `corona`, `prominences`, `solar_flare`, `solar_wind` modules
- **Events**: `solar_flares`, `coronal_mass_ejections`, `sunspots` modules
- **Interactions**: `radiation`, `solar_wind_interaction`, `tidal_forces` modules

---

## What is solid

- Complete solar physics simulation with 267+ tests across all subsystems
- PBR rendering pipeline with solar-specific material parameters
- Research-grade models for energy transport, magnetic fields, nuclear fusion, and stellar structure

## Points to watch

- Long-duration coronal mass ejection simulations need validation for extreme events
- Magnetic field reconnection edge cases

## Verdict

Production-ready Sun simulation engine with comprehensive test coverage and rendering endpoints for external visualization.

---

## Development notes

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