3.12.2 AddStartingMaterial

unsigned int AddStartingMaterial(OESystem::OEIter<OEMolBase>&,
                                 unsigned int reacnum,
                                 bool umatch=true)
unsigned int AddStartingMaterial(OESystem::OEIterBase<OEMolBase>*,
                                 unsigned int reacnum,
                                 bool umatch=true)
unsigned int AddStartingMaterial(const OEMolBase &mol,
                                 unsigned int reacnum,
                                 bool umatch = true)

The AddStartingMaterial methods are used to initialize the starting materials corresponding to a reaction component (reactant). An iterator over molecules or a single molecule may be passed as the first argument to the overloaded methods. Subsequent calls to the AddStartingMaterial methods append to the list of starting materials set in prior calls. The second argument specifies the reactant to which the starting materials correspond. A copy of the staring material molecules are stored internally with the atom maps from the reactant pattern. This is done for efficiency, as each product molecule requires very little computational work to be done because of the starting material preprocessing. The final argument is used to control the pattern matching of the reactant pattern to the staring material. If the value passed is true, only matches that contain a unique set of atoms relative to previously identified matches are used. If the value is false, every possible match including those related by symmetry will be used. Reactant patterns are unique matched by default.