Scroll to navigation

SMI_CANONICALISE(1) User Commands SMI_CANONICALISE(1)

NAME

smi_canonicalise - canonicalise SMILES

DESCRIPTION

USAGE

smi_canonicalise [<args>] [<files>]

DESCRIPTION

smi_canonicalise reads in files with SMILES descriptors and outputs them according to stable atom ordering established by Graph::Nauty. Moieties, if more than one, are ordered in lexicographic order.

OPTIONS

infer hydrogen atom counts according to valency rules [default]
do not infer hydrogen atom counts
aromatise Kekule structures (experimental)
do not attempt to aromatise [default]
Mark flat rings as aromatic. Two methods are supported: 'electron-cycles', which follows Richard L. Apodaca's electron cycle-based approach (default), 'Huckel', which aims to follow H??ckel's rule as implemented in Chemistry::Ring. 'external-list': uses aromaticity defined using --aromatic-atoms or --aromatic-bonds options.
comma-separated list of 0-based aromatic atom numbers to be consulted during aromaticity detection. Implies --aromatisation-method 'external-list'.
comma-separated list of bonds, expressed as dash-separated pairs of 0-based aromatic atom numbers. The list is consulted during aromaticity detection. Implies --aromatisation-method 'external-list'.
kekulise simple aromatic structures (experimental)
do not attempt to kekulise [default]
convert acyclic aromatic bonds to single
canonicalise the representation of haloanions [default]
retain input representation of haloanions
canonicalise the representation of nitro groups by converting them from *-[N+]([O-])=O to *-N(=O)=O
retain input representation of nitro groups [default]
ignore SMILES atom class in canonicalisation (useful for testing)
preserve input order of molecular entities and atoms
instead of canonical, output SMILES in random order (useful for testing)
print usage message and exit
January 2026 smi_canonicalise 0.4.0+dfsg