Version 1.7.5¶
OEChem 1.7.5¶
Documentation changes¶
- Generic Data handling chapter added. 
- All the - OEChemexamples have been overhauled. Several examples have been removed, new ones have been created and all the examples (across all the languages we support) have been reviewed to bring them up to a similar standard. For the details of example toolkit scripts see the examples summary chapter. Source code is also included in the documentation.
New features¶
- OEAtomBondSet container added. 
- OEIsAtomHybridization functor added. 
- OEBase.GetDataIterthat takes an unsigned integer added for convenience.
- OEIsMember and OEIsMemberPtr can now be initialized with an OEIterBase pointer. 
- OEParseSmilesfunction will now ignore extra leading spaces in non-strict mode.
- OELibraryGen.SetTitleSeparatorwill now store an internal copy of the string, fixing issues in wrapped languages.
- OEIs3DFormatfunction added as a convenience function for the user to determine whether a file format supports 3D coordinates.
- OEMolBase.Clearcan now be called on a compressed DBMol and DBMCMol to wipe out the molecule entirely.
- OEIsNonRingAtomDoubleBondedToRing functor added to detect atoms double bonded to a ring. Most users consider atoms double bonded to a ring system as part of the “scaffold”. 
- MiniMols can now store coordinates, energy, and dimension. These are stored as generic data, so not particularly “mini”. Just meant to allow MiniMols to be used as a more general purpose molecule implementation. 
- Safety precautions to prevent corrupted molecules from being written were placed into the OEB writer for rotor-offset-compressed molecules. These molecules should not be modified, and definitely should not be written if they were modified. 
- Both old format and new format PDB hydrogen atom names are now supported. The new PDB naming format is used when new H atom names are assigned. The call - OEResidueHydrogensnow supports an option to control which style of H atom names is assigned.
- Four new residue types have been defined: - OEResidueIndex_NHE(carboxy-terminal amine)- OEResidueIndex_NME(carboxy-terminal methyl amine)- OEResidueIndex_CIP(AmberFF’s +1 ion)- OEResidueIndex_CIM(AmberFF’s -1 ion).
- The Python global interpreter lock will be released when calling - Compressand- UnCompresson a molecule. Since these are relatively expensive methods this should improve the performance of multi-threaded python applications.
Major bug fixes¶
- Fixed memory leak in - OEMolBase.SetCoordswhen taking a Python sequence or dictionary.- OEMolBase.SetCoordswill also throw a Python exception if the object passed does not conform to what is expected.
- Fixed a crash in the OEB writer that occurred when very large values were set for the map index or isotope atom properties. 
- Fixed a bug with parity bits in SDF files. This would occur if - OEPerceiveChiralwas called with an aromaticity model other than MDL before the molecule was written. The SDF writer now makes sure to re-perceive chirality based upon the MDL aromaticity model to get the correct parity bits.
- Fixed a memory leak that would occur when reusing a oemolistream for many different files under certain circumstances. 
- OEMol.operator=fixed to not duplicate SD data when being assigned from an OEGraphMol.
- The FASTA reader now assigns the proper stereochemistry to the molecules it produces. 
- The function - OEPerceiveResiduesnow respects the following data preservation flags:- OEPreserveResInfo_Occupancy,- OEPreserveResInfo_BFactor, and- OEPreserveResInfo_FragmentNumberboth individually and implicitly as part of the flag:- OEPreserveResInfo_All. Using the flag- OEPreserveResInfo_SerialNumberwill leave only the serial number of new atoms altered.
Minor bug fixes¶
- OELibraryGen fixed when explicitly defined bonds on the reactant side are not set correctly. This used to generate products with incorrect valence. 
- OEMiniMol::Sweep() fixed to properly re-index atoms and bonds after some atoms and bonds were deleted. 
- OEKekulizewill now fail if the integer bond types are set correctly, i.e., not between- 1and- 5inclusive.
- OEOFlavor_Generic_Defaultwill now be consistent in molstreams for all flavors. The- OEIsWriteablefunction that takes a format and a flavor will now check the generic and specific flavor bits separately.
- OERMSDfixed when dealing with multi-conformer molecules with suppressed hydrogen atoms.
- OERMSDwill now check whether the associated OEMatchBase actually belongs to the molecule being passed in.
- OEParseSmilesfixed to not crash when parsing empty strings in strict mode.
- OELibraryGen.GetTitleSeparatormethod signature changed to return a string directly. The previous signature and function couldn’t operate and didn’t actually do anything.
- OESmartsLexReplacefixed to not give incorrect SMARTS whenever a name appears twice in the bindings vector. Instead, the first pair is used, and a warning is thrown to indicate to the user about there being multiple pairs.
- OEIsHeavy is fixed to not return - truefor dummy atoms, that is, any atom with an atomic number of- 0. OEIsHeavy will only return- trueif the atomic number is greater than- 1.
- oemolithread.openstringcrash fixed when used without a valid format being set.
- Atom names perceived for unknown ligand types ( - OEResidueIndex_UNKand- OEResidueIndex_UNL) are now constructed from the element name and an integer.
- OEAddExplicitHydrogensis fixed to produce better hydrogen placement geometries when adding hydrogens to sp3 carbons where the carbon’s existing attachments vary significantly from ideal tetrahedral geometry.
- OEFuzzValnamespace constants now properly wrapped in Python. The- OEFuzzVal_Trueand- OEFuzzVal_Falseconstants would override the built in Python- Trueand- Falseby redefining them to the integral values of- 1and- 0respectively. This wouldn’t cause any problems, in fact, Python 2.2 and previous versions used to define- Trueand- Falseexactly this way.
OEBio 1.7.5¶
New features¶
- New - OEAltLocationFactory.GetCurrentLocationsmethods provide a way to determine which alternate locations are selected. A new- OEAltLocationFactory.GetGroupmethod is provided to convert from an OEAltLocation to an OEAltGroup.
- A new - OEGetRotamerscall that takes an OEResidue is now provided as a convenience.
- A new - OEExpandCrystalSymmetryfunction expands the crystal symmetry of the source molecule into different conformers in the destination molecule.
Minor bug fixes¶
- OERotamer is now properly wrapped in Python. 
- OEBio::OEHierResidue::GetOEResidue()now returns a reference to a blank residue when the class is uninitialized instead of a reference to random memory.
- Adding - OESequenceAlignment.operator boolmethod. An OESequenceAlignment object is considered invalid until its implementation is set. Both the- OEWriteAlignmentand the- OERMSDfunctions checks whether the passed alignment is valid and throw a warning if it is not.
OEGrid 1.3.5¶
Minor bug fixes¶
- OEGetCenterAndExtentsfixed to work on a OESkewGrid when it is regular grid, i.e. has no orientation.
- OEErrorHandler.SetOutputStreamperformance significantly improved to avoid quadratic behavior in certain circumstances.
- OEWriteGridfixed to actually gzip the output if the file name ends in- .gz. Before it would just write the file in the specified format, but never gzip it.
OESystem 1.7.5¶
New features¶
- OEErrorLevel_Defaulthas been changed from- OEErrorLevel_Verboseto- OEErrorLevel_Info. This allows- OEThrow.Verboseto be used for printing more information to the terminal, but it will only appear when- OEThrow.SetLevelis called with the- OEErrorLevel_Verboselevel. In the past, the- OEErrorLevel_Verboselevel was essentially ignored since it was nearly the same as- OEErrorLevel_Info.
- OELinearColorGradient class added to interpolate colors between specified ranges. OEColorStop class added to initialize OELinearColorGradient objects. 
- OESystem::OEBkgrdGreyadded as a new color for using a light grey background of an image.
- OECopyBaseDataconvenience function added for copying generic data.
- OEGetTagheavily optimized for multi-threaded use.
Minor bug fixes¶
- Fixed memory leak in OEArray (OEFloatArray, OEDoubleArray, OEIntArray, etc) constructor when used on a Python sequence. 
- Fixed memory leak in OEInterface constructor. 
- OEBitVector.SetDatacrash fixed where it would try to copy more bytes than the actual size of the given data.
- OEStringToNumberfunction now allows for new-line characters,- \n, to appear after the digits in the string.
- OEBase generic data can now handle an empty - std::vectorthrough OEB reading and writing.
- OEStringTokenizenow has an additional parameter, concat_delim, that specifies whether consecutive delimiters should be treated as a single delimiter. This is useful for parsing CSV files with empty fields. However, the default behavior is to behave as before, treating consecutive delimiters as a single delimiter.
- OEGridBase.GetXIdx,- OEGridBase.GetYIdx,- OEGridBase.GetZIdxfixed so that the dimensions are guaranteed to always be within the dimensions of the grid. These methods would sometimes return indices that were outside the range of the dimensions of the grid due to floating point rounding errors.
- unsignedcan now be used as the- !TYPEin interface files for unsigned int parameters.
- OELinearInterpolateperformance has been significantly improved.
OEPlatform 1.7.5¶
Minor bug fixes¶
- OEEOFis now defined by the- OEPlatformheaders and is the value returned by- oestreammethods to indicate that the end of the file has been reached.
- oeostream.operator<<can not properly write a- size_ton 64-bit Windows.