# PYRION PSI combustion data dictionary

One row per extracted condition value. Values and units are copied from data/conditions; no additional conversions are performed. Unit `1` denotes a dimensionless fraction. `o2_mole_fraction` is ambient oxygen; `burner_o2_mole_fraction` is oxygen in the burner stream, not the cabin. Flagged `insufficient_evidence` rows are not observations for calculations. In PSI-69, `outcome:burning_rate` rows with unit mm are flagged insufficient evidence and must not be interpreted as burning rates.

## Columns

- `accession`: PSI investigation identifier.
- `acronym`: Investigation acronym from the manifest.
- `test_id`: Test identifier in the condition extraction.
- `variable`: Condition variable name.
- `value`: Extracted value in the reported harmonised unit.
- `unit`: Unit of value; blank for categorical values.
- `value_original`: Value as recorded by the extraction.
- `unit_original`: Original unit.
- `method`: Extraction method as recorded.
- `source_file`: Path relative to data/raw/; source files are not in the public repo and can be obtained from PSI.
- `source_location`: Location within the source.
- `quote`: Source text recorded by the extraction.
- `status`: Extraction status: extracted denotes a retained extraction; insufficient_evidence is flagged and must not be used as a measurement.
- `note`: Extraction note, including caveats.
- `doi`: Investigation DOI from the manifest.

## Variables

- `ambient_temperature`: ambient temperature. Units present: K. Example source: `psi-data/PSI-68/Experimental table/PSI-68_Experimental table_Flex2.csv`, `row=1;column= Ambient Temperature (C)`; recorded source text: ' Ambient Temperature (C)'. Interpret in the context of each row and source.
- `burner_o2_mole_fraction`: burner o2 mole fraction. Units present: 1. Example source: `psi-data/PSI-10/Experimental table/PSI-10_Experimental table_Flame Design_Inverse Flame.csv`, `row=100;column=XO2`; recorded source text: 'XO2'. Interpret in the context of each row and source.
- `diluent`: diluent. Units present: (blank). Example source: `psi-data/PSI-102/Reports/PSI-102_Reports_SAME_Final Science Report.pdf`, `page=21`; recorded source text: 'For each test, a new sample was moved into place by rotating one of the six sample chambers in the carousel into the flow duct and the sample heating and the flow were synchronized to provide a steady air stream over the sample during the heating interval.'. Interpret in the context of each row and source.
- `droplet_diameter_initial`: droplet diameter initial. Units present: mm. Example source: `psi-data/PSI-68/Experimental table/PSI-68_Experimental table_Flex2.csv`, `row=1;column=Initial Droplet Diameter (mm)`; recorded source text: 'Initial Droplet Diameter (mm)'. Interpret in the context of each row and source.
- `flame_type`: flame type. Units present: (blank). Example source: `psi-data/PSI-10/Experimental table/PSI-10_Experimental table_Flame Design_Inverse Flame.csv`, `row=100;column=Flame Type`; recorded source text: 'Flame Type'. Interpret in the context of each row and source.
- `flow_configuration`: flow configuration. Units present: (blank). Example source: `psi-data/PSI-25/Reports/PSI-25_Reports_BASS-II Summary Report.pdf`, `page=120`; recorded source text: 'T10 [...] Concurrent [...] T11 [...] Concurrent [...] T12 [...] Concurrent [...] T13 [...] Concurrent [...] T14 [...] Concurrent [...] T16 [...] Concurrent [...] T17 [...] Concurrent [...] T18 [...] Concurrent [...] T19 [...] Concurrent [...] T20 [...] Concurrent [...] T21 [...] Concurrent [...] T22 [...] Concurrent [...] T23 [...] Concurrent [...] T24 [...] Concurrent'. Interpret in the context of each row and source.
- `flow_velocity`: flow velocity. Units present: cm/s. Example source: `psi-data/PSI-101/Experimental table/PSI-101_Experimental table_SAME-R.csv`, `row=100;column=Inlet velocity (cm/s)`; recorded source text: 'Inlet velocity (cm/s)'. Interpret in the context of each row and source.
- `fuel`: fuel. Units present: (blank). Example source: `psi-data/PSI-10/Reports/PSI-10_Reports_FinalRpt_ACMEFlameDesign.pdf`, `page=69`; recorded source text: 'On GMT 018, we ignited 12 inverse flames for Flame Design. We performed these tests with two different ethylene concentrations in a range of oxidizer concentrations and flow rates from the burner.'. Interpret in the context of each row and source.
- `fuel_phase`: fuel phase. Units present: (blank). Example source: `psi-data/PSI-102/Science Documents/PSI-102_Science Documents_SAME_Baseline Concept Description Doc.pdf`, `page=11`; recorded source text: 'The samples themselves are composed of five (5) materials: Teflon, Kapton, Silicone, Cellulose and DiButyl Phthalate (which being a liquid, is contained within a small section of cotton lampwick) in small, cylindrical sections, that are wrapped with coils of wire (baseline: stainless steel) that both provides the heat energy to the sample when energized and measures its temperature (by its varying resistance).'. Interpret in the context of each row and source.
- `gravity_regime`: gravity regime. Units present: (blank). Example source: `psi-data/PSI-10/Reports/PSI-10_Reports_FinalRpt_ACMEFlameDesign.pdf`, `page=25`; recorded source text: 'In this work, experiments aboard the International Space Station and a transient numerical model are used to investigate the existence of steady-state microgravity spherical diffusion flames. Gaseous spherical diffusion flames stabilized on a porous spherical burner are employed in normal (i.e., fuel flowing into an ambient oxidizer) and inverse (i.e., oxidizer flowing into an ambient fuel) flame configurations.'. Interpret in the context of each row and source.
- `material`: material. Units present: (blank). Example source: `psi-data/PSI-25/Experimental table/PSI-25_Experimental table_BASS-II.csv`, `row=100;column=Fuel Sample Material`; recorded source text: 'Fuel Sample Material'. Interpret in the context of each row and source.
- `o2_mole_fraction`: o2 mole fraction. Units present: 1. Example source: `nasa/ntrs-20180005168/20180005168.pdf`, `page=30`; recorded source text: 'Table 1.  Summary of Samples, Test Conditions, and Selected Results [...] Δ %O2 i [...] III-1 Cotton-Fiberglass 40.6 cm 0.37 mm 94 cm 25 cm/s Concurrent 21.2 to 21.0'. Interpret in the context of each row and source.
- `outcome:burn_time`: Outcome: burn time. Units present: s. Example source: `psi-data/PSI-159/Experimental table/PSI-159_Experimental table_CFI-G_Inverse Flames.csv`, `row=100;column=burn time (sec)`; recorded source text: 'burn time (sec)'. Interpret in the context of each row and source.
- `outcome:burning_rate`: Outcome: burning rate. Units present: mm. Example source: ``, ``; recorded source text: ''. Interpret in the context of each row and source.
- `outcome:cool_flame`: Outcome: cool flame. Units present: (blank). Example source: `psi-data/PSI-159/Experimental table/PSI-159_Experimental table_CFI-G_Normal Flames.csv`, `row=158;column=Cool flame?`; recorded source text: 'Cool flame?'. Interpret in the context of each row and source.
- `outcome:hot_ignition`: Outcome: hot ignition. Units present: (blank). Example source: `psi-data/PSI-159/Experimental table/PSI-159_Experimental table_CFI-G_Inverse Flames.csv`, `row=100;column=Hot ignition`; recorded source text: 'Hot ignition'. Interpret in the context of each row and source.
- `outcome:o2_mole_fraction_after_test`: Outcome: o2 mole fraction after test. Units present: 1. Example source: `psi-data/PSI-25/Experimental table/PSI-25_Experimental table_BASS-II.csv`, `row=100;column=Calibrated final O2 % by vol`; recorded source text: 'Calibrated final O2 % by vol'. Interpret in the context of each row and source.
- `outcome:pressure_after_test`: Outcome: pressure after test. Units present: kPa. Example source: `psi-data/PSI-10/Experimental table/PSI-10_Experimental table_Flame Design_Inverse Flame.csv`, `row=100;column=pfinal (atm)`; recorded source text: 'pfinal (atm)'. Interpret in the context of each row and source.
- `outcome:test_end`: Outcome: test end. Units present: (blank). Example source: `psi-data/PSI-69/Experimental table/PSI-69_Experimental table_FLEX.csv`, `row=100;column=Test end`; recorded source text: 'Test end'. Interpret in the context of each row and source.
- `outcome:visible_flame_extinction_diameter`: Outcome: visible flame extinction diameter. Units present: mm. Example source: `psi-data/PSI-69/Experimental table/PSI-69_Experimental table_FLEX.csv`, `row=100;column=Visible flame extinction diameter; mm`; recorded source text: 'Visible flame extinction diameter; mm'. Interpret in the context of each row and source.
- `platform`: platform. Units present: (blank). Example source: `psi-data/PSI-23/Reports/PSI-23_Reports_s_Flame_final_report_20210729.pdf`, `page=3`; recorded source text: 'The Structure and Response of Spherical Diffusion Flames (s-Flame) experiment is one of six independent experiments that make up the Advanced Combustion via Microgravity Experiments (ACME) project for which tests are conducted within the Combustion Integrated Rack (CIR) on the International Space Station (ISS).'. Interpret in the context of each row and source.
- `pressure`: pressure. Units present: kPa. Example source: `psi-data/PSI-20/Reports/PSI-20_Reports_Final_20220201.pdf`, `page=154`; recorded source text: 'On GMT 028, the final test points were performed for the ACME BRE (Burning Rate Emulator) experiment [...] In the study of microgravity flammability, 13 flames were ignited with the 50-mm diameter burner at oxygen concentrations from 40% to 23% in 1 atm.'. Interpret in the context of each row and source.
- `sample_thickness`: sample thickness. Units present: mm. Example source: `psi-data/PSI-25/Experimental table/PSI-25_Experimental table_BASS-II.csv`, `row=10;column=Fuel Sample Material`; recorded source text: 'Fuel Sample Material'. Interpret in the context of each row and source.