Skip to content
Back to skills

Carbon Oxidation State Assessment

ASecurity

Use when after molecular formula assignment from FT-ICR MS peak data,

  • 16 stars
  • 0 votes
  • 0 copies
  • 4 views
  • Added September 12, 2026
ai-agentspythongit

Security analysis

A100/100

Scanned September 12, 2026

npx -y skills add HolobiomicsLab/asb-skill-collections --skill carbon-oxidation-state-assessment --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Carbon Oxidation State Assessment?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Carbon Oxidation State Assessment
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/holobiomicslab-carbon-oxidation-state-assessment/badge)](https://www.skillsdirectory.com/skills/holobiomicslab-carbon-oxidation-state-assessment)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: carbon-oxidation-state-assessment
description: Use when after molecular formula assignment from FT-ICR MS peak data,
  when you need to classify metabolites by their redox state to predict bioavailability
  or lability, or when generating thermodynamic indices for chemodiversity analysis
  and environmental metabolomic interpretation.
license: CC-BY-4.0
metadata:
  edam_operation: http://edamontology.org/operation_3629
  edam_topics:
  - http://edamontology.org/topic_3172
  - http://edamontology.org/topic_0625
  tools:
  - NumPy
  - pandas
  - MetaboDirect
  techniques:
  - LC-MS
  - GC-MS
  license_tier: open
  provenance_tier: literature
derived_from:
- doi: 10.1186/s40168-023-01476-3
  title: MetaboDirect
evidence_spans:
- requires the Python dependencies NumPy [40], pandas [41, 42]
- The MetaboDirect pipeline was developed in Python 3.8 [38] and R 4.0.2 [39] and
  is available to install through the Python Package Index... It requires the Python
  dependencies NumPy
- It requires the Python dependencies NumPy [40], pandas [41, 42]
claims: []
provenance:
  collection: https://w3id.org/holobiomicslab/asb-skill/collection/metabolomics/v2
  assembled_by: scripts/collect_metabolomics_collection.py
  sources:
  - build: coll_metabodirect_cq
    doi: 10.1186/s40168-023-01476-3
    title: MetaboDirect
  dedup_kept_from: coll_metabodirect_cq
schema_version: 0.2.0
attribution:
  generator: AgenticScienceBuilder
  original_doi: 10.1186/s40168-023-01476-3
  all_source_dois:
  - 10.1186/s40168-023-01476-3
  zenodo_doi: 10.5281/zenodo.20794027
  curators: []
  promoter: Louis-Félix Nothias
  sponsor: CNRS & Université Côte d'Azur
---

# carbon-oxidation-state-assessment

## Summary

Calculate the nominal oxidation state of carbon (NOSC) from elemental composition of assigned molecular formulas to characterize metabolite oxidation degree and predict degradation likelihood in FT-ICR MS metabolomic datasets.

## When to use

After molecular formula assignment from FT-ICR MS peak data, when you need to classify metabolites by their redox state to predict bioavailability or lability, or when generating thermodynamic indices for chemodiversity analysis and environmental metabolomic interpretation.

## When NOT to use

- Peaks without assigned molecular formulas or missing elemental composition counts cannot be processed.
- If only m/z values are available without formula assignment, NOSC cannot be calculated.
- Data from techniques other than direct-injection FT-ICR MS (e.g., GC-MS, LC-MS with chromatographic separation) require different oxidation state frameworks.

## Inputs

- Peak data table (CSV) with m/z, assigned molecular formula, and elemental composition counts (C, H, O, N, S, P)
- Supplementary Table 2 NOSC equation specification

## Outputs

- NOSC index column (numeric vector) for each peak
- Extended CSV table with columns: m/z, molecular formula, NOSC, peak intensity

## How to apply

For each peak with assigned molecular formula and elemental composition (C, H, O, N, S, P counts), apply the NOSC calculation equation from Supplementary Table 2 using the elemental composition vector. NOSC characterizes the average oxidation state of carbon atoms within the molecule and ranges typically from −1 (highly reduced, e.g., alkanes) to +1 (highly oxidized, e.g., carboxylic acids) for organic matter. The calculation is deterministic given valid elemental counts; validate by ensuring all peaks with valid formulas receive NOSC values within expected biological ranges (typically −0.5 to +0.5 for natural organic matter). NOSC is downstream of formula assignment but upstream of Gibbs free energy and aromaticity index calculations, which depend on it. No missing or NaN values should appear in the output column.

## Related tools

- **MetaboDirect** (Command-line pipeline that orchestrates NOSC calculation as part of thermodynamic index computation step following formula assignment) — https://github.com/Coayala/MetaboDirect
- **NumPy** (Vectorized computation of NOSC from elemental composition arrays)
- **pandas** (Data frame management for indexed storage and export of NOSC values alongside peak metadata)

## Evaluation signals

- All peaks with valid assigned molecular formulas receive exactly one NOSC value; no NaN or missing entries in output column.
- NOSC values fall within expected biological ranges for organic matter (typically −0.5 to +0.5 for natural organic matter; extremes −1 to +1 acceptable for synthetic or highly reduced/oxidized compounds).
- NOSC values correlate predictably with compound class (e.g., carbohydrates cluster near −0.3 to 0, lipids near −1, highly oxygenated acids near +0.5), reflecting known redox chemistry.
- NOSC computation is deterministic: identical elemental compositions produce identical NOSC values across runs.
- NOSC output integrates cleanly into downstream Gibbs free energy (ΔG°C-ox) and aromaticity index (AImod) calculations without data type mismatches.

## Limitations

- NOSC assumes all assigned molecular formulas are correct; errors in formula assignment directly propagate to incorrect NOSC values.
- NOSC is an average oxidation state per molecule and does not distinguish structural isomers with identical molecular formulas but different spatial arrangements or local oxidation states.
- FT-ICR MS cannot directly distinguish chemical isomers, so two signals with the same m/z and formula receive the same NOSC even if they represent different compounds with different true oxidation states.
- NOSC calculation is sensitive to detection of low-abundance elements (N, S, P); incomplete or misassigned minor element counts can introduce systematic bias.

## Evidence

- [other] For each peak's elemental composition, calculate the nominal oxidation state of carbon (NOSC) using the elemental composition equation from Supplementary Table 2.: "For each peak's elemental composition, calculate the nominal oxidation state of carbon (NOSC) using the elemental composition equation from Supplementary Table 2."
- [other] MetaboDirect calculates thermodynamic indices including double-bond equivalent (DBE), Gibbs free energy (GFE), aromaticity index (AI), and nominal oxidation state of carbon (NOSC) from the elemental composition of assigned molecular formulas to characterize metabolite properties such as saturation, lability, and degree of oxidation.: "MetaboDirect calculates thermodynamic indices including double-bond equivalent (DBE), Gibbs free energy (GFE), aromaticity index (AI), and nominal oxidation state of carbon (NOSC) from the elemental"
- [other] all peaks with valid molecular formulas receive four index values; no missing or NaN values in output; indices fall within expected biological ranges for organic matter.: "all peaks with valid molecular formulas receive four index values; no missing or NaN values in output; indices fall within expected biological ranges for organic matter."
- [other] Load filtered peak data with assigned molecular formulas and elemental composition (C, H, O, N, S, P counts) from the pre-processing step output as CSV.: "Load filtered peak data with assigned molecular formulas and elemental composition (C, H, O, N, S, P counts) from the pre-processing step output as CSV."
- [other] Calculate Gibbs free energy (ΔG°C-ox or GFE) for each peak from NOSC to determine degradation likelihood using the equation in Supplementary Table 2.: "Calculate Gibbs free energy (ΔG°C-ox or GFE) for each peak from NOSC to determine degradation likelihood using the equation in Supplementary Table 2."

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.