Package chemaxon.calculations

Class MajorMicrospeciesPlugin

java.lang.Object

chemaxon.calculations.CalculatorPlugin

chemaxon.calculations.MajorMicrospeciesPlugin

All Implemented Interfaces:

TaggedCalculator, Licensable

@PublicApi
public class MajorMicrospeciesPlugin
extends CalculatorPlugin

Plugin class that calculates the major microspecies on a given pH.

API usage example:

    // Import molecule
    Molecule mol = MolImporter.importMol("CC(=O)OC1=CC=CC=C1C(O)=O");

    // Create plugin
    MajorMicrospeciesPlugin plugin = new MajorMicrospeciesPlugin();

    // Set pH
    plugin.setPh(7.4);

    // Set target molecule
    plugin.setMolecule(mol);

    // Run the calculation
    plugin.run();

    // Get result
    Molecule msmol = plugin.getMajorMicrospecies();

    // Print result
    System.out.println("Major microspecies at pH=7.4: " + MolExporter.toFormat(msmol, "smiles"));
 

For calculator plugin example applications using Chemaxon's concurrent framework, refer to the Calculator Plugins Developer's Guide.

Nested Class Summary

Nested classes/interfaces inherited from class chemaxon.calculations.CalculatorPlugin

CalculatorPlugin.HydrogenData

Field Summary

Fields inherited from class chemaxon.calculations.CalculatorPlugin

ATOM, BLUE, CALCRGB_OFF, COVALENT_HYDRATION_ERROR_REMARK, CRITICAL_ERROR_MSG, EPSILON, explicitHydrogens, INCORRECT_AROMATIC_NITROGEN_REMARK, INSTABLE_TAUTOMERIC_FORM_REMARK, KEEP_HYDROGENS, keepHydrogens, licenseEnvironment, MOLECULE, MOLECULES, NAN, PLUGIN_CLASS_KEY, PLUGIN_DIR, RED, TRUE

Constructor Summary

Constructors

Constructor	Description
MajorMicrospeciesPlugin()	Constructor.

Method Summary

Modifier and Type	Method	Description
void	checkMolecule(Molecule mol)	Checks the input molecule.
protected final Molecule	createModifiedInputMolecule(Molecule mol)	Returns the major tautomeric form of the molecule.
protected Molecule	getDisplayMolecule()	Returns the molecule object to be used for GUI display.
String	getErrorMessage()	Returns the calculation error information message or the empty string if there is no error.
String	getIonizerErrorMessage()	Returns the calculation error information message or the empty string if there is no error.
Molecule	getMajorMicrospecies()	Returns the major microspecies at the pH set in setPh(double).
Molecule	getMicrospecies(int index)	Returns the microspecies molecule.
int	getMicrospeciesCount()	Returns the number of microspecies
double	getpH()	Deprecated, for removal: This API element is subject to removal in a future version. Use getPh() instead.
double	getPh()	Returns the pH where the major microspecies should be taken.
String	getProductName()	Returns the product identifier of the plugin.
Object	getResult(Object type, int index)	Returns the microsepcies if pH is different from Double.NaN, otherwise returns the input molecule itself.
String	getResultAsString(Object type, int index, Object result)	Returns the specified result molecule in SMILES format.
int	getResultCount(Object type)	Returns the number of result items: 1.
int	getResultDomain(Object type)	Returns the calculation domain CalculatorPlugin.MOLECULE.
Molecule	getResultMolecule()	Returns the major microspecies for display.
Object[]	getResultTypes()	Returns the result types (possible types: "majority-ms").
Molecule	getSortedMicrospecies(int index)	Returns the microspecies molecule, sorted by descreasing distribution at the given pH.
double	getSortedMsDistribution(int index)	Returns the microspecies distribution, sorted by descreasing distribution at the given pH.
boolean	handlesMultiFragmentMolecules()	Returns true if the plugin handles multifragment molecules, false otherwise.
boolean	run()	Stores the input molecule with ungrouped sgroups.
protected void	setChemicalTermsArgument(String arg)	Deprecated.
void	setCorrectionLibrary(String correctionLibraryId)	Sets the correction library.
void	setCorrectionLibraryPath(String correctionLibraryPath)	Sets the correction library file directly.
protected void	setInputMolecule(Molecule mol)	Sets the input molecule.
void	setKeepExplicitHydrogens(boolean keepExplicitHydrogens)	Sets if result molecule keeps explicit hydrogens or not
Molecule	setMolecule(Molecule mol, boolean st, boolean om)	Sets the input molecule after an optional standardization and/or modification.
void	setParameters(Properties params)	Sets the input parameters for the plugin.
void	setpH(double ph)	Deprecated, for removal: This API element is subject to removal in a future version. Use setPh(double) instead.
void	setPh(double ph)	Sets the pH: major microspecies on given pH is taken as input molecule if set to Double.NaN then the input molecule is taken as it is.
void	setTakeMajorTatomericForm(boolean takeMajorTautomericForm)	Sets to use major tautomeric form in calculation.
void	standardize(Molecule mol)	Standardizes the molecule.

Methods inherited from class chemaxon.calculations.CalculatorPlugin

addHeavyAtomLimitChecker, addInputChecker, arrangeHydrogenIncerments, canRepeat, checkLicense, checkType, containsCoordinateBond, containsMulticenterSgroup, containsPseudoAtom, containsSRUSgroup, create, createStandardizedMolecule, format, format, format, format, getAtomCount, getAtomIndex, getAtomIndexMap, getAtomIndexMapping, getCalcMolecule, getDocument, getDoublePrecision, getExplicitHydrogenData, getInputMolDim, getOriginalMolecule, getQueryMoleculeErrorMessage, getRemark, getResult, getResultAsRGB, getResultAsRGB, getResultAsString, getResultCount, getResultDomain, getResultMessage, getResultMolecules, getResultsAsRGB, getResultsAsRGB, getResultsAsString, getResultsAsString, getResultSource, getTypeString, getWarningMessage, isInputMoleculeAromatized, isLicensed, isMsCalc, isMultiThreadedRunEnabled, isNegligibleResult, isOK, isRgrouped, loadPluginClass, removeWhitespace, restoreExplicitHydrogens, setAtomIndexMap, setChemicalTermsParameters, setDoublePrecision, setDoublePrecision, setDoublePrecision, setKeepHydrogens, setLicenseEnvironment, setMolecule, setMolecule, setMolecule, setProgressMonitor, standardizeIonicGroups

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface chemaxon.calculations.api.TaggedCalculator

tags

Constructor Details

MajorMicrospeciesPlugin

public MajorMicrospeciesPlugin()

Constructor. Creates the ionizer object.

Method Details

setMolecule

public Molecule setMolecule(Molecule mol,
 boolean st,
 boolean om)
                     throws CalculatorPluginException

Description copied from class: CalculatorPlugin

Sets the input molecule after an optional standardization and/or modification. Standardization includes plugin specific standardization (e.g. dehydrogenize, aromatize) and S-group expansion, modification usually means taking a microspecies form, or the major tautomeric form of the input molecule (usually optional). The input molecule is left unchanged (it is cloned before standardization/modification if required).

Overrides:

setMolecule in class CalculatorPlugin

Parameters:

mol - is the input molecule

st - is true if standardization is required

om - is true if original input molecule is to be used for atom indexing false if modified molecule is to be used for atom indexing

Returns:

the molecule to be used for atom indexing

Throws:

CalculatorPluginException - on error

See Also:

• CalculatorPlugin.setInputMolecule(Molecule)
• CalculatorPlugin.createStandardizedMolecule(Molecule)
• CalculatorPlugin.createModifiedInputMolecule(Molecule)

getProductName

public String getProductName()

Description copied from class: CalculatorPlugin

Returns the product identifier of the plugin. For internal use only!

Specified by:

getProductName in class CalculatorPlugin

setParameters

public void setParameters(Properties params)
                   throws CalculatorPluginException

Sets the input parameters for the plugin. The parameters and value ranges:

• pH: major microspecies on given pH is taken as input molecule if omitted then the input molecule is taken as it is
• microspecies: "true" if major microspecies should be taken as input molecule (corresponds to 'take major microspecies' GUI checkbox)
• msdistr: "true" if microspecies distributions should be calculated (default: "false")

Overrides:

setParameters in class CalculatorPlugin

Parameters:

params - is the parameter table

Throws:

CalculatorPluginException - on error

setChemicalTermsArgument

@Deprecated
protected void setChemicalTermsArgument(String arg)
                                 throws CalculatorPluginException

Deprecated.

Description copied from class: CalculatorPlugin

Sets the argument string as specified in Chemical Terms expressions. This method may only be called from CalculatorPlugin.setChemicalTermsParameters(Properties, String).

Overrides:

setChemicalTermsArgument in class CalculatorPlugin

Parameters:

arg - The argument, never null. Its meaning is implementation-dependent.

Throws:

CalculatorPluginException - on error

setPh

public void setPh(double ph)

Sets the pH: major microspecies on given pH is taken as input molecule if set to Double.NaN then the input molecule is taken as it is.

Parameters:

ph - is the pH value

setpH

@Deprecated(forRemoval=true)
@SubjectToRemoval(date=JUL_01_2027)
public void setpH(double ph)

Deprecated, for removal: This API element is subject to removal in a future version.

Use setPh(double) instead. This method will be removed in a future version.

Sets the pH: major microspecies on given pH is taken as input molecule if set to Double.NaN then the input molecule is taken as it is.

Parameters:

ph - is the pH value

getPh

public double getPh()

Returns the pH where the major microspecies should be taken. Returns Double.NaN if no microspecies calculation required.

Overrides:

getPh in class CalculatorPlugin

Returns:

the pH where the major microspecies should be taken or Double.NaN if no microspecies calculation

getpH

@Deprecated(forRemoval=true)
@SubjectToRemoval(date=JUL_01_2027)
public double getpH()

Deprecated, for removal: This API element is subject to removal in a future version.

Use getPh() instead. This method will be removed in a future version.

Returns the pH where the major microspecies should be taken. Returns Double.NaN if no microspecies calculation required.

Overrides:

getpH in class CalculatorPlugin

Returns:

the pH where the major microspecies should be taken or Double.NaN if no microspecies calculation

setInputMolecule

protected void setInputMolecule(Molecule mol)
                         throws CalculatorPluginException

Sets the input molecule.

Specified by:

setInputMolecule in class CalculatorPlugin

Parameters:

mol - is the input molecule

Throws:

CalculatorPluginException - on error

setTakeMajorTatomericForm

public void setTakeMajorTatomericForm(boolean takeMajorTautomericForm)

Sets to use major tautomeric form in calculation. Default: false.

Parameters:

takeMajorTautomericForm - the calculation will be performed on the major tutomeric form of the input molecule if set (true)

Since:

Marvin 5.2

setCorrectionLibrary

public void setCorrectionLibrary(String correctionLibraryId)

Sets the correction library.

Parameters:

correctionLibraryId - is the correction library identifier

Since:

Marvin 21.16

setCorrectionLibraryPath

public void setCorrectionLibraryPath(String correctionLibraryPath)

Sets the correction library file directly.

Since:

Marvin 21.16

createModifiedInputMolecule

protected final Molecule createModifiedInputMolecule(Molecule mol)
                                              throws CalculatorPluginException

Returns the major tautomeric form of the molecule.

Overrides:

createModifiedInputMolecule in class CalculatorPlugin

Parameters:

mol - is the input molecule

Returns:

the major tautomeric form of the molecule

Throws:

CalculatorPluginException - on error

Since:

Marvin 5.2

run

public boolean run()
            throws CalculatorPluginException

Stores the input molecule with ungrouped sgroups.

Specified by:

run in class CalculatorPlugin

Returns:

true if the calculation was successful, false on calculation error

Throws:

CalculatorPluginException - on error

See Also:

• CalculatorPlugin.getErrorMessage()

getMajorMicrospecies

public Molecule getMajorMicrospecies()
                              throws CalculatorPluginException

Returns the major microspecies at the pH set in setPh(double).

Returns:

the major microspecies

Throws:

CalculatorPluginException - if run() has not been called beforehand

getMicrospeciesCount

public int getMicrospeciesCount()
                         throws CalculatorPluginException

Returns the number of microspecies

Returns:

the number of microspecies

Throws:

CalculatorPluginException - on error

getMicrospecies

public Molecule getMicrospecies(int index)
                         throws CalculatorPluginException

Returns the microspecies molecule.

Parameters:

index - is the microspecies index

Returns:

the microspecies molecule

Throws:

CalculatorPluginException - on error

getSortedMicrospecies

public Molecule getSortedMicrospecies(int index)
                               throws CalculatorPluginException

Returns the microspecies molecule, sorted by descreasing distribution at the given pH.

Parameters:

index - is the microspecies index

Returns:

the microspecies molecule

Throws:

CalculatorPluginException - on error

getSortedMsDistribution

public double getSortedMsDistribution(int index)
                               throws CalculatorPluginException

Returns the microspecies distribution, sorted by descreasing distribution at the given pH.

Parameters:

index - is the microspecies index

Returns:

the microspecies distribution

Throws:

CalculatorPluginException - on error

getResultTypes

public Object[] getResultTypes()

Returns the result types (possible types: "majority-ms").

Overrides:

getResultTypes in class CalculatorPlugin

Returns:

the result types

getResultDomain

public int getResultDomain(Object type)

Returns the calculation domain CalculatorPlugin.MOLECULE.

Overrides:

getResultDomain in class CalculatorPlugin

Parameters:

type - is the result type

Returns:

CalculatorPlugin.MOLECULE

See Also:

• getResultTypes()

getResultCount

public int getResultCount(Object type)

Returns the number of result items: 1.

Overrides:

getResultCount in class CalculatorPlugin

Parameters:

type - is the result type

Returns:

the number of result items

See Also:

• getResultTypes()

getResult

public Object getResult(Object type,
 int index)
                 throws CalculatorPluginException

Returns the microsepcies if pH is different from Double.NaN, otherwise returns the input molecule itself.

Overrides:

getResult in class CalculatorPlugin

Parameters:

type - is the result type ("major-ms", "ms", "ms-count" or "ms-distr")

index - is the microspecies index

Returns:

the result item for the specified type and index

Throws:

CalculatorPluginException - if the result cannot be returned

See Also:

• getResultTypes()

getResultAsString

public String getResultAsString(Object type,
 int index,
 Object result)
                         throws CalculatorPluginException

Returns the specified result molecule in SMILES format.

Overrides:

getResultAsString in class CalculatorPlugin

Parameters:

type - is the result type

index - is the result index

result - is the result item (molecule)

Returns:

the specified result in String format

Throws:

CalculatorPluginException - if an invalid result item is given

getDisplayMolecule

protected Molecule getDisplayMolecule()
                               throws CalculatorPluginException

Returns the molecule object to be used for GUI display. This is the major microspecies returned by getMajorMicrospecies().

Overrides:

getDisplayMolecule in class CalculatorPlugin

Returns:

the molecule object to be used for GUI display

Throws:

CalculatorPluginException - on error

getResultMolecule

public Molecule getResultMolecule()
                           throws CalculatorPluginException

Returns the major microspecies for display.

Overrides:

getResultMolecule in class CalculatorPlugin

Returns:

the major microspecies

Throws:

CalculatorPluginException - on error

Since:

Marvin 4.0

getErrorMessage

public String getErrorMessage()

Returns the calculation error information message or the empty string if there is no error.

Overrides:

getErrorMessage in class CalculatorPlugin

Returns:

the calculation error information message

getIonizerErrorMessage

public String getIonizerErrorMessage()

Returns the calculation error information message or the empty string if there is no error.

Returns:

the calculation error information message

checkMolecule

public void checkMolecule(Molecule mol)
                   throws CalculatorPluginException

Checks the input molecule. Throws exception if the molecule molecule contains R-groups.

Overrides:

checkMolecule in class CalculatorPlugin

Parameters:

mol - is the input molecule

Throws:

CalculatorPluginException - with error message for the user if the molecule is refused

standardize

public void standardize(Molecule mol)

Standardizes the molecule. Adds dehydrogenization to default standardization in case when major microsepcies calculation required.

Overrides:

standardize in class CalculatorPlugin

Parameters:

mol - is the molecule to be standardized

setKeepExplicitHydrogens

public void setKeepExplicitHydrogens(boolean keepExplicitHydrogens)

Sets if result molecule keeps explicit hydrogens or not

Parameters:

keepExplicitHydrogens - if the result should keep explicit hydrogens or not

handlesMultiFragmentMolecules

public boolean handlesMultiFragmentMolecules()

Returns true if the plugin handles multifragment molecules, false otherwise. This plugin handles multifragment molecules, so it returns true.

Overrides:

handlesMultiFragmentMolecules in class CalculatorPlugin

Returns:

true because this plugin handles multifragment molecules in case of salt type strutures.e.g.[Na+].CC([O-])=O