<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>SciForge - Project Presentation</title>
<style>
*{margin:0;padding:0;box-sizing:border-box}
:root{--bg:#0d1117;--surface:#161b22;--border:#30363d;--text:#c9d1d9;--muted:#8b949e;--blue:#58a6ff;--lightblue:#79c0ff;--green:#7ee787;--orange:#ffa657;--red:#f85149;--purple:#d2a8ff}
body{font-family:system-ui,-apple-system,sans-serif;background:var(--bg);color:var(--text);line-height:1.6}
a{color:var(--blue);text-decoration:none}a:hover{text-decoration:underline}
.hero{text-align:center;padding:4em 2em 3em;background:linear-gradient(180deg,#161b22 0%,#0d1117 100%);border-bottom:1px solid var(--border)}
.hero h1{font-size:3.5em;color:var(--blue);margin-bottom:.2em;letter-spacing:-.02em}
.hero .sub{font-size:1.3em;color:var(--muted);max-width:700px;margin:0 auto}
.hero .badges{margin-top:1.2em;display:flex;gap:.6em;justify-content:center;flex-wrap:wrap}
.badge{display:inline-block;padding:.3em .9em;border-radius:20px;font-size:.8em;font-weight:600;border:1px solid var(--border)}
.badge.rust{background:#3a1d0a;color:var(--orange)}
.badge.mit{background:#0a2a3a;color:var(--lightblue)}
.badge.zero{background:#0d2610;color:var(--green)}
.badge.tests{background:#1a0d2a;color:var(--purple)}
.container{max-width:1400px;margin:0 auto;padding:2em}
.stats-row{display:grid;grid-template-columns:repeat(auto-fill,minmax(200px,1fr));gap:1em;margin:2em 0}
.stat{background:var(--surface);border:1px solid var(--border);border-radius:10px;padding:1.5em;text-align:center}
.stat .num{font-size:2.5em;font-weight:800;color:var(--blue);line-height:1}
.stat .lbl{font-size:.85em;color:var(--muted);margin-top:.3em}
section{margin:3em 0}
section>h2{color:var(--blue);font-size:1.8em;margin-bottom:.8em;padding-bottom:.4em;border-bottom:1px solid var(--border)}
section>h3{color:var(--lightblue);font-size:1.2em;margin:1.5em 0 .6em}
.mod-grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(280px,1fr));gap:1em}
.mod-card{background:var(--surface);border:1px solid var(--border);border-radius:10px;padding:1.2em;transition:border-color .2s}
.mod-card:hover{border-color:var(--blue)}
.mod-card .name{font-size:1.1em;font-weight:700;color:var(--text)}
.mod-card .meta{font-size:.8em;color:var(--muted);margin-top:.4em;display:flex;gap:1em}
.mod-card .bar{height:4px;border-radius:2px;background:var(--border);margin-top:.6em;overflow:hidden}
.mod-card .bar-fill{height:100%;border-radius:2px}
.mod-card .status{display:inline-block;padding:2px 8px;border-radius:10px;font-size:.7em;font-weight:600;margin-top:.5em}
.status-tested{background:#0d2a1a;color:var(--green)}
.status-impl{background:#1a1d2a;color:var(--lightblue)}
.status-pending{background:#2a1a0a;color:var(--orange)}
.charts{display:grid;grid-template-columns:repeat(auto-fill,minmax(480px,1fr));gap:1.5em;margin:1.5em 0}
.chart-box{background:var(--surface);border:1px solid var(--border);border-radius:10px;padding:1.5em}
.chart-box h3{color:var(--lightblue);font-size:1em;margin-bottom:1em}
.nav{display:flex;gap:0;border-bottom:2px solid var(--border);margin-bottom:0;flex-wrap:wrap;background:var(--surface);position:sticky;top:0;z-index:100}
.nav-btn{padding:.8em 1.5em;cursor:pointer;background:none;border:none;color:var(--muted);font-weight:600;font-size:.9em;transition:color .15s,border-color .15s;border-bottom:2px solid transparent;margin-bottom:-2px}
.nav-btn:hover{color:var(--text)}
.nav-btn.active{color:var(--blue);border-bottom-color:var(--blue)}
.page{display:none;padding:2em}
.page.active{display:block}
.md-tabs{display:flex;gap:0;margin-bottom:0;flex-wrap:wrap}
.md-tab{padding:.6em 1.2em;cursor:pointer;background:var(--surface);border:1px solid var(--border);border-bottom:none;border-radius:6px 6px 0 0;color:var(--muted);font-weight:600;font-size:.85em}
.md-tab:hover{color:var(--text)}
.md-tab.active{background:var(--bg);color:var(--blue);border-bottom:1px solid var(--bg)}
.md-panel{display:none;border:1px solid var(--border);padding:2em;border-radius:0 6px 6px 6px;background:var(--bg)}
.md-panel.active{display:block}
.example-tabs{display:flex;gap:0;margin-bottom:0;flex-wrap:wrap}
.ex-tab{padding:.6em 1.2em;cursor:pointer;background:var(--surface);border:1px solid var(--border);border-bottom:none;border-radius:6px 6px 0 0;color:var(--muted);font-weight:600;font-size:.85em}
.ex-tab:hover{color:var(--text)}
.ex-tab.active{background:var(--bg);color:var(--blue);border-bottom:1px solid var(--bg)}
.ex-panel{display:none;border:1px solid var(--border);border-radius:0 6px 6px 6px;background:var(--bg);overflow:hidden}
.ex-panel.active{display:block}
.example-frame{width:100%;height:80vh;border:none;border-radius:0 0 6px 6px}
.md-panel h1{color:var(--blue);font-size:2em;margin:.8em 0 .4em;padding-bottom:.3em;border-bottom:1px solid var(--border)}
.md-panel h2{color:var(--lightblue);font-size:1.5em;margin:1.2em 0 .4em;padding-bottom:.2em;border-bottom:1px solid var(--border)}
.md-panel h3{color:var(--lightblue);font-size:1.2em;margin:1em 0 .3em}
.md-panel h4{color:var(--text);font-size:1em;margin:.8em 0 .3em}
.md-panel p{margin:.5em 0}
.md-panel blockquote{border-left:3px solid var(--blue);padding:.5em 1em;margin:.8em 0;color:var(--muted);background:var(--surface);border-radius:0 6px 6px 0}
.md-panel ul,.md-panel ol{margin:.5em 0 .5em 1.5em}
.md-panel li{margin:.2em 0}
.md-panel table{border-collapse:collapse;width:100%;margin:1em 0}
.md-panel th,.md-panel td{border:1px solid var(--border);padding:6px 10px;text-align:left;font-size:.85em}
.md-panel th{background:var(--surface);color:var(--blue)}
.md-panel tr:nth-child(even){background:var(--surface)}
.md-panel pre{background:var(--surface);padding:1em;border-radius:6px;overflow-x:auto;margin:.8em 0}
.md-panel code{font-family:ui-monospace,'Cascadia Code',monospace;font-size:.9em;background:var(--surface);padding:2px 6px;border-radius:4px}
.md-panel pre code{background:none;padding:0}
.md-panel hr{border:none;border-top:1px solid var(--border);margin:1.5em 0}
.md-panel .badges{display:flex;gap:.5em;flex-wrap:wrap;margin:.5em 0}
.progress-legend{display:flex;flex-wrap:wrap;gap:1.5em;margin:1em 0;font-size:.85em}
.progress-legend .dot{width:12px;height:12px;border-radius:50%;display:inline-block;margin-right:6px;vertical-align:middle}
footer{text-align:center;padding:2em;color:var(--muted);font-size:.85em;border-top:1px solid var(--border);margin-top:3em}
.features-grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(300px,1fr));gap:1.2em;margin:1.5em 0}
.feature{background:var(--surface);border:1px solid var(--border);border-radius:10px;padding:1.5em;display:flex;gap:1em;align-items:flex-start;transition:border-color .2s}
.feature:hover{border-color:var(--blue)}
.feature .icon{font-size:1.8em;line-height:1;flex-shrink:0}
.feature .ft-title{font-weight:700;color:var(--text);margin-bottom:.3em}
.feature .ft-desc{font-size:.85em;color:var(--muted)}
.philosophy{background:var(--surface);border:1px solid var(--border);border-radius:10px;padding:2em;margin:1.5em 0}
.philosophy ul{list-style:none;display:grid;grid-template-columns:repeat(auto-fill,minmax(280px,1fr));gap:.8em;margin-top:1em}
.philosophy li{padding:.6em 1em;background:var(--bg);border:1px solid var(--border);border-left:3px solid var(--blue);border-radius:0 6px 6px 0;font-size:.9em}
.donut-row{display:grid;grid-template-columns:repeat(3,1fr);gap:1.5em;margin:1.5em 0}
.donut-card{background:var(--surface);border:1px solid var(--border);border-radius:10px;padding:1.5em;text-align:center}
.donut-card h4{color:var(--muted);font-size:.9em;margin-top:.5em}
.page table{border-collapse:collapse;width:100%;margin:1em 0}
.page th,.page td{border:1px solid var(--border);padding:8px 12px;text-align:left;font-size:.85em}
.page th{background:var(--surface);color:var(--blue)}
.page tr:nth-child(even){background:var(--surface)}
.page code{font-family:ui-monospace,'Cascadia Code',monospace;font-size:.9em;background:#21262d;padding:2px 6px;border-radius:4px}
.pass{color:var(--green);font-weight:600}
.fail{color:var(--red)}
.milestone{display:grid;grid-template-columns:180px 1fr 250px;gap:1em;align-items:center;padding:.7em 0;border-bottom:1px solid var(--border)}
.milestone:last-child{border-bottom:none}
.ms-label{font-weight:600;font-size:.9em}
.ms-bar{height:10px;background:#21262d;border-radius:5px;overflow:hidden}
.ms-fill{height:100%;border-radius:5px}
.ms-val{font-size:.8em;color:var(--muted);text-align:right}
</style>
</head>
<body>
<div class="hero">
<img src="Sciforge.png" alt="SciForge" style="max-width:500px;width:100%;height:auto;margin-bottom:1em">
<p class="sub">A comprehensive scientific computing library written in pure Rust — zero dependencies, 11 modules, 48 600+ lines of code.</p>
<div class="badges">
<span class="badge rust">Rust Edition 2024</span>
<span class="badge mit">MIT License</span>
<span class="badge zero">Zero Dependencies</span>
<span class="badge tests">94 Tests Passing</span>
</div>
</div>
<nav class="nav">
<button class="nav-btn active" onclick="showPage('overview')">Overview</button>
<button class="nav-btn" onclick="showPage('modules')">Modules</button>
<button class="nav-btn" onclick="showPage('progress')">Progress</button>
<button class="nav-btn" onclick="showPage('docs')">Documentation</button>
<button class="nav-btn" onclick="showPage('examples')">Examples</button>
</nav>
<div id="page-overview" class="page active">
<div class="container">
<div class="stats-row">
<div class="stat"><div class="num">11</div><div class="lbl">Modules</div></div>
<div class="stat"><div class="num">131</div><div class="lbl">Submodules</div></div>
<div class="stat"><div class="num">5074</div><div class="lbl">Public APIs</div></div>
<div class="stat"><div class="num">575</div><div class="lbl">Source Files</div></div>
<div class="stat"><div class="num">48 612</div><div class="lbl">Lines of Code</div></div>
<div class="stat"><div class="num">94</div><div class="lbl">Tests</div></div>
<div class="stat"><div class="num">118</div><div class="lbl">Elements</div></div>
<div class="stat"><div class="num">0</div><div class="lbl">Dependencies</div></div>
</div>
<section>
<h2>Key Features</h2>
<div class="features-grid">
<div class="feature"><div class="icon">⚡</div><div><div class="ft-title">Pure Rust, Zero Dependencies</div><div class="ft-desc">Built entirely from scratch using only the standard library — no external crates, no hidden costs, fully auditable.</div></div></div>
<div class="feature"><div class="icon">🧬</div><div><div class="ft-title">11 Scientific Domains</div><div class="ft-desc">Constants, Mathematics, Physics, Chemistry, Biology, Geology, Astronomy, Meteorology, Hub, Benchmark, and Parser.</div></div></div>
<div class="feature"><div class="icon">🧪</div><div><div class="ft-title">5 074 Public APIs</div><div class="ft-desc">Comprehensive function coverage across all scientific domains — from matrix operations to protein folding, orbital mechanics to enzyme kinetics.</div></div></div>
<div class="feature"><div class="icon">⚛️</div><div><div class="ft-title">118 Elements — IUPAC 2024</div><div class="ft-desc">Complete periodic table with atomic mass, electron configuration, isotopes, oxidation states, and physical properties.</div></div></div>
<div class="feature"><div class="icon">📊</div><div><div class="ft-title">Benchmark Pipeline</div><div class="ft-desc">Full engine with encode/decode, simulation, reporting, and interactive HTML export with SVG charts and dark theme.</div></div></div>
<div class="feature"><div class="icon">📄</div><div><div class="ft-title">Multi-Format Parser</div><div class="ft-desc">CSV, JSON, YAML, Markdown, and HTML parsing — all from scratch, zero dependencies, with a unified API surface.</div></div></div>
</div>
</section>
<section>
<h2>Architecture</h2>
<p>SciForge is organized into 8 scientific domain modules, a central Hub dispatch, a Benchmark pipeline, and a multi-format Parser — all under a single crate with zero external dependencies.</p>
<div class="charts">
<div class="chart-box">
<h3>Module Size (Public APIs)</h3>
<svg width="100%" viewBox="0 0 700 400" xmlns="http://www.w3.org/2000/svg">
<text x="10" y="28" fill="#c9d1d9" font-size="13" font-family="system-ui">Constants</text><rect x="140" y="10" width="400" height="24" rx="4" fill="#21262d"/><rect x="140" y="10" width="9.2" height="24" rx="4" fill="#7ee787"/><text x="600" y="28" fill="#8b949e" font-size="12" font-family="system-ui" text-anchor="end">57</text><text x="10" y="63" fill="#c9d1d9" font-size="13" font-family="system-ui">Mathematics</text><rect x="140" y="45" width="400" height="24" rx="4" fill="#21262d"/><rect x="140" y="45" width="158.0" height="24" rx="4" fill="#79c0ff"/><text x="600" y="63" fill="#8b949e" font-size="12" font-family="system-ui" text-anchor="end">977</text><text x="10" y="98" fill="#c9d1d9" font-size="13" font-family="system-ui">Physics</text><rect x="140" y="80" width="400" height="24" rx="4" fill="#21262d"/><rect x="140" y="80" width="102.8" height="24" rx="4" fill="#d2a8ff"/><text x="600" y="98" fill="#8b949e" font-size="12" font-family="system-ui" text-anchor="end">636</text><text x="10" y="133" fill="#c9d1d9" font-size="13" font-family="system-ui">Chemistry</text><rect x="140" y="115" width="400" height="24" rx="4" fill="#21262d"/><rect x="140" y="115" width="74.7" height="24" rx="4" fill="#ffa657"/><text x="600" y="133" fill="#8b949e" font-size="12" font-family="system-ui" text-anchor="end">462</text><text x="10" y="168" fill="#c9d1d9" font-size="13" font-family="system-ui">Biology</text><rect x="140" y="150" width="400" height="24" rx="4" fill="#21262d"/><rect x="140" y="150" width="400.0" height="24" rx="4" fill="#f97583"/><text x="600" y="168" fill="#8b949e" font-size="12" font-family="system-ui" text-anchor="end">2474</text><text x="10" y="203" fill="#c9d1d9" font-size="13" font-family="system-ui">Geology</text><rect x="140" y="185" width="400" height="24" rx="4" fill="#21262d"/><rect x="140" y="185" width="7.1" height="24" rx="4" fill="#f0b27a"/><text x="600" y="203" fill="#8b949e" font-size="12" font-family="system-ui" text-anchor="end">44</text><text x="10" y="238" fill="#c9d1d9" font-size="13" font-family="system-ui">Astronomy</text><rect x="140" y="220" width="400" height="24" rx="4" fill="#21262d"/><rect x="140" y="220" width="7.9" height="24" rx="4" fill="#bc8cff"/><text x="600" y="238" fill="#8b949e" font-size="12" font-family="system-ui" text-anchor="end">49</text><text x="10" y="273" fill="#c9d1d9" font-size="13" font-family="system-ui">Meteorology</text><rect x="140" y="255" width="400" height="24" rx="4" fill="#21262d"/><rect x="140" y="255" width="7.1" height="24" rx="4" fill="#56d4dd"/><text x="600" y="273" fill="#8b949e" font-size="12" font-family="system-ui" text-anchor="end">44</text><text x="10" y="308" fill="#c9d1d9" font-size="13" font-family="system-ui">Hub</text><rect x="140" y="290" width="400" height="24" rx="4" fill="#21262d"/><rect x="140" y="290" width="34.3" height="24" rx="4" fill="#58a6ff"/><text x="600" y="308" fill="#8b949e" font-size="12" font-family="system-ui" text-anchor="end">212</text><text x="10" y="343" fill="#c9d1d9" font-size="13" font-family="system-ui">Benchmark</text><rect x="140" y="325" width="400" height="24" rx="4" fill="#21262d"/><rect x="140" y="325" width="4.7" height="24" rx="4" fill="#7ee7b0"/><text x="600" y="343" fill="#8b949e" font-size="12" font-family="system-ui" text-anchor="end">29</text><text x="10" y="378" fill="#c9d1d9" font-size="13" font-family="system-ui">Parser</text><rect x="140" y="360" width="400" height="24" rx="4" fill="#21262d"/><rect x="140" y="360" width="14.6" height="24" rx="4" fill="#ff7eb6"/><text x="600" y="378" fill="#8b949e" font-size="12" font-family="system-ui" text-anchor="end">90</text></svg>
</div>
<div class="chart-box">
<h3>Submodule Distribution</h3>
<svg width="100%" viewBox="0 0 700 400" xmlns="http://www.w3.org/2000/svg">
<path d="M200,200 L350.0,200.0 A150,150 0 0,1 345.7,235.6 Z" fill="#7ee787"/>
<text x="296.8" y="211.7" fill="#0d1117" font-size="11" font-weight="700" font-family="system-ui" text-anchor="middle" dominant-baseline="middle">5</text>
<path d="M200,200 L345.7,235.6 A150,150 0 0,1 274.0,330.5 Z" fill="#79c0ff"/>
<text x="277.8" y="258.8" fill="#0d1117" font-size="11" font-weight="700" font-family="system-ui" text-anchor="middle" dominant-baseline="middle">17</text>
<path d="M200,200 L274.0,330.5 A150,150 0 0,1 198.2,350.0 Z" fill="#d2a8ff"/>
<text x="224.3" y="294.4" fill="#0d1117" font-size="11" font-weight="700" font-family="system-ui" text-anchor="middle" dominant-baseline="middle">11</text>
<path d="M200,200 L198.2,350.0 A150,150 0 0,1 57.2,246.0 Z" fill="#ffa657"/>
<text x="142.1" y="278.5" fill="#0d1117" font-size="11" font-weight="700" font-family="system-ui" text-anchor="middle" dominant-baseline="middle">26</text>
<path d="M200,200 L57.2,246.0 A150,150 0 0,1 233.9,53.9 Z" fill="#f97583"/>
<text x="128.2" y="134.0" fill="#0d1117" font-size="11" font-weight="700" font-family="system-ui" text-anchor="middle" dominant-baseline="middle">44</text>
<path d="M200,200 L233.9,53.9 A150,150 0 0,1 261.1,63.0 Z" fill="#f0b27a"/>
<text x="231.0" y="107.6" fill="#0d1117" font-size="11" font-weight="700" font-family="system-ui" text-anchor="middle" dominant-baseline="middle">4</text>
<path d="M200,200 L261.1,63.0 A150,150 0 0,1 286.1,77.2 Z" fill="#bc8cff"/>
<text x="248.1" y="115.2" fill="#0d1117" font-size="11" font-weight="700" font-family="system-ui" text-anchor="middle" dominant-baseline="middle">4</text>
<path d="M200,200 L286.1,77.2 A150,150 0 0,1 308.0,95.9 Z" fill="#56d4dd"/>
<text x="263.4" y="125.9" fill="#0d1117" font-size="11" font-weight="700" font-family="system-ui" text-anchor="middle" dominant-baseline="middle">4</text>
<path d="M200,200 L308.0,95.9 A150,150 0 0,1 329.6,124.5 Z" fill="#58a6ff"/>
<text x="277.8" y="141.2" fill="#0d1117" font-size="11" font-weight="700" font-family="system-ui" text-anchor="middle" dominant-baseline="middle">5</text>
<path d="M200,200 L329.6,124.5 A150,150 0 0,1 345.7,164.4 Z" fill="#7ee7b0"/>
<text x="290.4" y="163.5" fill="#0d1117" font-size="11" font-weight="700" font-family="system-ui" text-anchor="middle" dominant-baseline="middle">6</text>
<path d="M200,200 L345.7,164.4 A150,150 0 0,1 350.0,200.0 Z" fill="#ff7eb6"/>
<text x="296.8" y="188.3" fill="#0d1117" font-size="11" font-weight="700" font-family="system-ui" text-anchor="middle" dominant-baseline="middle">5</text>
<rect x="420" y="15" width="14" height="14" rx="3" fill="#7ee787"/><text x="440" y="27" fill="#c9d1d9" font-size="12" font-family="system-ui">Constants (5)</text>
<rect x="420" y="37" width="14" height="14" rx="3" fill="#79c0ff"/><text x="440" y="49" fill="#c9d1d9" font-size="12" font-family="system-ui">Mathematics (17)</text>
<rect x="420" y="59" width="14" height="14" rx="3" fill="#d2a8ff"/><text x="440" y="71" fill="#c9d1d9" font-size="12" font-family="system-ui">Physics (11)</text>
<rect x="420" y="81" width="14" height="14" rx="3" fill="#ffa657"/><text x="440" y="93" fill="#c9d1d9" font-size="12" font-family="system-ui">Chemistry (26)</text>
<rect x="420" y="103" width="14" height="14" rx="3" fill="#f97583"/><text x="440" y="115" fill="#c9d1d9" font-size="12" font-family="system-ui">Biology (44)</text>
<rect x="420" y="125" width="14" height="14" rx="3" fill="#f0b27a"/><text x="440" y="137" fill="#c9d1d9" font-size="12" font-family="system-ui">Geology (4)</text>
<rect x="420" y="147" width="14" height="14" rx="3" fill="#bc8cff"/><text x="440" y="159" fill="#c9d1d9" font-size="12" font-family="system-ui">Astronomy (4)</text>
<rect x="420" y="169" width="14" height="14" rx="3" fill="#56d4dd"/><text x="440" y="181" fill="#c9d1d9" font-size="12" font-family="system-ui">Meteorology (4)</text>
<rect x="420" y="191" width="14" height="14" rx="3" fill="#58a6ff"/><text x="440" y="203" fill="#c9d1d9" font-size="12" font-family="system-ui">Hub (5)</text>
<rect x="420" y="213" width="14" height="14" rx="3" fill="#7ee7b0"/><text x="440" y="225" fill="#c9d1d9" font-size="12" font-family="system-ui">Benchmark (6)</text>
<rect x="420" y="235" width="14" height="14" rx="3" fill="#ff7eb6"/><text x="440" y="247" fill="#c9d1d9" font-size="12" font-family="system-ui">Parser (5)</text>
</svg>
</div>
</div>
</section>
<section>
<h2>Design Philosophy</h2>
<div class="philosophy">
<p style="color:var(--muted);margin-bottom:.5em">Every line of SciForge follows these non-negotiable principles:</p>
<ul>
<li>Zero external dependencies — only <code>std</code></li>
<li>Zero comments — the code speaks for itself</li>
<li>Zero clippy warnings — strict lint compliance</li>
<li>No <code>#[allow]</code> attributes — ever</li>
<li>Rust Edition 2024 — latest language features</li>
<li>All tests must pass before any commit</li>
<li>Pure functions when possible — minimal side effects</li>
<li>No unsafe code — full memory safety guaranteed</li>
</ul>
</div>
</section>
</div>
</div>
<div id="page-modules" class="page">
<div class="container">
<section>
<h2>All Modules</h2>
<div class="mod-grid">
<div class="mod-card"><div class="name">Constants</div><div class="meta"><span>5 submodules</span><span>57 public APIs</span><span>0 tests</span></div><div class="bar"><div class="bar-fill" style="width:2%;background:var(--lightblue)"></div></div><span class="status status-impl">Implemented</span></div>
<div class="mod-card"><div class="name">Mathematics</div><div class="meta"><span>17 submodules</span><span>977 public APIs</span><span>0 tests</span></div><div class="bar"><div class="bar-fill" style="width:39%;background:var(--lightblue)"></div></div><span class="status status-impl">Implemented</span></div>
<div class="mod-card"><div class="name">Physics</div><div class="meta"><span>11 submodules</span><span>636 public APIs</span><span>0 tests</span></div><div class="bar"><div class="bar-fill" style="width:26%;background:var(--lightblue)"></div></div><span class="status status-impl">Implemented</span></div>
<div class="mod-card"><div class="name">Chemistry</div><div class="meta"><span>26 submodules</span><span>462 public APIs</span><span>0 tests</span></div><div class="bar"><div class="bar-fill" style="width:19%;background:var(--lightblue)"></div></div><span class="status status-impl">Implemented</span></div>
<div class="mod-card"><div class="name">Biology</div><div class="meta"><span>44 submodules</span><span>2474 public APIs</span><span>0 tests</span></div><div class="bar"><div class="bar-fill" style="width:100%;background:var(--lightblue)"></div></div><span class="status status-impl">Implemented</span></div>
<div class="mod-card"><div class="name">Geology</div><div class="meta"><span>4 submodules</span><span>44 public APIs</span><span>0 tests</span></div><div class="bar"><div class="bar-fill" style="width:2%;background:var(--lightblue)"></div></div><span class="status status-impl">Implemented</span></div>
<div class="mod-card"><div class="name">Astronomy</div><div class="meta"><span>4 submodules</span><span>49 public APIs</span><span>0 tests</span></div><div class="bar"><div class="bar-fill" style="width:2%;background:var(--lightblue)"></div></div><span class="status status-impl">Implemented</span></div>
<div class="mod-card"><div class="name">Meteorology</div><div class="meta"><span>4 submodules</span><span>44 public APIs</span><span>0 tests</span></div><div class="bar"><div class="bar-fill" style="width:2%;background:var(--lightblue)"></div></div><span class="status status-impl">Implemented</span></div>
<div class="mod-card"><div class="name">Hub</div><div class="meta"><span>5 submodules</span><span>212 public APIs</span><span>0 tests</span></div><div class="bar"><div class="bar-fill" style="width:9%;background:var(--lightblue)"></div></div><span class="status status-impl">Implemented</span></div>
<div class="mod-card"><div class="name">Benchmark</div><div class="meta"><span>6 submodules</span><span>29 public APIs</span><span>28 tests</span></div><div class="bar"><div class="bar-fill" style="width:1%;background:var(--green)"></div></div><span class="status status-tested">Tested</span></div>
<div class="mod-card"><div class="name">Parser</div><div class="meta"><span>5 submodules</span><span>90 public APIs</span><span>66 tests</span></div><div class="bar"><div class="bar-fill" style="width:4%;background:var(--green)"></div></div><span class="status status-tested">Tested</span></div>
</div>
</section>
<section>
<h2>Module Details</h2>
<table>
<thead><tr><th>Module</th><th>Submodules</th><th>Public APIs</th><th>Tests</th><th>Documentation</th><th>Semver</th></tr></thead>
<tbody>
<tr><td><strong>Constants</strong></td><td>5</td><td>57</td><td>0</td><td style="color:var(--red)">✖</td><td style="color:var(--red)">✖</td></tr>
<tr><td><strong>Mathematics</strong></td><td>17</td><td>977</td><td>0</td><td style="color:var(--red)">✖</td><td style="color:var(--red)">✖</td></tr>
<tr><td><strong>Physics</strong></td><td>11</td><td>636</td><td>0</td><td style="color:var(--red)">✖</td><td style="color:var(--red)">✖</td></tr>
<tr><td><strong>Chemistry</strong></td><td>26</td><td>462</td><td>0</td><td style="color:var(--red)">✖</td><td style="color:var(--red)">✖</td></tr>
<tr><td><strong>Biology</strong></td><td>44</td><td>2474</td><td>0</td><td style="color:var(--red)">✖</td><td style="color:var(--red)">✖</td></tr>
<tr><td><strong>Geology</strong></td><td>4</td><td>44</td><td>0</td><td style="color:var(--red)">✖</td><td style="color:var(--red)">✖</td></tr>
<tr><td><strong>Astronomy</strong></td><td>4</td><td>49</td><td>0</td><td style="color:var(--red)">✖</td><td style="color:var(--red)">✖</td></tr>
<tr><td><strong>Meteorology</strong></td><td>4</td><td>44</td><td>0</td><td style="color:var(--red)">✖</td><td style="color:var(--red)">✖</td></tr>
<tr><td><strong>Hub</strong></td><td>5</td><td>212</td><td>0</td><td style="color:var(--red)">✖</td><td style="color:var(--red)">✖</td></tr>
<tr><td><strong>Benchmark</strong></td><td>6</td><td>29</td><td>28</td><td style="color:var(--red)">✖</td><td style="color:var(--red)">✖</td></tr>
<tr><td><strong>Parser</strong></td><td>5</td><td>90</td><td>66</td><td style="color:var(--red)">✖</td><td style="color:var(--red)">✖</td></tr>
</tbody>
</table>
</section>
</div>
</div>
<div id="page-progress" class="page">
<div class="container">
<section>
<h2>Project Progress</h2>
<p>Tracking semver validation, documentation coverage, and test coverage across all 11 modules.</p>
<div class="donut-row">
<div class="donut-card">
<svg width="120" height="120" viewBox="0 0 120 120" xmlns="http://www.w3.org/2000/svg">
<circle cx="60" cy="60" r="45" fill="none" stroke="#0d2610" stroke-width="8"/><circle cx="60" cy="60" r="45" fill="none" stroke="#7ee787" stroke-width="8" stroke-dasharray="51.4 231.3" stroke-dashoffset="70.7" stroke-linecap="round"/><text x="60" y="62" fill="#7ee787" font-size="22" font-weight="800" font-family="system-ui" text-anchor="middle" dominant-baseline="middle">18%</text>
</svg>
<h4>Tests</h4>
<p style="font-size:.75em;color:var(--muted)">2/11 modules</p>
</div>
<div class="donut-card">
<svg width="120" height="120" viewBox="0 0 120 120" xmlns="http://www.w3.org/2000/svg">
<circle cx="60" cy="60" r="45" fill="none" stroke="#2a1d05" stroke-width="8"/><circle cx="60" cy="60" r="45" fill="none" stroke="#ffa657" stroke-width="8" stroke-dasharray="0.0 282.7" stroke-dashoffset="70.7" stroke-linecap="round"/><text x="60" y="62" fill="#ffa657" font-size="22" font-weight="800" font-family="system-ui" text-anchor="middle" dominant-baseline="middle">0%</text>
</svg>
<h4>Documentation</h4>
<p style="font-size:.75em;color:var(--muted)">0/11 modules</p>
</div>
<div class="donut-card">
<svg width="120" height="120" viewBox="0 0 120 120" xmlns="http://www.w3.org/2000/svg">
<circle cx="60" cy="60" r="45" fill="none" stroke="#2a0d0d" stroke-width="8"/><circle cx="60" cy="60" r="45" fill="none" stroke="#f85149" stroke-width="8" stroke-dasharray="0.0 282.7" stroke-dashoffset="70.7" stroke-linecap="round"/><text x="60" y="62" fill="#f85149" font-size="22" font-weight="800" font-family="system-ui" text-anchor="middle" dominant-baseline="middle">0%</text>
</svg>
<h4>Semver</h4>
<p style="font-size:.75em;color:var(--muted)">0/11 modules</p>
</div>
</div>
<h3>Module Readiness</h3>
<table>
<thead><tr><th>Module</th><th>Submodules</th><th>Public APIs</th><th>Tests</th><th>Documentation</th><th>Semver</th><th>Score</th></tr></thead>
<tbody>
<tr><td><strong>Constants</strong></td><td>5</td><td>57</td><td class="fail">✗ none</td><td class="fail">✗ missing</td><td class="fail">✗ pending</td><td>0/3</td></tr>
<tr><td><strong>Mathematics</strong></td><td>17</td><td>977</td><td class="fail">✗ none</td><td class="fail">✗ missing</td><td class="fail">✗ pending</td><td>0/3</td></tr>
<tr><td><strong>Physics</strong></td><td>11</td><td>636</td><td class="fail">✗ none</td><td class="fail">✗ missing</td><td class="fail">✗ pending</td><td>0/3</td></tr>
<tr><td><strong>Chemistry</strong></td><td>26</td><td>462</td><td class="fail">✗ none</td><td class="fail">✗ missing</td><td class="fail">✗ pending</td><td>0/3</td></tr>
<tr><td><strong>Biology</strong></td><td>44</td><td>2474</td><td class="fail">✗ none</td><td class="fail">✗ missing</td><td class="fail">✗ pending</td><td>0/3</td></tr>
<tr><td><strong>Geology</strong></td><td>4</td><td>44</td><td class="fail">✗ none</td><td class="fail">✗ missing</td><td class="fail">✗ pending</td><td>0/3</td></tr>
<tr><td><strong>Astronomy</strong></td><td>4</td><td>49</td><td class="fail">✗ none</td><td class="fail">✗ missing</td><td class="fail">✗ pending</td><td>0/3</td></tr>
<tr><td><strong>Meteorology</strong></td><td>4</td><td>44</td><td class="fail">✗ none</td><td class="fail">✗ missing</td><td class="fail">✗ pending</td><td>0/3</td></tr>
<tr><td><strong>Hub</strong></td><td>5</td><td>212</td><td class="fail">✗ none</td><td class="fail">✗ missing</td><td class="fail">✗ pending</td><td>0/3</td></tr>
<tr><td><strong>Benchmark</strong></td><td>6</td><td>29</td><td class="pass">✓ 28</td><td class="fail">✗ missing</td><td class="fail">✗ pending</td><td>1/3</td></tr>
<tr><td><strong>Parser</strong></td><td>5</td><td>90</td><td class="pass">✓ 66</td><td class="fail">✗ missing</td><td class="fail">✗ pending</td><td>1/3</td></tr>
</tbody>
</table>
<h3>Milestone Targets</h3>
<div class="milestone"><div class="ms-label">Test Coverage</div><div class="ms-bar"><div class="ms-fill" style="width:18%;background:var(--green)"></div></div><div class="ms-val">2 / 11 modules (94 tests)</div></div>
<div class="milestone"><div class="ms-label">Documentation</div><div class="ms-bar"><div class="ms-fill" style="width:0%;background:var(--orange)"></div></div><div class="ms-val">0 / 11 modules</div></div>
<div class="milestone"><div class="ms-label">Semver Validation</div><div class="ms-bar"><div class="ms-fill" style="width:0%;background:var(--red)"></div></div><div class="ms-val">0 / 11 modules</div></div>
<div class="milestone"><div class="ms-label">Total Tests</div><div class="ms-bar"><div class="ms-fill" style="width:9%;background:var(--purple)"></div></div><div class="ms-val">94 / 1 000 target</div></div>
<div class="milestone"><div class="ms-label">Public APIs</div><div class="ms-bar"><div class="ms-fill" style="width:100%;background:var(--blue)"></div></div><div class="ms-val">5074 / 5 000 target</div></div>
<div class="milestone"><div class="ms-label">Periodic Table</div><div class="ms-bar"><div class="ms-fill" style="width:100%;background:var(--green)"></div></div><div class="ms-val">118 / 118 elements</div></div>
<div class="progress-legend">
<span><span class="dot" style="background:var(--green)"></span>Tested</span>
<span><span class="dot" style="background:var(--orange)"></span>Documented</span>
<span><span class="dot" style="background:var(--red)"></span>Semver Validated</span>
<span><span class="dot" style="background:var(--lightblue)"></span>Implemented</span>
</div>
</section>
</div>
</div>
<div id="page-docs" class="page">
<div class="container">
<section>
<h2>Project Documentation</h2>
<p>Rendered Markdown files from the project root.</p>
<div class="md-tabs">
<button class="md-tab active" onclick="showMd(0)">README.md</button>
<button class="md-tab" onclick="showMd(1)">ChangeLog.md</button>
<button class="md-tab" onclick="showMd(2)">ComingSoon.md</button>
<button class="md-tab" onclick="showMd(3)">Contributing.md</button>
<button class="md-tab" onclick="showMd(4)">LICENSE</button>
</div>
<div class="md-panel active" id="md-0">
<h1>SciForge</h1>
<p>A comprehensive scientific computing library written in pure Rust.</p>
<p class="badges"><a href="https://img.shields.io/badge/License-MIT-blue.svg"></p>
<p class="badges"><a href="https://img.shields.io/badge/Rust-Edition%202024-orange.svg">![Rust Edition</a>]()</p>
<p class="badges"><a href="https://img.shields.io/badge/Dependencies-0-brightgreen.svg">![Dependencies</a>]()</p>
<h2>Overview</h2>
<p>SciForge provides a wide range of scientific computing tools spanning mathematics, physics, chemistry, biology, geology, astronomy, and meteorology — all in a single, dependency-free Rust crate.</p>
<ul>
<li><strong>Zero external dependencies</strong></li>
<li><strong>575 source files</strong> — 48 600+ lines of Rust</li>
<li><strong>94 tests</strong> — zero clippy warnings</li>
<li><strong>118 elements</strong> — full periodic table dataset (IUPAC 2024)</li>
</ul>
<h2>Modules</h2>
<table>
<thead>
<tr><th>Module</th><th>Submodules</th><th>Description</th></tr>
</thead><tbody>
<tr><td><strong>Constants</strong></td><td>5</td><td>Fundamental, astrophysical, atomic constants, unit conversions, element data</td></tr>
<tr><td><strong>Mathematics</strong></td><td>17</td><td>Complex numbers, tensors, linear algebra, FFT, ODE/PDE solvers, statistics, optimization</td></tr>
<tr><td><strong>Physics</strong></td><td>11</td><td>Relativity, quantum mechanics, thermodynamics, electrodynamics, optics, acoustics</td></tr>
<tr><td><strong>Chemistry</strong></td><td>26</td><td>Kinetics, electrochemistry, organic/inorganic, spectroscopy, polymers, quantum chemistry</td></tr>
<tr><td><strong>Biology</strong></td><td>44</td><td>Genetics, neuroscience, ecology, evolution, pharmacology, genomics, proteomics</td></tr>
<tr><td><strong>Geology</strong></td><td>4</td><td>Seismology, radiometric dating, petrology, plate tectonics</td></tr>
<tr><td><strong>Astronomy</strong></td><td>4</td><td>Orbital mechanics, stellar astrophysics, cosmology, celestial mechanics</td></tr>
<tr><td><strong>Meteorology</strong></td><td>4</td><td>Atmospheric modeling, radiation transfer, dynamics, precipitation</td></tr>
<tr><td><strong>Hub</strong></td><td>5</td><td>Central dispatch API, domain engine, tools, prelude</td></tr>
<tr><td><strong>Benchmark</strong></td><td>6</td><td>Benchmark engine, binary encode/decode, simulation, reporting, multi-format export</td></tr>
<tr><td><strong>Parser</strong></td><td>5</td><td>CSV, JSON, YAML, Markdown, HTML parsing and validation</td></tr>
</tbody></table>
<h2>Quick Start</h2>
<p>Add SciForge to your <code>Cargo.toml</code>:</p>
<pre><code>[dependencies]
sciforge = "0.0.1"
</code></pre>
<h3>Example</h3>
<pre><code>use sciforge::benchmark::engine::BenchmarkMetrics;
use sciforge::parser::csv;
use sciforge::parser::json;
</code></pre>
<h2>Benchmark Export</h2>
<p>The benchmark module generates a complete interactive HTML dashboard featuring:</p>
<ul>
<li>IUPAC 2024 periodic table grid with category-colored gradient cells</li>
<li>Click-to-detail element cards with full metrics</li>
<li>SVG chart visualizations (category distribution, timing analysis, top 10 fastest/slowest)</li>
<li>Tabbed file browser for CSV, JSON, YAML, TOML exports</li>
<li>Markdown summary report</li>
</ul>
<h2>Periodic Table Data</h2>
<p>118 element data files organized by IUPAC category under <code>tableau-periodique/</code>:</p>
<pre><code>tableau-periodique/
├── actinides/
├── elements-superlourds/
├── gaz-nobles/
├── halogenes/
├── lanthanides/
├── metalloides/
├── metaux-alcalino-terreux/
├── metaux-alcalins/
├── metaux-de-transition/
├── metaux-post-transition/
└── non-metaux/
</code></pre>
<h2>Building</h2>
<pre><code>cargo build
</code></pre>
<h2>Testing</h2>
<pre><code>cargo test
</code></pre>
<p>94 tests (28 benchmark + 66 parser), all passing.</p>
<h2>Linting</h2>
<pre><code>cargo clippy
</code></pre>
<p>Zero warnings.</p>
<h2>Project Structure</h2>
<pre><code>src/
├── lib.rs
├── constants/ # Physical constants and element data
├── maths/ # Mathematical computing (17 submodules)
├── physics/ # Physics simulations (11 submodules)
├── chemistry/ # Chemical modeling (26 submodules)
├── biology/ # Biological computing (44 submodules)
├── geology/ # Earth sciences (4 submodules)
├── astronomy/ # Astrophysics (4 submodules)
├── meteorology/ # Atmospheric sciences (4 submodules)
├── hub/ # Central dispatch API
├── benchmark/ # Benchmarking and export pipeline
└── parser/ # Multi-format file parsing
tests/
├── benchmark.rs # 28 benchmark tests
└── parser.rs # 66 parser tests
tableau-periodique/ # 118 element data files
</code></pre>
<h2>Contributing</h2>
<p>See <a href="#" onclick="showPage('docs');showMd(3);return false">Contributing.md</a> for guidelines.</p>
<h2>Roadmap</h2>
<p>See <a href="#" onclick="showPage('docs');showMd(2);return false">ComingSoon.md</a> for upcoming features and development plans.</p>
<h2>Changelog</h2>
<p>See <a href="#" onclick="showPage('docs');showMd(1);return false">ChangeLog.md</a> for version history.</p>
<h2>License</h2>
<p><a href="#" onclick="showPage('docs');showMd(4);return false">MIT</a></p>
</div>
<div class="md-panel" id="md-1">
<h1>Changelog</h1>
<p>All notable changes to SciForge are documented in this file.</p>
<h2>[0.0.1] - 2026-03-23</h2>
<h3>Project Foundation</h3>
<ul>
<li>Initialized <code>sciforge</code> crate (Rust edition 2024, zero external dependencies)</li>
<li>Established 11-module architecture: <code>constants</code>, <code>maths</code>, <code>physics</code>, <code>chemistry</code>, <code>biology</code>, <code>geology</code>, <code>astronomy</code>, <code>meteorology</code>, <code>benchmark</code>, <code>parser</code>, <code>hub</code></li>
<li>575 source files, 48 600+ lines of Rust across all modules</li>
</ul>
<h3>Constants</h3>
<ul>
<li>Fundamental physical constants (CODATA values)</li>
<li>Astrophysical constants</li>
<li>Atomic constants</li>
<li>Unit conversion factors</li>
<li>Full periodic table element data (118 elements)</li>
</ul>
<h3>Mathematics (17 submodules)</h3>
<ul>
<li>Complex number arithmetic</li>
<li>Tensor, vector, polynomial types</li>
<li>Linear algebra and sparse matrix operations</li>
<li>Non-Euclidean geometry</li>
<li>Graph theory</li>
<li>Interpolation and numerical integration</li>
<li>ODE and PDE solvers</li>
<li>FFT (Fast Fourier Transform)</li>
<li>Optimization algorithms</li>
<li>Statistics and probability distributions</li>
<li>Signal processing</li>
</ul>
<h3>Physics (11 submodules)</h3>
<ul>
<li>Special and general relativity</li>
<li>Quantum mechanics</li>
<li>Thermodynamics</li>
<li>Classical electrodynamics</li>
<li>Fluid and solid mechanics</li>
<li>Optics and acoustics</li>
<li>Nucleosynthesis</li>
<li>Electronics</li>
<li>Materials science</li>
</ul>
<h3>Chemistry (26 submodules)</h3>
<ul>
<li>Reaction kinetics and chemical equilibrium</li>
<li>Electrochemistry and thermochemistry</li>
<li>Molecular and organic/inorganic chemistry</li>
<li>Analytical and quantum chemistry</li>
<li>Solutions, gas laws, acid-base equilibria</li>
<li>Nuclear chemistry and photochemistry</li>
<li>Polymers, spectroscopy, surface chemistry</li>
<li>Crystallography and stoichiometry</li>
<li>Colloids, solid-state, computational chemistry</li>
<li>Reaction engineering and transport phenomena</li>
<li>Environmental and green chemistry</li>
</ul>
<h3>Biology (44 submodules)</h3>
<ul>
<li>Population dynamics, genetics, genomics, proteomics</li>
<li>Enzyme kinetics, cell biology, developmental biology</li>
<li>Neuroscience, pharmacology, immunology</li>
<li>Ecology, evolution, phylogenetics, ethology</li>
<li>Biomechanics, biophysics, bioenergetics, biostatistics</li>
<li>Structural biology, systems biology, synthetic biology</li>
<li>Epigenetics, bioinformatics, biogeography</li>
<li>Microbiology, virology, parasitology, mycology</li>
<li>Endocrinology, physiology, plant biology, chronobiology</li>
<li>Toxicology, radiobiology, cryobiology, nutrition</li>
<li>Cancer biology, marine biology, aging, reproduction</li>
<li>Stem cell biology, bioelectricity, tissue engineering, paleobiology</li>
</ul>
<h3>Geology (4 submodules)</h3>
<ul>
<li>Seismology</li>
<li>Radiometric dating</li>
<li>Petrology</li>
<li>Plate tectonics</li>
</ul>
<h3>Astronomy (4 submodules)</h3>
<ul>
<li>Orbital mechanics</li>
<li>Stellar astrophysics</li>
<li>Cosmology</li>
<li>Celestial mechanics</li>
</ul>
<h3>Meteorology (4 submodules)</h3>
<ul>
<li>Atmospheric modeling</li>
<li>Radiation transfer</li>
<li>Atmospheric dynamics</li>
<li>Precipitation</li>
</ul>
<h3>Hub</h3>
<ul>
<li>Central dispatch API with <code>api</code>, <code>domain</code>, <code>engine</code>, <code>tools</code> submodules</li>
<li>Prelude module for ergonomic imports</li>
</ul>
<h3>Benchmark (6 submodules)</h3>
<ul>
<li><code>engine</code> — benchmark runner with <code>BenchmarkMetrics</code> (iterations, timing, throughput)</li>
<li><code>encode</code> / <code>decode</code> — compact binary <code>.bmk</code> format for benchmark results</li>
<li><code>simulation</code> — deterministic benchmark simulation for all 118 elements</li>
<li><code>report</code> — JSON, YAML, TOML report generation with tagged metadata</li>
<li><code>export</code> — multi-format export pipeline:</li>
<li>Per-element and aggregate CSV, JSON, YAML, TOML, BMK files</li>
<li>Per-category grouped exports</li>
<li>Interactive HTML dashboard:</li>
<li>IUPAC 2024 periodic table grid (La/Ac in main body, groups 1-18)</li>
<li>Dark gradient theme with category-colored element cells</li>
<li>Hover zoom, click-to-detail card with full metrics</li>
<li>CSV displayed as interactive HTML table</li>
<li>SVG chart visualizations (category distribution, timing, top 10 fastest/slowest, statistics)</li>
<li>Tabbed file browser for all export formats</li>
<li>Legend with gradient swatches</li>
<li>Markdown summary report</li>
<li>28 tests covering engine, encode/decode roundtrip, simulation, report, and export</li>
</ul>
<h3>Parser (5 submodules)</h3>
<ul>
<li><code>csv</code> — CSV reader/writer with configurable delimiters and quoting</li>
<li><code>json</code> — JSON parser and validator</li>
<li><code>yaml</code> — YAML parser and validator</li>
<li><code>markdown</code> — Markdown parser and validator</li>
<li><code>html</code> — HTML parser and validator</li>
<li>66 tests covering parsing, validation, edge cases, and file generation</li>
<li>Generated sample files: CSV (20 elements), JSON, YAML, Markdown, HTML (dark gradient theme)</li>
</ul>
<h3>Periodic Table Data</h3>
<ul>
<li>118 element data files organized by category under <code>tableau-periodique/</code>:</li>
<li>Non-metals, noble gases, halogens, metalloids</li>
<li>Alkali metals, alkaline earth metals</li>
<li>Transition metals, post-transition metals</li>
<li>Lanthanides, actinides, superheavy elements</li>
</ul>
<h3>Testing</h3>
<ul>
<li>94 total tests (28 benchmark + 66 parser), all passing</li>
<li>Zero clippy warnings</li>
<li>Zero `#[allow]` directives</li>
</ul>
</div>
<div class="md-panel" id="md-2">
<h1>Coming Soon</h1>
<p>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.</p>
<p>The project is maintained solely by the author. Contributions, suggestions, and collaboration requests should follow the <a href="#" onclick="showPage('docs');showMd(3);return false">Contributing</a> guide.</p>
<h2>Current State (v0.0.1)</h2>
<p>The foundation is in place with 575 source files, 48 600+ lines of Rust, 94 passing tests, and zero clippy warnings.</p>
<h3>Implemented Modules</h3>
<table>
<thead>
<tr><th>Module</th><th>Submodules</th><th>Status</th></tr>
</thead><tbody>
<tr><td>Constants</td><td>5 (fundamental, astro, atomic, units, elements)</td><td>Implemented</td></tr>
<tr><td>Mathematics</td><td>17 (complex, tensor, linalg, FFT, ODE, PDE, ...)</td><td>Implemented</td></tr>
<tr><td>Physics</td><td>11 (relativity, quantum, thermo, optics, ...)</td><td>Implemented</td></tr>
<tr><td>Chemistry</td><td>26 (kinetics, organic, spectroscopy, ...)</td><td>Implemented</td></tr>
<tr><td>Biology</td><td>44 (genetics, neuroscience, ecology, ...)</td><td>Implemented</td></tr>
<tr><td>Geology</td><td>4 (seismology, dating, petrology, tectonics)</td><td>Implemented</td></tr>
<tr><td>Astronomy</td><td>4 (orbits, stellar, cosmology, celestial)</td><td>Implemented</td></tr>
<tr><td>Meteorology</td><td>4 (atmosphere, radiation, dynamics, precipitation)</td><td>Implemented</td></tr>
<tr><td>Hub</td><td>5 (api, domain, engine, tools, prelude)</td><td>Implemented</td></tr>
<tr><td>Benchmark</td><td>6 (engine, encode, decode, simulation, report, export)</td><td>Implemented + tested</td></tr>
<tr><td>Parser</td><td>5 (csv, json, yaml, markdown, html)</td><td>Implemented + tested</td></tr>
</tbody></table>
<h3>Periodic Table Data</h3>
<p>118 element data files under <code>tableau-periodique/</code>, organized by IUPAC category (11 groups from non-metals to superheavy elements).</p>
<h2>Upcoming Development</h2>
<h3>Documentation</h3>
<ul>
<li>Full API reference with usage examples and expected input/output for every public function</li>
<li>Tutorials and guided workflows for simulations, data analysis, and cross-domain computations</li>
<li>Module-level guides explaining the scientific models behind each implementation</li>
</ul>
<h3>Extended Testing</h3>
<ul>
<li>Unit and integration tests for all scientific modules (constants, maths, physics, chemistry, biology, geology, astronomy, meteorology)</li>
<li>Property-based testing and edge-case validation</li>
<li>Cross-module integration tests</li>
</ul>
<h3>Hub Expansion</h3>
<ul>
<li>Unified dispatch API connecting all modules through the Hub</li>
<li>Prelude with ergonomic re-exports for common use cases</li>
<li>Domain-specific query engines and tool pipelines</li>
</ul>
<h3>Computational Enhancements</h3>
<ul>
<li>Performance benchmarking across all scientific modules</li>
<li>Memory-optimized data structures for large-scale simulations</li>
<li>Deterministic, reproducible execution paths</li>
</ul>
<h3>Future Modules and Features</h3>
<ul>
<li>Interactive visualization utilities</li>
<li>Extended cross-domain analysis tools (e.g., astrochemistry, geophysics, bioinformatics pipelines)</li>
<li>Additional export formats and reporting capabilities</li>
<li>Automated validation pipelines for scientific correctness</li>
</ul>
<h2>Note</h2>
<p>Modules, examples, and documentation will be released progressively. Follow updates and participate in shaping SciForge by providing feedback via the <a href="#" onclick="showPage('docs');showMd(3);return false">Contributing</a> guide.</p>
<p>SciForge aims to become a trusted, high-quality platform for scientific computing, exploration, and education — fully auditable, reproducible, and dependency-free.</p>
</div>
<div class="md-panel" id="md-3">
<h1>Contributing to SciForge</h1>
<p>**Email:** The email associated with my [crates.io] account : <a href="https://crates.io/users/rayanmorel4498-ai" target="_blank" style="color:#58a6ff">https://crates.io/users/rayanmorel4498-ai</a></p>
<p><strong>Discord:</strong> The official discod's servor ascociated wiith the SciForge project : <a href="https://discord.gg/PtEHcJAruj" target="_blank" style="color:#58a6ff">https://discord.gg/PtEHcJAruj</a></p>
<h2>Project Overview</h2>
<p>SciForge is a pure Rust (edition 2024) scientific computing library with zero external dependencies. It currently spans 11 modules, 575 source files, and 48 600+ lines of code covering mathematics, physics, chemistry, biology, geology, astronomy, meteorology, benchmarking, parsing, and a central hub.</p>
<h2>How to Contribute</h2>
<ol>
<li><strong>Propose your change or idea</strong> — describe the problem you want to solve or the improvement you envision.</li>
<li><strong>Include your suggestions for APIs</strong> — indicate what functions, structs, or modules you think are necessary or redundant.</li>
<li><strong>Provide examples or code snippets</strong> where possible — even small snippets or pseudocode help.</li>
</ol>
<p>I will review your proposal and provide feedback. If approved, we can coordinate how to integrate it.</p>
<h2>Types of Contributions</h2>
<ul>
<li><strong>Bug fixes</strong> — identify and propose solutions to issues.</li>
<li><strong>Optimizations</strong> — suggest ways to improve performance, memory usage, or runtime behavior.</li>
<li><strong>New features</strong> — propose additional analysis capabilities, APIs, or tools.</li>
<li><strong>Documentation</strong> — help clarify usage, examples, or internal logic.</li>
<li><strong>Testing</strong> — provide sample files, expected outputs, or validation scripts.</li>
<li><strong>Logo & visual identity</strong> — if you can improve or refine the SciForge logo, your contribution is very welcome.</li>
</ul>
<h2>Code Conventions</h2>
<p>SciForge follows strict conventions. All contributions must adhere to:</p>
<ul>
<li><strong>Zero dependencies</strong> — no external crates allowed.</li>
<li><strong>Zero comments</strong> — code must be self-explanatory through clear naming and structure.</li>
<li>**No `#[allow]` directives** — all clippy and compiler warnings must be resolved, not suppressed.</li>
<li><strong>Edition 2024</strong> — use current Rust idioms and features.</li>
<li>**Zero clippy warnings** — <code>cargo clippy</code> must pass cleanly.</li>
<li>**All tests pass** — <code>cargo test</code> must succeed (currently 94 tests: 28 benchmark + 66 parser).</li>
</ul>
<h2>Proposal Guidelines</h2>
<p>When proposing improvements, please include:</p>
<ul>
<li>A clear description of the problem or opportunity</li>
<li>The API surface you envision (functions, structs, modules)</li>
<li>Any considerations about backward compatibility or potential side effects</li>
<li>Optional: performance trade-offs or optimizations you foresee</li>
</ul>
<p>Even rough ideas or pseudocode are welcome — detailed implementation can come later.</p>
<h2>API Discussion</h2>
<p>I value input on:</p>
<ul>
<li>Which APIs should be public and necessary</li>
<li>Which APIs are redundant or unnecessary</li>
<li>Any abstractions that could simplify usage or improve performance</li>
</ul>
<p>Your suggestions help shape a stable and ergonomic API for SciForge.</p>
<h2>Testing & Validation</h2>
<ul>
<li>Whenever possible, provide example files and expected outputs</li>
<li>Suggest how proposed changes can be validated in sandbox or test environments</li>
<li>Testing helps ensure new contributions integrate safely and correctly</li>
</ul>
<h2>Reporting Issues</h2>
<p>If you encounter a bug or unexpected behavior:</p>
<ol>
<li>Describe the steps to reproduce it</li>
<li>Provide expected vs. actual behavior</li>
<li>Include relevant environment details (OS, Rust version, platform)</li>
</ol>
<p>Please send reports via email or the discord.</p>
<h2>Code of Conduct</h2>
<p>I value respect, collaboration, and constructive feedback. Keep discussions professional and welcoming.</p>
<p>Thank you for helping make SciForge better. Your contributions — big or small — are always appreciated.</p>
</div>
<div class="md-panel" id="md-4">
<pre style="white-space:pre-wrap;font-family:ui-monospace,'Cascadia Code',monospace;font-size:.9em">MIT License
Copyright (c) 2026 Rayan
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
</pre></div>
</section>
</div>
</div>
<div id="page-examples" class="page">
<div class="container">
<section>
<h2>Export Examples</h2>
<p>Interactive HTML dashboards generated by the Benchmark and Parser modules.</p>
<div class="example-tabs">
<button class="ex-tab active" onclick="showExample(0)">Benchmark</button>
<button class="ex-tab" onclick="showExample(1)">Parser</button>
</div>
<div class="ex-panel active" id="ex-0">
<iframe src="tests/output/benchmark/benchmark.html" class="example-frame"></iframe>
</div>
<div class="ex-panel" id="ex-1">
<iframe src="tests/output/parser/parser.html" class="example-frame"></iframe>
</div>
</section>
</div>
</div>
<footer>
SciForge v0.0.1 — Pure Rust Scientific Computing — MIT License — IUPAC 2024
</footer>
<script>
function showPage(id){
document.querySelectorAll('.page').forEach(p=>p.classList.remove('active'));
document.querySelectorAll('.nav-btn').forEach(b=>b.classList.remove('active'));
document.getElementById('page-'+id).classList.add('active');
event.currentTarget.classList.add('active');
}
function showMd(idx){
document.querySelectorAll('.md-panel').forEach(p=>p.classList.remove('active'));
document.querySelectorAll('.md-tab').forEach(t=>t.classList.remove('active'));
document.getElementById('md-'+idx).classList.add('active');
document.querySelectorAll('.md-tab')[idx].classList.add('active');
}
function showExample(idx){
document.querySelectorAll('.ex-panel').forEach(p=>p.classList.remove('active'));
document.querySelectorAll('.ex-tab').forEach(t=>t.classList.remove('active'));
document.getElementById('ex-'+idx).classList.add('active');
document.querySelectorAll('.ex-tab')[idx].classList.add('active');
}
</script>
</body>
</html>