# Coming Soon
SciForge is an ambitious, single-author scientific computing library written in pure Rust (edition 2024, zero dependencies). It aims to provide a comprehensive, reliable, and efficient ecosystem spanning multiple scientific domains.
The project is maintained solely by the author. Contributions, suggestions, and collaboration requests should follow the [Contributing](Contributing.md) guide.
## Legend
- `Implemented`: delivered and used in the codebase
- `Partial`: present but incomplete or not generalized
- `Remaining`: not finalized yet
## Current State (According to 0.0.1 Version)
| Documentation | Full API reference with input/output examples for every public function | Partial | `docs/code/*.md`, `docs/modules/*.md` | Generate an exhaustive reference for all public functions (`benchmark`, `hub`, `parser`) with runnable examples |
| Documentation | Tutorials and guided workflows (simulation, data analysis, cross-domain) | Partial | `README.md`, `docs/` | Add end-to-end scenario tutorials with expected inputs/outputs |
| Documentation | Module-level scientific model guides | Implemented | `docs/modules/Astronomy.md`, `docs/modules/Physics.md`, `docs/modules/Biology.md`, and others | Ongoing maintenance and enrichment |
| Extended Testing | Unit and integration tests for all scientific modules | Partial | `tests/constants/*`, `tests/maths/*`, `tests/physics/*`, `tests/chemistry/*`, `tests/biology/*`, `tests/geology/*`, `tests/astronomy/*`, `tests/meteorology/*` | Close remaining coverage gaps in less-tested submodules |
| Extended Testing | Property-style testing and edge-case validation | Implemented | `tests/scientific_properties.rs`, `tests/scientific_validation.rs` | Expand invariant coverage per domain |
| Extended Testing | Cross-module integration tests | Implemented | `tests/hub/cross_domain.rs`, `tests/hub/main.rs` | Add more multi-step cross-domain scenarios |
| Hub Expansion | Unified dispatch API through Hub | Implemented | `src/hub/engine/dispatch/*.rs` | Continue signature normalization |
| Hub Expansion | Ergonomic prelude re-exports | Implemented | `src/hub/prelude.rs` | Stabilize naming conventions |
| Hub Expansion | Domain query engine and tool pipelines | Implemented | `src/hub/engine/query.rs`, `src/hub/engine/pipeline/flow.rs`, `src/hub/engine/worker/scheduler.rs` | Add more predefined pipeline templates |
| Computational Enhancements | Performance benchmarking across scientific modules | Partial | `src/benchmark/*`, `tests/benchmark.rs`, `output/*/bmk/` | Complete a benchmark matrix for all major subdomains |
| Computational Enhancements | Memory-optimized structures for large-scale workloads | Partial | `src/hub/tools/arena.rs`, `src/hub/tools/profiler.rs` | Add systematic memory/performance evidence |
| Computational Enhancements | Deterministic and reproducible execution paths | Implemented | `src/hub/tools/deterministic.rs` | Extend reproducibility assertions in tests |
| Future Features | Interactive visualization utilities | Implemented | `src/hub/tools/visualization.rs`, `src/benchmark/export.rs` | Add more visualization templates |
| Future Features | Extended cross-domain analysis tools (astrochem, geophysics, bioinformatics, etc.) | Partial | `src/biology/bioinformatics/*`, cross-domain dispatch paths in `src/hub/engine/dispatch/*` | Expand explicit coupled-domain coverage (astrochem/geophysics) |
| Future Features | Additional export formats and reporting | Implemented | HTML/MD/CSV/JSON/YAML/TOML export via `src/benchmark/export.rs` and `output/` | Add cross-format validation schemas |
| Future Features | Automated scientific validation pipeline | Partial | `tests/scientific_validation.rs` + `output/validation/` artifacts | Formalize a single pipeline command with gating thresholds |
## Quantitative Summary
| Implemented | 9 |
| Partial | 8 |
| Remaining | 0 |
## Priority Backlog (Remaining Work For 0.0.3 Version)
1. Refactor files containing more than 600 lines to improve maintainability, readability, and long-term evolution (split 'src/benchmark/*/', 'tests/parsersrs' 'and tests/benchmark.rs').
2. Produce a complete API reference focused on real public functions.
3. Add reproducible guided tutorials (Hub + Parser + Benchmark).
4. Complete test coverage in less-covered scientific submodules.
5. Define a single "scientific validation pipeline" command with blocking thresholds.
6. Expand coupled cross-domain scenarios (astrochemistry/geophysics) with numeric validations.
7. Readable .bmk into html files.
8. Small demo usable to test all the crate.
## Next Priorities (0.0.4 Version)
1. Add uncertainty quantification workflows (Monte Carlo, bootstrap, error propagation) for scientific models.
2. Add heuristic optimization algorithms (simulated annealing, genetic algorithms, particle swarm optimization).
3. Add wavelet and spectral analysis tools for astronomy, seismology, meteorology, and signal-heavy domains.
4. Add lightweight Bayesian inference utilities for data exploration and inverse-problem workflows.
5. Add PCA and clustering utilities for dimensionality reduction, structure discovery, and exploratory analysis.
6. Adding all the following constants and functions:
### 1️⃣ Fundamental / Quantum Physics
| Fermi constant | `G_F` | 1.1663787×10⁻⁵ | GeV⁻² | fundamental |
| Strong coupling constant | `ALPHA_S` | 0.1181 | dimensionless | fundamental |
| Muon mass | `MUON_MASS` | 1.883531627×10⁻²⁸ | kg | atomic |
| Tau mass | `TAU_MASS` | 3.16747×10⁻²⁷ | kg | atomic |
| Neutrino mass | `NEUTRINO_MASS` | ≤2.2×10⁻³⁶ | kg | atomic |
| Rydberg constant | `R_INF` | 10973731.56816 | m⁻¹ | atomic |
### 2️⃣ Astronomy / Cosmology
| Solar density | `SOLAR_DENSITY` | 1.408 | g/cm³ | astro |
| Solar surface gravity | `SOLAR_GRAVITY` | 274 | m/s² | astro |
| Earth surface gravity | `EARTH_GRAVITY` | 9.80665 | m/s² | astro |
| Mars radius | `MARS_RADIUS` | 3.3895×10⁶ | m | astro |
| Mars mass | `MARS_MASS` | 6.417×10²³ | kg | astro |
| Cosmological constant | `COSMOLOGICAL_LAMBDA` | 1.1056×10⁻⁵² | m⁻² | astro |
| Day | `DAY` | 86400 | s | units |
| Julian year | `JULIAN_YEAR` | 365.25×DAY | s | units |
### 3️⃣ Chemistry / Elements
| Standard density | `ELEMENT_DENSITY_Z` | variable | g/cm³ | elements |
| Melting point | `ELEMENT_MELTING_Z` | variable | K | elements |
| Boiling point | `ELEMENT_BOILING_Z` | variable | K | elements |
| Standard state | `ELEMENT_STATE_Z` | variable | — | elements |
| Electron configuration | `ELEMENT_ECONFIG_Z` | variable | — | elements |
### 4️⃣ Units / Additional Conversions
| kWh to J | `KWH_TO_J` | 3.6×10⁶ | units |
| MeV to J | `MEV_TO_J` | 1.60218×10⁻¹³ | units |
| Day to s | `DAY` | 86400 | units |
| Year to s | `YEAR` | 365.25×DAY | units |