SMILES String Preparation for Molecular Input
License: restricted — no clear open-source license detected for the underlying tool; verify licensing before commercial use or redistribution.
Summary
Format a molecule's SMILES representation as a queryable input string for computational chemistry tools that predict metabolites or other molecular properties. This skill ensures the SMILES notation is syntactically correct and wrapped in the tool-specific format required by command-line or API invocation.
When to use
You have a target molecule (e.g., acetaminophen, a drug candidate, or a xenobiotic) whose structure you need to encode for metabolite prediction, reaction rule matching, or other structure-based cheminformatics workflow. The downstream tool accepts SMILES input and requires explicit format specification to distinguish a SMILES string from a file path.
When NOT to use
- Input is already a file path to an SDF or structure file — use the file path directly without SMILES= prefix instead.
- The tool accepts either SMILES or SDF indifferently without explicit format tagging — check tool documentation to avoid redundant formatting.
Inputs
- Molecular structure (as InChI, common name, or SMILES notation)
- Canonical or semi-canonical SMILES string
Outputs
- Formatted SMILES query string (e.g., SMILES=CC(=O)Nc1ccc(O)cc1)
- Validated SMILES input ready for metabolite prediction or structure-based cheminformatics workflow
How to apply
Obtain or derive the canonical or semi-canonical SMILES string for your molecule (e.g., CC(=O)Nc1ccc(O)cc1 for acetaminophen). If the tool requires explicit labeling (as CyProduct does), prepend the SMILES with the format prefix SMILES= to disambiguate it from a file path input. Validate that the SMILES string is chemically valid by checking it parses without syntax errors and represents the intended molecular structure. Pass the formatted string (e.g., SMILES=CC(=O)Nc1ccc(O)cc1) as the QueryMolecule parameter to the command-line tool or API.
Related tools
- CyProduct (Accepts SMILES string as QueryMolecule parameter for metabolite prediction across specified CYP450 enzymes) — https://github.com/Le0nT1/CyProduct
- Java (Runtime environment for executing CyProduct.jar with SMILES input and command-line parameters)
Examples
java -jar CyProduct.jar SMILES=CC(=O)Nc1ccc(O)cc1 1A2,2A6,2B6,2C8,2C9,2C19,2D6,2E1,3A4 /path/to/output
Evaluation signals
- SMILES string parses without syntax errors in a cheminformatics toolkit (RDKit, CDK, etc.)
- Formatted input (e.g., SMILES=...) is accepted by the tool without malformed-input errors
- Tool successfully generates output (predicted metabolites, reaction matches) without rejecting the input as invalid
- SMILES notation correctly represents the intended molecular structure (manual visual inspection or comparison against a reference SDF)
- Output metabolites or results are consistent with expectations for the query molecule and enzyme/reaction set used
Limitations
- SMILES strings are not unique — different SMILES can represent the same molecule; canonical or semi-canonical forms are recommended but tool behavior may vary.
- The SMILES= prefix format is tool-specific to CyProduct; other tools may require different input syntax or no prefix at all.
- Complex or unusual molecules (e.g., salts, charged species, stereoisomers with mixed or undefined stereochemistry) may not parse correctly or may generate ambiguous results.
- No validation that the SMILES represents a chemically realistic or drug-like molecule — syntactic validity does not imply biological relevance.
Evidence
- [readme] QueryMolecule input format specification: "The QueryMolecule can be either a SMILES string or the path to a sdf file. Note that if the QueryMolecule is a SMILES string, it should use format:SMILES=yourSmilesString."
- [other] Concrete SMILES example for acetaminophen: "1. Prepare the acetaminophen SMILES string (CC(=O)Nc1ccc(O)cc1) as the query molecule input."
- [readme] Command-line invocation with SMILES input: "java -jar CyProduct.jar CC(=O)Nc1ccc(O)cc1 1A2,2A6,2B6,2C8,2C9,2C19,2D6,2E1,3A4 E:\Users\cyproduct"
- [readme] Enzyme format specification: "Please note that when you use the CyProduct tool or its API, please input enzyme without "CYP". For example, please use 1A2 other than CYP1A2 in both cases."
1---2name: smiles-string-preparation3description: Use when you have a target molecule (e.g., acetaminophen, a drug candidate, or a xenobiotic) whose structure you need to encode for metabolite prediction, reaction rule matching, or other structure-based cheminformatics workflow.4license: CC-BY-4.05---67# SMILES String Preparation for Molecular Input89> **License: restricted** — no clear open-source license detected for the underlying tool; verify licensing before commercial use or redistribution. <!-- asb-license-banner -->10## Summary1112Format a molecule's SMILES representation as a queryable input string for computational chemistry tools that predict metabolites or other molecular properties. This skill ensures the SMILES notation is syntactically correct and wrapped in the tool-specific format required by command-line or API invocation.1314## When to use1516You have a target molecule (e.g., acetaminophen, a drug candidate, or a xenobiotic) whose structure you need to encode for metabolite prediction, reaction rule matching, or other structure-based cheminformatics workflow. The downstream tool accepts SMILES input and requires explicit format specification to distinguish a SMILES string from a file path.1718## When NOT to use1920- Input is already a file path to an SDF or structure file — use the file path directly without SMILES= prefix instead.21- The tool accepts either SMILES or SDF indifferently without explicit format tagging — check tool documentation to avoid redundant formatting.2223## Inputs2425- Molecular structure (as InChI, common name, or SMILES notation)26- Canonical or semi-canonical SMILES string2728## Outputs2930- Formatted SMILES query string (e.g., SMILES=CC(=O)Nc1ccc(O)cc1)31- Validated SMILES input ready for metabolite prediction or structure-based cheminformatics workflow3233## How to apply3435Obtain or derive the canonical or semi-canonical SMILES string for your molecule (e.g., CC(=O)Nc1ccc(O)cc1 for acetaminophen). If the tool requires explicit labeling (as CyProduct does), prepend the SMILES with the format prefix SMILES= to disambiguate it from a file path input. Validate that the SMILES string is chemically valid by checking it parses without syntax errors and represents the intended molecular structure. Pass the formatted string (e.g., SMILES=CC(=O)Nc1ccc(O)cc1) as the QueryMolecule parameter to the command-line tool or API.3637## Related tools3839- **CyProduct** (Accepts SMILES string as QueryMolecule parameter for metabolite prediction across specified CYP450 enzymes) — https://github.com/Le0nT1/CyProduct40- **Java** (Runtime environment for executing CyProduct.jar with SMILES input and command-line parameters)4142## Examples4344```45java -jar CyProduct.jar SMILES=CC(=O)Nc1ccc(O)cc1 1A2,2A6,2B6,2C8,2C9,2C19,2D6,2E1,3A4 /path/to/output46```4748## Evaluation signals4950- SMILES string parses without syntax errors in a cheminformatics toolkit (RDKit, CDK, etc.)51- Formatted input (e.g., SMILES=...) is accepted by the tool without malformed-input errors52- Tool successfully generates output (predicted metabolites, reaction matches) without rejecting the input as invalid53- SMILES notation correctly represents the intended molecular structure (manual visual inspection or comparison against a reference SDF)54- Output metabolites or results are consistent with expectations for the query molecule and enzyme/reaction set used5556## Limitations5758- SMILES strings are not unique — different SMILES can represent the same molecule; canonical or semi-canonical forms are recommended but tool behavior may vary.59- The SMILES= prefix format is tool-specific to CyProduct; other tools may require different input syntax or no prefix at all.60- Complex or unusual molecules (e.g., salts, charged species, stereoisomers with mixed or undefined stereochemistry) may not parse correctly or may generate ambiguous results.61- No validation that the SMILES represents a chemically realistic or drug-like molecule — syntactic validity does not imply biological relevance.6263## Evidence6465- [readme] QueryMolecule input format specification: "The QueryMolecule can be either a SMILES string or the path to a sdf file. Note that if the QueryMolecule is a SMILES string, it should use format:SMILES=yourSmilesString."66- [other] Concrete SMILES example for acetaminophen: "1. Prepare the acetaminophen SMILES string (CC(=O)Nc1ccc(O)cc1) as the query molecule input."67- [readme] Command-line invocation with SMILES input: "java -jar CyProduct.jar CC(=O)Nc1ccc(O)cc1 1A2,2A6,2B6,2C8,2C9,2C19,2D6,2E1,3A4 E:\Users\cyproduct\"68- [readme] Enzyme format specification: "Please note that when you use the CyProduct tool or its API, please input enzyme without "CYP". For example, please use 1A2 other than CYP1A2 in both cases."
HolobiomicsLab