OEIFlavor

The OEIFlavor namespace encodes symbolic constants used as bit-masks to indicate how to write various file formats by OEChem TK.

Note

A very important introduction (with examples) as to how to manipulate these bit-masks is given Flavored Input and Output

The OEIFlavor_Generic namespace within OEIFlavor defines control bit-masks that are common to all of the input formats. Although these generic bits are common to all file formats, they may be specified independently for each file format.

See also

The interpretation of many of these flavor values, is identical to those passed to the corresponding OEChem TK low-level file format readers.

This namespace contains the following namespaces:

OEIFlavor::CAN

The OEIFlavor_CAN namespace encodes symbolic constants used as bit-masks that control the processing performed by the high-level molecule file reader OEReadMolecule after reading OEFormat_CAN format file by the OEParseSmiles function.

This namespace contains the following constants:

Default

No special options are set.

OEIFlavor::CDX

The OEIFlavor_CDX namespace encodes symbolic constants used as bit-masks that control the processing performed by the high-level molecule file reader OEReadMolecule after reading OEFormat_CDX format file by the OEReadCDXFile low-level file reader.

This namespace contains the following constants:

SuperAtom

Controls whether nested CDX fragment objects, which represent superatom abbreviation groups, are expanded and read with their atoms parented to the enclosing atom. When this flag is set (the default), abbreviations such as Ph or OMe embedded in a CDX structure are interpreted as substructures.

Default

Same as the OEIFlavor_CDX_SuperAtom constant.

OEIFlavor::CIF

The OEIFlavor_CIF namespace encodes symbolic constants used as bit-masks that control the processing performed by the high-level molecule file reader OEReadMolecule after reading OEFormat_CIF format file by the OEReadCIFFile low-level file reader.

This namespace contains the following constants, that mimic the XYZ reader.

FormalCrg

This flag indicates that high-level molecular file reader calls the OEAssignFormalCharges function to assign formal charges.

ImplicitH

This flag indicates that high-level molecular file reader calls the OEAssignImplicitHydrogens function to assign implicit hydrogens.

BondOrder

This flag indicates that high-level molecular file reader calls the OEPerceiveBondOrders function to perceive bond orders.

Rings

The reader stores excluded sites and sites left after filtering. The filtering of these sites is based on the flavors listed below.

OccFilterOneHalf

If occupancy is noted in the CIF file, only the sites with occupancy larger than one half is kept. If occupancy is not defined in the CIF file, the occupancies are set to 1 to prevent filtering.

RemovePBCImages

Each site read is checked to see if it is equal to a previously read site up to periodic wrapping in fractional coordinates.

NormalizeHydPos

Hydrogen positions and bond lengths are normalized if necessary.

BondHydToClosest

Enforces that hydrogen atoms are bonded to their closest heavy atom in space.

RemoveQuestionMarkInLabel

Sites with a question mark after atom labels are assigned are filtered out. These extra sites are sometimes alternative positions of existing sites.

Default

Combination of: OEIFlavor_CIF_FormalCrg, OEIFlavor_CIF_ImplicitH, OEIFlavor_CIF_BondOrder, OEIFlavor_CIF_Rings, OEIFlavor_CIF_OccFilterOneHalf, OEIFlavor_CIF_RemovePBCImages, OEIFlavor_CIF_NormalizeHydPos, OEIFlavor_CIF_BondHydToClosest, OEIFlavor_CIF_RemoveQuestionMarkInLabel flags.

OEIFlavor::CSV

This namespace contains constants for modifying the behavior of how the OEFormat_CSV file format is read.

See also

CSV File Format

Header

Attempt to interpret the first line of the .csv file as a header line containing column names. The header line will be parsed into an OECSVHeader object and stored on the oemolistream object, retrievable by oemolstreambase.GetCSVHeader.

If this flag is not set, or the first column of the first line does not contain a valid SMILES string, the OECSVHeader will be initialized with the number of columns present in the first line of the file. The columns will then be named and parsed in the following order: SMILES, TITLE, OE_CSV_COLUMN_1, OE_CSV_COLUMN_2, …, OE_CSV_COLUMN_N.

Default

Set to include OEIFlavor_CSV_Header to automatically parse column names into molecule SD data.

DEFAULT

Synonym for OEIFlavor_CSV_Default.

OEIFlavor::CXSMILES

The OEIFlavor_CXSMILES namespace encodes symbolic constants used as bit-masks that control the processing performed by the OEParseSmiles function.

This namespace contains the following constants:

Strict

Enables strict parsing mode for CXSMILES strings. The parser applies more rigorous sanity checking, rejecting malformed SMILES strings that would be accepted by the non-strict parser. For example, C==C is accepted by default but rejected in strict mode.

Canon

When set, the parser assumes the SMILES string is well-formed and omits the usual kekulization step performed by OEKekulize. This can speed up parsing of large databases, but bond orders may not be correctly assigned for aromatic molecules.

DEFAULT

No special parsing options are set. Both OEIFlavor_CXSMILES_Strict and OEIFlavor_CXSMILES_Canon flags are disabled.

Default

Same as the OEIFlavor_CXSMILES_DEFAULT constant.

OEIFlavor::FASTA

The OEIFlavor_FASTA namespace encodes symbolic constants used as bit-masks that control the processing performed by the high-level molecule file reader OEReadMolecule after reading OEFormat_FASTA format file by the OEReadFASTAFile low-level file reader.

This namespace contains the following constants:

Default

No special options are selected.

CustomResidues

Instructs the FASTA reader to interpret values surrounded in square brackets, [foo], as custom residues. The structure of these custom residues must first be registered with the OEAddCustomFASTAResidue function.

Warning

This is an experimental API that may change in the future.

EmbeddedSMILES

Instructs the FASTA reader to interpret values surrounded in square brackets, [CCC], as SMILES strings if a custom residue with the same name can not be found. The SMILES can optionally contain attachment points back to the peptide backbone. For example, [[R1]CSC[R15]] specifies to attach to the first and fifteenth residue in the peptide, effectively cyclizing the peptide.

Warning

This is an experimental API that may change in the future.

AllMask

Combination of OEIFlavor_FASTA_CustomResidues and OEIFlavor_FASTA_EmbeddedSMILES flags.

OEIFlavor::Generic

This namespace contains the following constants:

OEAroModelDaylight

This flag indicates that the Daylight aromaticity model is used to perceive aromaticity by the OEReadMolecule high-level reader.

OEAroModelOpenEye

This flag indicates that the OpenEye aromaticity model is used to perceive aromaticity by the OEReadMolecule high-level reader.

OEAroModelTripos

This flag indicates that the Tripos aromaticity model is used to perceive aromaticity by the OEReadMolecule high-level reader.

OEAroModelMMFF

This flag indicates that the MMFF aromaticity model is used to perceive aromaticity by the OEReadMolecule high-level reader.

OEAroModelMDL

This flag indicates that the MDL aromaticity model is used to perceive aromaticity by the OEReadMolecule high-level reader.

AroMask

Combination of OEIFlavor_Generic_OEAroModelDaylight, OEIFlavor_Generic_OEAroModelOpenEye, OEIFlavor_Generic_OEAroModelTripos, OEIFlavor_Generic_OEAroModelMMFF and OEIFlavor_Generic_OEAroModelMDL flags.

Rings

This flag indicates the rings are perceived by the OEReadMolecule high-level reader by calling the OEFindRingAtomsAndBonds function.

GenericMask

Combination of OEIFlavor_Generic_AroMask and OEIFlavor_Generic_Rings flags.

SpecificMask

Bit mask covering all format-specific flavor bits (bits 0-13). This is the complement of OEIFlavor_Generic_GenericMask.

DEFAULT

Same as the OEIFlavor_Generic_Rings constant. Ring perception is performed after every molecule read by the high-level OEReadMolecule reader.

Default

Same as the OEIFlavor_Generic_DEFAULT constant.

OEIFlavor::ISM

The OEIFlavor_ISM namespace encodes symbolic constants used as bit-masks that control the processing performed by the high-level molecule file reader OEReadMolecule after reading OEFormat_ISM format file by the OEParseSmiles function.

This namespace contains the following constants:

Default

No special options are set.

OEIFlavor::MDL

The OEIFlavor_MDL namespace encodes symbolic constants used as bit-masks that control the processing performed by the high-level molecule file reader OEReadMolecule after reading OEFormat_MDL format file by the OEReadMDLFile low-level file reader.

This namespace contains the following constants:

Default

No special options are set. The OEIFlavor_MDL_FixBondMarks, OEIFlavor_MDL_SuppressEmptyMolSkip, OEIFlavor_MDL_SuppressImp2ExpENHSTE, and OEIFlavor_MDL_ForceImp2ExpENHSTE flags are all disabled.

FixBondMarks

This input flavor requests that the reader make an attempt to repair stereocenters that throw warnings due to issues identified by OEMDLStereoFromBondStereo. With this input flavor enabled, the warnings will continue to be issued to allow user inspection and verification of the modified bond marks. However, once the corrected structure(s) have been rewritten with any format that captures bond stereomark information, a re-read of the structure(s) should emit fewer stereocenter correction warnings. This input flavor is not enabled for the default OEFormat_MDL setting.

SuppressEmptyMolSkip

This input flavor suppresses the default action of skipping empty molecules in the input stream. This may be important in order to recover SDData stored on empty molecule records.

SuppressImp2ExpENHSTE

This input flavor suppresses any enhanced stereogroup implicit to explicit conversions for an input V3000 format molfile.

ForceImp2ExpENHSTE

This input flavor performs implicit to explicit enhanced stereogroup conversions for an input V2000 or V3000 format molfile.

OEIFlavor::MMCIF

The OEIFlavor_MMCIF namespace encodes symbolic constants used as bit-masks that control the processing performed by the high-level molecule file reader OEReadMolecule after reading OEFormat_MMCIF format file by the OEReadCIFFile low-level file reader.

This namespace contains the following constants.

FormalCrg

This flag indicates that high-level molecular file reader calls the OEAssignFormalCharges function to assign formal charges.

ImplicitH

This flag indicates that high-level molecular file reader calls the OEAssignImplicitHydrogens function to assign implicit hydrogens.

BondOrder

This flag indicates that high-level molecular file reader calls the OEPerceiveBondOrders function to perceive bond orders.

Rings

This flag indicates that high-level molecular file reader calls the OEFindRingAtomsAndBonds function to determine ring structure.

Connect

This flag indicates that high-level molecular file reader calls the OEDetermineConnectivity function to perceive bond connectivity from atomic coordinates.

SecStruct

This flag indicates that high-level molecular file reader calls the OEPerceiveSecondaryStructure function to assign secondary structure.

ALTLOC

This flavor is required when OEAltLocationFactory is to be used so that all the atoms with alternate location codes are retained.

DEFAULT

Combination of OEIFlavor_MMCIF_Connect, OEIFlavor_MMCIF_Rings, OEIFlavor_MMCIF_BondOrder, OEIFlavor_MMCIF_ImplicitH, OEIFlavor_MMCIF_SecStruct, OEIFlavor_MMCIF_FormalCrg, flags.

Default

Same as the OEIFlavor_MMCIF_DEFAULT constant.

SpruceDefault

Combination of OEIFlavor_MMCIF_DEFAULT, OEIFlavor_MMCIF_ALTLOC, flags.

AllMask

Combination of OEIFlavor_MMCIF_DEFAULT and OEIFlavor_MMCIF_ALTLOC flags.

OEIFlavor::MMOD

The OEIFlavor_MMOD namespace encodes symbolic constants used as bit-masks that control the processing performed by the high-level molecule file reader OEReadMolecule after reading OEFormat_MMOD format file by the OEReadMacroModelFile low-level file reader.

This namespace contains the following constants:

FormalCrg

This flag indicates that high-level molecular file reader calls the OEAssignFormalCharges function to assign formal charges.

Default

No special options are set. Formal charge assignment via OEAssignFormalCharges is disabled.

OEIFlavor::MOL2

The OEIFlavor_MOL2 namespace encodes symbolic constants used as bit-masks that control the processing performed by the high-level molecular file reader OEReadMolecule after reading OEFormat_MOL2 format file by the OEReadMol2File low-level file reader.

This namespace contains the following constants:

M2H

Instructs the MOL2 file reader to treat the file as containing explicit hydrogen atoms. When set, the reader applies additional formal charge and resonance form corrections appropriate for structures with explicit hydrogens. This corresponds to the behavior of the OEFormat_MOL2H format.

Forcefield

This specifies a commonly used variant of MOL2, wherein the chemical element for an atom is inferred from the atom name, but not using the second character if it is capitalized. For example:

  • CA specifies carbon (not calcium)

  • Ca specifies calcium

  • NA specifies nitrogen (not sodium)

  • Na specifies sodium

  • HA specifies hydrogen (not hahnium)

Exceptions were made for atom names beginning with FE, ZN, MG, MN, CL, and BR: these specify chemical elements Fe, Zn, Mg, Mn, Cl, and Br, respectively.

AllMask

Combination of OEIFlavor_MOL2_M2H and OEIFlavor_MOL2_Forcefield flags.

DEFAULT

No special options are set. Neither OEIFlavor_MOL2_M2H nor OEIFlavor_MOL2_Forcefield is enabled.

Default

Same as the OEIFlavor_MOL2_DEFAULT constant.

OEIFlavor::MOL2H

This namespace contains the following constants:

M2H

Indicates that explicit hydrogen atoms are present in the file. When active, the reader applies formal charge and resonance form corrections appropriate for structures with explicit hydrogens.

AllMask

Same as the OEIFlavor_MOL2H_M2H constant; the only flag in this namespace.

DEFAULT

Same as the OEIFlavor_MOL2H_M2H constant. Explicit hydrogen treatment is always the default for OEFormat_MOL2H format.

Default

Same as the OEIFlavor_MOL2H_DEFAULT constant.

OEIFlavor::OEB

This namespace contains the following constants:

Default

No special options are set.

OEIFlavor::OEZ

This namespace contains the following constants:

Default

No special options are set.

OEIFlavor::PDB

This namespace contains the following constants:

TER

Controls whether the PDB file reader should separate consecutive molecules at TER records. OEIFlavor_PDB_TER is off by default.

END

Controls whether the PDB file reader should separate consecutive molecules at END records. OEIFlavor_PDB_END is on by default.

ENDM

Controls whether the PDB file reader should separate consecutive molecules at ENDM records.

OEIFlavor_PDB_ENDM is on by default.

TerMask

Combination of OEIFlavor_PDB_TER and OEIFlavor_PDB_END and OEIFlavor_PDB_ENDM flags.

Note

By default, only OEIFlavor_PDB_END and OEIFlavor_PDB_ENDM are on (and OEIFlavor_PDB_TER is off), meaning that different chains are read into the a single molecule, but different NMR models and concatenated PDB files are treated as sequential molecules.

If OEIFlavor_PDB_END, OEIFlavor_PDB_ENDM and OEIFlavor_PDB_TER are all turned off, all of the ATOM and HETATM records in a single PDB file will be read into a single OEMolBase.

ALL

It used to indicate that all of the atom records in the input file should be read into the OEMolBase. By default, the OEReadPDBFile function ignores/omits ATOM and HETATM records that represent pseudo or dummy atoms and/or alternate conformations. Without OEIFlavor_PDB_ALL, the PDB file reader ignores all atoms whose alternate location indicator is other than ' ', A or 1, all atoms with atom names beginning " Q", all atoms with residue name "DUM", and all atoms with coordinates 9999.000, 9999.000, 9999.000 (as used by XPLOR/CNS to represent dummy atoms).

ALTLOC

Combination of OEIFlavor_Generic_Default, OEIFlavor_PDB_Default, and OEIFlavor_PDB_ALL flags. This flavor is required when OEAltLocationFactory is to be used so that all the atoms with alternate location codes are retained.

DATA

Controls whether the PDB file reader preserves the PDB file’s header data as OEMolBase’s generic data. This option currently preserves the following records:

Note

Modifying or reordering the molecule may invalidate the atom serial numbers used in some of the PDB records.

CHARGE

It is used to indicate that the contents of the b-factor column in the input PDB file contains a partial charge, and should be stored in the ‘partial charge’ property of an atom, instead of the ‘b-factor’ property. This value can then be retrieved using the OEAtomBase.GetPartialCharge method.

RADIUS

It is used to indicate that the contents of the occupancy column in the input PDB file contains a radius, and should be stored in the ‘radius’ property of an atom instead of the ‘occupancy’ property. This value can then be retrieved using the OEAtomBase.GetRadius method.

DELPHI

Combinations of OEIFlavor_PDB_CHARGE and OEIFlavor_PDB_RADIUS flags.

FORMALCHARGE

Controls whether the PDB reader should read the formal charge of the atom from column 79 and 80. Note, this flavor is not turned on default because the subsequent perception steps would not take this formal charge into account when filling valences with bonds and hydrogens.

SecStruct

This controls whether protein secondary structure is perceived after a file is read in. It is on by default. If this flavor is off, secondary structure information specified in the input PDB file (through SHEET and HELIX records) is retained.

FormalCrg

Note

This flag is only relevant in the high-level file reader (OEReadMolecule) and not in OEReadPDBFile.

ImplicitH

Note

This flag is only relevant in the high-level file reader (OEReadMolecule) and not in OEReadPDBFile.

BondOrder

Note

This flag is only relevant in the high-level file reader (OEReadMolecule) and not in OEReadPDBFile.

Rings

Note

This flag is only relevant in the high-level file reader (OEReadMolecule) and not in OEReadPDBFile.

Connect

Note

This flag is only relevant in the high-level file reader (OEReadMolecule) and not in OEReadPDBFile.

ExtraMask

Note

This flag is only relevant in the high-level file reader (OEReadMolecule) and not in OEReadPDBFile.

AllMask

Combination of OEIFlavor_PDB_BasicMask and OEIFlavor_PDB_ExtraMask flags.

SpruceDefault

Combination of OEIFlavor_PDB_DEFAULT, OEIFlavor_PDB_ALTLOC, flags.

OEIFlavor::RDF

The OEIFlavor_RDF namespace encodes symbolic constants used as bit-masks that control the processing performed by the high-level molecule file reader OEReadMolecule after reading OEFormat_RDF format file by the OEReadMDLFile low-level file reader.

Default

No special options are set. The OEIFlavor_RDF_FixBondMarks, OEIFlavor_RDF_SuppressEmptyMolSkip, OEIFlavor_RDF_SuppressImp2ExpENHSTE, and OEIFlavor_RDF_ForceImp2ExpENHSTE flags are all disabled.

FixBondMarks

This input flavor requests that the reader make an attempt to repair stereocenters that throw warnings due to issues identified by OEMDLStereoFromBondStereo. With this input flavor enabled, the warnings will continue to be issued to allow user inspection and verification of the modified bond marks. However, once the corrected structure(s) have been rewritten with any format that captures bond stereomark information, a re-read of the structure(s) should emit fewer stereocenter correction warnings. This input flavor is not enabled for the default OEFormat_RDF setting.

SuppressEmptyMolSkip

This input flavor suppresses the default action of skipping empty molecules in the input stream. This may be important in order to recover SDData stored on empty molecule records.

SuppressImp2ExpENHSTE

This input flavor suppresses any enhanced stereogroup implicit to explicit conversions for an input V3000 format RDFile.

ForceImp2ExpENHSTE

This input flavor performs implicit to explicit enhanced stereogroup conversions for an input RDFile.

OEIFlavor::SDF

The OEIFlavor_SDF namespace encodes symbolic constants used as bit-masks that control the processing performed by the high-level molecule file reader OEReadMolecule after reading OEFormat_SDF format file by the OEReadMDLFile low-level file reader.

This namespace contains the following constants:

Default

No special options are set. The OEIFlavor_SDF_FixBondMarks, OEIFlavor_SDF_SuppressEmptyMolSkip, OEIFlavor_SDF_SuppressImp2ExpENHSTE, and OEIFlavor_SDF_ForceImp2ExpENHSTE flags are all disabled.

FixBondMarks

This input flavor requests that the reader make an attempt to repair stereocenters that throw warnings due to issues identified by OEMDLStereoFromBondStereo. With this input flavor enabled, the warnings will continue to be issued to allow user inspection and verification of the modified bond marks. However, once the corrected structure(s) have been rewritten with any format that captures bond stereomark information, a re-read of the structure(s) should emit fewer stereocenter correction warnings. This input flavor is not enabled for the default OEFormat_SDF setting.

SuppressEmptyMolSkip

This input flavor suppresses the default action of skipping empty molecules in the input stream. This may be important in order to recover SDData stored on empty molecule records.

SuppressImp2ExpENHSTE

This input flavor suppresses any enhanced stereogroup implicit to explicit conversions for an input V3000 format SDFile.

ForceImp2ExpENHSTE

This input flavor performs implicit to explicit enhanced stereogroup conversions for an input V2000 or V3000 format SDFile.

OEIFlavor::SKC

The OEIFlavor_SKC namespace encodes symbolic constants used as bit-masks that control the processing performed by the high-level molecule file reader OEReadMolecule after reading OEFormat_SKC format file by the OEReadSketchFile low-level file reader.

This namespace contains the following constants:

Default

No special options are set.

OEIFlavor::SMI

The OEIFlavor_SMI namespace encodes symbolic constants used as bit-masks that control the processing performed by the OEParseSmiles function.

This namespace contains the following constants:

Strict

Enables strict parsing mode when processing SMILES strings. The parser applies more rigorous sanity checking, rejecting malformed strings that the non-strict parser would accept. For example, C==C is accepted by default but rejected in strict mode.

Canon

When set, the parser assumes the SMILES string is well-formed and omits the usual kekulization step performed by OEKekulize. This can speed up parsing of large databases, but bond orders may not be correctly assigned for aromatic molecules.

DEFAULT

No special options are set. Both OEIFlavor_SMI_Strict and OEIFlavor_SMI_Canon flags are disabled.

Default

Same as the OEIFlavor_SMI_DEFAULT constant.

OEIFlavor::USM

The OEIFlavor_USM namespace encodes symbolic constants used as bit-masks that control the processing performed by the OEParseSmiles function.

This namespace contains constants.

Default

No special options are set.

OEIFlavor::XYZ

The OEIFlavor_XYZ namespace encodes symbolic constants used as bit-masks that control the processing performed by the high-level molecule file reader OEReadMolecule after reading OEFormat_XYZ format file by the OEReadXYZFile low-level file reader.

This namespace contains the following constants:

FormalCrg

This flag indicates that high-level molecular file reader calls the OEAssignFormalCharges function to assign formal charges.

ImplicitH

This flag indicates that high-level molecular file reader calls the OEAssignImplicitHydrogens function to assign implicit hydrogens.

BondOrder

This flag indicates that high-level molecular file reader calls the OEPerceiveBondOrders function to perceive bond orders.

Rings

This flag indicates that high-level molecular file reader calls the OEFindRingAtomsAndBonds function to determine ring structure.

Connect

This flag indicates that high-level molecular file reader calls the OEDetermineConnectivity function to perceive bond connectivity from atomic coordinates. Since OEFormat_XYZ files contain only atomic positions without explicit bond information, this flag is required to establish bonding.

ExtraMask

Combination of OEIFlavor_XYZ_Connect, OEIFlavor_XYZ_Rings, OEIFlavor_XYZ_BondOrder, OEIFlavor_XYZ_ImplicitH and OEIFlavor_XYZ_FormalCrg flags.

Default

Same as the OEIFlavor_XYZ_ExtraMask constant.