How farhanlabibahan/flamme works
Flamme is a source-linked NASA microgravity-combustion evidence platform. Users describe or configure experimental conditions, then explore matched evidence, investigation comparisons, rankings and coverage gaps; the interactive lab also combines an explicitly illustrative flame response with separate FLEX and CFI-G model results. Shared scenario/search state and deterministic ranking/parsing form the internal application layer. Evidence is limited to the README and sampled/indexed files; some page and data wiring is documented but not directly excerpted.
Main entry points: FlammeContext.jsx Shared scenario state · LabPage.jsx Lab condition controls · ranking.js Evidence ranker · AskPage.jsx Ask interface
Components 24
Application and state
- Page router
src/main.jsx - Workspace shell
src/components/Shell.jsx - Shared scenario state
src/context/FlammeContext.jsx - Condition parser
src/prompt.js - Evidence ranker
src/ranking.js
Evidence exploration
- Evidence search
src/pages/EvidencePage.jsx - Investigation comparison
src/pages/InvestigationsPage.jsx - Finding rankings
src/pages/RankingsPage.jsx - Coverage gap map
src/pages/GapsPage.jsx - NASA source catalog
src/pages/SourcesPage.jsx - Ask interface
src/pages/AskPage.jsx - Sample evidence data
src/data.js - Ask API endpoint
api/ask.js
Interactive flame lab
- Lab condition controls
src/pages/LabPage.jsx - 3D flame chamber
src/Lab.jsx - Chamber scene
src/labScene.js - Illustrative response
src/labModel.js
Modeling and data
- FLEX inference
src/flexModel.js - CFI-G inference
src/cfigModel.js - Model transparency
src/pages/ModelPage.jsx - Offline model training
ML/build_flex_model.py - CFI-G training
ML/build_cfig_model.py
Other components
- Researcher
- LLM interpretation service
Connections 27
- Researcher → Page router: opens pages
src/main.jsx - Page router → Workspace shell: mounts workspace
src/main.jsx - Page router → Shared scenario state: provides shared state
src/main.jsx - Workspace shell → Shared scenario state: reads source selection
src/components/Shell.jsx - Shared scenario state → Sample evidence data: ranks and filters
src/context/FlammeContext.jsx - Shared scenario state → Evidence ranker: calls ranking
src/context/FlammeContext.jsx - Evidence search → Shared scenario state: reads evidence state
src/pages/EvidencePage.jsx - Investigation comparison → Evidence ranker: ranks linked findings
src/pages/InvestigationsPage.jsx - Finding rankings → Evidence ranker: scores findings
src/pages/RankingsPage.jsx - Coverage gap map → Evidence ranker: uses coverage logic
src/pages/GapsPage.jsx - NASA source catalog → Researcher: presents citations
- Ask interface → Shared scenario state: reads shared context
src/pages/AskPage.jsx - Ask interface → Condition parser: parses questions
src/pages/AskPage.jsx - Ask interface → Ask API endpoint: requests interpretation
- Ask API endpoint → LLM interpretation service: sends LLM request
- Lab condition controls → Illustrative response: derives flame regime
src/pages/LabPage.jsx - Lab condition controls → FLEX inference: predicts FLEX response
src/pages/LabPage.jsx - Lab condition controls → CFI-G inference: predicts CFI-G response
src/pages/LabPage.jsx - Lab condition controls → 3D flame chamber: opens 3D view
src/pages/LabPage.jsx - 3D flame chamber → Chamber scene: renders chamber
src/Lab.jsx - Chamber scene → Illustrative response: uses response model
src/labScene.js - Model transparency → FLEX inference: documents inference
src/pages/ModelPage.jsx - Offline model training → FLEX inference: fits browser model
- CFI-G training → CFI-G inference: fits browser model
- Researcher → Investigation comparison: compares studies
- Researcher → Finding rankings: explores scored findings
- Researcher → Coverage gap map: inspects coverage