# Introduction¶

This is OEChem‘s C++ Programming manual.

## How to read this manual¶

This is a collection of prose covering many of the important topics which can be addressed by the OEChem library. This manual is meant to be read from front to back at least once. Each topic in this manual is introduced assuming the knowledge presented earlier in the manual has been read. Further, the complexity of topics as well as the complexity of the example code grows as the text progresses. While the initial listings are effectively the ‘’Hello World’’ of OEChem, later examples may require some time to comprehend fully. This manual is filled with example programs. We encourage you to compile, test and modify the examples we present.

Experienced OEChem programmers should use the Application Programming Interface (OEChem API) for the most thorough reference of OEChem functionality.

## How to use the toolkits¶

See the C++ Quickstart Manual for installation instructions.

To include OpenEye libraries in a C++ program the appropriate header files must be included at compile time. All OpenEye libraries require that the openeye.h header file is included first. Then additional OpenEye libraries can be included, for example, the OEChem library:

include "openeye.h"
include "oechem.h"


Every OpenEye library resides in its own C++ namespace. It is often useful to use the following idiom to produce shorter, more readable code:

using namespace OEChem;


Since OEChem‘s objects and functions have unique names, there is little chance to have a name clash with this particular idiom.

## OEChem and Informatics¶

Chemical information processing is the science of representing molecules in computers. Hence the fundamental “object” or data structure within a chemical information system is that of the molecule, its atoms and its bonds.

A significant problem encountered in such systems is that different applications place differing requirements or constraints on how a molecule is represented. In protein biochemistry, molecules are divided into amino acid residues with specific atom naming and conformational information such as alpha helix or beta sheet. Inorganic chemistry requires isotopic and coordination information for atoms and modeling of complex chiralities. One possible solution is to prescribe a single data structure that encodes all of the potential information required of a molecule. However, such an approach suffers from the fact that ‘you cannot please all of the chemists, all of the time’. A requirement in the field of chemical databases and substructure searching is that a molecule representation be as compact as possible, to allow as much information to be held in memory as possible and maximize the performance of processing databases from disk. It is this reason that the molecule, its atoms and its bonds are defined in an abstract a manner as possible in OEChem.

The following is a quick guide to the chapters covering these fundamental classes:

OEMolBase