Research & development
LigninQC - Reproducible Scientific Research Workflows
Check a BDE - antioxidant association and reconcile sulfated-lignin thermal claims with the published tables. Rerun both cases offline.
Overview
LigninQC connects two scientific questions to inspectable calculations: how state and normalization choices affect an antioxidant association, and whether selected thermal claims agree with a sulfated-lignin table. Version 1.0.0 includes two CC BY article cases, source locations, CSV inputs, Python code, tests and reports in one offline archive.
Recomputed case results
| Question | Result and scope |
|---|---|
| How closely does the reconstructed neutral-state BDE association fit DPPH values? | R = 0.637 across 18 compounds Calculated from rounded Table 1 values in Lauberte et al. (2019). This is one declared reconstruction; state mapping, exclusions and OH normalization are sensitivity analyses. It is not external predictive validation. |
| Do the reported 800 degC thermal values agree with the prose? | Table: 61.9% initial, 76.6% sulfated mass loss Kazachenko et al. (2022), Table 2. The prose reverses these two values. This is a source-internal inconsistency; the available table does not establish which statement reflects the raw experiment. |
Run the included cases
Python 3.10 or later; no pip installation or account required. After downloading, the included cases run offline using only the standard library. On Windows, use py -3 instead of python3.
- Download and extract the release archive.
- Open a terminal in the directory containing the extracted folder.
- Run the two commands below, then open results/report.html in your browser.
cd ligninqc-reanalysis-2026-09-05
python3 -m ligninqc reproduce --out results
python3 -m ligninqc verifyThe run writes results/report.html and results/results.json. To replace a previous nonempty results directory, add --force to the reproduce command. The archive includes version 1.0.0, source locators and the reference output.
Antioxidant association: what changes with the assumptions?
The Lauberte et al. (2019) case reanalyses published O - H bond dissociation energies and radical-deactivation values. It varies the reported molecular-state mapping, the included compounds and normalization by phenolic OH count. Missing observations remain missing. The report shows how these declared choices change the association; a difference from a rounded published correlation is not by itself evidence of a calculation error.
Sulfated lignin: do the words and tables agree?
The Kazachenko et al. (2022) case checks selected thermal statements against the reported cumulative mass-loss table and describes the molecular-weight ratios. It preserves the distinction between a table/prose mismatch and an experimentally established error. Changes in GPC eluent, calibration, sulfation and purification limit what an apparent molecular-weight decrease can establish about bond cleavage.
Scope of the results
This release reanalyses a selected subset of published data. It does not perform new quantum-chemical calculations, independently validate the underlying experiments, estimate field-wide error rates, or measure researcher productivity. Numerical agreement and software checks are reported separately from scientific interpretation.
Access and reuse
Code is licensed under MIT. Original documentation and analysis are CC BY 4.0. The bundled articles and selected data are CC BY 4.0 with their authors and source locations retained. LICENSE and DATA-LICENSE.md explain these boundaries. No private corpus or account access is needed to run the included cases.
What It Covers
- Recalculate two documented article cases with source locators, units and explicit assumptions
- Run locally with Python 3.10 or later and its standard library, without accounts or API keys
- Inspect the computed results, source comparisons and limitations in a static HTML report
- Reuse the included code and permitted data under the licenses supplied with the package
Stack And Topics
- Python 3.10+
- Standard library
- CSV
- JSON
- HTML
References
- Read the scientific report
- Download the offline package
- Verify the download
- Inspect the source tables
- Data: antioxidant model compounds (CSV)
- Data: cumulative mass loss (CSV)
- Data: molecular weights (CSV)
- Lauberte et al. (2019): original article
- Kazachenko et al. (2022): original article
- Plain-text case study