chemical-classification-aggregation
Summary
Aggregate chemical taxonomy classifications assigned by ClassyFire into a structured table indexed by molecular identifiers, after standardized molecular structures have been classified. This step consolidates per-molecule kingdom, superclass, class, and subclass taxonomy levels into a single machine-readable artifact.
When to use
You have a collection of standardized molecular structures (SMILES or MOL format) that have been submitted to ClassyFire and you need to collect and organize their classification results into a single CSV or JSON table for downstream analysis, validation, or retention time modeling.
When NOT to use
- Input structures have not been standardized using PubChem standardization or an equivalent canonical form — ClassyFire requires consistent chemical notation
- Molecules are already annotated with a curated or expert-assigned classification system that is authoritative for your use case — aggregating ClassyFire results may introduce redundancy or conflict
- The ClassyFire API or local instance is unavailable or has not been deployed in your environment
Inputs
- Standardized molecular structures (SMILES or MOL format files)
- Molecular identifiers (e.g., InChI, compound names, or sequential IDs)
- Optional: chromatographic metadata (column, gradient, flow rate, eluents)
Outputs
- Aggregated classification table (CSV or JSON format)
- Per-molecule taxonomy records (kingdom, superclass, class, subclass)
- Validation report (non-null classification coverage, taxonomy completeness)
How to apply
Query the ClassyFire API or local instance with each standardized molecular structure to retrieve its full chemical classification taxonomy (kingdom, superclass, class, subclass). Aggregate the returned classifications alongside their corresponding molecular identifiers and any other metadata (e.g., retention time, chromatographic conditions) into a structured table format (CSV or JSON). Perform validation by checking that each molecule has a non-null ClassyFire classification record and that all available taxonomy levels are populated where applicable. Sort or index the aggregated table by molecular identifier to enable cross-referencing with input structure files and downstream feature tables.
Related tools
- ClassyFire (Query chemical classification taxonomy for each standardized structure and retrieve kingdom, superclass, class, and subclass levels)
- PubChem standardization (Standardize input molecular structures to canonical form prior to ClassyFire submission)
Evaluation signals
- All molecules in the input structure file have a corresponding non-null record in the aggregated classification table (100% coverage)
- Each taxonomy level (kingdom, superclass, class, subclass) is populated where ClassyFire returns a value; no spurious null entries
- Aggregated table rows are indexed by molecular identifier and can be cross-referenced successfully with input structure files and computed molecular fingerprints/descriptors
- No duplicate molecular identifier rows exist in the aggregated table
- Taxonomy values conform to ClassyFire's controlled vocabulary (e.g., kingdom is one of Organic, Inorganic, Mixed, or Unknown)
Limitations
- ClassyFire classification relies on the quality and currency of its chemical ontology; molecules outside its coverage (e.g., complex salts, rare isotopologues) may receive incomplete or missing classifications
- Aggregation will fail or produce sparse results if the ClassyFire API is slow, rate-limited, or encounters network errors; no retry logic or fallback is specified in the workflow
- The workflow assumes all input structures can be successfully queried against ClassyFire; malformed or non-standard SMILES/MOL input will cause per-molecule failures
Evidence
- [other] Query ClassyFire API or local instance with each structure to retrieve chemical classification taxonomy (kingdom, superclass, class, subclass).: "Query ClassyFire API or local instance with each structure to retrieve chemical classification taxonomy (kingdom, superclass, class, subclass)."
- [other] Aggregate classification results with corresponding molecular identifiers into a structured table (CSV or JSON).: "Aggregate classification results with corresponding molecular identifiers into a structured table (CSV or JSON)."
- [other] Validation: verify each molecule has a non-null ClassyFire classification record and all taxonomy levels are populated where available.: "Validation: verify each molecule has a non-null ClassyFire classification record and all taxonomy levels are populated where available."
- [readme] Classification of molecules is performed using ClassyFire.: "Classification of molecules is performed using ClassyFire."
- [readme] structures are standardized using the PubChem standardization and molecular fingerprints and chemical descriptors are calculated using rcdk: "structures are standardized using the PubChem standardization and molecular fingerprints and chemical descriptors are calculated using rcdk"
1---2name: chemical-classification-aggregation3description: Use when you have a collection of standardized molecular structures (SMILES or MOL format) that have been submitted to ClassyFire and you need to collect and organize their classification results into a single CSV or JSON table for downstream analysis, validation, or retention time modeling.4license: CC-BY-4.05---67# chemical-classification-aggregation89## Summary1011Aggregate chemical taxonomy classifications assigned by ClassyFire into a structured table indexed by molecular identifiers, after standardized molecular structures have been classified. This step consolidates per-molecule kingdom, superclass, class, and subclass taxonomy levels into a single machine-readable artifact.1213## When to use1415You have a collection of standardized molecular structures (SMILES or MOL format) that have been submitted to ClassyFire and you need to collect and organize their classification results into a single CSV or JSON table for downstream analysis, validation, or retention time modeling.1617## When NOT to use1819- Input structures have not been standardized using PubChem standardization or an equivalent canonical form — ClassyFire requires consistent chemical notation20- Molecules are already annotated with a curated or expert-assigned classification system that is authoritative for your use case — aggregating ClassyFire results may introduce redundancy or conflict21- The ClassyFire API or local instance is unavailable or has not been deployed in your environment2223## Inputs2425- Standardized molecular structures (SMILES or MOL format files)26- Molecular identifiers (e.g., InChI, compound names, or sequential IDs)27- Optional: chromatographic metadata (column, gradient, flow rate, eluents)2829## Outputs3031- Aggregated classification table (CSV or JSON format)32- Per-molecule taxonomy records (kingdom, superclass, class, subclass)33- Validation report (non-null classification coverage, taxonomy completeness)3435## How to apply3637Query the ClassyFire API or local instance with each standardized molecular structure to retrieve its full chemical classification taxonomy (kingdom, superclass, class, subclass). Aggregate the returned classifications alongside their corresponding molecular identifiers and any other metadata (e.g., retention time, chromatographic conditions) into a structured table format (CSV or JSON). Perform validation by checking that each molecule has a non-null ClassyFire classification record and that all available taxonomy levels are populated where applicable. Sort or index the aggregated table by molecular identifier to enable cross-referencing with input structure files and downstream feature tables.3839## Related tools4041- **ClassyFire** (Query chemical classification taxonomy for each standardized structure and retrieve kingdom, superclass, class, and subclass levels)42- **PubChem standardization** (Standardize input molecular structures to canonical form prior to ClassyFire submission)4344## Evaluation signals4546- All molecules in the input structure file have a corresponding non-null record in the aggregated classification table (100% coverage)47- Each taxonomy level (kingdom, superclass, class, subclass) is populated where ClassyFire returns a value; no spurious null entries48- Aggregated table rows are indexed by molecular identifier and can be cross-referenced successfully with input structure files and computed molecular fingerprints/descriptors49- No duplicate molecular identifier rows exist in the aggregated table50- Taxonomy values conform to ClassyFire's controlled vocabulary (e.g., kingdom is one of Organic, Inorganic, Mixed, or Unknown)5152## Limitations5354- ClassyFire classification relies on the quality and currency of its chemical ontology; molecules outside its coverage (e.g., complex salts, rare isotopologues) may receive incomplete or missing classifications55- Aggregation will fail or produce sparse results if the ClassyFire API is slow, rate-limited, or encounters network errors; no retry logic or fallback is specified in the workflow56- The workflow assumes all input structures can be successfully queried against ClassyFire; malformed or non-standard SMILES/MOL input will cause per-molecule failures5758## Evidence5960- [other] Query ClassyFire API or local instance with each structure to retrieve chemical classification taxonomy (kingdom, superclass, class, subclass).: "Query ClassyFire API or local instance with each structure to retrieve chemical classification taxonomy (kingdom, superclass, class, subclass)."61- [other] Aggregate classification results with corresponding molecular identifiers into a structured table (CSV or JSON).: "Aggregate classification results with corresponding molecular identifiers into a structured table (CSV or JSON)."62- [other] Validation: verify each molecule has a non-null ClassyFire classification record and all taxonomy levels are populated where available.: "Validation: verify each molecule has a non-null ClassyFire classification record and all taxonomy levels are populated where available."63- [readme] Classification of molecules is performed using ClassyFire.: "Classification of molecules is performed using ClassyFire."64- [readme] structures are standardized using the PubChem standardization and molecular fingerprints and chemical descriptors are calculated using rcdk: "structures are standardized using the PubChem standardization and molecular fingerprints and chemical descriptors are calculated using rcdk"
HolobiomicsLab