chemical-structure-annotation-and-export
License: noncommercial — confirm your use is a permitted (noncommercial) purpose before applying; commercial use requires a separate license (see metadata.tool_license).
Summary
Export predicted metabolite structures and their associated biotransformation annotations from BioTransformer's environmental microbial degradation module into a structured output file. This skill enables systematic capture and organization of metabolism prediction results for downstream metabolite identification and pathway analysis.
When to use
After executing BioTransformer's environmental microbial degradation module on a small-molecule input, when you need to capture predicted metabolites alongside the specific transformation rules applied and degradation pathway information in a format suitable for subsequent analysis, comparison, or publication.
When NOT to use
- Input is mammalian or gut microbiota metabolism predictions rather than soil/aquatic microbial degradation; use the appropriate BioTransformer module instead.
- You have only a single predicted metabolite or do not need systematic organization; manual documentation may be more efficient.
- The downstream tool expects a different schema or metabolite representation format not supported by the export step.
Inputs
- predicted metabolites from BioTransformer environmental microbial degradation module execution
- transformation rules applied (from EAWAG-BBD or EnviPath)
- degradation pathway information
Outputs
- structured output file listing predicted metabolites with chemical structures
- transformation rule annotations per metabolite
- degradation pathway annotations per metabolite
How to apply
Following retrieval of predicted metabolites from the EAWAG-BBD and EnviPath metabolic transformation data, systematically format the output to include three components for each predicted metabolite: (1) chemical structure (typically as SMILES or MOL format), (2) the specific transformation rule(s) applied by BioTransformer, and (3) the degradation pathway annotation. Export this annotated data as a structured output file (e.g., CSV, JSON, or SDF with metadata fields) that preserves the linkage between structure, rule, and pathway. The choice of export format should depend on downstream use—SDF with embedded metadata for visualization tools, CSV for tabular analysis, or JSON for computational integration.
Related tools
- BioTransformer (Predicts small-molecule metabolism and generates metabolite structures and transformation rules for the environmental microbial degradation module) — bitbucket.org/wishartlab/biotransformer
Evaluation signals
- Output file is well-formed and parseable in its declared format (CSV, JSON, SDF, etc.)
- Each predicted metabolite entry contains all three required components: structure, transformation rule(s), and pathway annotation
- Chemical structures in output are valid and represent distinct molecular entities
- Transformation rule annotations are traceable to EAWAG-BBD or EnviPath identifiers or rule names
- Row/entry count in output matches the number of unique predicted metabolites returned by BioTransformer
Limitations
- Export fidelity depends on BioTransformer's completeness of metadata export; some transformation metadata may be lost if BioTransformer does not expose it in programmatic output.
- Degradation pathway annotations from EAWAG-BBD may be incomplete or absent for novel or understudied compounds, limiting the utility of pathway-level annotations.
- No changelog available for BioTransformer versions, making it difficult to assess whether export format or annotation completeness has changed between releases.
Evidence
- [other] Retrieve predicted metabolites, including chemical structures, transformation rules applied, and degradation pathway information.: "Retrieve predicted metabolites, including chemical structures, transformation rules applied, and degradation pathway information."
- [other] Format and export the prediction results as a structured output file listing all predicted metabolites with their structures and transformation annotations.: "Format and export the prediction results as a structured output file listing all predicted metabolites with their structures and transformation annotations."
- [intro] BioTransformer's environmental microbial degradation module uses data from the EAWAG's Biodegradation and Biocatalysis Database: "BioTransformer's environmental microbial degradation module uses data from the EAWAG's Biodegradation and Biocatalysis Database"
- [intro] BioTransformer also assists scientists in metabolite identification, based on the metabolism prediction: "BioTransformer also assists scientists in metabolite identification, based on the metabolism prediction"
1---2name: chemical-structure-annotation-and-export3description: Use when after executing BioTransformer's environmental microbial degradation module on a small-molecule input, when you need to capture predicted metabolites alongside the specific transformation rules applied and degradation pathway information in a format suitable for subsequent analysis.4license: CC-BY-4.05---67# chemical-structure-annotation-and-export89> **License: noncommercial** — confirm your use is a permitted (noncommercial) purpose before applying; commercial use requires a separate license (see `metadata.tool_license`). <!-- asb-license-banner -->10## Summary1112Export predicted metabolite structures and their associated biotransformation annotations from BioTransformer's environmental microbial degradation module into a structured output file. This skill enables systematic capture and organization of metabolism prediction results for downstream metabolite identification and pathway analysis.1314## When to use1516After executing BioTransformer's environmental microbial degradation module on a small-molecule input, when you need to capture predicted metabolites alongside the specific transformation rules applied and degradation pathway information in a format suitable for subsequent analysis, comparison, or publication.1718## When NOT to use1920- Input is mammalian or gut microbiota metabolism predictions rather than soil/aquatic microbial degradation; use the appropriate BioTransformer module instead.21- You have only a single predicted metabolite or do not need systematic organization; manual documentation may be more efficient.22- The downstream tool expects a different schema or metabolite representation format not supported by the export step.2324## Inputs2526- predicted metabolites from BioTransformer environmental microbial degradation module execution27- transformation rules applied (from EAWAG-BBD or EnviPath)28- degradation pathway information2930## Outputs3132- structured output file listing predicted metabolites with chemical structures33- transformation rule annotations per metabolite34- degradation pathway annotations per metabolite3536## How to apply3738Following retrieval of predicted metabolites from the EAWAG-BBD and EnviPath metabolic transformation data, systematically format the output to include three components for each predicted metabolite: (1) chemical structure (typically as SMILES or MOL format), (2) the specific transformation rule(s) applied by BioTransformer, and (3) the degradation pathway annotation. Export this annotated data as a structured output file (e.g., CSV, JSON, or SDF with metadata fields) that preserves the linkage between structure, rule, and pathway. The choice of export format should depend on downstream use—SDF with embedded metadata for visualization tools, CSV for tabular analysis, or JSON for computational integration.3940## Related tools4142- **BioTransformer** (Predicts small-molecule metabolism and generates metabolite structures and transformation rules for the environmental microbial degradation module) — bitbucket.org/wishartlab/biotransformer4344## Evaluation signals4546- Output file is well-formed and parseable in its declared format (CSV, JSON, SDF, etc.)47- Each predicted metabolite entry contains all three required components: structure, transformation rule(s), and pathway annotation48- Chemical structures in output are valid and represent distinct molecular entities49- Transformation rule annotations are traceable to EAWAG-BBD or EnviPath identifiers or rule names50- Row/entry count in output matches the number of unique predicted metabolites returned by BioTransformer5152## Limitations5354- Export fidelity depends on BioTransformer's completeness of metadata export; some transformation metadata may be lost if BioTransformer does not expose it in programmatic output.55- Degradation pathway annotations from EAWAG-BBD may be incomplete or absent for novel or understudied compounds, limiting the utility of pathway-level annotations.56- No changelog available for BioTransformer versions, making it difficult to assess whether export format or annotation completeness has changed between releases.5758## Evidence5960- [other] Retrieve predicted metabolites, including chemical structures, transformation rules applied, and degradation pathway information.: "Retrieve predicted metabolites, including chemical structures, transformation rules applied, and degradation pathway information."61- [other] Format and export the prediction results as a structured output file listing all predicted metabolites with their structures and transformation annotations.: "Format and export the prediction results as a structured output file listing all predicted metabolites with their structures and transformation annotations."62- [intro] BioTransformer's environmental microbial degradation module uses data from the EAWAG's Biodegradation and Biocatalysis Database: "BioTransformer's environmental microbial degradation module uses data from the EAWAG's Biodegradation and Biocatalysis Database"63- [intro] BioTransformer also assists scientists in metabolite identification, based on the metabolism prediction: "BioTransformer also assists scientists in metabolite identification, based on the metabolism prediction"
