-
Notifications
You must be signed in to change notification settings - Fork 0
Home
This repository implements a rigorous quantitative analysis workflow for Temporal Analysis of Products (TAP) mass spectrometry data. Unlike steady-state MS analysis, which often relies on relative intensity ratios, TAP requires the conversion of time-resolved electrical signals (counts or Amps) into absolute molar flux (
Because TAP experiments rely on the precise analysis of transient pulse shapes (moments analysis), maintaining strict mass balance is critical. This software achieves this using a dual-factor calibration logic:
- Dynamic Normalization: Using an internal inert standard (e.g., Argon) to correct for pulse-to-pulse variations in reactor state.
- Static Calibration: Using a species-specific factor to account for fundamental ionization physics.
The fundamental equation used to transform the raw mass spectrometer signal
The master equation implemented in the code is:
| Symbol | Unit | Description |
|---|---|---|
|
Molar Flux of species |
||
|
Raw Intensity signal from the mass spectrometer at time |
||
| Baseline background signal (vacuum level) to be subtracted. | ||
| Intensity-to-Flux Constant. A dynamic scalar derived from the inert tracer in the current pulse. | ||
| Dimensionless |
Calibration Factor. A static scalar representing the relative detection efficiency of species |
-
Code Variable:
config['conv'] - UI Label: Intensity -> Flux Conversion
- Nature: Dynamic (Recalculated for every pulse/peak)
Purpose: This factor normalizes the data against the "machine state" at the exact moment of the experiment. It compensates for variables that drift over time, such as detector gain, vacuum chamber pressure, and slight variations in the pulse valve injection size.
Derivation: It is calculated by integrating the signal of the co-pulsed inert tracer (e.g., Argon) where the injected amount is known (calibrated sample loop).
** Implementation Note:**
In multi-peak experiments (e.g., pump-probe), this value is defined separately for each peak (e.g., c_global_0, c_global_1) to account for different loop volumes or detector drift between events.
-
Code Variable:
calibration_factor - UI Label: Calibration Factor (AMU X)
- Nature: Static (Determined offline, constant for the species)
Purpose:
This is a material constant that corrects for the fact that the mass spectrometer is not equally sensitive to all molecules. It encapsulates the ratio of probabilities for Ionization (
Derivation: This factor is determined in a separate offline calibration experiment where a binary mixture of known composition (e.g., 50% Ar / 50% Reactant) is pulsed repeatedly.
Once determined, this value is "hard-coded" or entered once for the specific AMU and remains constant across all experiments involving that species.
Here is the updated Markdown code, restructured to include a dedicated Transport Analysis section as requested.
Markdown
This repository implements a rigorous quantitative analysis workflow for Temporal Analysis of Products (TAP) mass spectrometry data. Unlike steady-state MS analysis, which often relies on relative intensity ratios, TAP requires the conversion of time-resolved electrical signals (counts or Amps) into absolute molar flux (
Because TAP experiments rely on the precise analysis of transient pulse shapes (moments analysis), maintaining strict mass balance and validating the transport regime is critical. This software achieves this using a dual-factor calibration logic and automated Knudsen validation.
The fundamental equation used to transform the raw mass spectrometer signal
The master equation implemented in the code is:
| Symbol | Unit | Description |
|---|---|---|
|
Molar Flux of species |
||
|
Raw Intensity signal from the mass spectrometer at time |
||
| Baseline background signal (vacuum level) to be subtracted. | ||
| Intensity-to-Flux Constant. A dynamic scalar derived from the inert tracer in the current pulse. | ||
| Dimensionless |
Calibration Factor. A static scalar representing the relative detection efficiency of species |
-
Code Variable:
config['conv'] - Nature: Dynamic (Recalculated for every pulse/peak)
Purpose: This factor normalizes the data against the "machine state" at the exact moment of the experiment. It compensates for variables that drift over time, such as detector gain, vacuum chamber pressure, and slight variations in the pulse valve injection size.
Derivation: It is calculated by integrating the signal of the co-pulsed inert tracer (e.g., Argon) where the injected amount is known (calibrated sample loop).
-
Code Variable:
calibration_factor - Nature: Static (Determined offline, constant for the species)
Purpose:
This is a material constant that corrects for the fact that the mass spectrometer is not equally sensitive to all molecules. It encapsulates the ratio of probabilities for Ionization (
Derivation: This factor is determined in a separate offline calibration experiment where a binary mixture of known composition (e.g., 50% Ar / 50% Reactant) is pulsed repeatedly.
For TAP kinetic models to be valid, the reactor must operate in the Knudsen Diffusion Regime, where transport is dominated by molecule-wall collisions rather than molecule-molecule collisions. This ensures that the gas phase concentration is low enough to ignore homogeneous reactions and that the transport rate is temperature-dependent only.
The software automatically validates this regime by calculating the statistical moments of the inert tracer pulse.
| Parameter | Symbol | Derivation | Description |
|---|---|---|---|
| Zeroth Moment | Represents the total moles eluted in the pulse. Used for mass balance closure. | ||
| Peak Flux | The maximum rate of molecules leaving the reactor. | ||
| Peak Time | The time elapsed between injection and maximum flux. | ||
| Normalized Peak Height | A shape factor with units of |
The product of the normalized peak height and the peak time provides a dimensionless shape factor that characterizes the diffusion quality.
-
Target Range:
$0.25 \le H_p \cdot t_p \le 0.35$ - Interpretation: A value near 0.3 indicates ideal one-dimensional Knudsen diffusion. Deviations suggest problems such as channeling, dead volumes, or transition-regime flow.
The software processes .tdms files through a strict pipeline to ensure that the resulting flux curves form a valid probability density function for transport analysis.
Before any scaling, the vacuum background must be removed. This is critical because even a small DC offset, when integrated over the long tail of a TAP pulse, will result in significant mass balance errors.
# Code Logic
corrected_raw = raw_vals - baseline_offsetTAP experiments often involve complex sequences (e.g., pump-probe) where different logic applies to different time segments. The code uses boolean masking to apply the specific
# The Master Equation in Code
# eff_conv combines the machine state (conv) and chemical physics (calibration_factor)
eff_conv = config['conv'] * calibration_factor
# Apply conversion only to the specific time window (mask)
flux_column[mask] = corrected_raw[mask] * eff_convAfter conversion, the software runs the validation check on the derived flux curve to ensure the experiment meets the criteria defined in Section 3.
# Code Logic: Validate Knudsen Criteria
Mo_avg = area_under_curve(t_list, f_list)
Hp_val = F_peak / Mo_avg
knudsen_product = Hp_val * t_p_val
if 0.25 <= knudsen_product <= 0.35:
status = "✓ EXCELLENT"