IChemLabs ChemDoodle 8.x User Guide
IChemLabs ChemDoodle 8.x User Guide
ChemDoodle v8.0
User Guide
Copyright c 2006-2016 iChemLabs, LLC.
All Rights Reserved. No part of this document may be reproduced or transmitted in any form or by any means,
electronic, mechanical, photocopying, recording, or otherwise, without the prior written permission of iChemLabs.
INTRODUCTION 2
CHEMDOODLE BASICS 12
WIDGETS 82
SHAPES 116
CHEMINFORMATICS 158
REACTIONS 194
SPECTRA 203
APPENDICES 252
i
List of Figures
ii
4.7 MolGrabber Widget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
4.8 Multiplet Tool Widget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
4.9 Multiplet Input Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
4.10 Real-Time Sliders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
4.11 Multiplet Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
4.12 NMR SignalSeek Widget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
4.13 NMR Simulation Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
4.14 In-depth Simulation Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
4.15 Properties Widget Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
4.16 Search Widget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
4.17 Search Settings for the Search Widget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
4.18 Statistics Widget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
4.19 Symbols Widget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
4.20 Symbol Preview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
4.21 Unicode Character Selector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
4.22 Templates Widget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
4.23 TLC Canvas Widget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
4.24 Format Spot Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
5.1 Control Anchors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
5.2 Corner/Edge Anchors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
5.3 Line Shape and Anchors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
5.4 Arc Shape and Anchors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
5.5 Arrow Shape and Anchors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
5.6 Rectangle Shape and Anchors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
5.7 Oval Shape and Anchors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
5.8 Bracket Shape and Anchors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
5.9 Pen and Polyline Control Points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
5.10 Bezier Control Points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
5.11 Ruler Shape and Anchors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
5.12 Editing a Text Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
5.13 An Updating Label . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
6.1 Selected Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
6.2 Color Button Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
6.3 Quick Colors Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
6.4 ChemDoodle’s Pinwheel Color Chooser . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
7.1 Aromatic Ring Circle (Rotated Perspective) . . . . . . . . . . . . . . . . . . . . . . . . . . 161
7.2 Aromatic Ring Circles Mold to any Shape . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
7.3 Hidden Carbon Labels Displayed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
7.4 Chemical Warnings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
7.5 Glassware Clipart Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
7.6 Glassware Setup with Altered Colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
7.7 Beaker with and without Solution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
7.8 Glassware Figure Containing Tubing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
7.9 BioArt Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
7.10 Hydrogens Added as Atoms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
7.11 Hydrogens Added as Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
7.12 Kekulizing a Single Bond Frame to Generate Corannulene . . . . . . . . . . . . . . . . . . 182
7.13 Kekulizing Aromatic Rings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
7.14 Condensed vs. Expanded Atom Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
7.15 Abbreviations in Atom Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
7.16 ChemDoodle Expansion of a Molecular Formula . . . . . . . . . . . . . . . . . . . . . . . 185
7.17 Lewis Dot Structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
7.18 Carbon Nanotube Geometry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
7.19 Building a Prism Geometry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
iii
7.20 A Half-completed Newman Projection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
7.21 A Completed Newman Projection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
7.22 A Wrapped Sequence for Crambin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
8.1 Edit Reaction Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
8.2 Reaction Visual Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
8.3 A Stacked Wide Reaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
9.1 An NMR Spectrum Loaded from a JCAMP File . . . . . . . . . . . . . . . . . . . . . . . 204
9.2 An IR Spectrum Loaded from a JCAMP File . . . . . . . . . . . . . . . . . . . . . . . . . 205
9.3 An MS Spectrum Loaded from a JCAMP File . . . . . . . . . . . . . . . . . . . . . . . . 205
9.4 ChemDoodle could not understand the spectrum in the JCAMP file. . . . . . . . . . . . . 206
9.5 Hovering Over a Spectrum to Display its Anchor Points . . . . . . . . . . . . . . . . . . . 207
9.6 The Spectrum Edit Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
9.7 A Grid Displayed Over a Spectrum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
9.8 An Integration Line Calculated Over an NMR Multiplet . . . . . . . . . . . . . . . . . . . 210
10.1 Visual Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
10.2 Anti-aliasing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
10.3 Stroke Control Set to Pure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
10.4 Stroke Control Set to Normalize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
11.1 Copy Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
11.2 Bitmap Image vs. Vector Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
11.3 Paste Special Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
11.4 An Activated ChemDoodle Embedded Object (Microsoft Word 2010) . . . . . . . . . . . 244
11.5 OLE Server Installation Corruption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
11.6 Roundtrip Editing: Workarounds for iWork Pages . . . . . . . . . . . . . . . . . . . . . . 246
11.7 Roundtrip Editing: Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
11.8 OLE Object. . . Menu Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
11.9 Selecting ChemDoodle Embedded Object . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
A.1 The iChemLabs Updater . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
A.2 The Update Available Window with the Skip this Update Button . . . . . . . . . . . . . 256
B.1 File Annotations Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
B.2 Chemical File Conversion Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
D.1 ChemDoodle’s References List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
D.2 The Interactive Periodic Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
D.3 Focusing on a Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
D.4 Element Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
D.5 States of Matter Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
F.1 Generate ChemDoodle Web Component Window . . . . . . . . . . . . . . . . . . . . . . . 277
F.2 Previewing the Web Component (Apple Safari shown) . . . . . . . . . . . . . . . . . . . . 278
F.3 The Optimize PDB to JSON Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
H.1 Contact Customer Service Menu Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
iv
List of Tables
v
vi
CHAPTER 1
Introduction
2 Chapter 1: INTRODUCTION
Contents
ABOUT CHEMDOODLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
ADDITIONAL INFORMATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
CHEMDOODLE FOLDERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
INSTALLATION FOLDER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
SETTINGS FOLDER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
PROGRAM ACTIVATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
USER LICENSES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
SITE LICENSES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
CONNECTION ISSUES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
FIREWALL ISSUES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
PROXY ISSUES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
UNAUTHORIZED USE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
ATTRIBUTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
REFERENCING . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Chapter 1: INTRODUCTION 3
ABOUT CHEMDOODLE
ChemDoodle is a desktop software tool for drawing chemical structures, diagrams and figures. It is a richly
featured, multi-platform (Windows, Mac OS X, Linux) graphical user interface containing many features for
working with chemical information and graphics.
ChemDoodle is integrated with the following iChemLabs Products:
ChemDoodle 3D - A desktop software tool for creating 3D scientific graphics.
https://www.chemdoodle3d.com
ChemDoodle Web Components - A pure Javascript chemical graphics and cheminformatics library.
https://web.chemdoodle.com
ChemDoodle Mobile - A companion mobile app to the desktop software.
https://mobile.chemdoodle.com
ChemDoodle 8.0 includes significant new features and improvements. Among the changes are:
• The graphics system has been improved even beyond current industry standards for graphics. Every
bond merge and pixel was scrutinized. Chemical structures have never looked better. ChemDoodle
provides the best graphics in chemistry, everything else is a waste of money.
• Major IUPAC naming improvements, including very advanced ring systems.
• Full support for Retina display Macs and support for high-DPI Windows hardware.
• A new query structure system for defining sets of molecules and for searching partner services.
• New powerful tools for drawing arbitrary rings and crown ethers to atoms and bonds.
• Superscript and subscript merging to easily create atomic notations and other chemical text.
• More specific cleaning tool for adjusting only a selection of a structure.
• Text output options and improvements for EPS and SVG files in addition to PDF.
• A dramatically improved Templates widget with new and more aesthetic templates.
• Read in NTUPLES (multiple spectra) from JCAMP files.
• Added support for both the SketchEl (el) and Crystallographic Information Format (cif) filetypes.
• More support for working with the ChemDoodle Web Components.
• Dozens of new BioArt graphics.
• Performance improvements for faster work.
• Dozens more new features: two new bond types, implicit hydrogen control, automatic IUPAC locant
labelling, vastly improved condensed labels, search files based on query structures, recursive SMARTS,
metric support for document aids and rulers, a new precise form for scaling a specific bond, many
interface improvements and so much more.
4 Chapter 1: INTRODUCTION
This User Guide contains information for the ChemDoodle application for the Windows, Mac OS X and
Linux operating systems. It assumes you are familiar with the basics of your operating system. If necessary,
please review your operating system manual before using ChemDoodle.
TYPOGRAPHICAL CONVENTIONS
Toolbar buttons, menu items, and other Bold Select the Clear button or use the Edit
interface components menu
Series of menu items in a specific order Vertical bar | File|New means from the File drop-
down menu choose New
Figure/Table captions Italicize Figure 1.4: The Doodle Board
Folder and File locations Monospaced In the ChemDoodleSettings folder
Product Names Brown Mac OS X
Internal link within the document Dark Green In the ADDITIONAL INFORMATION
section
External link to the internet Underlined Blue https://www.chemdoodle.com
Keyboard input Key icon To undo an action, press ctrl + Z
Caution! / Warning!
It is not necessary to read this entire manual before proceeding to use ChemDoodle; however, it is rec-
ommended that you skim the table of contents and read INTRODUCTION. Once you have the program
installed, read CHEMDOODLE BASICS. Subsequent chapters can be consulted as questions arise during
use of the program. This user’s guide can be found by clicking on Help|User Guide in the application
menu at the top of the program screen.
Chapter 1: INTRODUCTION 5
ADDITIONAL INFORMATION
Additional information about ChemDoodle and its use and related software can be found by following any
of the links in the table below.
You can also find information about ChemDoodle and iChemLabs on social media.
ChemDoodle is a Java based application. A Java runtime environment (JRE) is bundled into
the ChemDoodle application as required by Oracle best practices. So while you do not have
to install Java to run ChemDoodle, you may still see system warnings and messages about
allowing Java to run to use ChemDoodle. Accept these prompts.
• Mac OS X 10.7+ (Lion, Mountain Lion, Mavericks, Yosemite, El Capitan or more recent)
• A minimum of 1GB of memory
• Any version of Linux (we test with Mint, Fedora, Debian and OpenSUSE Linux)
• Any working GUI, although we recommend and test with GNOME
• A minimum of 1GB of memory
Several users can set up licenses for ChemDoodle on a single computer if all users have separate operating
system accounts. All preferences and settings files are user-specific and associated with the named operating
system user account. Each account that wishes to use ChemDoodle must be licensed. Licensing is done
by inputting an activation code. Instructions for installing ChemDoodle for multiple users are operating-
system-dependent and specifics for each operating system are given in the following subsections.
WINDOWS
During the installation, keep the install folder in C:\Program Files\. All users will be able to execute
ChemDoodle from within this folder.
There will be periodic updates to ChemDoodle. ChemDoodle requires administrator privileges to update.
Updates are performed only once on a given computer; all users then have access to the updated program.
Chapter 1: INTRODUCTION 7
MAC OS X
During the installation, drag the ChemDoodle folder to the /Applications folder as instructed. All users
will be able to execute ChemDoodle from within this folder.
There will be periodic updates to ChemDoodle. Only superusers are able to update ChemDoodle. Updates
are performed only once on a given computer; all users then have access to the updated program.
LINUX
Run the Linux BIN in a folder that all users have rights to execute binaries from. After the installation,
verify that all users that will be using ChemDoodle have the necessary permissions to do so.
There will be periodic updates to ChemDoodle. You may want to restrict write privileges to the ChemDoodle
installation folder to a single user. This user will then need to update ChemDoodle as root on the computer.
This only needs to be done once for the computer, and all users will then have access to the updated program.
CHEMDOODLE FOLDERS
There are two folders that the ChemDoodle application uses: the main ChemDoodle installation folder and
the ChemDoodleSettings folder.
INSTALLATION FOLDER
The contents of the main ChemDoodle installation folder are specified in the table below:
Do not remove or alter the contents of the ChemDoodle installation folder or unex-
pected behavior may occur. To move the application, you must move the entire ChemDoodle
folder.
SETTINGS FOLDER
The ChemDoodleSettings folder can be found in the operating system’s standard Documents folder. The
location of the standard operating system Documents folder for the different platforms on which ChemDoodle
runs are indicated below:
PROGRAM ACTIVATION
USER LICENSES
Activation occurs when a purchased activation code is used to associate a license with the ChemDoodle
application for a given user account.
Activation is achieved in one of two ways: (1) the activation code is entered in the activation screen after
first opening ChemDoodle and accepting the license (this can be done before a trial is started or after a trial
has completed), or (2) the user clicks on the Purchase|Activate ChemDoodle menu item while a trial is
active and entering the activation code.
The activation code may be manually typed into the activation form or copied and pasted (in its entirety)
from the receipt into the form. Once activated with a purchased license, all restrictions from the trial are
removed. Student licenses will be subject to additional restrictions, see STUDENT VERSION.
Activation requires an active internet connection. Our server is sent the activation code, which is then
validated and grants permission to create the license file.
SITE LICENSES
For a site license, each member of the site will receive his/her own unique activation code to activate Chem-
Doodle on personal computers. An additional campus configuration capability which will allow use without
individual activation by any users that log into campus computers is also provided. Campus configurations
are set up globally for a ChemDoodle installation and are typically done by IT staff at the institution owning
the site license.
To configure ChemDoodle for campus use, place the provided site license.config file in the config
subfolder inside the ChemDoodle installation folder. Do this wherever you install ChemDoodle on campus.
Then no matter where you open ChemDoodle on campus, if a configured ChemDoodle is used, ChemDoodle
will open without activation. This procedure works on Windows, Mac OS X and Linux.
Chapter 1: INTRODUCTION 9
Individual activation codes can be obtained by the user by inputing their institution affiliated email address
into the site license form on the ChemDoodle website:
https://www.chemdoodle.com/support/request-site-code/
FREE TRIAL
A free trial may be initiated by clicking the Free Trial button on the activation screen when ChemDoodle
is opened. Trials will remain active for 14 days and cannot be renewed. Once you have activated a trial for
ChemDoodle on your user account, you will not be able to activate any further trials of ChemDoodle until
a new major version of ChemDoodle is released. So if you started a trial for ChemDoodle version 1, for
instance, you will be able to start a new trial of ChemDoodle version 2 and subsequent versions when they
are released.
The trial is intended to provide the user with access to the application for evaluation purposes only. Output
from the trial will contain watermarks and should not be used for other purposes.
Free trials are subject to the following restrictions:
• Documents show a watermark at the top and will render a background texture.
• The Save..., Save as Image... and Convert... functions are disabled.
• Only images and ChemDoodle data can be pasted from ChemDoodle.
• IUPAC naming is disabled.
• All copied and printed content will contain a watermark.
• Templates cannot be saved.
• ChemDoodle Web Components cannot be previewed or generated.
STUDENT VERSION
The student version of ChemDoodle is a subscription and the activation code expires at the end of the
subscription. The student version of ChemDoodle is subject to the following restrictions:
• Round-trip editing is not enabled.
• Images output from ChemDoodle will not contain chemical metadata.
• Formatted documents and publishing style sheets are not available.
• Import/Export of style sheets is disabled.
• Only ChemDoodle Documents can be saved.
• There is no conversion utility available.
• ChemDoodle Web Components cannot be previewed or generated.
• The only chemical data format you can copy is the ChemDoodle format.
• Tweets from ChemDoodle will be appended with the hashtag #ChemDoodle.
10 Chapter 1: INTRODUCTION
CONNECTION ISSUES
Connectivity issues may arise during activation. These are most likely to occur in corporate environments
and are usually related to the firewall or the proxy server.
FIREWALL ISSUES
If your firewall blocks internet connections from Java applications, then ChemDoodle will not be allowed to
connect to the internet. An administrator should set up a special exception to allow ChemDoodle to connect
to the internet, at least for activation.
PROXY ISSUES
If you use a proxy to access the internet, ChemDoodle will use the default system proxy information to
connect to the internet. If that fails, then you will need to manually define the proxy settings in the
proxy.config file that can be found in the config folder in the ChemDoodle installation folder.
UNAUTHORIZED USE
Using ChemDoodle to output the glassware graphics or the BioArt graphics for the sole purpose of publishing,
selling, or distributing them individually or as a set is forbidden.
ATTRIBUTIONS
REFERENCING
ChemDoodle can be referenced in publications. In the Help|References menu item, a copyable reference
template is provided for your use. You can also reference published reviews of ChemDoodle, which are found
in the opened references list.
CHAPTER 2
ChemDoodle Basics
12 Chapter 2: CHEMDOODLE BASICS
Contents
THE CHEMDOODLE GRAPHICAL USER INTERFACE . . . . . . . . . . . . . . . . . . . . 14
DOODLE BOARD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Ruler Guides . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Scrollbars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Tab Tray . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
APPLICATION MENU BAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
ChemDoodle Menu (Mac OS X Only) . . . . . . . . . . . . . . . . . . . . . . . . 18
File Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Edit Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
View Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Content Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Structure Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Reaction Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Spectrum Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Window Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Purchase Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Help Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
GENERAL TOOLBARS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Files Toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Formatting + Strokes Toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Content Toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
MAIN TOOLBAR TOOLS AND PALETTES . . . . . . . . . . . . . . . . . . . . . . . . 33
Elemental Labels Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Bonds Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Rings Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Carbon Chain Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Macromolecular Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Chemical Attributes Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Orbitals Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Arrows Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Shapes Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Brackets Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Pen Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
WIDGETS AND THE WIDGET MENU . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
THE WORKSPACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Resizing the Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Resetting to the Default Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Reverting to the Last Saved Workspace . . . . . . . . . . . . . . . . . . . . . . . 42
Saving the Current Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
INTERFACE OPTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
DRAWING CONTROLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Drawing Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Optimize Zone Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Hover Distance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Snap to Grid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Single Bond Behavior . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Increment Past Triple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Chapter 2: CHEMDOODLE BASICS 13
ChemDoodle’s functions are accessed through interaction with several types of components as indicated in
Table 2.2 below.
Component Description
DOODLE BOARD
The Doodle Board is the main drawing window and contains all of the documents you create and edit.
You may use mouse and keyboard gestures to interact with the Doodle Board and to draw your figures.
Figure 2.2 displays the main components of the Doodle Board.
Ruler Guides
There are two rulers aligned with the currently displayed document on the Doodle Board. The ruler to
the left of the document allows for vertical measurements and the ruler to the top of the document allows
for horizontal measurements.
When the document rendering scale is changed, the ruler scale will also change to match the new dimensions.
When the scrollbars are used to focus on a different area of the document, the rulers will also scroll to match
the new location.
The ruler displays full ticks at each inch, half-ticks at each half-inch, and quarter-ticks every eighth of an
inch. The ruler units can be set to metric mode for centimeter ticks instead of inches in the Preferences
window under the General tab.
Several colored ticks and areas are also present on the rulers for visual feedback as described below. These
feedback tips can be disabled in the Preferences window under the General tab.
• Margin Areas - Margins are highlighted in a yellow color.
• Mouse Pointer Ticks - Mouse pointer locations are ticked on the rules with a red color.
• Selection Dimension Area - Marks the bounds of the currently selected content. This is denoted
by an amber area. This area corresponds to the internal coordinates of the content and not the visual
bounds. For example, it will denote the bounding box given the atom coordinates, but will ignore the
dimensions of the labels for those atoms.
Scrollbars
Scrollbars will appear to the right and bottom of the document if the height and width, respectively, of the
document are too large to fit on the Doodle Board. You can click and drag the scroll bars to change which
area of the document is displayed on the Doodle Board. You can also use the mouse scroll gesture to
translate the view. Horizontal mouse scrolling is only supported on Mac OS X.
If the alt key is held down while vertical scrolling over the current document, the document
scale will be altered accordingly.
Tab Tray
The Doodle Board stores all drawing content and organizes it into documents that can be saved as files or
images. Each document has a corresponding tab, located at the bottom of the Doodle Board in the tab
tray. When a tab is pressed, the corresponding document will be selected and viewed. This allows you to
manage a large number of files at once, without having to manage a large number of windows.
The number of tabs present in the tab tray will change depending on how many documents are open. If only
a single document is present, then only one tab is displayed and will be selected. Selected tabs are brighter
and shown popped forward (see Figure 2.3a). When multiple documents are open, multiple tabs will be
Margin Areas - Margins are highlighted in a yellow color.
Mouse Pointer Ticks - Mouse pointer locations are ticked on the rules with a red color.
Selection Dimension Area - Marks the bounds of the currently selected content. This is
denoted by an amber area. This area corresponds to the internal coordinates of the content
16
and not the visual bounds. For example, it will denote theChapter
bounding box given the atom
2: CHEMDOODLE BASICS
coordinates, but will ignore the dimensions of the labels for those atoms.
Figure
Figure2.2:
2.2: The
The Doodle Board
Doodle Board
displayed in the tab tray. The tab corresponding to the currently selected document will appear brighter
and forward of the other tabs (see Figure 2.3b).
If there are more tabs than can fit in the tab tray, not all the tabs will be displayed in the tray. Only the
most recently viewed tabs will be displayed. Two right-oriented chevrons and a number are displayed to the
right of the last tab to notify you that there are undisplayed tabs (see Figure 2.4a).
Click on the chevrons and number to open a popup menu that lists the undisplayed tabs (see Figure 2.4b).
Click on an item in the list to select that document.
The name of the file is displayed on the tab. If the name is too long, it may be cropped and appended with
an ellipsis (. . .). You may also see an asterisk (∗) and/or a caret (ˆ) displayed before a file name in a tab.
Chapter 2: CHEMDOODLE BASICS 17
The asterisk is a reminder that the file has been changed since the last save, and the caret marks it as an
online file.
Tab specific functions that can be accessed by right-clicking on any given tab are:
• Close - Close the current tab. This option is only enabled if multiple tabs are present.
• Close Others - Close the other tabs, but leave the current one open. This option is only enabled if
multiple tabs are present.
• New Document - Create a new document and tab.
• Restore - If the corresponding document was created by opening a file, then this function will be
enabled, allowing you to undo all of your changes and reload the file.
Menus are located on the top of the ChemDoodle application. On Mac OS X, the ChemDoodle menu bar is
displayed as the screen menu bar. For menu item keyboard shortcuts, consult the KeyboardShortcuts.pdf
document in the docs folder in the ChemDoodle installation folder.
There are 9 menus in the menu bar (10 on Mac OS X), not including the Purchase menu that is present
during the free trial:
• ChemDoodle - This is a Mac OS X specific menu bar and contains access to several Mac OS X
specific tasks as well as the About, Preferences and Quit menu items.
• File - This menu handles all input and output of data, as well as file specific functions such as
Annotations. . .. You also have access to your iChemLabs account through this menu and the Quit
menu item is located here on non-Mac OS X platforms.
• Edit - Standard global document functions are located here including Cut, Copy and Paste.
• View - Functions for changing how documents are shown are located here as well as access to the
elemental and chemical data provided with ChemDoodle. The dynamic periodic table is also accessible
through this menu.
• Content - Contains all non-chemical functions for editing content in the current document.
• Structure - Contains all functions related to editing and analyzing molecules.
• Reaction - Contains all functions related to editing and analyzing reactions.
• Spectrum - Contains all functions related to editing and analyzing spectra.
• Window - Manage your workspace and the entire ChemDoodle application window.
• Purchase - This menu is only present during the free trial and provides functions for purchasing and
activating licenses for ChemDoodle.
• Help - This menu contains several functions to access this user guide, list references, contact customer
service and other common help items.
18 Chapter 2: CHEMDOODLE BASICS
This is a Mac OS X specific menu bar and provides access to several Mac OS X specific tasks as well as the
About, Preferences and Quit menu items.
File Menu
Save Selection As Image. . . - Saves the currently selected objects as an image. Several bitmap and vector
image types are supported. This menu item is disabled if no objects are selected.
Convert. . . - Displays a window to convert chemical files to different chemical file types that ChemDoodle
interprets. Nothing is loaded to the Doodle Board, as output is written directly to a new file that is
created.
Generate Web Component. . . - Generate a ChemDoodle Web Component. An entire window will
appear for you to define and edit the ChemDoodle Web Component, as well as preview and generate
the Javascript for it. More information on this feature is covered in APPENDIX: CHEMDOODLE WEB
COMPONENTS .
Sync with Online Account. . . - Login to your iChemLabs Account to access special online features in
ChemDoodle.
Open Online File > - our online files will be listed in this submenu. Click on a file to open it on the
Doodle Board.
Save As Online File - Save your file online. This is useful for using ChemDoodle efficiently on several
computers or for interacting with iChemLabs cloud services. This feature also allows you to transfer
structures drawn on your desktop to ChemDoodle Mobile on your phone.
Refresh - Revalidate the menus and re-sync your information with your online account. This should be
done when you transfer a new file into your account from a source other than ChemDoodle desktop.
Logout - Logout from your iChemLabs account.
Interfaces > - This submenu provides access to third party interfaces, including ChemExper, LabArchives,
and Twitter.
Edit Menu
Paste - Paste the system clipboard data of highest priority into the document.
Paste and Match Style - Paste the system clipboard data of highest priority into the document and match
the style to the current style sheet.
Paste Text as Chemical > - Pastes the current text on the clipboard, interpreted as chemical data, as
any of the options provided in the submenu.
Beilstein ROSDAL - Paste text as ROSDAL.
ChemDoodle JSON - Paste text as ChemDoodle JSON.
Daylight SMILES - Paste text as SMILES.
IUPAC InChI - Paste text as InChI.
Tripos SLN - Paste text as SLN.
XYZ-Like Data - Paste text as a chemical, interpreted from a text blob where XYZ-like data is
parseable.
Guess Chemical Format - Paste text as chemical, where the format is guessed from the content. If
the data is ambiguous or a parsing issue occurs, an appropriate message will be displayed.
Paste Special. . . - Lists all data that ChemDoodle can interpret from the system clipboard. You may then
choose the data of choice to be pasted into the document. This function is useful, for instance, when you
would like to paste SMILES string text instead of a structure into the document. A structure has higher
priority than text.
Delete - Remove the currently selected content from the current document.
Chapter 2: CHEMDOODLE BASICS 21
View Menu
Content Menu
Reselect - Reselect the last content that was selected. This function is only enabled if no content is currently
selected. This function may not work as expected when content is removed. For instance, if you selected
content and then deleted it, then pressing reselect will have no action because the content to be reselected
no longer exists.
Scale. . . - Scale the currently selected objects. You will be presented with a window to set various options
to define how the content will be scaled. You can even choose to scale all molecules individually, to set them
all to a common bond length for instance.
Align Bond > - Contains functions for aligning a single selected bond, rotating the molecule it is contained
in. This function is enabled when only a single bond is selected.
Up - Align bond up.
Right - Align bond right.
Down - Align bond down.
Left - Align bond left.
Flip Bond Orientation - Flip the orientation of the bond. This switches the start and end atoms of the
bond. Non-symmetrical bonds will face the other direction.
Torsion Bond - Flip the orientation of atoms and bonds connected to the bond, as if the bond was rotating
on its own axis.
Scale Bond. . . - Scale the currently selected bond. This function is enabled when only a single bond is
selected. You will be presented with a window to set various options to define how the bond will be scaled.
Top Edges - Align all selected content by the top edges of their visual bounds.
Centers Horizontally - Align all selected content by the vertical centers of their visual bounds.
Bottom Edges - Align all selected content by the bottom edges of their visual bounds.
Distribute > - Contains functions for distributing selected content.
Horizontally on Page - Distribute selected content horizontally on the page such that they are evenly
distributed based on their visual bounds and fit within the page margins.
Vertically on Page - Distribute selected content vertically on the page such that they are evenly distributed
based on their visual bounds and fit within the page margins.
Horizontally by Buffer Space. . . - Distribute selected content horizontally on the page such that they
are evenly distributed based on their visual bounds by a value that you input.
Vertically by Buffer Space. . . - Distribute selected content vertically on the page such that they are
evenly distributed based on their visual bounds by a value that you input.
Grid All on Page. . . - A numeric field will appear. Select the number of columns or rows to place the
content in, and ChemDoodle will then align all content in a grid with that many rows or columns.
Stack All on Page - Stack all content on the page. Stacking will place all content within the page margins
based on their visual bounds. Stacking proceeds by placing content from left to right, and then top to
bottom, on the page using a small buffer space.
Chapter 2: CHEMDOODLE BASICS 25
Group - Group the currently selected content into a single shape. Single items in grouped content cannot
be edited and transformations will affect the entire group as a whole. Groups can also be grouped into larger
groups.
Ungroup - Ungroup grouped content. Ungrouping is not recursive, so if the group being ungrouped contains
a group, then that inner group will remain grouped.
Join - If two atoms are selected, then they will be joined into a single atom, and their bonds will all point to
the new joined atom. If selected atoms were part of two discrete molecules, then one molecule is translated
to the other. If two bonds are selected, then they will be joined together, and all bonds connected to the
selected bonds will connect to the new joined bond. Two bonds within the same molecule cannot be joined.
One molecule will be translated and rotated to the other to aesthetically display the new joined molecule.
This function is disabled in all other cases.
Flatten - This function will change all z-coordinates of selected atoms to zero, thereby flattening 3D struc-
tures.
Add Frame > - Contains various functions for surrounding selected content with shapes based on their
visual bounds.
Chevrons - Surround selected content with chevrons based on the content’s visual bounds.
Curly Brackets - Surround selected content with curly brackets based on the content’s visual bounds.
Parentheses - Surround selected content with parentheses based on the content’s visual bounds.
Rectangle - Surround selected content with a rectangle based on the content’s visual bounds.
Square Brackets - Surround selected content with square brackets based on the content’s visual bounds.
Measure > - Contains various functions for measuring selected content.
Diagonal - Place one ruler object diagonally over selected content based on its visual bounds to measure
its diagonal. You can change the units of the ruler object.
Width and Height - Place two ruler objects, one vertically to the left and one horizontally below selected
content based on its visual bounds to measure its width and height. You can change the units of the
ruler object.
Conform to Document Settings - Conform all currently selected objects to the current chemical docu-
ment settings, including scaling and changing fonts.
26 Chapter 2: CHEMDOODLE BASICS
Structure Menu
Kekulize - This function will convert a delocalized substructure (defined with resonance bonds) or a single
bond skeleton to a Kekulé structure with the most delocalized area.
Delocalize - Converts a Kekulé structure to the delocalized equivalent.
Graph Reduction > - Contains several functions for reducing the underlying graph data structures that
represent the selected structures. This is ideal for extracting information about small molecule building
blocks for drug discovery purposes.
Reduce 0◦ (Lone) - This function will remove all 0 degree nodes, so all lone atoms will be removed.
Reduce 1◦ (Terminals) - This function will remove all 1 degree nodes, so all terminal atoms will be
removed.
Repeatedly Reduce 1◦ (Terminals) - This function will repeatedly remove all 1 degree nodes until
none remain, so all isolated chains will be removed.
Reduce 1◦ + 0◦ - This function will remove all 0 and 1 degree nodes, so all lone and terminal atoms will
be removed.
Reduce 2◦ (Chains) - This function will remove all 2 degree nodes, so all inner chain atoms will be
removed.
Reduce 2◦ + 1◦ + 0◦ - This function will remove all 0, 1 and 2 degree nodes, so all lone, terminal and
chain (including non-isolated chains) atoms will be removed.
Chapter 2: CHEMDOODLE BASICS 27
Add Breakers > - Contains several functions for adding atom and bond breakers.
On Atoms - Add a breaker to each selected atom.
On Bonds - Add a breaker to each selected bond.
Collapse to Label - A label field will appear, input the text and styling you wish to display for the collapsed
fragment and close the text input. The selected fragment will be replaced by the newly created collapsed
label.
Expand Labels - Will expand all complex atom labels to their all-atom equivalents.
Rings > - Contains several functions for defining ring sets in selected structures. If a highly overlapping
figure results, just stack the content for a cleaner layout.
Explode Smallest Set of Smallest Rings - Explode out the smallest set of smallest rings (SSSR) for
selected structures. The SSSR is the standard for defining ring sets in flat 2D structures.
Explode Euler Facet Rings - Explode out the Euler facet rings for selected structures. The Euler facet
ring set is better than the SSSR at defining essential rings in 2D depictions of 3D structures.
Explode Hanser (All) Rings - Explode every last graph cycle in selected structures.
Stereochemistry > - Contains several functions for deducing the stereochemistry of selected structures.
Assign R/S (CIP) - Finds and assigns CIP stereochemistry to chiral centers.
Assign E/Z (CIP) - Finds and assigns CIP stereochemistry to stereochemical double bonds.
Assign cis/trans - Finds and assigns cis/ trans stereochemistry to appropriate double bonds.
Attach Updating Label - A window will appear with a drop down to select which description to set to
the label attached to selected molecules. These labels will update as you edit the associated molecule.
Clean > - Contains various functions for optimizing and beautifying selected structures.
2D Optimization - The CCG depiction algorithm is performed on your selected structures to clean them
in 2D.
Build 3D Model (NIH Cactus) - This function will use the Cactus service from the NIH to build a 3D
molecule based on templates. This function is very fast, but requires an internet connection.
Distance Geometry Embedding - Distance geometry is used on the bond distance matrix of the selected
structures to embed them in 3D. This is great for highly connected structures like buckyballs or adaman-
tane and will produce suitable 3D coordinates for figures. It will not work very well on less connected
structures like chains.
Create Lewis Dot Structure - This function will create Lewis Dot Structure models from any selected
molecules.
Descriptors > - Contains various functions that will display the named descriptor for the first of the selected
molecules. See CHEMINFORMATICS for further details and the full list of descriptors.
Last Chosen - This menu item is a placeholder that will remember the last chosen descriptor for easy
repeat access.
Constitutional > - Contains any constitutional descriptors; descriptors that are defined by the chemical
makeup of the molecule.
28 Chapter 2: CHEMDOODLE BASICS
Topological > - Contains any topological descriptors; descriptors that are defined by the bond connec-
tivity of the molecule.
Physicochemical > - Contains any physicochemical descriptors; descriptors that are defined by physics
or chemistry of the molecule.
ADME Filters > - Contains descriptors that assess bioactivity.
Generate Line Notation > - Contains functions for generating line notations of selected structures.
Daylight SMILES - Generates simplified molecular input line entry specification (SMILES).
Tripos SLN - Generates Sybyl Line Notation (SLN).
IUPAC InChI - Generates the international chemical identifier (InChI).
Beilstein ROSDAL - Generates the representation of organic structure descriptions arranged linearly
(ROSDAL).
Parse IUPAC Name. . . - A text field will appear. Type or paste in a valid IUPAC name and the structure
will be generated and inserted into the current document.
Structure to IUPAC Name - Generates the IUPAC name for the selected structure, which can then be
pasted into the document or to the system clipboard.
Reaction Menu
Build Implied Reaction - When an arrow and structures are selected, this function will become enabled.
All selected structures with midpoints to the left of the arrow midpoint become reactants while all selected
structures with midpoints to the right of the arrow midpoint become products.
Edit Reaction. . . - Will open up a window showing all the structures in the current document. Click and
drag structures from the document tray to the reactant and product trays to explicitly define the reaction.
This function is enabled when an arrow is selected.
Dissolve Reaction - Will dissociate any selected reaction data structures.
Chapter 2: CHEMDOODLE BASICS 29
Spectrum Menu
Generate > - Contains various functions for generating and simulating spectra.
1
H NMR - Generates a proton nuclear magnetic resonance spectrum of the first selected structure.
13
C NMR - Generates a carbon-13 nuclear magnetic resonance spectrum of the first selected structure.
Mass Parent Peak - Generates a mass parent peak from the mass spectrum of the first selected structure.
This will show the magnitude of the parent ion and the isotopic distribution.
Window Menu
Show/Hide Dialogs - Toggle the visibility of all other ChemDoodle windows besides the main window.
Widgets > - Controls which widgets are visible on the screen. Widgets are fully described in WIDGETS.
The available widgets are:
Doodle Statistics
Elemental Analysis
30 Chapter 2: CHEMDOODLE BASICS
History
Line Notation Pad
MolGrabber
Multiplet Tool
NMR SignalSeek
Properties
Search
Symbols
Templates
TLC Canvas
Close All Widgets - Close all currently open widgets.
Collect Windows - Collect all of ChemDoodle’s windows around the main window.
Default Workspace - Return the configuration of windows within the main ChemDoodle window to the
default layout.
Revert Workspace - Revert the ChemDoodle workspace to the last saved workspace.
Save Workspace - Save the current configuration of the windows within the main ChemDoodle window.
This also saves file chooser paths and other workspace settings. This command is executed automatically
when ChemDoodle is closed.
Purchase Menu
Help Menu
View User License - View the user license that you accepted when you activated ChemDoodle.
Deactivate ChemDoodle - ChemDoodle can only be used on the number of computers determined in
your license. To switch from one computer to another, use this function first. This function is also useful if
you need to reinstall your operating system.
Contact Customer Service - Open the iChemLabs customer support form and fill in the appropriate
fields. This is the quickest and easiest way to contact iChemLabs customer service.
iChemLabs Newsfeed - View the iChemLabs newsfeed RSS.
Check for Updates - Check for updates to ChemDoodle. If any are found, you will see the changes listed
and you will be requested to update ChemDoodle. If allowed, ChemDoodle will automatically update itself.
There is no need to redownload or reinstall ChemDoodle for updates.
GENERAL TOOLBARS
The general toolbars are located at the top of the ChemDoodle window (see Figure 2.1). They dain buttons
for quickly accessing menu items and controls for various settings for the document. The bottom most
toolbar (Content Toolbar) in this section contains tools for working with content in the document.
Files Toolbar
Content Toolbar
The Main Toolbar and palettes are located on the left hand side of the main window and contain tools for
drawing on the document. Many buttons in the Main Toolbar represent a group of drawing tools. When
you click on the button, several options will appear. The option that is chosen becomes the default tool for
that button.
This toolbar can be detached and moved to the desired position while working. Set Atom Label
When selected, will allow you to click on any atom and open a text field. Enter desired text in the
text field and then click on the page or press the escape key to close the text field, thus setting the
selected atom’s label to the contents of the text field.
When selected, will allow you to click on any atom or bond and open a query field for that object.
Enter the desired query or use the query toolbar to set the query and press the escape key to set
the query. Query structures are covered in the QUERY STRUCTURES chapter.
34 Chapter 2: CHEMDOODLE BASICS
Click on the element label to see a full periodic table. Select an element label to attach it to any atom in
the drawing.
Right click on the elemental labels button to see the common labels palette as shown in Figure 2.9.
Bonds Palette
Covalent
Two Electron bond Any Order Unknown bond
bond4
bond
To place bonds of a specified type, click on the desired type of bond and the drawing mode will change to
place a bond of that type. Clicking on a hovered bond will change that bond’s current bond type to the
selected bond type.
The single bond order will add to other bond orders by default. So clicking on a single bond will change it
to a double bond, clicking on a double bond will change it to a triple bond, etc. Clicking on a triple bond
will change it to a single bond. Clicking on decorated bond orders (protruding, ambiguous double, etc.) will
convert it to a single bond before incrementing it. To stop single bond orders from adding to bonds, you
can set the single bond behavior to always override other bond orders in the Preferences window under
the General tab.
4 The covalent bond is coordinate covalent by default but can be changed to polar covalent.
36 Chapter 2: CHEMDOODLE BASICS
Rings Palette
Macromolecular Tools
Macromolecular Tools
Chemical Attributes
Tag by Roman
Tag by Number
Numeral
Orbitals Palette
Atomic fxz2 |xy2 |x(x2 −3y2 )|y(3x2 −y2 ) orbitals Bonding π orbital
Arrows Palette
The top row of the arrows palette consists of three drop-down menus specifying the starting arrow style, the
connector style between arrows and the ending arrow style.
Connector style
Starting arrow style Ending arrow style
between arrows
Chapter 2: CHEMDOODLE BASICS 39
The set of buttons to the left allows you to place an arrow in the
document at a given preset angle. The preset angles, from left to
right, are 270, 180, 120, 90 and 0. At any time, you can change
the arc angle of a placed arc to an arbitrary angle of your choice.
This set of buttons contains presets for common non-standard arrow types,
such as retrosynthetic arrows. The arc angles of these arrows cannot be
changed.
Shapes Palette
Brackets Palette
Pen Tools
Polylines
Widgets are auxiliary applications that provide added functionality to ChemDoodle. Each widget has its
own unique interface contained within a widget window. A widget window is a simple, movable and re-
sizable window that contains the widget interface and a two buttons in its top bar for closing and for
maximizing/minimizing the widget. A comprehensive guide to the widgets and their use can be found in
the WIDGETS chapter of this manual.
Name Description
Elemental Analysis Calculates molecular masses, elemental analysis and isotopic dis-
tributions for structures
History Provides full access to the undo/redo queue
Line Notation Pad Generates and parses line notations and will also correct your
input
MolGrabber Search databases for chemical structures
Multiplet Tool Simulate multiplets
NMR SignalSeek Simulate nuclear magnetic resonance and associate peaks to nuclei
as well as provide more thorough information about the spectrum
and simulation
Properties Calculates molecular descriptors
Search Search your computer and attached storage devices for chemical
structures
Statistics Displays document and drawing statistics
Symbols Quick access to chemically relevant symbols and the full unicode
range
Templates Organizes chemical structure templates for your use
TLC Canvas Draw thin layer chromatography plates
42 Chapter 2: CHEMDOODLE BASICS
THE WORKSPACE
The ChemDoodle workspace consists of the application’s windows and all interface elements contained within.
You may freely place toolbars, select widgets, change the document scale, select view options, etc., and your
choices will be saved. ChemDoodle also provides several functions for managing your workspace.
A minimum screen resolution of 1280 by 800 pixels is recommended to neatly fit all of the components in
ChemDoodle on the screen. Slightly smaller resolutions are still acceptable when shrinking the document
scale. For much smaller resolutions, the workspace will display scrollbars to access the entire ChemDoodle
interface.
On devices that just fit the Doodle Board, ChemDoodle will expand to fit the entire screen. On larger
resolution devices, ChemDoodle will open to take only as much room as necessary. At any time, you may
minimize and maximize the application or resize it to your preference. Upon resizing the Doodle Board
will be centered.
The workspace will keep track of the size and location of ChemDoodle when it was last closed.
To reset to the default workspace that was presented when ChemDoodle was first opened, select the Win-
dow|Default Workspace menu item.
To revert to the last saved workspace select the Window|Revert Workspace menu item.
To save the current workspace, which will override the last saved workspace, execute the following steps:
1. Organize the workspace as desired.
2. Select the Window|Save Workspace menu item.
The current workspace is now saved and can be reverted to.
Upon closing, ChemDoodle will automatically save your current workspace and when it is
opened again the workspace will look exactly as it did when it was closed. Therefore, you
may wish to revert the workspace to your saved workspace before exiting ChemDoodle.
Chapter 2: CHEMDOODLE BASICS 43
INTERFACE OPTIONS
In addition to being a very powerful application for your chemical data, ChemDoodle is readily customizable.
ChemDoodle provides many options for changing the way it looks, how it works, and the visual effects. To
access the interface options, select the Preferences. . . menu item in the Edit menu (in the ChemDoodle
menu on Mac OS X). The General (leftmost) tab contains the interface options.
DRAWING CONTROLS
Drawing Mode
There are two drawing modes, Quick and Control. Quick mode is the default, and actions are performed by
pressing down with the mouse, dragging to set the tool, and then releasing the mouse to finish the action.
In Control mode, the same action is achieved by clicking the mouse once, moving the mouse to set the tool
and then clicking again to complete the action.
The Optimize Zone is a special component in ChemDoodle for placing bonds in the optimal position around
atoms. It appears as a blue circle when placing bonds and other molecule fragments. To use the Optimize
Zone, just place the mouse pointer in the blue circle. The bond or fragment being placed will automatically
be oriented in the most optimal position. You can change the size of the optimize zone to be Small, Medium
or Large. It is Medium by default.
Hover Distance
The hover distance controls how close the mouse pointer must be to an object for it to be considered hovered.
The default is 10 pixels, but it can be made more sensitive or more pinpoint.
Snap to Grid
By default, coordinates for all objects can be placed anywhere. However, you can set a 5-pixel or 10-pixel
grid for objects to snap to.
By default, single bonds will increment bond orders. So using the Single bond tool, if you click on a single
bond it will become a double bond and so forth. However, you can change this behavior to instead override
bond orders so any bonds clicked on with the Single bond tool become single bonds.
By default, if the Increment Bond Orders option under Single Bond Behavior is selected, bonds will
not be incremented past triple bonds, instead falling back to being single bonds again. When this option is
enabled, bonds can be incremented all the way to being sextuple bonds before becoming single bonds again.
44 Chapter 2: CHEMDOODLE BASICS
By default, using delete functions when a bond is hovered will remove that bond entirely. However, you can
change this behavior to instead decrement bond orders.
This option is enabled by default and will have the atoms placed by ring and template tools automatically
merge with any overlapping atoms present in the document.
This option is enabled by default and fixes the bond lengths of the drawing tools. You can quickly modify
this setting when drawing by holding down the shift key.
This option is enabled by default and fixes the bond angles of the drawing tools. You can quickly modify
this setting when drawing by holding down the alt key.
Many chemical sketchers have the bond as the smallest building block. ChemDoodle uses atoms as the
smallest building blocks, and all drawing functions require a starting atom. You can disable this requirement
and allow new bonds to be placed with a single mouse click.
By default, text does not rotate when you rotate structures. This setting enables atom text rotation when
structures are rotated.
If you are working only with atoms or you don’t want to touch bonds, enabling this setting will make editing
easier. When disabled, bonds cannot be hovered or selected.
3D Rotation Mode
When using the structure perspective tool, mouse movements will correspond to x- and y-axis movements
during 3-D rotation. You can change this to correspond to a quaternion rotation if desired.
Chapter 2: CHEMDOODLE BASICS 45
APPEARANCE
Interface Scale
You can choose to have ChemDoodle increase the size of it’s text and components with this setting. This
is useful for accessibility purposes or if you are having difficulty using the application. The recommended
scales are 1.5x and 2x.
Recently opened files can be displayed at the bottom of the File menu, or in a submenu in the File menu.
By default they are displayed in a submenu, but you may wish to switch this option for quicker access if you
have a tall screen.
If you prefer a different font from the standard sans-serif font that ChemDoodle uses, you can change it here.
This is also helpful if you need to switch to a different font that supports characters for another language.
If you prefer a different font size from the standard size that ChemDoodle uses, you can change it here. This
is also helpful if you have trouble reading the labels in the program.
Application Color
If you prefer a color other than the default light green color, you can choose to change this here. Light, pale
color choices are easiest on the eyes and are least distracting.
Highlight Color
This color is used for hovered decorations and some selected highlights. It is pale brown by default.
Selected Color
This color is used for selected objects and the lasso bounds. It is pure blue by default.
Lasso Color
This color is used for the selection anchors and other lasso decorations. It is a dark blue by default.
46 Chapter 2: CHEMDOODLE BASICS
Preview Color
This color is used for preview feedback while using the drawing tools. It is a neon green by default.
Error Color
This color is used to highlight errors and other problems. It is a brick red by default.
DECORATIONS
When enabled, statistics are rendered to show lengths and angles if they are not fixed.
When enabled, statistics are rendered to show how lasso functions alter your figures.
When enabled, the lasso outline will exhibit a crawling ants effect.
When enabled, buttons will display a shimmer effect when you hover the mouse cursor over them. This
makes it easy to detect which button you are pressing.
When enabled, the mouse position will be ticked on the document’s rulers in red.
When enabled, the lasso selection will be highlighted on the document’s rulers in amber.
When enabled, an aesthetically pleasing drop shadow is displayed under the document pages.
Chapter 2: CHEMDOODLE BASICS 47
FILECHOOSER SETTINGS
By selecting this option, all file choosers, regardless of function will remember the last location of any of the
file choosers. Otherwise, they will each retain their own memory.
OTHER SETTINGS
Ruler Mode
Document Alignment
Allows setting the alignment of documents in the main application window between Center and Left.
Will hide all widgets and other windows when ChemDoodle is not the active application.
The Properties and Elemental Analysis widgets will update with the last modified molecule if no content
is selected.
The document represents a virtual sheet or sheets of paper. Each document embodies one page or pages of
the chemical structures, objects and figures that you create. The document is fully customizable and also
contains a definition of the styles of the content within it. You can create new blank documents, or read one
from a file that ChemDoodle recognizes.
A style or a visual specification is a definition that stipulates how an object is rendered. For
example, a bond line width is a visual specification for a bond. The terms visual specification,
style, and document setting are all used interchangeably in this document.
48 Chapter 2: CHEMDOODLE BASICS
CREATING A DOCUMENT
You can create a new, blank document using the default ChemDoodle document settings, or use a Chemical
Document Settings file to create a new formatted document. To create a new blank document using the
default style sheet, select the File|New menu item. To create a new blank document using a predefined
style sheet, select the File|New Formatted Document. . . menu item.
ChemDoodle provides built-in Chemical Document Settings files. For example, the ACS Document 1996
style is configured to create documents that are set with the bond lengths, bond width, spacing, and fonts
used in the 2-column format of all American Chemical Society journals. Currently, ChemDoodle provides
the following style sheets:
• ACS Document 1996
• Adv. Synth. Catal Document 20
• J. Chin. Chem. Soc. Document
• J. Het. Chem. Document
• J. Mol. Mod. Document (1 Column)
• J. Mol. Mod. Document (2 Column)
• Phytomedicine Document
• RSC Document (1 Column)
• RSC Document (2 Column)
• Science of Synthesis Document
• SYNTHESIS, SYNLETT Document
• Verlag Helv. Chim. Acta Document
• Wiley Document
These style sheets are available when you create a new formatted document as is shown in Figure 2.16 below.
The style sheets are organized into three sections. The first contains just the default style sheet, the second
contains all the built-in style sheets and the last contains custom style sheets. Select the style sheet that you
prefer, set any custom dimensions, and then click the OK button to create your new formatted document.
If you would like to modify the document dimensions of the formatted document, then select the Use
Custom Dimensions checkbox and edit the Page Size and Margins fields.
Chapter 2: CHEMDOODLE BASICS 49
OPENING A DOCUMENT
To open a document, select the File|Open. . . menu item, locate the file you would like to open with the
file chooser that appears and click the Open button.
ChemDoodle can read many file formats, and the default file type the file chooser searches for is a Chem-
Doodle Document. To allow other file types, click on the format drop down selection at the bottom of
the file chooser and select the file type you would like to open, or select the All Files type.
Selecting All Files will allow you to select any file, including files that ChemDoodle cannot
read. If such a file is chosen, you will see a file read error displayed. Otherwise, ChemDoodle
will attempt to open the file by analyzing the file extension and file content to determine its
type.
To open a recently opened document, enter the Open Recent submenu in the File menu and select the
document you would like to open. The ten most recently opened files are remembered.
FILE CHOOSER
The file choosers that you use to open your files will closely resemble the standard file choosers of the
operating system. However, there are some enhancements. One addition is chemical file previews.
On all operating systems, you will see a preview of chemical files that you select in file choosers. On Windows
and Linux, the file chooser will show a preview of the entire document to the right as shown in Figures 2.17
and 2.18. If you place your mouse over the document preview, that part of the preview will be zoomed in
for a closer inspection.
Figure 2.17: The file chooser on Windows showing the file preview
50 Chapter 2: CHEMDOODLE BASICS
Figure 2.18: The file chooser on Linux showing the file preview
Figure 2.19: The file chooser on Mac OS X showing the file preview and preview tray
On Mac OS X, a tray is added to the bottom of the file chooser to list the individual molecules present in
the file as shown in Figure 2.19. A Quick Look plugin is also provided on Mac OS X, for you to quickly
preview any files ChemDoodle recognizes using Quick Look functionality in Finder.
You can disable file chooser previews in the Preferences window, under the General tab in the Filechooser
Settings section.
Quick Look is a feature of the Mac OS X platform that allows you to quickly preview files in Finder.
ChemDoodle contains a Quick Look plugin to provide Quick Look previews for all the compatible chemical
file types recognized by ChemDoodle.
On slower Macs, it may take up to 15 seconds to generate a preview for complex files.
To register the plugin with Mac OS X, run the ChemDoodle application once. It may take a few minutes for
the operating system to fully register the plugin. Please keep in mind that the Quick Look functionality
Chapter 2: CHEMDOODLE BASICS 51
will only work for an actively licensed copy of ChemDoodle (trial or purchased license). If you did not
activate ChemDoodle or your trial has expired, the Quick Look function will stop working.
To view a Quick Look preview in Finder for a compatible file, execute the following steps:
1. Locate the file you would like to see a Quick Look preview for.
2. Click on the file and press the space key, or right-click on the file and select the Quick Look “file-
name” menu item.
A preview will pop up in a preview window as shown in Figure 2.20. Previews will also appear in the side
panel and Get Info windows for compatible file types.
To change the size of the current document, execute the following steps:
1. Choose the Edit|Resize Document. . . menu item.
2. Use the form to select a preset document size or manually type in the desired document dimensions.
3. Click the OK button to resize the document.
To retrieve the last saved version of a file without using Undo functions, select the File|Restore menu
item. All changes made to the file since it was last saved are discarded and the saved version of the file will
appear.
SAVING DOCUMENTS
To save your document as a file, select the Save or Save As. . . menu items from the File menu. Save will
automatically save the document to the file it is associated with, while Save As. . . will allow you to save
that file to a new location or overwrite another file. If there is no file associated with a document, the Save
function is identical to the Save As. . . function.
When saving a new file or using the Save As. . . function, a file chooser will appear. Select the location to
save the document to and type a preferred file name or accept the default name. You do not need to type
in an extension.
52 Chapter 2: CHEMDOODLE BASICS
Only the ChemDoodle Document can store your document with 100% accuracy. Other
file types, designed for other purposes, may not accurately or fully describe the objects and
properties in ChemDoodle. A warning will pop up when saving to a file type other than a
ChemDoodle Document. These warnings can be disabled in the Preferences window
under the Saving tab.
After selecting the file type to be used, press the Save button to save your document as a file.
AUTOSAVING
ChemDoodle will automatically save unsaved content for you at regular intervals. If your computer shuts off
unexpectedly, the next time ChemDoodle opens, all autosaved content will be displayed. You can turn off
autosaving in the Preferences window under the Saving tab. You can also specify the autosave interval
in the same section. The default autosave interval is five minutes.
REVERSING ACTIONS
ChemDoodle keeps track of the actions you perform. You can reverse actions one at a time by selecting the
Edit|Undo menu then restore them with the Edit|Redo menu item. Once you close your document, the
undo queue is reset.
More advanced undo/redo functionality is associated with the History widget.
MOUSE CURSORS
The mouse pointer is context sensitive and will change when hovered over the document to display visual
feedback about the current mouse gestures that can be performed. The different mouse cursors are described
in Table 2.4.
Cursor Function
This is the lasso cursor. Clicking and dragging will generate an outline following the drag
path. All content within the drag path will be selected.
This pinpoints the exact location that your click will hit. This enhances accuracy when
using the rectangular marquee or when placing shapes.
This means that content can be grabbed. Individual objects or selected content can be
grabbed.
Chapter 2: CHEMDOODLE BASICS 53
This means that content has been grabbed and dragging gestures will perform appropriate
actions.
This cursor only appears when rotating structures in 3D. It means that content can be
grabbed.
This cursor only appears when rotating structures in 3D. It means that content has been
grabbed and drag gestures will perform appropriate actions.
This cursor signifies that resize actions can be performed by clicking and dragging. This
cursor will also appear when translating the rotation anchor.
This cursor signifies that rotation actions can be performed by clicking and dragging.
SELECTED CONTENT
Content that is selected will be bordered by a dashed blue line. Selected content can be used in functions
and sent to other components. A crawling ants effect is on by default to help the user keep track of selected
content. The crawling ants effect can be disabled in the Preferences window under the General tab.
For instructions on selecting and editing content, see CONTENT MANAGEMENT TOOLS.
CHAPTER 3
Drawing Chemical Structures
Chapter 3: DRAWING CHEMICAL STRUCTURES 55
Contents
BASIC STRUCTURE DRAWING TOOLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Keyboard Shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Hovering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
ATOMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Placing Carbon Atoms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Placing Other Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Placing Atoms with Non-elemental Labels . . . . . . . . . . . . . . . . . . . . . . 58
Hovering Atoms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Selecting Atoms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Changing Atom Labels to Other Elements . . . . . . . . . . . . . . . . . . . . . . 59
Sprouting Bonds to Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Changing Atom Labels to Nonelemental Text . . . . . . . . . . . . . . . . . . . . 60
Repeating the Most Recently Typed Atom Label . . . . . . . . . . . . . . . . . . 60
Moving an Atom . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Deleting an Atom . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
CHEMICAL LABELS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Atom Label Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Atom Label Token Stacking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Atom Label Orientation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Formatting Atom Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
BONDS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Single Bonds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Placing Bonds other than Single Bonds . . . . . . . . . . . . . . . . . . . . . . . . 64
Optimize Zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Placing Bonds with Fixed Lengths and Angles . . . . . . . . . . . . . . . . . . . . 64
Placing Bonds at Non-fixed Lengths . . . . . . . . . . . . . . . . . . . . . . . . . 65
Placing Bonds at Non-fixed Angles . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Placing Bonds at Non-fixed Lengths and Non-fixed Angles . . . . . . . . . . . . . 65
Connecting two Atoms with a New Bond . . . . . . . . . . . . . . . . . . . . . . . 65
Hovering Bonds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Selecting Bonds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Changing a Bond Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Changing Selected Bonds to Single Bonds . . . . . . . . . . . . . . . . . . . . . . 66
Incrementing a Bond Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Deleting a Bond . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Decrementing a Bond Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Deleting Bonds Around Atoms . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Changing the Z-Order of Bonds . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
CHAINS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Placing Chains at Fixed Angles . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Placing Chains at Non-fixed Angles . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Forcing the Placement of Chains Vertically and Horizontally . . . . . . . . . . . . 68
Inverting Carbon Chains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
RINGS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Placing a Ring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Optimize Zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Placing Rings with Fixed Lengths and Angles . . . . . . . . . . . . . . . . . . . . 69
56 Chapter 3: DRAWING CHEMICAL STRUCTURES
Keyboard Shortcuts
There are many keyboard shortcuts to help you draw structures quickly and efficiently. The full list of
keyboard shortcuts is given in the KeyboardShortcuts.pdf file located in the docs folder in the main
ChemDoodle installation folder.
Hovering
Atoms, bonds, and attributes can be hovered in ChemDoodle. To hover an atom, bond or attribute simply
move the mouse close enough to the atom, bond or attribute that an amber circle (for atoms or attributes)
or amber semicircles (for bonds) enclose the object. See Figure 3.1 below. Once an atom, bond or attribute
is hovered further actions pertaining to it can be performed.
ATOMS
Atoms are the basic building blocks in chemistry and are the basic building blocks in ChemDoodle. Before
any other chemical objects can be drawn, an atom must be present as the starting point.
58 Chapter 3: DRAWING CHEMICAL STRUCTURES
When you first open ChemDoodle, a gray dot follows your mouse pointer on the Doodle Board as shown
in Figure 3.2.
To set a carbon atom at the current location of the mouse pointer, just click the mouse. After a carbon
atom has been set structures can be grown from it.
At any time while drawing chemical structures, if there is no hovered atom to grow from, a carbon atom will
trail your mouse and once placed can be used to grow a new structure.
More advanced users may find it inconvenient to always require a starting atom to draw
structures. You can turn off this restriction in the Preferences window under the General
tab, by check the Require Starting Atom checkbox. Clicks with the bond tools will then
immediately place those bonds and rings, templates and chains will not require a starting
atom.
To place atoms with element symbols other than carbon, use the Elemental Labels Palette or the Ele-
ments panel in the Symbols widget. Just click on the desired element symbol and the mouse cursor will
change to be that symbol with a small arrow in the bottom-left corner of the symbol. To place an atom of
the selected element, move the bottom-left arrow to the desired location and click.
If you click while hovering over an atom of a different element, then that atom’s label will change to the
currently selected element symbol.
To place atoms with any text you desire, click on the Set Atom Label tool ( ) located on the Drawing
Toolbar. Then click on the Doodle Board in the desired location to place the new atom and to open an
atom label text field. Type the desired atom label text into the text field and then click elsewhere on the
Doodle Board or press the esc key to close the text field and set the atom.
If you select Set Atom Label and then hover over any existing atom on the Doodle Board, an editable
text field for that atom’s label appears.
Chapter 3: DRAWING CHEMICAL STRUCTURES 59
Hovering Atoms
Atoms can be hovered with most tools in ChemDoodle. Exceptions include the shape tools, such as when
drawing rectangles. Once an atom is hovered further actions pertaining to it can be performed.
Selecting Atoms
To select an atom, first hover one and then press and hold the mouse down. The amber circle indicating
hovering will turn into a blue circle. The blue circle is actually a special component called the Optimize
Zone, which will be discussed in the BONDS section of this chapter.
To change an atom’s label to another element symbol, use the Labels palette or the Elements panel in
the Symbols widget. Just click on the desired element symbol, and the mouse cursor will change to be
that symbol with a small arrow at the bottom-left. Once you have hovered the atom with the label to be
changed, just click to set the new label.
Additionally, when an atom is hovered, you can press any of the letter keys on the keyboard to cycle through
the element symbols that begin with that letter. For instance, if you hover a carbon atom and press the N
key, the atom’s element will be changed to nitrogen.
While placing labels using element symbols or other label tool presets, the Optimize Zone (blue circle, see
Figure 3.4) appears while pressing and holding the mouse down. If you then drag the label outside of the
Optimize Zone, you will sprout a new bond to the selected label. If you then move the mouse back close
to the center of the atom, it will revert back to modifying the label of that atom.
Sprouting the bond follows the same conventions as placing a new bond while using the Optimize Zone.
60 Chapter 3: DRAWING CHEMICAL STRUCTURES
To change an atom’s label to any text you desire, click on the Set Atom Label tool ( ) located on the
Drawing Toolbar. Then hover the atom with the label to be changed and click to open up its atom label
text field. Type the desired atom label text into the text field and then click elsewhere on the Doodle
Board or press the esc key to close the text field and set the new label. Additionally, you can hover the
atom in any mode and then press the space key to open the atom’s label text field.
To reuse a complex atom label for other atoms, hover the other atoms with labels to be changed and press
the enter key. The hovered atom’s label will be set to the most recently typed label.
You can also define the label text to be used when you press the enter key by opening up a previously
typed atom label text box and then closing it.
Moving an Atom
To move an atom, first select one of the selection tools discussed in CONTENT MANAGEMENT TOOLS.
Make sure that no content is currently selected by emptying the lasso. Then execute the following steps:
1. Hover the atom to be moved.
2. Press the mouse down to select the atom.
3. Drag the mouse to move the atom.
4. Release the mouse to finish the move action.
If the atom is a terminal atom in a molecule, then the above instructions will move the atom and bond with
fixed angles and lengths as described in the BONDS section of this chapter.
If the atom is part of a molecule and not a terminal atom, the above instructions will move that entire
molecule. Hold down the shift key while executing the above instructions to move just the atom itself.
Deleting an Atom
To delete an atom, hover it and then press the delete or backspace key. All attached bonds will also be
removed, leaving the adjacent atoms.
CHEMICAL LABELS
The last section described how to use the atom label tool to assign any arbitrary text to an atom. This
text is chemically interpreted; a label of CH3 will be interpreted as one carbon atom with three hydrogen
atoms attached to it. Much more advanced labels can be written and parsed. More information on chemical
interpretation, and expanding these labels, is described in the CHEMINFORMATICS chapter.
In addition to chemical interpretation, the label will automatically be formatted for display; the CH3 label
will display as CH3 . Stacking will also be applied, so as bond overlap with labels is kept to a minimum. You
can override ChemDoodle’s chemical interpretation and apply your own formatting to more advanced labels
such as for rendering isopropyl groups (iPr and i Pr) or adding indexes to carbon chain groups (R10 ).
Chapter 3: DRAWING CHEMICAL STRUCTURES 61
When opening an atom label field, a format toolbar will appear above it containing several controls. The
only enabled button will be the Interpret Chemically button, which is selected by default as shown in
Figure 3.5.
Without further editing, closing this label will assign an ethyl group to the atom and the text will be
automatically formatted as CH2 CH3 .
When labels are chemically interpreted, they will be split up into tokens that describe each discrete unit. For
instance, NH will be split into (N)(H) and CCH2COOH will be split into (C)(CH2)(COOH). More about
this is covered in CONTENT MANAGEMENT TOOLS. ChemDoodle will automatically stack tokens in
atom labels such that they overlap with surrounding bonds as little as possible, as shown in Figure 3.6.
Figure 3.6: Stacked atom label tokens with minimal bond overlapping
By default, if not on a terminal atom, the second token and all subsequent tokens will be stacked to the next
line. There are two visual specifications for more precise control over this behavior: Stack Lone/Terminal
and Token Stacking.
You can set this checkbox to determine if lone and terminal labels will also
stack labels.
In addition to the token behavior settings, you also have full control of the spacing between tokens. All of
these settings are present in the Preferences window in the Visuals tab in the Atoms section under the
Labels subsection.
62 Chapter 3: DRAWING CHEMICAL STRUCTURES
By default, atom label tokens will orient themselves in the direction of least overlap with the rest of the
structure. It may be necessary, on occasion, to force the label to flush in a specific direction. To do so,
execute the following steps:
1. Hover the atom with label to orient.
2. Right-click on the atom and expand the Label Orientation submenu.
3. Choose the direction to orient the label. Choose Auto if you want ChemDoodle to automatically
determine the best orientation.
If a different formatting for the atom label is desired, just deselect the Interpret Chemically button and
the formatting options will be enabled as shown in Figure 3.7.
Use the controls in the toolbar that appears above the atom label field to explicitly format the atom label.
The attributes that can be changed are listed in the table below. In the third column of the table are
descriptions of how to change the attribute.
Chapter 3: DRAWING CHEMICAL STRUCTURES 63
Bold
Select the text to be bold and press the Bold button.
Italics
Select the text to be italicized and press the Italics button.
Select the text to change the font size of and then use the size
Font Size chooser in the Formatting toolbar to select the font size.
When chemical interpretation is disabled the label loses all chemical significance, is not ex-
pandable or suitable for any chemical algorithms.
BONDS
Bonds are the second most important building blocks in chemistry. Bonds in ChemDoodle are graphical
connectors between atoms. There are many options for bond types and for defining how they look.
64 Chapter 3: DRAWING CHEMICAL STRUCTURES
Single Bonds
To place a single bond, click the Single Bond tool ( ) in the Drawing Toolbar. By default, this tool
will be selected when ChemDoodle is opened. Then hover over an atom and press and hold the mouse down.
A preview of the new bond and atom will be drawn as shown in Figure 3.8.
Drag the mouse and use the techniques discussed in the following subsections to place the bond in the
preferred orientation. Then release the mouse to set the bond.
To place bond types other than single bonds, just click on the desired bond type in the Bonds palette. Then
follow the instructions for placing a single bond.
Optimize Zone
The Optimize Zone is a special component in ChemDoodle to help you place bonds in the optimal position
around atoms. It is the blue circle that appears when placing bonds and other molecule fragments. To use
the Optimize Zone, just place the mouse pointer in the blue circle. The bond or fragment being placed
will automatically be oriented in the most optimal position.
The Optimize Zone size can be changed in the Preferences window under the General tab.
By default, fixed widths and fixed angles are enforced when drawing structures. To place a bond with these
constraints, hover over an atom and press the mouse down with a bond tool. You will see the Optimize
Zone appear.
Drag the mouse pointer out of the Optimize Zone. The new bond placement will now orient towards the
mouse pointer.
The default fixed length is defined by the Bond Length visual specification in the Preferences window
under the Visuals tab under the Bonds subtab. Angles are fixed every 30◦ starting at 0◦ .
You can set whether fixed lengths and/or fixed angles are on by default in the Preferences window under
the General tab.
Chapter 3: DRAWING CHEMICAL STRUCTURES 65
When placing bonds, fixed lengths will be enforced. To break from fixed lengths, hold down the shift key
while placing the bond.
You may turn off fixed lengths in the Preferences window under the General tab. In this case, the shift
key will then enforce fixed lengths.
When placing bonds, fixed angles will be enforced. To break from fixed angles, hold down the alt key
while placing the bond.
You may turn off fixed angles in the Preferences window under the General tab. In this case, the alt
key will then enforce fixed angles.
When placing bonds outside of the Optimize Zone, fixed angles and fixed lengths will be enforced. To
break from fixed lengths and fixed angles at the same time, hold down both the shift and alt keys while
placing the bond.
You may turn off fixed lengths and fixed angles in the Preferences window under the General tab. In this
case, holding down both the shift and alt keys will enforce fixed lengths and angles.
If two atoms are already present in the document and you want to connect them with a bond, just initiate
drawing a new bond from one atom and without releasing the mouse, drag over the second atom until it is
highlighted with a red circle. Then release the mouse and the new bond will be formed.
Hovering Bonds
Bonds can be hovered with some tools in ChemDoodle. Once a bond is hovered further actions pertaining
to it can be performed.
Selecting Bonds
Bonds can only be selected when using the selection tools discussed in CONTENT MANAGEMENT TOOLS.
To select bonds, first hover them and then press and hold the mouse down. The amber semicircles will turn
a blue color, indicating that the bond has been selected.
To change a bond type, first select the bond type you would like to change the bond to in the Bonds palette.
Then hover the bond with the type that you would like to change and click the mouse. The new bond type
will override the old type.
66 Chapter 3: DRAWING CHEMICAL STRUCTURES
To change the bond types of a large number of bonds to all be single bonds, execute the following steps:
1. Select the bonds to be changed to single bonds using a selection tool as discussed in CONTENT
MANAGEMENT TOOLS.
2. Click on the Structure|Saturate menu item.
When using the Single Bond tool, clicking on hovered bonds will not override other bond types. Instead
the Single Bond tool will increment the bond order. For example, clicking on a double bond will change it
to a triple bond and clicking on the triple bond will change it back to a single bond.
This functionality can be disabled so that the Single Bond tool overrides bond types in the Preferences
window under the General tab. Also in the General tab is the option to allow bonds to be incremented
past triple; if this option is enabled, bonds will be incremented all the way up to sextuple bonds before
reverting back to a single bond.
Deleting a Bond
To delete a bond, hover it and then press the delete or backspace keys. The constituent atoms will remain.
By default, the delete or backspace keys will remove a bond. You can change this behavior to instead
decrement bond orders. You can enable this behavior in the Preferences window under the General tab,
by setting the Delete Bond Behavior setting to Decrements Bond Orders.
If you select Decrements Bond Orders, press the delete or backspace keys or use the eraser tool while
a bond is hovered. A triple bond will change to a double bond, a double bond will change to a single bond,
and a single bond will simply be removed.
To delete many bonds, but retain the atoms contained in the bonds, execute the following steps:
1. Select the bonds to be removed using a selection tool as discussed in CONTENT MANAGEMENT
TOOLS.
2. Press the Structure|Remove Selected Bonds menu item.
All selected bonds will be removed, but their atoms will remain.
When bonds overlap, one bond will be rendered in front of the other. For structures with 3D coordinates,
the bond with the most positive z-coordinates will be rendered on top. Without z-coordinates, the bonds
will be rendered in chronological order such that the last bond drawn will be rendered on top.
To change the z-order of bonds when z-coordinates are present, execute the following steps:
1. Select the structure with the z-orders to be changed.
Chapter 3: DRAWING CHEMICAL STRUCTURES 67
CHAINS
Chains are a group of carbon atoms, linked linearly by bonds. Three types of chains are provided in
ChemDoodle:
A carbon chain where all chain angles are at 120◦ , but the
Random Chain chain itself can deviate in any direction as shown in
Figure 3.9(c).
By default, the chains will be oriented at fixed angles every 15◦ starting at 0◦ . All bond lengths are defined
by the Bond Length visual specification in the Preferences window under the Visuals tab under the
Bonds subtab.
To place chains at non-fixed angles, hold down the alt key while dragging the mouse when defining the
chain to break from the fixed chain orientation angles.
To place chains oriented vertically or horizontally, hold down the shift key while dragging the mouse when
defining the chain. The chain preview will then automatically orient vertically or horizontally depending on
the angle from the starting atom to the current mouse cursor position.
Carbon chains can be inverted by holding down the slash key / while placing. The preview will update
accordingly.
RINGS
Rings are chains of carbon atoms in which the last atom in the chain connects to the first.
There may be bond types other than single bonds in rings. Currently the following rings can be drawn
quickly from the Rings palette, with additional ring choices in the Templates widget:
Placing a Ring
Optimize Zone
The Optimize Zone can be used to optimize ring placement as described earlier in the BONDS section of
this chapter.
By default, fixed widths and fixed angles are enforced when drawing rings. To place a ring within these
constraints, hover over an atom and press and hold the mouse down with a bond tool. You will see the
Optimize Zone appear.
Drag the mouse pointer out of the Optimize Zone. The new ring placement will now orient towards the
mouse pointer.
The default fixed length is defined by the Bond Length visual specification in the Preferences window
under the Visuals tab under the Bonds subtab. Angles are fixed at 30◦ intervals starting with 0◦ .
You can specify whether fixed lengths and/or fixed angles are turned on by default in the Preferences
window under the General tab.
When placing rings outside of the Optimize Zone, fixed lengths will be enforced. To break from fixed
lengths, hold down the shift key while placing the bond.
You can turn off fixed lengths in the Preferences window under the General tab. In this case, the shift
key will then enforce fixed lengths.
70 Chapter 3: DRAWING CHEMICAL STRUCTURES
When placing rings outside of the Optimize Zone, fixed angles will be enforced. To break from fixed angles,
hold down the alt key while placing the bond.
You can turn off fixed angles in the Preferences window under the General tab. In this case, the alt
key will then enforce fixed angles.
When placing rings outside of the Optimize Zone, fixed angles and fixed lengths will be enforced. To break
from fixed lengths and fixed angles at the same time, hold down both the shift and alt key while placing
the bond.
You can turn off fixed lengths and fixed angles in the Preferences window under the General tab. In this
case, holding the shift and alt keys will then enforce fixed lengths and angles.
When adding rings to atoms, it is sometimes difficult to achieve an aesthetic fuse angle. To correct for this
problem, add the ring to a bond instead of an atom. The ring will automatically align to the bond to which
it is being added.
To add rings to bonds, execute the following steps:
1. Select a ring tool from the Rings palette.
2. Hover the bond to which a ring will be added.
3. Click and drag the mouse pointer to the side of the bond to which the ring should be added.
4. Release the mouse to set the ring.
When the mouse pointer is close to the bond the ring is sprouting from, ChemDoodle will automatically
select the optimal side of the bond to add to.
TEMPLATES
ChemDoodle contains a very advanced structure templates system. Several sets of predefined templates are
already packaged with ChemDoodle and can be accessed through the Templates widget. Currently, the
following template sets are provided:
The Templates widget organizes your templates and allows you to easily use them. Execute the following
steps to select a template for use:
1. Activate the Templates widget by clicking on the Templates widget button.
2. Choose a template group from the drop-down menu.
3. Click on a template choice to choose a template from the list.
4. Define a substitution atom by clicking on the preferred atom in the main structure panel. The substi-
tution point will overlap with the atom used as the growth position.
Note this will not place the template into the document; please see the following sections for template
placement instructions.
Placing a Template
To place a template, set up a template as described above and choose a substitution atom in the Templates
widget. Then hover over the atom in the document to which you are attaching the template and press and
hold the mouse down. A preview of the template will be depicted as in Figure 3.11.
Drag the mouse and use the techniques discussed in the following subsections to place the template in the
preferred orientation. Then release the mouse to set the template.
Optimize Zone
The Optimize Zone can be used to optimize template placement as described in the Bonds section of this
chapter.
By default, fixed widths and fixed angles are enforced when drawing structures. To place a template within
these constraints, hover over an atom and press and hold the mouse down with a template selected. You will
see the Optimize Zone appear. Drag the mouse pointer out of the Optimize Zone. The new template
placement will now orient towards the mouse pointer.
The default fixed length is defined by the Bond Length visual specification in the Preferences window
under the Visuals tab under the Bonds subtab. Angles are fixed at 30◦ intervals starting at 0◦ .
You can set whether fixed lengths and/or fixed angles are on by default in the Preferences window under
the General tab.
72 Chapter 3: DRAWING CHEMICAL STRUCTURES
When placing templates outside of the Optimize Zone, fixed lengths will be enforced. To break from fixed
lengths, hold down the shift key while placing the template.
You can turn off fixed lengths in the Preferences window under the General tab. In this case, the shift
key will then enforce fixed lengths.
When placing templates outside of the Optimize Zone, fixed angles will be enforced. To break from fixed
angles, hold down the alt key while placing the template.
You can turn off fixed angles in the Preferences window under the General tab. In this case, the alt
key will then enforce fixed angles.
When placing templates outside of the Optimize Zone, fixed angles and fixed lengths will be enforced. To
break from fixed lengths and fixed angles at the same time, hold down both the shift and alt keys while
placing the template.
You can turn off fixed lengths and fixed angles in the Preferences window under the General tab. In this
case, holding the shift and alt keys will then enforce fixed lengths and angles.
To save a template into the Templates widget library, execute the following steps:
1. Draw the desired template on the Doodle Board.
2. Select the template with the selection tools discussed in CONTENT MANAGEMENT TOOLS. Only
a single structure can be used in any template.
3. Right-click after selecting the structure.
4. Press the Add Fragment as Template. . . menu item to pop up the Add Template window.
5. Type in a name for the template in the Template Name text field.
6. Choose a template group to add the template to using the drop down selection. You can create a new
template group using the Add Group button.
7. Click the Done button to add the template.
All of your templates are stored in the templates folder in the ChemDoodleSettings folder located in
your operating system’s standard Documents folder. You may distribute your template groups to other
ChemDoodle users or place third party template groups in this folder to use them in ChemDoodle. If
ChemDoodle is open when manually placing template groups in the templates folder, you must close and
then restart ChemDoodle for them to be registered.
Chapter 3: DRAWING CHEMICAL STRUCTURES 73
ATTRIBUTES
Attributes are special objects in ChemDoodle that are associated with other chemical objects. These include
charges, symbols and ids on atoms and ids on bonds. They are both spatially and semantically linked to the
chemical object that they describe. Any number of attributes can be added to a single chemical object.
In addition to the standard attributes provided in ChemDoodle, you can add your own text-based attributes
as shown in Figure 3.12.
Figure 3.12: Nitrogen atom attribute with “attribute” as the display text.
Adding Attributes
Hovering Attributes
You can hover attributes by using any of the selection tools. First, make sure the current selection is empty
and then move the mouse cursor close to the center of the attribute so that it is closer to the attribute
than any other chemical objects. The attribute will then be defined as hovered and an amber circle will be
rendered on top of it as shown in Figure 3.13.
To help identify which object the attribute describes, a transparent amber circle is drawn over that object
(the nitrogen atom in Figure 3.13).
74 Chapter 3: DRAWING CHEMICAL STRUCTURES
Selecting Attributes
Attributes can only be selected when using the selection tools discussed in CONTENT MANAGEMENT
TOOLS. To select attributes, first hover them and then press and hold the mouse down. The amber circle
indicating hovering will turn into a blue circle as shown in Figure 3.14.
Editing Attributes
The display text and names of custom attributes can be edited at any time by executing the following steps:
1. Hover the attribute to be edited.
2. Right-click on the hovered attribute.
3. Press the Format Attribute. . . menu item. In the visual specifications window that appears, change
the Name and Display text to the new values.
4. Click the Done button to set the new text values.
Moving Attributes
Removing Attributes
To remove an attribute, use the Eraser tool and click on the hovered symbol or hover the symbol with the
selection tools and press the delete or backspace key.
Chapter 3: DRAWING CHEMICAL STRUCTURES 75
CHARGES
Charges are attributes that can be associated with any atoms as shown in Figure 3.15. Both positive and
negative values can be used.
Adding Charges
Removing Charges
Circles can be placed around charges globally for the document, or individually for the charge attribute.
Circles will only surround the charge symbol, and not any magnitude numbers.
To add circles around all charges in the document, execute the following steps:
1. Select all the content in the document.
2. In the Preferences window, select the Visuals tab and then select the Attributes subtab.
3. In the Charges section, enable the Surround with a Circle option.
To add a circle to an individual charge attribute, execute the following steps:
1. Hover the charge that you would like to surround with a circle with a selection tool while nothing is
selected.
2. Right-click on the hovered charge and select the Format Charge. . . menu item, or press the comma
, key.
SYMBOLS
Symbols are standard types of atom decorations that can be associated with any atoms such as the radical
cation symbol shown in Figure 3.16.
Adding Symbols
Removing Symbols
To remove a symbol, use the Eraser tool and click on the hovered symbol or hover the symbol with the
selection tools and press the delete or backspace key.
ISOTOPES
Mass numbers can be associated with atoms with element symbols as their label to designate isotopes. All
mass numbers are displayed in superscript format to the left of element symbols as shown in Figure 3.17.
If you later change an atom’s label and there is a mass number associated with that atom, then the mass
number will be removed.
To set a published mass number to an elemental atom, execute the following steps:
1. Hover the atom with the mass number to be set.
2. Right-click on the hovered atom.
3. Expand the Mass Number submenu.
4. Press any of the listed values to set the mass number of the isotope.
78 Chapter 3: DRAWING CHEMICAL STRUCTURES
To set an arbitrary mass number to an element atom, execute the following steps:
1. Hover the atom with the mass number to be set.
2. Right-click on the hovered atom.
3. Expand the Mass Number submenu.
4. Press the Other. . . menu item.
5. Type in an integer value into the text field that appears.
6. Click the Accept button to set the mass number.
ORBITALS
2D graphics for various orbital shapes can be placed directly into the document or attached onto structures.
Use them to show more detailed chemical figures. Each orbital shape has several different shading and fill
styles.
The following orbital types are provided:
Atomic fxz2 |xy2 |x(x2 −3y2 )|y(3x2 −y2 ) orbitals Bonding π orbitals
Chapter 3: DRAWING CHEMICAL STRUCTURES 79
Orbitals are defined by two anchor points as shown in Figure 3.18. The first anchor point defines the center
of the orbital while the second anchor point defines the extent of the orbital.
To place orbitals at non-fixed lengths or angles, hold down the alt key while dragging the mouse when
defining the orbital to break from the fixed lengths and angle orientations.
To place orbitals oriented vertically or horizontally, hold down the shift key while dragging the mouse when
defining the orbital. The orbital preview will then automatically orient vertically or horizontally depending
on the angle from the start point to the current mouse cursor position.
80 Chapter 3: DRAWING CHEMICAL STRUCTURES
Moving Orbitals
To move orbitals, use a selection tool, either the lasso or the rectangular marquee. Make sure that no content
is currently selected by emptying the current selection. Execute the following steps:
1. Hover the mouse pointer over the orbital so an open hand mouse cursor appears and the rectangle
anchor points are drawn as shown in Figure 3.18 above.
2. Press and hold the mouse down and drag without selecting an anchor point to move the orbital.
3. Release the mouse to finish the edit.
Resizing Orbitals
To resize orbitals, use a selection tool, either the lasso or the rectangular marquee. Make sure that no content
is currently selected by emptying the current selection. Execute the following steps:
1. Hover the mouse pointer over the orbital so an open hand mouse cursor appears and the rectangle
anchor points are drawn as shown in Figure 3.18 above.
2. Move the mouse pointer over one of the two end anchor points so that anchor point is filled in with an
amber color.
3. Press the mouse down so the anchor point is filled with a blue color.
4. Drag the anchor point to resize the orbital.
5. Release the mouse to finish the resize action.
Removing Orbitals
Contents
WIDGET WINDOWS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
WIDGET EXPANSION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
WIDGET LIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
WIDGET MENU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
AVAILABLE WIDGETS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
ELEMENTAL ANALYSIS WIDGET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
HISTORY WIDGET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
LINE NOTATION PAD WIDGET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
MOLGRABBER WIDGET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Directing to the Online Database . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Database Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
ChemExper Disclaimer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
ChemSpider Disclaimer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
PubChem User Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
MULTIPLET TOOL WIDGET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Simulating Multiplets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Setting up the Multiplet Figure . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Editing Multiplets from the Doodle Board . . . . . . . . . . . . . . . . . . . . . . 98
Memory and Runtime Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
NMR SIGNALSEEK WIDGET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Simulating NMR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Analyzing the Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
How NMR is Simulated . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
PROPERTIES WIDGET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
SEARCH WIDGET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Search Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
STATISTICS WIDGET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Chapter 4: WIDGETS 83
Widgets are auxiliary applications that provide added functionality to ChemDoodle. Each
widget has its own unique interface contained within a widget window.
WIDGET WINDOWS
A widget window is a simple, movable and resizable window that contains the widget interface and two
buttons in its top bar for maximizing/unmaximizing the widget and closing the widget as shown in Figure 4.1.
The top bar contains a button for maximizing the widget to fill the entire ChemDoodle application window.
Clicking on this button again when the widget is maximized will return it to its original size. You can also
use the drag anchors to resize widgets.
Clicking on the close button in the top bar will close the widget.
To move widgets, click and drag the top bar.
The entire widget interface is presented in the rest of the widget window below the title, which is displayed
below the top bar.
5 Widget window decorations (drag anchor, maximize/unmaximize button) have a slightly different appearance
on Mac OS X.
Chapter 4: WIDGETS 85
WIDGET EXPANSION
Some widgets are initially in a collapsed state. Each collapsed widget will have some method to expand it.
For example, the MolGrabber widget is initially collapsed. Type a search term in the text field and press
the enter key to expand it as shown in Figure 4.2. Every collapsible widget will also have a collapse button
to collapse it.
WIDGET LIST
There are currently 12 widgets provided in ChemDoodle: Brief descriptions are given in Table 4.6.
In addition to selecting widgets, icons may also perform additional functions. For instance, if you drag a
structure onto the Line Notation Pad widget icon, that structure will be loaded into the widget. Infor-
mation on these additional functions is provided in the subsequent sections of this chapter.
86 Chapter 4: WIDGETS
Name Description
Elemental Analysis Calculates molecular masses, elemental analysis and isotopic dis-
tributions for structures
History Provides full access to the undo/redo queue
Line Notation Pad Generates and parses line notations and will also correct your
input
MolGrabber Search databases for chemical structures
Multiplet Tool Simulate multiplets
NMR SignalSeek Simulate nuclear magnetic resonance and associate peaks to nuclei
as well as provide more thorough information about the spectrum
and simulation
Properties Calculates molecular descriptors
Search Search your computer and attached storage devices for chemical
structures
Statistics Displays document and drawing statistics
Symbols Quick access to chemically relevant symbols and the full unicode
range
Templates Organizes chemical structure templates for your use
TLC Canvas Draw thin layer chromatography plates
By default, the Doodle Statistics, History and MolGrabber widgets are shown. You can toggle which
widgets are shown by using the Widget menu or the Widget Tray.
Chapter 4: WIDGETS 87
WIDGET MENU
The Widget menu is a submenu under the Window menu and appears as shown in Figure 4.3.
Clicking on an unchecked menu item will show the corresponding widget. Clicking a checked menu item will
hide the corresponding widget.
88 Chapter 4: WIDGETS
AVAILABLE WIDGETS
Purpose
This widget calculates formulas and masses, performs elemental analysis, and simulates isotopic distributions.
Interface
The interface consists of four sections (see Figure 4.4). From top to bottom, the first section displays the
molecular formula, molecular mass and monoisotopic mass. The second section shows the elemental analysis;
each element shown with its percent composition. The third section lists the isotopic distribution, with mass
values and intensities. The fourth section shows an interactive spectrum of the isotopic distribution. The
Decimals component at the top will allow you to control the resolution of the calculations.
Chapter 4: WIDGETS 89
HISTORY WIDGET
Purpose
The History widget is an advanced undo/redo tool and provides access to the complete log of all actions
performed since the document was created or opened. Click on a given action to jump back and forth to the
document state when that action was performed.
Interface
The interface consists of a single list in a scrolling pane as shown in Figure 4.5. The current state of the
document is signified with a green highlight over the left side of the latest action. Any actions performed
earlier are undecorated and listed above the current state, while any actions that have been undone are
highlighted in an amber color and are listed below the current state. By clicking on any actions above the
current state, the document will revert back to that action, undoing all actions between the current state
and the action clicked. By clicking on any actions below the current state, the document will redo all actions
between the current state and the action clicked. Therefore, the History widget allows you to easily revert
and restore any actions performed during the edit history of the document.
90 Chapter 4: WIDGETS
Purpose
The Line Notation Pad widget can interpret and generate SMILES, SLN, InChI and ROSDAL chemical
line notation formats as well as convert between them with ease.
Interface
The interface for the Line Notation Pad widget is shown in Figure 4.6. The interface, from top to bottom,
consists of a Format drop-down menu, a String text field for inputting and outputting the line notation,
a column of buttons for performing various functions, the main structure panel and the input analysis list.
Initially, the interface is collapsed. Drag a structure onto the Line Notation Pad widget button or type
in a line notation in the String text field and press the enter key to expand it.
From the Format drop-down menu you can choose any of the line notations available to set the current
line notation format. If content is present in the text field, then that content will be converted into the new
format.
The String text field will display the generated line notation when a structure is dropped on the main
structure panel or the Line Notation Pad widget button. You may also explicitly type your line notation
in this component and then press the enter key or the View in 2D button to interpret it and display the
corresponding structure in the main structure panel.
The buttons to the left of the main structure panel perform functions as described in Table 4.7 below.
Chapter 4: WIDGETS 91
Search Begins a search query using the search term input into the
Search text field and restricts it to matching the field selected
in the Source drop-down selections.
Add to the Doodle Board Places the current structure in the main structure panel onto the
current document. Alternatively, you can click on the main
structure panel and drag onto the document to place it.
Choose Start Point Allows you to click on an atom in the main structure panel to
denote it as the start point for the generation of the line
notation. If the line notation format is canonical or if such an
option is set, then setting the starting point will have no effect.
Copy to System Clipboard Copies the current text in the String text field onto the system
as Text clipboard as plain text. For MIME-type specific clipboard
contents, set the appropriate options in the Advanced tab of
the Preferences window, then copy from the Doodle Board.
Clear
Clears the current contents and collapses the widget.
The main structure panel displays the structure associated with the line notation in the String text field.
You can generate a line notation for a structure on the Doodle Board by selecting the structure and then
by clicking and dragging that structure onto the main structure panel of the Line Notation Pad widget.
Structures from the main drawing panel can also be dragged onto the Doodle Board.
The final component of the interface is a scrollable list. Any errors or warnings perceived when interpreting
the line notation will be listed here. Use these suggestions to help correct malformed strings
92 Chapter 4: WIDGETS
MOLGRABBER WIDGET
Purpose
MolGrabber is a web application for obtaining pre-drawn molecular structures and properties from online
databases. The interface is shown in Figure 4.7. Currently, MolGrabber interfaces with the following
databases:
• ChemExper - http://www.chemexper.com/
• ChemSpider - http://www.chemspider.com/
• PubChem - http://pubchem.ncbi.nlm.nih.gov/
Interface
The interface for the MolGrabber widget consists of, from top to bottom, buttons for performing functions,
a Search text field for inputting a search term, a Source drop-down selection for choosing the database
to search through followed by a second drop-down selection to restrict the search, a progress spinner to the
right of those three components to notify you that a search is currently being performed, a main structure
panel with a button column to the left of it for performing various functions, a scrollable list to hold all
search results and, at the bottom, statistics about the search result with traversal buttons for navigating
through large numbers of results.
Initially, the interface is collapsed. Type a search term in the Search text field and press the enter key
to expand it. This can be any search term that the associated database can handle. After pressing the
Chapter 4: WIDGETS 93
return key, the progress spinner will activate to notify you that it is performing the search. After the search
completes, the progress spinner will deactivate, the results will populate the result list, and the first result
will appear in the main structure panel.
The Source drop-down selection can be used to select which database to search. The second drop-down
selection will restrict your search to a specific data field type supported by the database. Choose a specific
field and the search will only match results in that field for the input search term.
The buttons on the top of the widget perform functions as described in Table 4.8 below.
Search Begins a search query using the search term input into the
Search text field and restricts it to matching the field selected
in the Source drop-down selections.
Add to the Doodle Board Places the current structure in the main structure panel onto the
current document. Alternatively, you can click on the main
structure panel and drag onto the document to place it.
Show/Hide Hydrogen Adds and removes hydrogen atoms from the structure in the
main structure panel based on the coordinates for the hydrogen
atoms provided by the database. Some databases may not
provide hydrogen coordinates and in those cases this function
will have no effect.
Show Associated Data Displays all associated database data for the structure displayed
in the main structure panel.
Clear
Clears the current contents and collapses the widget.
The main structure panel will display the structure for the selected result. Once the desired structure is
displayed on the main structure panel, it can be dragged and dropped onto the Doodle Board.
Below the main structure panel is the search result list. This list will display a maximum of 20 results with
the following format for each entry:
Name (Molecular Formula) [Molecular Mass amu]
Click on any of the items in the list to display them in the main structure panel.
Below the search results is a label to inform you of which search results are presented in the current result
set along with traversal buttons to navigate through large numbers of results. Press the left and right arrows
to view the previous 20 and next 20 results respectively. If there are no previous or no next results, then the
corresponding arrow will be disabled.
ChemSpider does not currently support pagination of results, so care must be taken with
generic queries as they may return many, many results and may take a long time to complete.
94 Chapter 4: WIDGETS
After a molecule has been loaded, clicking on the Show Associated Data button will list associated data
from that database. The top item will be the specific database id as a hyperlink. The link will open up your
default browser to the selected database’s page for the current result.
Database Notes
ChemExper Disclaimer
http://www.chemexper.com/’main=ccd/disclaimer.html
***** USE AT YOUR OWN RISK *****
ChemExper compiles chemical information from many sources.
THIS DATA IS PROVIDED “AS IS” AND IN NO EVENT SHALL CHEMEXPER BE LIABLE
FOR ANY DAMAGES, INCLUDING, WITHOUT LIMITATION, DAMAGES RESULTING
FROM LOST DATA OR LOST PROFITS OR REVENUE, THE COSTS OF RECOVERING
SUCH DATA, CLAIMS BY THIRD PARTIES OR FOR OTHER SIMILAR COSTS, OR ANY
SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF THE
USE OF THE DATA.
The accuracy or reliability of the data is not guaranteed or warranted in any way and the Providers dis-
claim liability of any kind whatsoever, including, without limitation, liability for quality, performance, mer-
chantability and fitness for a particular purpose arising out of the use, or inability to use the data.
ChemSpider Disclaimer
http://www.chemspider.com/Disclaimer.aspx
General
The ChemSpider website is maintained by The Royal Society of Chemistry on behalf of its wholly owned
subsidiary RSC Worldwide Ltd. RSC Worldwide Ltd does not warrant or assume any legal liability or
responsibility for the accuracy, completeness, or usefulness of any documents, data, software, apparatus,
product, process, or other information on the ChemSpider website. You should not rely on any information
on the website for any assessment of the risks of any specific experiment, procedure or process that you wish
to carry out; you should always carry out your own risk assessment for such purposes. The information on
this website may not be correct or appropriate for local regulations, legal codes, practices or policies. The
information may be out of date. RSC Worldwide Ltd takes no responsibility for any injury, loss, or damage
caused in any manner whatsoever by the use of the information on this website.
Some ChemSpider webpages link to pages on other websites, for the convenience of users. RSC Worldwide
Ltd is not responsible for the availability of content on these webpages. Nor does it endorse or warrant the
services, products or information offered on these other pages, unless explicitly stated.
For site security purposes software programs and algorithms are used to monitor traffic and to identify
unauthorized attempts to upload or change information or otherwise cause damage to the ChemSpider
Chapter 4: WIDGETS 95
service. In the event of unauthorized activities utilizing information on the ChemSpider website information
from these sources may be used to help identify an individual for prosecution.
Data
The data on the ChemSpider website are sourced from a number of contributors and collaborators. The
majority of data were originally sourced from the NCBI-PubChem website and are made available under
the explicit statements and disclaimers provided by National Center for Biotechnology Information (NCBI).
NCBI places no restrictions on the use or distribution of the data contained within their database. RSC
Worldwide Ltd has abided by the assumptions of NCBI. These are as follows: “While some submitters of
the original data (or the country of origin of such data) may claim patent, copyright, or other intellectual
property rights in all or a portion of the data (that has been submitted), NCBI is not in a position to assess
the validity of such claims and, therefore, cannot provide comment or unrestricted permission concerning the
use, copying, or distribution of the information contained in the molecular databases.” In this regard should
any contributors to the NCBIPubChem database wish to have their data removed from the ChemSpider
website please send a detailed request to [email protected].
Data on ChemSpider, including structures and spectra, are sourced also from individuals. In depositing
these data to the ChemSpider website, these individuals undertake that they have the rights to do so, and
that the rights do not reside with any third party.
http://eutils.ncbi.nlm.nih.gov/entrez/query/static/eutils_help.html
Do not overload NCBI’s systems. Users intending to send numerous queries and/or retrieve large numbers
of records from Entrez should comply with the following:
• Run retrieval scripts on weekends or between 9 pm and 5 am Eastern Time weekdays for any series of
more than 100 requests.
• NCBI’s Disclaimer and Copyright notice must be evident to users of your service. NLM does not claim
the copyright on the abstracts in PubMed; however, journal publishers or authors may. NLM provides
no legal advice concerning distribution of copyrighted materials, consult your legal counsel.
96 Chapter 4: WIDGETS
Purpose
The Multiplet Tool widget is a comprehensive tool for generating multiplet trees, simulating signals and
producing their figures. It is perfectly suited for simulating nuclear magnetic resonance (NMR) or electron
paramagnetic resonance (EPR, aka ESR) signals. The interface is shown in Figure 4.8.
Interface
The interface for the Multiplet Tool widget consists of, from top to bottom, a row of buttons for performing
various functions and the main multiplet panel.
Use the buttons to set up the simulation and layout of the multiplet. The buttons perform functions as
described in Table 4.9.
Chapter 4: WIDGETS 97
Add to the Doodle Board Places the current multiplet from the main multiplet panel into
the current document.
Input Parameters Pops up a window for you to define parameters for the
simulation including the number of neighboring nuclei, their spin
and coupling magnitude.
Real-Time Sliders Provides a window with sliders for each parameter. Changing
the sliders will affect the simulation in real time.
Settings Displays a window to define how the simulation is performed
and how the multiplet figure is laid out and displayed.
After completing your simulation, drag and drop the multiplet from the main multiplet panel onto the
Doodle Board.
Simulating Multiplets
To simulate multiplets, define the parameters in the Input Parameters window that appears after clicking
the Input Parameters button and then click the Calculate button as shown in Figure 4.9. Press the reset
button in this window to reset all parameters.
To tweak the input parameters to analyze their effect on the simulation, use the Real-Time Sliders button
and change the values slowly in the window that appears as shown in Figure 4.10. When you are satisfied
with the simulation, press the Done button. The Reset button will reset the parameters to their initial
values before the window was opened.
To define how the simulation is performed and how the multiplet figure is displayed, click on the Settings
button to display the Multiplet Settings window (see Figure 4.11).
To edit a multiplet from the Doodle Board, select it and then drag and drop it onto the Multiplet Tool
widget button or onto the main multiplet panel. A copy will be made and can be edited using the Multiplet
Tool widget. Add this new edited multiplet to the Doodle Board and delete the old one.
A nucleus of any spin may be used, including hypothetical spins, however more complex simulations require
more memory and processor power leading to longer runtimes. Some extremely complex simulations may
cause memory issues.
Chapter 4: WIDGETS 99
Purpose
The NMR SignalSeek widget simulates 1 H and 13 C nuclear magnetic resonance and also associates peaks
with nuclei. Full information about each simulation is provided for in-depth analysis.
Interface
The interface for the NMR SignalSeek widget is shown in Figure 4.12. The interface consists of the main
structure panel above which are two buttons for performing various functions, and to the right is a set of
panels for displaying the simulated NMR spectra with 13 C displayed on top and 1 H displayed on the bottom.
The main structure panel displays the structure being analyzed and is interactive. The spectra are also
interactive and display the simulation results. Use the buttons to set up the simulation and copy content to
the Doodle Board. The buttons perform functions as described in Table 4.10.
Simulating NMR
To simulate NMR spectra for a structure, drag and drop that structure from the Doodle Board onto the
NMR SignalSeek widget button or the main structure panel. The 1 H and 13 C NMR spectra are instantly
generated and displayed.
All variables for the simulation can be customized. To define the variables, click on the Settings button to
display a window containing the parameters, as shown in Figure 4.13.
When you are finished defining the variables, click the Simulate button to recalculate the spectra. Adjust
these parameters to match an experimental spectrum for correlated figures on the Doodle Board. Settings
include:
• Pulse Frequency - The spectrum resolution. The value is appropriate for 1 H NMR. 13 C NMR
will be simulated to a resolution of a quarter of this value to remain consistent with experimental
spectrometers.
• Solvent - Choose a solvent. Splitting is fully calculated with the appropriate spin of the nuclei
(Deuterium has a spin of 1 and you will see this splitting correctly in the solvent peaks).
Chapter 4: WIDGETS 101
The spectra are completely interactive. You can easily change the view of the spectrum by clicking and
dragging to zoom in on the x-axis. Double clicking on the spectrum will revert it to the full view. Scrolling
will change the scale of the y-axis.
Peaks and nuclei are hoverable. Hovering over a peak will highlight the corresponding nuclei and vice versa.
The chemical shift of the nuclei is displayed above the structure in the main structure panel.
Clicking on a highlighted peak or nuclei set will display further data from the simulation, including the shift
prediction, splitting nuclei and j-constant predictions as shown in Figure 4.14.
The NMR SignalSeek widget is initially small to conserve space. But as with all widgets, you can resize
or maximize them if you desire more interaction space.
The simulations in the NMR SignalSeek widget are based on empirical algorithms, with a database of
incremental constants compiled from publications and some unpublished work. These references are listed
by clicking the References menu item in the Help menu. Further information on the algorithms used to
simulate NMR is provided in APPENDIX: HOW NMR IS SIMULATED .
102 Chapter 4: WIDGETS
PROPERTIES WIDGET
Purpose
The Properties widget calculates and displays descriptors for molecules. There are two unique interfaces
displayed by the Properties widget depending on the situation. If and only if a single molecule is being
drawn, a table will be displayed. Otherwise, a drop-down tree will be presented to show data for each
of the selected molecules. The Properties widget will automatically update to reflect any changes if the
Auto-update box is checked. The interface displayed when a single molecule is being edited is shown in
Figure 4.15(a), and the interface displayed when multiple molecules are selected is shown in Figure 4.15(b).
Interface
The interface consists of a checkbox and button at the top that control when the widget updates and the
data component at the bottom which displays a table or drop-down tree depending on the situation.
The table is non-interactive and only displays the most important information. For additional descriptors,
select the molecule to display the organized tree. To use the tree, click the arrow to the left of each item, or
double click on the item to expand it.
When the Auto-update checkbox is selected, the Properties widget will refresh automatically when any
content is changed. Deselect the checkbox to improve drawing performance when handling large molecules.
When the Auto-update checkbox is deselected, the Update button will be enabled to manually control
when the widget refreshes.
Chapter 4: WIDGETS 103
Currently, the Properties widget calculates the following properties for each molecule:
• Molecular Formula
– Counts
∗ Atoms
∗ Bonds
∗ Rings
· Frèrejacque Number
· All Rings
∗ Degree of Unsaturation
∗ Wiener Index
– Calculations
∗ Molar Refractivity
∗ XlogP v2.0
∗ Mass
· Molecular
· Monoisotopic
· Elemental Composition
To copy content from the Properties widget, right-click on any item and choose the Copy menu item.
It may take quite a few clicks to access information through the Properties widget. For quicker access to
all molecular descriptors, use the Descriptors submenu of the Structure menu.
104 Chapter 4: WIDGETS
SEARCH WIDGET
Purpose
The Search widget allows you to search your hard drive and any attached storage devices for chemical
structures. The Search widget recognizes all formats that ChemDoodle understands, so you will be able to
find the old files you thought you lost a long time ago and edit them in ChemDoodle.
Interface
The Search widget interface is shown in Figure 4.16. The interface consists of, from top to bottom, a Folder
button to select the root directory of the search, Match and Multiple options to define how the search
is performed, a small drop panel to drop the structures to be searched for and to notify you that a search
is currently being performed, a column of buttons for various functions with a main structure panel to the
right of them, a list of search results and then labels to notify you of search progress.
The top section will allow you to select a root folder for the search. Click on the Folder button and use
the file chooser that appears to select a folder. Be as exclusive as possible when choosing a root folder, as
searching your entire hard drive can take a very long time and may cause memory issues. The Match and
Multiple options will affect how the search is performed. Setting Match to Entire will guarantee that all
results are exact matches of the query structures, while selecting Substructure will match any structures
where the query structures are matched exactly or contained within larger structures. Setting Multiple to
Chapter 4: WIDGETS 105
AND will ensure that all query structures are matched in a file for that file to be considered a result, while
selecting OR will allow any matched query structure to qualify the file as a result.
Initially, the interface is collapsed. Drag and drop a structure or group of structures from the Doodle
Board onto the small drop panel or onto the Search widget button to expand it and set the query structure
content.
The buttons to the left of the main structure panel perform functions as described in the Table 4.11 below.
Search Begins the search query using the query structure(s) dropped
onto the Search widget button with the specified search options.
Open
Opens the currently selected result on the Doodle Board.
Add to the Doodle Board Places the current structure in the main structure panel onto the
current document. Alternatively, you can click on the main
structure panel and drag onto the document to place it.
Clear
Clears the current contents and collapses the widget.
While the search is being performed, a pulsing stop sign will become visible on top of the small drop-down
panel to notify you of search progress. Clicking on the stop sign will terminate the search. At the bottom
of the interface are two labels. The first label names the file currently being searched, and will display
Finished! when completed. The second label displays statistics about the files searched from the onset of
the search. The statistics have the following format:
Be careful with the search! Searching large numbers of files may cause ChemDoodle to run out of memory,
causing ChemDoodle to respond slowly. Choose the root search folder and the search settings described in
the next section with care.
Once the search is completed, all matched files will be listed in the results list. Click on any result to view
all the structures in that file, one at a time, in the main structure panel. All hits are highlighted in red. If a
file contains multiple structures, clicking the gray arrows that appear to the left and right of the structure
will allow you to browse through them. The total number of structures in the file is noted at the bottom
left of the main structure panel. Once you have found the structure you were looking for, drag and drop the
structure from the main structure panel onto the Doodle Board. You can also use the Open button to
open the entire file on the Doodle Board.
106 Chapter 4: WIDGETS
Search Settings
Search parameters can be defined by clicking on the Settings button. A window with the options will appear
as shown in Figure 4.17.
1. Search File Size Restriction - This value determines the maximum file size that the Search widget
will include in its search, to avoid memory issues.
2. Maximum Number of Search Results - This value will control the maximum number of search
results. The search will continue until all the files in the selected root search folder are visited or when
this maximum result value is reached. Keeping it low and providing smaller root search folders will
avoid runtime and memory issues.
3. Exclude PDB Files - Many times, PDB files are very large and contain molecular dynamics trajec-
tories or Monte Carlo distributions. To avoid all of these files and the subsequent runtime and memory
issues, keep this option selected. If you need to search through PDB files, turn this option off.
STATISTICS WIDGET
Purpose
The Statistics widget will display information about the current document and hovered or selected items.
Use it to help with drawing and placement tasks.
Interface
The interface is separated into three sections as shown in Figure 4.18. The top section displays information
about the document, the middle section displays information about the content, and the final section displays
specific information about hovered or selected objects.
SYMBOLS WIDGET
Purpose
The Symbols widget is a complement to the Labels toolbar. This widget contains an abbreviation library,
a periodic table of elements, arrows, Greek letters and many other symbols. A few selected tabs are shown
in Figures 4.19.
Interface
The content in the Symbols widget is small and may be difficult to read. As can be seen in Figure 4.20,
hovering over any symbol will show a larger preview at the top left hand corner of the widget. Hovering for
a few seconds will also display a tooltip description.
108 Chapter 4: WIDGETS
When abbreviations or elements are chosen, you may modify atoms as described in the labels section. Other
symbols, such as arrows may not be used directly as atom labels. However, you can open up an atom label
text field, and then input the symbol. If you are modifying any text component, clicked symbols will be
inserted into the component’s content.
If you set an atom’s label to one that is not recognized or parsed by ChemDoodle, an unrecognized warning
will appear. You may dismiss this warning or edit the current list of abbreviations to allow unrecognized
tokens by selecting the Add New. . . menu item in the Structure menu in the Abbreviations submenu.
All possible symbols available are accessible in the Symbols widget, even if they are not displayed immedi-
ately in the tab sets. click the Unicode Character Selection button at the bottom of the widget to view
the unicode character selector shown in Figure 4.21.
Chapter 4: WIDGETS 109
Using hex, you can traverse the entire unicode range and easily insert any desired symbols into text compo-
nents. Note that not all fonts will have character glyphs assigned to each hex value. In these cases, a blank
space or empty rectangle will appear in your text component and in the unsupported symbol button.
Some programs use the Symbol font to display symbols. This is an archaic solution and the
standard is to now use unicode characters, which ChemDoodle fully supports. ChemDoodle
will try to recognize and correct such cases when reading in files from other programs.
110 Chapter 4: WIDGETS
TEMPLATES WIDGET
Purpose
The Templates widget organizes your templates and allows you to easily use them. The interface is shown
in Figure 4.22.
Interface
The interface consists of, from top to bottom, a main structure panel, a drop down selection for selecting a
template group and a scrollable list for selecting a template.
The main structure panel displays the selected template. An atom can be set to be the substitution point
by clicking on it. The substitution point is the atom that will be overlapped with the atom the template is
connected to. Note that selecting the substitution point does not place the template into the document, you
will still need to follow the directions in DRAWING CHEMICAL STRUCTURES to use the template.
The template group drop-down selection will allow you to select a group of templates to browse. After
selecting a template group, the template list will populate with templates from that group. Click on a
Chapter 4: WIDGETS 111
Using Templates
Drawing with templates and creating templates is discussed in detail in DRAWING CHEMICAL STRUC-
TURES.
Purpose
The TLC Canvas widget provides a tool for creating graphics of thin-layer chromatography (TLC) plates.
The interface is shown in Figure 4.23.
112 Chapter 4: WIDGETS
Interface
The interface consists of, from left to right, a column of buttons for spot types, the main TLC panel for
drawing the TLC plate. Above them both are a row of buttons for performing various functions.
The top button in the spot type column sets the color of spots. Beneath the color button are six different
shapes of spots:
Click on any of the spot types to set the drawing mode to place the spot.
Each spot button is a group button. Expand the group button for more spot styles. For each spot there are
three spot styles:
The main TLC panel contains the TLC plate being drawn. You can edit it using the controls to the right.
When finished editing the TLC plate, use the Add to Doodle Board button to place it on the Doodle
Board.
The topmost button column contains function buttons to control how to edit the TLC plate. The buttons
perform functions as described in the table below.
Chapter 4: WIDGETS 113
Add to the Doodle Board Places the current TLC plate in the main TLC panel onto the
current document.
Settings Pops up a window to edit the visual specifications of the TLC
plate.
Move Allows you to translate spots along their lanes and allows you to
move the origin and solvent front.
Resize Spots Displays the anchor points for all spots and allows you to click
and drag them to alter spot shapes.
Delete Allows you to remove spots by clicking on them and allow you to
delete lanes by clicking on the lane tick at the origin.
Clear Removes all spots, leaves a single lane, and resets the origin and
solvent front.
There are 13 buttons associated with the TLC Canvas. The controls on the left are the simplest. The top
button is the color of the spots; click it to choose a different color. The rest of the buttons in that column
correspond to spot shapes. These are the compact, expanded, trailing, widened, crescent and custom spots,
in that order. Click on a spot button, then hover over the TLC plate for a preview and Rf calculation.
Once you are satisfied with a location, click to place the spot. You can create new lanes by placing spots in
between the existing lanes.
These spot buttons are group buttons and more spot styles will appear when hovered. All of the spots can
be initialized with a solid, hollow or gradient style. The gradient styled spots most closely represent actual
spots.
Using the Move button, you hover over spots to highlight them, and then click and drag to move them
along their lanes. Rf values are displayed while you move spots. You may also click and drag the origin and
solvent front to move them, preserving Rf values.
When spots are hovered, you can right click on them to open a popup menu with the following functions:
• Duplicate Spot - Will produce a duplicate spot of the hovered spot, underneath the hovered spot in
the same lane.
The Format Spot window will provide several options for precisely defining its color, style, display settings
and position as shown in Figure 4.24.
114 Chapter 4: WIDGETS
To resize and reshape spots on the TLC plate, use the Resize Spots button. Hover over the control points
that appear, and then click and drag to move them. All spots except the custom spot are defined by 4
control points. You may move all four to create different shapes. The custom spot is unique and is defined
by eight control points. You may use custom spots to create much more complicated shapes.
To remove spots and lanes, use the Delete button. Hover over spots to highlight them, then click to remove
them. You may delete a lane by clicking its lane tick at the origin. Deleting a lane will also delete its
contained spots. To clear and reset the entire TLC plate, click the Clear button.
To edit a TLC plate from the Doodle Board, select it and then drag and drop it onto the TLC Canvas
widget button or onto the main TLC panel. A copy will be made and can be edited using the TLC Canvas
widget. Add this new edited TLC plate to the Doodle Board and delete the old one.
CHAPTER 5
Shapes
116 Chapter 5: SHAPES
Contents
OVERVIEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
ANCHORS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
CONTROL ANCHORS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
CORNER/EDGE ANCHORS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
LINES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
DRAWING LINES AT FIXED ANGLES . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
DRAWING LINES AT NON-FIXED ANGLES . . . . . . . . . . . . . . . . . . . . . . . . 119
FORCING LINES TO BE DRAWN VERTICALLY AND HORIZONTALLY . . . . . . . 120
MOVING LINES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
RESIZING LINES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
REMOVING LINES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
ARCS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
DRAWING ARCS AT FIXED ANGLES . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
DRAWING ARCS AT NON-FIXED ANGLES . . . . . . . . . . . . . . . . . . . . . . . . 121
FORCING ARCS TO BE DRAWN VERTICALLY AND HORIZONTALLY . . . . . . . 121
MOVING ARCS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
RESIZING ARCS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
CHANGING ARC ANGLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
FLIPPING AN ARC’S ORIENTATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
REMOVING ARCS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
ARROWS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
DRAWING ARROWS AT FIXED ANGLES . . . . . . . . . . . . . . . . . . . . . . . . . 124
DRAWING ARROWS AT NON-FIXED ANGLES . . . . . . . . . . . . . . . . . . . . . . 124
FORCING ARROWS TO BE DRAWN VERTICALLY AND HORIZONTALLY . . . . . 124
MOVING ARROWS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
RESIZING ARROWS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
CHANGING ARROW ARC ANGLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
REMOVING ARROWS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
EDITING ARROWHEADS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
RECTANGLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
DRAWING RECTANGLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
DRAWING SQUARES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
MOVING RECTANGLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
RESIZING RECTANGLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
CONVERTING BETWEEN ROUNDED & NON-ROUNDED RECTANGLES . . . . . . 127
REMOVING RECTANGLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
OVALS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
DRAWING OVALS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
DRAWING CIRCLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
MOVING OVALS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
RESIZING OVALS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
REMOVING OVALS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
BRACKETS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Chapter 5: SHAPES 117
RULERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
DRAWING RULERS AT FIXED ANGLES . . . . . . . . . . . . . . . . . . . . . . . . . . 136
DRAWING RULERS AT NON-FIXED ANGLES . . . . . . . . . . . . . . . . . . . . . . 136
FORCING RULERS TO BE DRAWN VERTICALLY AND HORIZONTALLY . . . . . 136
AUTOMATICALLY MEASURING OBJECT WIDTH AND HEIGHT . . . . . . . . . . 136
AUTOMATICALLY MEASURING OBJECT DIAGONAL . . . . . . . . . . . . . . . . . 137
MOVING RULERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
RESIZING RULERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
SHOWING AND HIDING MAJOR AND MINOR TICKS . . . . . . . . . . . . . . . . . 137
CHANGING THE MEASUREMENT UNIT . . . . . . . . . . . . . . . . . . . . . . . . . 138
REMOVING RULERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
OVERVIEW
In addition to chemical structures, ChemDoodle provides tools for drawing shapes for advanced figures.
In this chapter the new user is introduced to shapes within ChemDoodle. Topics covered include:
ANCHORS
Anchors are points that define a given shape. By moving them, you modify how the shape appears. There
are two types of anchors, control anchors and corner/edge anchors.
CONTROL ANCHORS
Control anchors represent points that can be moved anywhere and have no relationship to other anchors.
Shapes that are controlled by these achors include in lines, custom shapes or orbitals. They appear as
compass shapes as shown in Figure 5.1.
CORNER/EDGE ANCHORS
Corner edge anchors define corners and edges of shapes. Moving these anchors will change the shape in
relationship to the other anchors. For instance, if you move a left-right pointing anchor, you will not affect
the vertical positioning of the other anchors. These anchors are present for box shaped objects, like rectangles
and ovals. They appear as double sided arrows as shown in Figure 5.2.
Chapter 5: SHAPES 119
LINES
Lines are the most basic shape and are defined by two anchors placed at their endpoints as shown in
Figure 5.3. There is also a third anchor at the midpoint for controlling the arc angle. This anchor point is
discussed in the next section (Arcs).
1. Select a line tool from the Shapes palette in the main toolbar.
2. Press and hold the mouse down on the Doodle Board to set the start point of the line.
3. Drag the mouse to preview the placement of the end of the line.
You can also click the mouse to set the start point then move the mouse and click again to set the end point.
To place lines at non-fixed angles, hold down the alt key while dragging the mouse when defining the line.
120 Chapter 5: SHAPES
To place lines oriented vertically or horizontally, hold down the shift key while dragging the mouse when
defining the line. The line preview will then automatically orient vertically or horizontally depending on the
angle from the start point to the current mouse cursor position.
MOVING LINES
To move lines, use a selection tool, either the lasso or the rectangular marquee. Make sure that no content
is currently selected by emptying the current selection. Execute the following steps:
1. Hover the mouse pointer over the line so an open hand mouse cursor appears and the anchor points
are drawn as shown in Figure 5.3.
2. Press the mouse down and drag to move the line without selecting any of the anchors.
RESIZING LINES
To resize lines, use a selection tool, either the lasso or the rectangular marquee. Make sure that no content
is currently selected by emptying the current selection. Execute the following steps:
1. Hover the mouse pointer over the line so an open hand mouse cursor appears and the anchor points
are drawn as shown in Figure 5.3.
2. Move the mouse pointer over one of the two end anchor points so that anchor point is filled in with an
amber color.
3. Press the mouse down so the anchor point is filled with a blue color.
REMOVING LINES
• Use a selection tool to hover the mouse pointer over the line so an open hand mouse cursor appears
and the line anchor points are drawn as shown in Figure 5.3. Then press the backspace or delete
key.
• Use the eraser tool to hover the mouse pointer over the line so the line anchor points are drawn. Then
click with the mouse.
Chapter 5: SHAPES 121
ARCS
Arcs are segments of a circle and are defined by two anchors placed at their endpoints as shown in Figure 5.4.
There is also a third anchor at the middle for controlling the arc angle. Only 90◦ , 120◦ , 180◦ and 270◦ arcs
are directly provided in the Shapes palette, but an arc of any angle can be drawn. The only difference
between the line shape and the arc shape is the angle, and either shape can be converted into the other by
changing this value.
1. Select an arc tool by expanding the Shape palette in the main toolbar.
2. Press and hold the mouse down on the Doodle Board to set the start point of the arc.
3. Drag the mouse to preview the placement of the end of the arc.
You can also click the mouse to set the start point then move the mouse and click again to set the end point.
While placing the arc, if the z key is clicked, the arc will flip to the opposite side.
To place arcs at non-fixed angles, break from the fixed orientation angles by holding down the alt key
while dragging the mouse when defining the arc.
To place arcs oriented vertically or horizontally, hold down the shift key while dragging the mouse when
defining the arc. The arc preview will then automatically orient vertically or horizontally depending on the
angle from the start point to the current mouse cursor position.
122 Chapter 5: SHAPES
MOVING ARCS
To move arcs, use a selection tool, either the lasso or the rectangular marquee. Make sure that no content
is currently selected by emptying the current selection. Execute the following steps:
1. Hover the mouse pointer over the arc so an open hand mouse cursor appears and the anchor points
are drawn as shown in Figure 5.4.
2. Press the mouse down and drag to move the arc without selecting any of the anchors.
RESIZING ARCS
To resize arcs, use a selection tool, either the lasso or the rectangular marquee. Make sure that no content
is currently selected by emptying the current selection. Execute the following steps:
1. Hover the mouse pointer over the arc so an open hand mouse cursor appears and the anchor points
are drawn as shown in Figure 5.4.
2. Move the mouse pointer over one of the two end anchor points so that anchor point is filled in with an
amber color.
3. Press the mouse down so the anchor point is filled with a blue color.
Arc angles can be changed using the midpoint anchor. Choose a selection tool, either the lasso or the
rectangular marquee. Make sure that no content is currently selected by emptying the current selection.
Execute the following steps:
1. Hover the mouse pointer over the arc so an open hand mouse cursor appears and the arc anchor points
are drawn as shown in Figure 5.4.
2. Move the mouse pointer over the middle anchor point so that anchor point is filled in with an amber
color.
3. Press the mouse down so the anchor point is filled with a blue color.
While changing the angle of arcs, the arc angle will be displayed below the mouse cursor.
Chapter 5: SHAPES 123
To flip an arc’s orientation, so that the curve faces the opposite direction. use a selection tool, either the
lasso or the rectangular marquee. Make sure that no content is currently selected by emptying the current
selection. Execute the following steps:
1. Hover the mouse pointer over the arc so an open hand mouse cursor appears and the arc anchor points
are drawn as shown in Figure 5.4.
3. Select the Flip Arc menu item to flip the arc’s orientation.
You can also click and drag the midpoint to the other side of the arc to perform this task.
If you are viewing the preview of the arc while drawing it, you can press and release the z key to quickly
flip it in the other direction.
REMOVING ARCS
• Use a selection tool to hover the mouse pointer over the arc so an open hand mouse cursor appears
and the arc anchor points are drawn as shown in Figure 5.4. Then press the backspace or delete key.
• Use the eraser tool to hover the mouse pointer over the arc so the arc anchor points are drawn. Then
click with the mouse.
ARROWS
Arrows are essential in chemical graphics for many reasons, the most important being for reaction and
mechanism diagrams. Arrows are so important that they have their own unique toolbar. Essentially, arrow
shapes are just lines and arcs with arrowheads as shown in Figure 5.5. Polylines and Bezier curves can also
be used for arrows, and they are discussed in the CUSTOM SHAPES section this chapter.
ChemDoodle also provides advanced features.for building and defining reactions. Reactions are covered in
the REACTIONS chapter.
124 Chapter 5: SHAPES
1. Select the desired arrowheads and connector styles in the Arrows toolbar.
2. Click on the line or one of the arc angle buttons in the Arrows toolbar to enter the arrow placement
mode.
3. Press the mouse down on the Doodle Board to set the start point of the arrow.
4. Drag the mouse to preview the placement of the end of the arrow.
You can also click the mouse to set the start point then move the mouse and click again to set the end point.
To place arrows at non-fixed angles, break from the fixed orientation angles by holding down the alt key
while dragging the mouse when defining the arrow.
To place arrows oriented vertically or horizontally, hold down the shift key while dragging the mouse when
defining the arrow. The arrow preview will then automatically orient vertically or horizontally depending
on the angle from the start point to the current mouse cursor position.
MOVING ARROWS
To move arrows, use a selection tool, either the lasso or the rectangular marquee. Make sure that no content
is currently selected by emptying the current selection. Execute the following steps:
1. Hover the mouse pointer over the arrow so an open hand mouse cursor appears and the arrow anchor
points are drawn as shown in Figure 5.5.
2. Press the mouse down without selecting an anchor point and drag to move the arrow.
RESIZING ARROWS
To resize arrows, use a selection tool, either the lasso or the rectangular marquee. Make sure that no content
is currently selected by emptying the current selection. Execute the following steps:
1. Hover the mouse pointer over the arrow so an open hand mouse cursor appears and the arrow anchor
points are drawn as shown in Figure 5.5.
2. Move the mouse pointer over one of the two end anchor points so that anchor point is filled in with an
amber color.
Chapter 5: SHAPES 125
3. Press the mouse down so the anchor point is filled with a blue color.
Arrow arc angles can be changed using the midpoint anchor. Choose a selection tool, either the lasso or
the rectangular marquee. Make sure that no content is currently selected by emptying the current selection.
Execute the following steps:
1. Hover the mouse pointer over the arrow so an open hand mouse cursor appears and the arrow anchor
points are drawn as shown in Figure 5.5.
2. Move the mouse pointer over the middle anchor point so that anchor point is filled in with an amber
color.
3. Press the mouse down so the anchor point is filled with a blue color.
While changing the angle of arrow arcs, the arrow arc angle will be displayed below the mouse cursor.
A few special arrow types, such as the retrosynthetic type, are always straight, and you will
not be able to change the arc angles for these types.
REMOVING ARROWS
• Use a selection tool to hover the mouse pointer over the arrow so an open hand mouse cursor appears
and the arrow anchor points are drawn as shown in Figure 5.5. Then press the backspace or delete
key.
• Use the Eraser tool to hover the mouse pointer over the arrow so the arrow anchor points are drawn.
Then click with the mouse.
EDITING ARROWHEADS
Arrowheads can be added/removed from the ends of the line shape. This can be done before they are drawn,
with the Arrow toolbar, or afterwards by using the Format Arrow menu item in the right-click menu
after hovering an arrow.
There are several settings that control how arrowheads are drawn:
• Indented - When selected, the back end of the arrow will be indented.
• Filled - When selected, the arrow will be filled in; otherwise it will be an outline.
126 Chapter 5: SHAPES
• Length - This setting controls the length of the arrow head along the line.
• Angle - This setting controls the angle of the arrow, from one side to the other.
If the arrowhead length is greater than 50% of the length of the line it is on, then the length
will be decreased to 50% of the length of the line it is on.
RECTANGLES
Rectangles can be drawn in several styles and are defined by an anchor box set that controls its dimensions
as shown in Figure 5.6.
DRAWING RECTANGLES
1. Select a rectangle tool from the Shapes palette in the main toolbar.
2. Press the mouse down on the Doodle Board to set one corner of the rectangle.
3. Drag the mouse to preview the placement of the opposite corner along the diagonal of the rectangle.
You can also click the mouse to set the start point then move the mouse and click again to set the end point.
DRAWING SQUARES
To draw squares, hold down the shift key while dragging the mouse when defining the rectangle to force
the width and height to be equivalent.
Chapter 5: SHAPES 127
MOVING RECTANGLES
To move rectangles, use a selection tool, either the lasso or the rectangular marquee. Make sure that no
content is currently selected by emptying the current selection. Execute the following steps:
1. Hover the mouse pointer over the rectangle so an open hand mouse cursor appears and the rectangle
anchor points are drawn as shown in Figure 5.6.
2. Press the mouse down without selecting any of the anchor points and drag to move the rectangle.
RESIZING RECTANGLES
To resize rectangles, use a selection tool, either the lasso or the rectangular marquee. Make sure that no
content is currently selected by emptying the current selection. Execute the following steps:
1. Hover the mouse pointer over the rectangle so an open hand mouse cursor appears and the rectangle
anchor points are drawn as shown in Figure 5.6.
2. Move the mouse pointer over one of the anchor points so that anchor point is filled with an amber
color.
3. Press the mouse down so the anchor point is filled with a blue color.
To change a rectangle into a rounded rectangle or vice versa, use a selection tool, either the lasso or the
rectangular marquee. Make sure that no content is currently selected by emptying the current selection.
Execute the following steps:
1. Hover the mouse pointer over the rectangle so an open hand mouse cursor appears and the rectangle
anchor points are drawn as shown in Figure 5.6.
2. Right-click on the hovered rectangle and select the Format Rectangle. . . menu item.
3. Scroll to the Rectangle section and use the Rounded on/off choice to set the rectangle to be rounded
or not.
REMOVING RECTANGLES
• Use a selection tool to hover the mouse pointer over the rectangle so an open hand mouse cursor
appears and the rectangle anchor points are drawn as shown in Figure 5.6. Then press the backspace
or delete key.
• Use the Eraser tool to hover the mouse pointer over the rectangle so the rectangle anchor points are
drawn. Then click with the mouse.
128 Chapter 5: SHAPES
OVALS
Ovals can be drawn in several styles and are defined by an anchor box set that controls its dimensions as
shown in Figure 5.7.
DRAWING OVALS
1. Select an oval tool from the Shapes palette in the main toolbar.
2. Press and hold the mouse on the Doodle Board to set one corner of the circumscribing rectangle.
You can also click the mouse to set the start point then move the mouse and click again to set the end point.
DRAWING CIRCLES
To draw circles, hold down the shift key while dragging the mouse when defining the oval to force the
major and minor axes lengths to be equivalent.
MOVING OVALS
To move ovals, use a selection tool, either the lasso or the rectangular marquee. Make sure that no content
is currently selected by emptying the current selection. Execute the following steps:
1. Hover the mouse pointer over the oval so an open hand mouse cursor appears and the oval anchor
points are drawn as shown in Figure 5.7.
2. Press the mouse down without selecting any of the anchor points and drag to move the oval.
RESIZING OVALS
To resize ovals, use a selection tool, either the lasso or the rectangular marquee. Make sure that no content
is currently selected by emptying the current selection. Execute the following steps:
1. Hover the mouse pointer over the oval so an open hand mouse cursor appears and the rectangle anchor
points are drawn as shown in Figure 5.7.
2. Move the mouse pointer over one of the anchor points so that anchor point is filled with an amber
color.
3. Press the mouse down so the anchor point is filled with a blue color.
REMOVING OVALS
• Use a selection tool to hover the mouse pointer over the oval so an open hand mouse cursor appears
and the oval anchor points are drawn as shown in Figure 5.7. Then press the backspace or delete
key.
• Use the Eraser tool to hover the mouse pointer over the oval so the oval anchor points are drawn.
Then click with the mouse.
BRACKETS
Brackets can be drawn in several styles and are defined byan anchor box set that controls its dimensions as
shown in Figure 5.8.
• Square Brackets - [ ]
• Parentheses - ( )
• Curly Brackets - { }
130 Chapter 5: SHAPES
DRAWING BRACKETS
1. Select a bracket tool by expanding the Bracket palette in the main toolbar.
2. Press and hold the mouse down on the Doodle Board to set one corner of the bracket.
3. Drag the mouse to preview the placement of the opposite corner along the diagonal of the bracket.
You can also click the mouse to set the start point then move the mouse and click again to set the end point.
To draw square brackets, hold down the shift key while dragging the mouse when defining the bracket to
force the width and height of the bracket content to be equivalent.
MOVING BRACKETS
To move brackets, use a selection tool, either the lasso or the rectangular marquee. Make sure that no
content is currently selected by emptying the current selection. Execute the following steps:
1. Hover the mouse pointer over the brackets so an open hand mouse cursor appears and the bracket
anchor points are drawn as shown in Figure 5.8.
2. Press the mouse down without selecting an anchor point and drag to move the brackets.
RESIZING BRACKETS
To resize brackets, use a selection tool, either the lasso or the rectangular marquee. Make sure that no
content is currently selected by emptying the current selection. Execute the following steps:
1. Hover the mouse pointer over the brackets so an open hand mouse cursor appears and the rectangle
anchor points are drawn as shown in Figure 5.8.
2. Move the mouse pointer over one of the two end anchor points so that anchor point is filled with an
amber color.
3. Press the mouse down so the anchor point is filled with a blue color.
To change the widths of the current bracket rendering style, use a selection tool, either the lasso or the
rectangular marquee. Make sure that no content is currently selected by emptying the current selection.
Execute the following steps:
1. Hover the mouse pointer over the brackets so an open hand mouse cursor appears and the rectangle
anchor points are drawn as shown in Figure 5.8.
2. Right-click on the hovered rectangle and select the Format Bracket. . . menu item.
3. Scroll to the Bracket section and use the Wideness number slider to define how protruded bracket
lips are rendered.
REMOVING BRACKETS
• Use a selection tool to hover the mouse pointer over the brackets so an open hand mouse cursor appears
and the oval anchor points are drawn as shown in Figure 5.8. Then press the backspace or delete
key.
• Use the Eraser tool to hover the mouse pointer over the brackets so the bracket anchor points are
drawn. Then click with the mouse.
DYNAMIC BRACKETS
Dynamic Brackets allow you to define a set of brackets to a pair of bonds. The brackets will automatically
update to fit the appropriate content. You can also add text to the bottom right of dynamic brackets that
will automatically place itself.
1. Select the Dynamic Brackets button in the Bracket group button in the Shapes toolbar.
2. Hover over one of the two bonds you would like to define the brackets to.
3. Press and hold the mouse down, drag to the second of the two bonds you would like to define the
brackets to and release the mouse.
5. Press the return key or click on the document to set the dynamic brackets.
To edit the dynamic brackets, hover over the text with the Dynamic Brackets tool and click. To remove
dynamic brackets, reverse the procedure used to place the dynamic brackets.
132 Chapter 5: SHAPES
CUSTOM SHAPES
In addition to the standard defined shapes previously discussed, ChemDoodle allows you to create custom
shapes. Currently there are three types of custom shapes:
Pen Allows you to draw any shape by clicking and dragging an outline.
Bezier Curve Allows you to draw a bezier curve by defining its control points.
Polyline Allows you do draw any polygon shape that can be convex or concave.
Both pen paths and polylines can be open or closed and are defined by their control points, which the shape
will pass through as shown in Figure 5.9.
Bezier curves can be open or closed and are defined by a more complex set of control points as shown in
Figure 5.10.
To draw a custom shape with the Pen tool, execute the following steps:
1. Select a Pen tool from the Custom Shapes palette in the main toolbar.
ChemDoodle will automatically simplify your path for you and generate a cubic interpolation.
To draw a custom shape with the Polyline tool, execute the following steps:
1. Select a Polyline tool from the Custom Shapes palette in the main toolbar.
2. Press the mouse down on the Doodle Board to set the first point.
3. Move the mouse to the location you prefer the next point to be placed.
4. Click to place the next point. Points will automatically connect to previous points.
6. Click on the first point drawn or double-click the last point to complete the shape and set it.
To move custom shapes, use a selection tool, either the lasso or the rectangular marquee. Make sure that
no content is currently selected by emptying the current selection. Execute the following steps:
1. Hover the mouse pointer over the custom shape so an open hand mouse cursor appears and the control
points are rendered as shown in Figure 5.9.
2. Press the mouse down without selecting any of the control points and drag to move the custom shape.
You can move the control points that define pen paths and polylines. To do so, use a selection tool, either the
lasso or the rectangular marquee. Make sure that no content is currently selected by emptying the current
selection. Execute the following steps:
1. Hover the mouse pointer over the custom shape so an open hand mouse cursor appears and the control
points are drawn as shown in Figure 5.9.
2. Move the mouse pointer over one of the control points that you desire to be moved so that control
point is filled with an amber color.
3. Press the mouse down so the control point is filled with a blue color.
134 Chapter 5: SHAPES
Bezier curves are defined by pairs of control points. There is a main point which the curve passes through,
and a second control point that describes the tangent line to the curve at the point the curve passes through.
To draw a bezier curve, execute the following steps:
1. Select the Bezier Curve tool from the Custom Shapes palette in the main toolbar.
2. Press the mouse down on the Doodle Board to set the first point.
3. Drag your mouse to set the paired control point that defines the tangent line to the curve at the first
point. The further from the first point you make this paired control point, the tighter the curve will
hug the first point.
5. Move the mouse to location you prefer the next point to be placed that the curve will pass through.
6. Press the mouse down to place the next point. Points will automatically connect to previous points.
7. Drag your mouse to set the paired control point that defines the tangent of the curve at the second
point. The further from the second point you make this paired control point, the tighter the curve will
hug the second point.
9. Press the escape key to complete the shape and set it.
You can move the control points that define bezier curves in one of two ways. The first way is by following
the same instructions as in the MODIFYING PEN PATHS AND POLYLINES section. The second is by
using the Bezier Curve tool. Execute the following steps:
1. Select the Bezier Curve tool from the Custom Shapes palette in the main toolbar.
2. Move the mouse pointer over the bezier curve that you desire to be modified so that its control points
are rendered.
3. Click on the bezier curve so that all of its control points are rendered as shown in Figure 5.10.
4. Hover over any of the control points so that an amber color fills the one you wish to move.
5. Press the mouse down and drag the control point to the new desired location.
Only the control points that have the curve pass through them may be deleted. Deleting one of these control
points will also remove the corresponding paired control point. To delete a bezier control point, execute the
following steps:
1. Select the Bezier Curve tool from the Custom Shapes palette in the main toolbar.
2. Move the mouse pointer over the bezier curve that you desire to be modified so that its control points
are rendered.
3. Click on the bezier curve so that all of its control points are rendered as shown in Figure 5.10.
4. Hover over the control point that you wish to remove so that it is filled with an amber color.
To add arrows to custom shapes follow the same procedures as discussed for the arrow shapes earlier in
this chapter. Right click on the bezier curve after it is hovered, select the appropriate Format Custom
Shape. . . menu item, and define the arrow sections to your preference.
To close or open a custom shape, use a selection tool, either the lasso or the rectangular marquee. Make
sure that no content is currently selected by emptying the current selection. Perform the following steps:
1. Hover the mouse pointer over the custom shape so an open hand mouse cursor appears and the arrow
anchor points are drawn as shown in Figure 5.9.
2. Right-click on the hovered custom shape and select the Format Custom Shape. . . menu item.
3. Scroll to the Path or Bezier Curve section and use the Close on/off choice to specify whether the
custom shape path is closed or not.
If closed, the custom shape can be filled with any desired color.
Custom shapes can be removed in a number of ways. You can do the following:
• Use a selection tool to hover the mouse pointer over the custom shape so an open hand mouse cursor
appears and the custom shape anchor points are drawn as shown in Figure 5.9. Then press the
backspace or delete key.
• Use the Eraser tool to hover the mouse pointer over the custom shape so the custom shape anchor
points are drawn. Then click with the mouse.
136 Chapter 5: SHAPES
RULERS
Rulers measure distances in 2 dimensions, and are defined by two anchors placed at their endpoints as shown
in Figure 5.11.
2. Press the mouse down on the Doodle Board to set the start point of the ruler.
3. Drag the mouse to preview the placement of the end of the ruler.
You can also click the mouse to set the start point then move the mouse and click again to set the end point.
To place rulers at non-fixed angles, hold down the alt key while dragging the mouse when defining the
ruler to break from the fixed chain orientation angles.
To place rulers oriented vertically or horizontally, hold down the shift key while dragging the mouse when
defining the ruler. The ruler preview will then automatically orient vertically or horizontally depending on
angle from the start point to the current mouse cursor position.
To measure the width and height of selected objects, execute the following procedure:
Two rulers will be placed to measure the width and height of the selected content.
Chapter 5: SHAPES 137
A single ruler will be placed across the diagonal of the selected content.
MOVING RULERS
To move rulers, use a selection tool, either the lasso or the rectangular marquee. Make sure that no content
is currently selected by emptying the current selection. Execute the following steps:
1. Hover the mouse pointer over the ruler so an open hand mouse cursor appears and the anchor points
are drawn as shown in Figure 5.11.
2. Press the mouse down without selecting a control point and drag to move the ruler.
RESIZING RULERS
To resize rulers, use a selection tool, either the lasso or the rectangular marquee. Make sure that no content
is currently selected by emptying the current selection. Execute the following steps:
1. Hover the mouse pointer over the ruler so an open hand mouse cursor appears and the anchor points
are drawn as shown in Figure 5.11.
2. Move the mouse pointer over one of the two end anchor points so that anchor point is filled with an
amber color.
3. Press the mouse down so the anchor point is filled with a blue color.
To show and hide ruler major and minor ticks, use a selection tool, either the lasso or the rectangular
marquee. Make sure that no content is currently selected by emptying the current selection. Execute the
following steps:
1. Hover the mouse pointer over the ruler so an open hand mouse cursor appears and the anchor points
are drawn as shown in Figure 5.11.
2. Right-click on the hovered ruler and select the Format Ruler. . . menu item.
3. Scroll to the Ruler section and use the Show Major Ticks and Show Minor Ticks on/off choices
to set whether major and minor ticks are visible or not.
138 Chapter 5: SHAPES
To change the ruler’s measurement unit, use a selection tool, either the lasso or the rectangular marquee.
Make sure that no content is currently selected by emptying the current selection. Execute the following
steps:
1. Hover the mouse pointer over the ruler so an open hand mouse cursor appears and the anchor points
are drawn as shown in Figure 5.11.
2. Right-click on the hovered ruler and select the Format Ruler. . . menu item.
3. Scroll to the Ruler section and use the Unit drop-down selection to select the unit to be displayed.
You can also hide the measurement completely by deselecting the Show Measurement option in this
Ruler Settings window.
REMOVING RULERS
• Use a selection tool to hover the mouse pointer over the ruler so an open hand mouse cursor appears
and the ruler anchor points are drawn as shown in Figure 5.11. Then press the backspace or delete
key.
• Use the Eraser tool to hover the mouse pointer over the ruler so the ruler anchor points are drawn.
Then click with the mouse.
TEXT AREAS
In addition to atom labels, you can also add blocks of text in text area objects. Text areas can have a border
and can have a background, and can be resized to any dimension.
To place text areas, click on the Text Area ( ) tool in the main toolbar. You can place text areas and edit
them just as you would Rectangle shapes. The text area is resizable and can have a border and background.
It will NOT automatically fit its contained text.
When editing the text area, text format functions will be provided in a toolbar that appears above it as
shown in Figure 5.12.
To edit text areas, use the Text Area tool to click on an existing text area, or hover the text area using a
selection tool and double-click.
Chapter 5: SHAPES 139
Text areas are deprecated and will be removed in a future version of ChemDoodle as the atom
label tool is expanded with further functionality. We recommend using the atom label tool
when possible to add text to your figures.
UPDATING LABELS
Updating labels can be attached to structures and defined to update dynamically. This is very convenient for
figures that change often or for dynamically generating IUPAC names or molecular formulas, for instance.
Updating labels automatically move to be placed at the bottom center of the associated structure and do not
present anchor points. If you hover over the label, it will highlight both itself and the associated structure,
as shown in Figure 5.13.
Figure 5.13: An updating label associated with a molecule of aspirin showing its IUPAC name
You can move an updating label by hovering the label with a selection tool and clicking and dragging.
Note that once you move the label, it will no longer reorient itself to be placed at the bottom center of the
associated molecule. It will, however, continue to update its content dynamically.
You can edit the content of the label by double clicking on the label with a selection tool. Note that once
you edit the content, it will break from the associated molecule and become a standard label graphic.
To copy the text in an updating label to the system clipboard, hover the updating label with a selection
tool and right-click. Select the Copy Text menu item to copy the displayed text and its formatting to the
system clipboard.
CHAPTER 6
Content Management Tools
Chapter 6: CONTENT MANAGEMENT TOOLS 141
Contents
OVERVIEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
COLORS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
COLOR BUTTON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
142 Chapter 6: CONTENT MANAGEMENT TOOLS
OVERVIEW
In this chapter the new user is introduced to content management tools within ChemDoodle. It covers the
following topics:
• Selecting content
• Duplicating content
• Editing content
• Organizing content
• Grouping content
• Removing content
SELECTING CONTENT
Content can be selected by using any of the selection tools. There are three types of selection tools provided
in ChemDoodle:
Rectangular Marquee Define a rectangle that selects any objects contained within.
Selected content will be highlighted in amber and will be surrounded by an animated (called a “crawling
ants” effect) blue outline as shown in Figure 6.1.
The crawling ants animation can be turned off in the Preferences window under the General tab.
144 Chapter 6: CONTENT MANAGEMENT TOOLS
To select an individual object, first select a lasso tool and make sure no content is currently selected. Then
hover the object to be selected and click. The single object will then be selected.
2. Click and drag to draw an outline with a lasso or to draw a rectangle with the rectangular marquee to
surround all of the objects you would like to select.
It may be difficult to see the full bounds for some shapes, such as large text areas with little
text in them. If you have trouble selecting a shape, make sure to discover where its bounds
are and draw the selection bounds around all anchors.
SELECT ALL
To select all content on a page, select the Content|Select—All menu item. The keyboard shortcut to use
this function is ctrl + A ( command + A on Mac OS X).
If a selection has already been made, you can add or remove an individual object from the selection. Hold
down the alt key and hover the object to be added or removed and click the mouse. If that object was
previously selected, it will be removed from the selection, otherwise it will be added to the selection.
If a selection has already been made, you can add or remove groups of objects from the selection. Hold down
the shift key and hover the object to be added or removed and click and drag to draw an outline with a
lasso or to draw a rectangle with the rectangular marquee to surround all of the objects you would like to
select or deselect. Then release the mouse. Any objects contained within the new boundary will be removed
from the selection if they were previously selected, otherwise they will be added to the selection.
Chapter 6: CONTENT MANAGEMENT TOOLS 145
Instead of surrounding an entire molecule with the selection tools to select it, the following techniques will
allow you to select individual molecules:
• Using a selection tool, hold down both the alt and shift keys and then click on an atom or bond
in the molecule.
• Press the tab key to navigate through molecules, selecting one at a time, starting at the last drawn
molecule and then navigating through them chronologically.
SMARTS is single line, text-based query system for matching chemical objects. Sometimes it is convenient
to select content in documents by SMARTS queries. To do so, execute the following steps:
2. A window will appear prompting you for the SMARTS query. Input your query here and press the
Accept button.
Any content that matches the SMARTS string will then be selected.
Instead of surrounding an entire shape with the selection tools to select it or clicking on the shape, you can
also press the tab key while holding down the shift key to navigate through shapes, selecting one at a
time, starting at the last drawn shape and then navigating through them chronologically.
When figures are highly congested, it may be difficult to select shapes from surrounding structures. In this
case, use the Lasso Only Shapes tool which will only recognize shapes. The behavior of the Lasso Only
Shapes tool is identical to that of the Lasso tool, except that it only recognizes shapes.
To select the inverse of the current selection on a page, select the Content|Select—Inverse menu item.
DESELECTING OBJECTS
• Move the mouse cursor away from the selection so that the lasso cursor icon appears. Then click the
mouse.
• When the mouse cursor is within the current selection boundary, double-click the mouse.
• Press the space key to deselect the current selection and return to the structure drawing mode.
RESELECTING OBJECTS
If you lost the current selection, you can reselect it by selecting the Content|Reselect menu item.
DUPLICATING CONTENT
Content in ChemDoodle can be duplicated on the Doodle Board in the current document or between
separate documents through copy and paste actions. To have ChemDoodle objects copied and pasted
correctly on the Doodle Board keep ChemDoodle Collage enabled in the Preferences window under
the Advanced tab.
2. Press the Edit|Copy menu item. The keyboard shortcut to use this function is ctrl + C ( command
+ C on Mac OS X).
3. Press the Edit|Paste menu item. The keyboard shortcut to use this function is ctrl + V ( command
+ V on Mac OS X).
To duplicate content and remove the original, execute the following steps:
2. Press the Edit|Cut menu item. The keyboard shortcut to use this function is ctrl + X ( command
+ X on Mac OS X).
3. Press the Edit|Paste menu item. The keyboard shortcut to use this function is ctrl + V ( command
+ V on Mac OS X).
Chapter 6: CONTENT MANAGEMENT TOOLS 147
ORGANIZING CONTENT
ChemDoodle provides several tools for laying out content in the document.
ALIGNING
2. Expand the Content|Align submenu and press the Left Edges, Horizontal Centers, Right Edges,
Top Edges, Vertical Centers or Bottom Edges menu items.
ALIGNING BY BOND
2. Press the ↑ , ↓ , ← or → arrow keys to align the bond from its first to second constituent
atom in the selected direction. This will rotate the entire molecule with the bond.
CENTERING
To center all content on the page, select the Content|Center—All on Page menu item.
2. Expand the Content|Center submenu and press the Selection on Page, Selection Horizontally
or Selection Vertically menu items.
DISTRIBUTING
2. Expand the Content|Distribute submenu and press the Horizontally on Page or Vertically on
Page menu items.
To distribute content across the document using a buffer spacing that you provide, execute the following
steps:
2. Expand the Content|Distribute submenu and press the Horizontally by Buffer Space. . . or
Vertically by Buffer Space. . . menu items.
3. Input a buffer space value into the number field that appears.
148 Chapter 6: CONTENT MANAGEMENT TOOLS
FLIPPING
2. Expand the Content|Flip submenu and press the Horizontally or Vertically menu item.
FLIPPING A BOND
You may wish to flip non-symmetrical bonds when you need them to face the other direction, such as when
working with wedge bonds. There are a few quick ways to do so:
• Use the bond tool of that bond type and click on the bond after hovering it. ChemDoodle will detect
the bond is being set to its current bond type and will instead flip the bond.
PLACING IN GRID
To place all content in a grid that covers the document, execute the following steps:
2. In the prompt that appears, select whether you want to specify the grid dimensions by columns or by
rows by choosing the corresponding selection from the drop-down menu.
3. Input the dimension of the grid in the number field. The other dimension will be calculated automat-
ically based on the number of objects being placed in the grid.
STACKING
Stacking will place all content on the page starting from the top-left of the document to the bottom- right,
such that their visual bounds are separated by a small buffer and that all objects are within the page margins.
To stack all content on the page, press the Content|Stack All on Page menu item.
If content is ever placed outside of the page bounds, red strips will appear at the sides of the page that the
content extends from. Click on the red strip to stack all of the content that extends from that side of the
page back onto the page.
Chapter 6: CONTENT MANAGEMENT TOOLS 149
FRAMING CONTENT
Content can be automatically framed with various different shapes. To frame objects, execute the following
steps:
EDITING CONTENT
The selection area is context sensitive and you can click and drag on the various features of the selection to
perform different actions.
TRANSLATING
2. Hover the mouse cursor over the selection so that an open hand cursor appears.
3. Press the mouse down so the mouse cursor turns into a closed hand cursor.
During the translation, the change in x position and change and y position will be displayed below the mouse
cursor. You can disable this feedback in the Preferences window under the General tab.
Holding down the shift key while translating a selection will lock the content horizontally or vertically
depending on where the mouse pointer is.
DUPLICATING CONTENT
Holding down the shift and alt keys while translating content will duplicate that content and it will be
locked horizontally or vertically depending on where the mouse pointer is. To remove the lock, release the
shift and alt keys.
150 Chapter 6: CONTENT MANAGEMENT TOOLS
ROTATING
2. Hover the mouse just outside the edge of the selection border so that the rotation cursor appears.
During the rotation, the rotation angle will be displayed below the mouse cursor. You can disable this
feedback in the Preferences window under the General tab.
2. Expand the Content|Rotate submenu and press the 90◦ CW, 90◦ CCW or 180◦ menu items.
2. Expand the Content|Rotate submenu and press the Arbitrary. . . menu item.
3. Enter a degree value in the number field that appears and select clockwise or counterclockwise as the
direction of rotation.
4. Press the Rotate button to complete the rotation with the settings you provided.
By default content is rotated about its center. Rotation about an alternative point can be achieved by
moving the rotation anchor which, by default, is located at the center of the selection. This is useful, for
instance, for rotating structures about an atom.
1. Move the mouse over the rotation anchor so that the anchor fills with an amber color and the mouse
cursor changes to a resize cursor.
2. Press the mouse down and drag the rotation anchor to the desired position.
Henceforth, all rotations will proceed around the new rotation anchor position.
When moving the rotation anchor, it will automatically lock onto atoms within the selection as you get close
to them, aiding you in setting the rotation anchor over atom positions.
Chapter 6: CONTENT MANAGEMENT TOOLS 151
SCALING
2. Hover the mouse over one of the anchor points in the selection so that the mouse resize cursor appears.
3. Press the mouse down and drag the anchor to scale the content.
The x scale factor and y scale factor will be displayed below the mouse cursor during scaling. You can disable
this feedback in the Preferences window under the General tab.
To preserve the width-to-height ratio while scaling content along the diagonals, just hold down the shift
key while performing the above steps.
3. Select whether to scale the content by dimension or bond length and then specify the remaining settings.
4. Press the Scale button to scale the content to the settings you provided.
DRAWING AIDS
Drawing guides are helpful when precision is important. There are several categories of drawing guides, and
each has its own use. Guides can be enabled and disabled in the View|Drawing Aids submenu.
ATOM AIDS
• Orthogonal - Will show a horizontal and vertical line through the center of each atom to help with
alignment.
• Circular - Will show a circle around each atom with radius equal to the current standard bond length
to help with distances.
BOND AIDS
• Parallel - Will draw a line through each bond, parallel to its direction to help with extrapolation.
152 Chapter 6: CONTENT MANAGEMENT TOOLS
RING AIDS
Rings can be colored in with a different color corresponding to the size of the ring to help with perception.
MOLECULE AIDS
• Bounds - Will show a rectangle representing the bounds of each molecule to help with placement.
• Orthogonal - Will show a horizontal and vertical line through the center of each molecule to help
with alignment.
BACKGROUND AIDS
• Crosshair - Will render a crosshair and grid to help with partitioning and aligning objects.
• Grid - Will render a grid at an interval that you specify to help with aligning objects.
FONTS
To change the fonts of atom labels and text-based shapes, execute the following steps:
1. Select the atoms and shapes whose fonts you would like to change.
2. Choose the font family, font size and font style from the Files + Formatting toolbar to change the
fonts.
COLORS
There are two features in the Files + Formatting toolbar for changing the colors of content, the Color
button and the Quick Colors button.
COLOR BUTTON
The Color button in ChemDoodle makes it easy to quickly change the colors of groups of objects. There
are eight colors defined by the Color button:
• Background
• Bonds
• Fill
Chapter 6: CONTENT MANAGEMENT TOOLS 153
• Atom Labels
• Identifier Text
• Other Text
• Plots
You may change these colors by clicking the thin rainbow button placed directly to the right of the Color
button. All objects drawn after choosing colors will conform to those choices. To change the colors of a
group of objects to the current selection of colors, just select them and click the Color button.
The Color button will change its display colors to reflect the current settings. A breakdown of the sections
of the Color button is shown in Figure 6.2.
If you wish for a certain fill to be empty and to not be colored, then in the color chooser, click the Empty
Color button.
The Color button, although powerful, is not a quick way to change colors. To quickly change colors, use the
Quick Colors button. Select the content for which you would like the colors changed and press the Quick
Colors button. All of the content will be changed to that color regardless of the content type.
If you click and hover (or drag) over the Quick Colors button, a palette will appear to select a new color.
Drag the mouse pointer over one of the preset colors to select it and immediately change the selected content
to that color.
You can also add custom colors to the last three rows of the Quick Colors palette. Release your mouse
over the circled plus icon ( ) and release to show a color chooser. Choose the desired color and press OK
to add it to the palette and change the currently selected content to that color.
COLOR DETECTION
When working with content that uses nonstandard colors, you may wish to detect what those colors are.
To do this, expand the Quick Colors button and release the mouse over the Detect Color ( ) button.
Then hover over the color in the document you wish to detect and press the mouse down when that color is
centered in the cursor. That color will be added to the Quick Colors button for further use.
COLOR CHOOSER
The color chooser will be different on all platforms, with different templates from which to pick colors.
However, the ChemDoodle pinwheel color chooser will be present on all platforms. The pinwheel color
chooser is shown in Figure 6.4.
The color selected can be seen in the preview bar at the bottom, with the hex value shown by default. You
can also view the RGB value by enabling the Decimal RGB checkbox.
To select a color, just move the mouse pointer over the pinwheel until the color you would like to select is
hovered, then click the mouse. You can also use the mouse wheel to scroll through colors.
If the pinwheel appears all black, you will need to increase the Brightness setting by moving the Brightness
slider up. If the pinwheel appears all white, you will need to decrease the Saturation setting by moving
the Saturation slider down.
Occasionally, you may want to change how shapes are z-ordered with respect to each other and with respect
to atoms and bonds. Shapes, by default, will always render behind atoms and bonds and will be z-ordered
chronologically.
4. Select the Send Forward, Send Backward, Send to Front or Send to Back menu item depending
on your preference.
GROUPING CONTENT
Content in ChemDoodle can be grouped. Once grouped, you will no longer be able to edit the member
objects individually. Any transformations performed on the group will affect all member objects.
Grouping can be nested, so groups can be grouped into further groups. Ungrouping is not recursive, so
ungrouping a group containing groups will leave those contained groups intact.
GROUPING
UNGROUPING
REMOVING CONTENT
Individual objects can be removed by using the Eraser tool to hover the object and then clicking to remove
it. Additionally, at any time, when an object is hovered, press the backspace or delete key.
Groups of objects can be removed in a number of ways. You can do the following:
• Use a selection tool to select the content to be removed. Then press the backspace or delete key.
• First select the content to be removed. Then use the Eraser tool to click on the Doodle Board.
• Select the Eraser tool, then press the mouse down and drag over all of the content to be removed. Se-
lected content will be highlighted. Then release the mouse to remove all highlighted objects. Dragging
over content that has already been highlighted will unhighlight it.
CHAPTER 7
Cheminformatics
158 Chapter 7: CHEMINFORMATICS
Contents
OVERVIEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
AROMATICITY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
KEKULÉ & CIRCLE REPRESENTATIONS FOR AROMATICS . . . . . . . . . . . . . 160
FORCING AROMATICITY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
MANIPULATING AROMATIC RING CIRCLES . . . . . . . . . . . . . . . . . . . . . . 161
DESCRIPTORS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
CONSTITUTIONAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
TOPOLOGICAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
PHYSICOCHEMICAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
ADME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
FLATTENING ATOMIC COORDINATES . . . . . . . . . . . . . . . . . . . . . . . . . . 169
FRAGMENTATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
CALCULATING MONOISOTOPIC MASS INSTEAD OF MOLECULAR MASS . . . . 170
REDUCE 1◦ + 0◦ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
REDUCE 2◦ (CHAINS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
REDUCE 2◦ + 1◦ + 0◦ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
HYDROGENS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
IMPLICIT HYDROGEN RENDERING . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
ADDING HYDROGENS AS ATOMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
ADDING HYDROGENS AS TEXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
DEFINING WHEN HYDROGENS ARE ADDED TO CARBONS . . . . . . . . . . . . . 177
STEREOCHEMISTRY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
CHIRAL CENTERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
DOUBLE BONDS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
RESOLVING STEREOCHEMISTRY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
FORCING STEREOCHEMICAL CONFIGURATIONS . . . . . . . . . . . . . . . . . . . 191
OVERVIEW
ChemDoodle is powered by an advanced cheminformatics engine to perform several functions for creating
graphics, such as ring perception and structure depiction. This engine allows for some very powerful functions
to help you create your chemical graphics and to analyze the structures you draw.
This section introduces the new user to advanced structure functionality within ChemDoodle. It covers the
following topics:
• How to edit your structures in a more advanced way than described in DRAWING CHEMICAL
STRUCTURES.
3D COORDINATE GENERATION
ChemDoodle provides functions to generate 3D coordinates for structures. A detailed explanation of the
algorithms can be found in the CLEANING STRUCTURES section in this chapter.
You can rotate structures in 3D using the Rotate in 3D button in the Content toolbar.
AROMATICITY
Aromaticity is detected based on the Hückel model. All rings are assumed to be planar. Any appropriately
hybridized heteroatoms can be constituents in an aromatic ring.
To toggle between viewing aromatics in Kekulé form (with double bond lines) or with circles, execute the
following steps:
3. Select the preferred setting for the Use Circles for Aromatics visual specification under the Aro-
matics section based on your preference.
The Always option will render circles for all aromatics. The Resonance Bond Rings Only option will
render circles only for aromatic rings defined by resonance bonds. The Never option will never render
aromatic circles. Use this visual specification for full control over the aromatic ring representations in your
figures.
Chapter 7: CHEMINFORMATICS 161
FORCING AROMATICITY
In rare cases, ChemDoodle may determine a ring to have no aromatic character when it should be aromatic
for some purpose. To force a ring to be recognized as aromatic, change all of the ring bonds to resonance
bonds.
You should also use all resonance bonds to define an aromatic ring that you want it to be represented with an
aromatic circle in mixed structures, such as when displaying a Kekulé benzene next to a benzene represented
by an aromatic circle.
Aromatic ring circles are rendered by a special algorithm that molds to the shape of the aromatic ring in
3D. This allows you to easily create complex perspective figures using aromatic circles, as shown for various
rotations of benzene in Figure 7.1.
Figure 7.1: The aromatic ring circle display for rotated perspective drawings
Aromatic ring circles will even mold to nonplanar or warped rings as shown in Figure 7.2.
1. Select the atoms that you would like covalent bonds deduced between.
Covalent radii are a best fit from a large number of experimental covalent radii. In some cases, a bond
distance from a file may be larger than the distance calculated by adding the corresponding element covalent
radii together and the bond will not be found. To address this, ChemDoodle multiplies all covalent radii
by a scalar when deducing bonds. By increasing this multiplier, ChemDoodle will discover bonds at longer
distances. You can change the radius multiplier in the Preferences window under the Functions tab.
162 Chapter 7: CHEMINFORMATICS
CARBON LABELS
By default, ChemDoodle draws skeleton figures where carbon labels are suppressed. However, it may be
necessary to show the carbon label for various reasons and this can be done easily for each atom or globally for
all atoms. To affect this globally, change the Display Carbon Label visual specification for the document
style sheet in the Preferences window under the Visuals tab. To do this for a specific carbon atom, change
the Display Carbon Label visual specification in the atom’s Format window.
The atom Display Carbon Label visual specification has four options for displaying carbon labels:
• On Lone and Hidden - only display carbon labels on lone and hidden carbons.
The default is On Hidden and only carbon atoms that are “hidden” between two bonds of the same bond
order will have their label displayed as shown in Figure 7.3.
Lone carbons are disconnected atoms and have no bonds attached. In addition to manually changing Display
Carbon Label visual specification, there is a quick method provided to show/hide carbon labels. To quickly
show individual carbon labels, execute the following steps:
2. Right-click on the atom and select the Show Carbon Label menu item.
To hide the carbon label execute the same steps, but instead select the Hide Carbon Label menu item.
You may prefer that all terminal carbon atoms will display labels. To show terminal carbon labels, check the
Show Terminal Labels visual specification in the Carbons section in the Atoms subtab in the Visuals
tab of the Preferences window.
Chapter 7: CHEMINFORMATICS 163
CHEMICAL SUPPLIERS
Chemical suppliers for the structures you draw can be listed by executing the following steps:
4. Select the Substructure Match or Exact Match menu item depending on whether you want to
search for a substructure or exact match for the selected structure.
5. The ChemExper database will appear in your default browser with a listing of matches. Select the
match to view the chemical suppliers.
The ChemExper database provides the supplier information and you must abide by their terms of use and
any copyrights or disclaimers presented when using their service.
CHEMICAL WARNINGS
ChemDoodle will check your structures and flag any questionable objects.
WARNING TYPES
• Improper Valency - It is unlikely that this element can have the current coordination number. Or
the atom label is an abbreviation and the valency is overextended.
• Uninterpretable Label - ChemDoodle does not understand or interpret the text present in the atom
label as chemically relevant.
• Unpublished Mass Number - This mass number is not found in ChemDoodle’s database of pub-
lished isotopes for the element.
• Unpublished Oxidation State - The oxidation state of this atom is not found in ChemDoodle’s
database of published oxidation states for the element.
• Sum of Bonds is not an Integer - The coordination number of this atom is not a whole number.
• Atom Overlaps Another - This pair of atoms has the same coordinates and will be perceived as a
single atom in graphical output.
164 Chapter 7: CHEMINFORMATICS
These warnings can be disabled individually in the Preferences window under the Warnings tab as shown
in Figure 7.4. This tab also contains an option to disable the display of chemical warning explanations at
the top-left of the document in which the warnings are present.
2. Right-click on the atom and select the Ignore Warnings menu item.
To enable warnings for an atom that is ignoring warnings, just right-click on it after hovering it and select
the Check for Warnings menu item.
If the warnings clutter the document while drawing, they can be easily suppressed by selecting the
View|Hide Warnings menu item.
Chapter 7: CHEMINFORMATICS 165
CLEANING STRUCTURES
ChemDoodle can generate 2D and 3D coordinates for structures.
OPTIMIZING STRUCTURES IN 2D
If your structures do not have acceptable or aesthetic coordinates, ChemDoodle can clean them. To clean
your structures, execute the following steps:
2. Expand the Structure|Clean submenu and select the 2D Optimization menu item.
ChemDoodle employs the published CCG algorithm for cleaning structures. This method is a statistical
approach. Therefore, repeated applications of the function may produce different results. If you are not
happy with the first result of the function, try it again, something you like better may be generated.
There are two options in the Preferences window on the Functions tab that will define how 2D cleaning
works:
• Clean Retains Stereochemistry - By default, this option is enabled and will make sure that stere-
ocenters after the clean have the same configuration as before the clean.
• Chain Angle - This option allows you to define the chain angle used. 120◦ is selected by default
and is preferred for skeletal figures, while 180◦ is useful for drawing Lewis Dot Structures and other
educational figures.
BUILD 3D MODEL
This is a very fast and high-quality template based approach to generating 3D coordinates. Stereochemistry
is retained. Hydrogens will be added appropriately.
This function uses the NIH Cactus service, and will require an internet connection. To use this method,
execute the following steps:
3. Expand the Structure|Clean submenu and select the Build 3D Model (NIH Cactus) menu item.
Also, the NIH Cactus service may be down for any number of reasons. If this is the case, please try again
later and it will likely be back up.
Distance geometry embedding sets 3D coordinates for a structure based on a regression of its bond distance
matrix. This function works best on highly embedded structures such as fullerenes, carbon nanotubes and
cage-like ring systems such as adamantane or norbornane. To use this method, execute the following steps:
2. Expand the Structure|Clean submenu and select the Distance Geometry Embedding menu item.
166 Chapter 7: CHEMINFORMATICS
PRESERVING STEREOCHEMISTRY
By default, structure cleaning will preserve stereochemical configurations. To disable this option, deselect
Clean Retains Stereochemistry in the Functions panel in the Preferences window.
DESCRIPTORS
ChemDoodle calculates a large number of molecular descriptors. The descriptors are currently categorized
into four types: constitutional, topological, physicochemical and ADME.
CONSTITUTIONAL
Constitutional descriptors are based on the makeup of the molecule, such as atom counts and molecular
formula. The following constitutional descriptors are provided:
• Degree of Unsaturation - The sum of all bond orders less one for each, plus the number of rings.
• Euler Facet Ring Count - The count of all Euler facets in a molecule. This is defined as all of the
sides of the 3D shape that is created by expanding the 2D structure on a 3D sphere.
• Exhaustive Ring Count - The total number of graph cycles present in the molecule.
• Frèrejacque Number - The fundamental ring count. Also known as the cyclomatic number or the
SSSR count.
• Hydrogen Bond Acceptor Count - Counts the number of atoms with lone pairs capable of hydrogen
bonding.
• Hydrogen Bond Donor Count - Counts all nitrogens, oxygens and fluorines that have hydrogens
attached.
• Rotatable Bond Count - Counts all saturated bonds. Exceptions are single bonds connected to
hydrogens or terminal atoms, Single bonds of amides, thioamides, sulphonamides and those connecting
two hindered aromatic rings (having at least three ortho substituents).
• Total Electron Count - Counts all electrons in a molecule taking into account charges.
• Lightest Isotopic Mass - Calculates the lightest isotopic mass by summing the lightest isotope for
each atom given its element.
• McGowan Characteristic Volume - Calculates the vdW volume using McGowan’s method.
• Molecular Mass - Calculates the molecular mass from atomic masses based on the IUPAC technical
reports.
• Monoisotopic Mass - Calculates the monoisotopic mass from isotopic masses based on the IUPAC
technical reports.
• Volume as a Sum of Atomic and Bond Contributions - Calculates the VABC vdW volume.
Chapter 7: CHEMINFORMATICS 167
• Empirical Formula - Generates the empirical formula for the molecule. The empirical formula is
just the molecular formula, where all element multiplicities have been divided by the greatest common
denominator.
• Molecular Formula - Generates the molecular formula for the molecule in the form of CxHy. . . where
. . . denotes all other elements and their counts in alphabetical order. This is based on the Hill system,
so if no carbon atoms are present, the hydrogen count will be in alphabetical order with the rest of the
elements.
TOPOLOGICAL
Topological descriptors are solely based on the connectivity between atoms in a molecule, such as a bond
distance matrix. The following topological descriptors are provided:
• Centric Index - Calculates the Centric index for the molecule (Bonchev et al.).
• Molecular Topological Index - Calculates the Molecular Topological index for the molecule (Schultz
et al.).
• Zagreb Indices - First and second order calculations are supported. (Z1 , Z2 )
• Bertz Complexity Index - Calculates the Bertz Complexity index for the molecule.
• Branching Index - Calculates the Branching index for the molecule. The Branching index is equiv-
alent to 1 χ.
• Chi Molecular Connectivity Indices - Indices from zeroth to third order are supported. Both
simple and valence models are calculated. (0 χ, 1 χ, 2 χ, 3 χ, 0 χv , 1 χv , 2 χv , 3 χv )
• Fraction Molecular Framework - Calculates the Fraction Molecular Framework (fMF) ratio for the
molecule.
• Kappa Shape Indices - Indices from the first to third order are supported. Both simple and alpha
models are calculated. (1 κ, 2 κ, 3 κ, 1 κα , 2 κα , 3 κα )
• Adjacency Matrix - Generates a matrix M of size A × A, where A is the number of atoms in the
molecule. M (Ai , Aj ) equals one if there is a bond connecting atoms i and j, and equals zero otherwise.
• Bond Distance Matrix - Generates a matrix M of size A × A, where A is the number of atoms in
the molecule. M (Ai , Aj ) equals the number of electrons shared between atoms i and j.
168 Chapter 7: CHEMINFORMATICS
• Bond Electron Matrix - Generates a matrix M of size A × A, where A is the number of atoms in
the molecule. M (Ai , Aj ) equals the shortest bond distance between atoms i and j.
• Detour Matrix - Generates a matrix M of size B × A, where , where B is the number of bonds in
the molecule and A is the number of atoms in the molecule. M (Bi , Aj ) equals one if bond i contains
atom j, and zero otherwise.
• Incidence Matrix - Generates a matrix M of size A × A, where A is the number of atoms in the
molecule. M (Ai , Aj ) equals the longest bond distance between atoms i and j.
• Laplacian Matrix - GGenerates a matrix M of size A × A, where A is the number of atoms in the
molecule. M (Ai , Aj ) equals one if there is a bond connecting atoms i and j and equals zero otherwise.
M (i, i) equals the number of bonds connected to atom Ai .
PHYSICOCHEMICAL
Physicochemical descriptors describe the physical or chemical properties of a molecule. These are estimations
of their real physical values. The following physicochemical descriptors are provided:
• Average Molecular Polarizability - Estimates the average molecular polarizability. Both the aver-
age hybrid components (Miller) and average hybrid polarizabilities (Kang) methods are implemented.
• Critical Pressure - Estimates the critical pressure (Pc ) of a substance based on Joback’s method.
• Critical Temperature - Estimates the critical temperature (Tc ) of a substance based on Joback’s
method.
• Critical Volume - Estimates the critical volume (Vc ) of a substance based on Joback’s method.
0
• Enthalpy of Formation - Estimates the enthalpy of formation (∆Hf,298 ) of a substance (ideal gas
at 298K) based on Joback’s method.
• Enthalpy of Fusion - Estimates the enthalpy of fusion (∆Hf ) of a substance based on Joback’s
method.
• Gibbs Energy of Formation - Estimates Gibbs energy of formation (∆G0f,298 ) of a substance (ideal
gas, unit fugacity, at 298K) based on Joback’s method.
• Heat Capacity - Estimates the heat capacity(Cp0 ) of a substance (ideal gas) based on Joback’s method.
• Lipophilicity, log P - Estimates the octanol/water partition coefficient (log P ) of a substance. The
NC+NHET, AlogP98, and XlogP v2.0 (Wang) algorithms are implemented.
• Liquid Viscosity - Estimates the liquid viscosity (ηL ) of a substance (at 298K) based on Joback’s
method.
• Molar Refractivity - Estimates the molar refractivity of a substance. Both the CMR3 and AMR
algorithms are implemented.
• Normal Boiling Point - Estimates the normal boiling point (Tb ) of a substance based on Joback’s
method.
• Normal Freezing Point - Estimates the normal freezing point (Tf ) of a substance based on Joback’s
method.
Chapter 7: CHEMINFORMATICS 169
• Topological Polar Surface Area - Estimates the topological polar surface area (TPSA) of a molecule
with the algorithm developed by Ertl et al.
ADME
Descriptors that rank bioactivity of drugs (ADME is an acronym for absorption, distribution, metabolism,
and excretion):
• Lipinski’s Rule of 5 Violations Count - Counts the number of violations to Lipinski’s rule of 5.
In cases where imported chemical data contains 3D coordinates, you can set all the z-coordinates to zero by
selecting that content and choosing the Content|Flatten menu item.
FRAGMENTATION
ChemDoodle contains several functions for fragmenting molecules. The fragmentation functions can be found
in the Content toolbar ( ).
2. Press the mouse down and drag over all the bonds to be removed, defining how the molecule is to be
fragmented.
When using the Molecular Weight fragmentation tool, molecular masses will be calculated for the frag-
ments generated. If you prefer to calculate monoisotopic masses instead, in the Preferences window under
the Functions tab, select Monoisotopic Mass for the Mass Fragmentation Calculator setting in the
Tools section.
FORMAL CHARGES
While you can place charges on atoms manually, ChemDoodle can also guess the formal charges for a
structure. To have ChemDoodle guess formal charges for a structure, execute the following steps:
GLASSWARE CLIPART
Figures for glassware setups can be created by using the glassware clipart library within ChemDoodle.
ChemDoodle contains hundreds of different glassware clipart and other laboratory clipart that can be put
together to create very complex laboratory setups. The clipart is organized into a window for easy selection,
shown in Figure 7.5. This is accessed by clicking on the Laboratory Glassware button in the Drawing
toolbar.
The left side contains tabs for selecting the category of clipart to view. While moving your mouse over the
clipart, a grey highlight will appear with a description of the clipart. An amber highlight means that the
clipart is selected.
Chapter 7: CHEMINFORMATICS 171
2. In the window that appears, select a glassware piece that you would like to place into your figure.
3. Press the mouse down on the current document and drag to place it where you prefer the piece to be
placed. Hold down the shift key to flip the template horizontally while placing.
To achieve the desired front-to-back order for glassware pieces, care must be taken when placing glassware
in a figure.
Each template is a complete image, and it is not possible to show one piece in between the front and back
of another piece. However, you may export your figure to be post-edited in vector editing software (such as
Adobe Illustrator) to achieve this effect.
All glassware clipart is governed by the same visual specifications that other shapes are. So you can change
the stroke thickness and the colors of the various components in the clipart as shown in Figure 7.6.
FLIPPING GLASSWARE
To flip the clipart graphics, just hold down the shift key while placing them. The preview will then show
you the flipped graphic.
You can also manually specify whether a clipart is flipped or not by right-clicking on it with nothing selected,
selecting the Format Clipart. . . menu item and then changing the Flip on/off choice in the Clipart section.
Many glassware clipart contain solution. You may desire to have this solution removed for your figures. To
do so, execute the following steps:
1. In your document (not in the glassware window), hover over the glassware clipart with the solution
you would like removed using a selection tool with nothing selected.
2. Right-click on the glassware clipart and select the Format Clipart. . . menu item, or press the comma
, key.
3. Scroll down to the Clipart section and deselect the Fill with Solution on/off choice.
The solution will then be removed from the glassware clipart as shown in Figure 7.7.
TUBING
You may wish to connect pieces of glassware via tubing. A good technique for doing this is by using the
Bezier Curve tool to draw the path of the tubing, and then increasing the stroke width of the path to the
desired thickness.
2. Press the mouse down in the middle of the outlet in the glassware figure where the first tubing con-
nection will be made.
3. Drag the mouse out in the direction that the first outlet faces. The longer you drag out the control
point, the longer the curve will be straight at that point.
4. Press the mouse down in the middle of the outlet in the glassware figure where the second tubing
connection will be made.
5. Drag the mouse out in the direction that the second outlet faces. The longer you drag out the control
point, the longer the curve will be straight at that point.
Chapter 7: CHEMINFORMATICS 173
6. Edit the bezier curve if necessary, or press the escape key to finish drawing the curve.
7. Hover the curve using a selection tool and right-click, selecting the Format Bezier Curve. . . menu
item.
8. In the Strokes section of the settings window that appears, change the Thickness setting to 10 pixels.
Your completed figure will then contain a nice smooth curve connecting the outlets that represents tubing
as shown in Figure 7.8.
BIOLOGICAL CLIPART
In addition to laboratory clipart, ChemDoodle includes clipart for creating biological diagrams. The clipart
is organized into a window for easy selection, much like the Laboratory Glassware, as shown in Figure 7.9.
This is accessed by clicking on the BioArt button in the Drawing toolbar.
174 Chapter 7: CHEMINFORMATICS
The left side contains tabs for selecting the category of clipart to view. While moving your mouse over the
clipart, a grey highlight will appear with a description of the clipart. An amber highlight means that the
clipart is selected.
2. In the window that appears, select a glassware piece that you would like to place into your figure.
3. Press the mouse down on the current document and drag to place it where you prefer the piece to be
placed. Hold down the shift key to flip the template horizontally while placing.
To achieve the desired front-to-back order for BioArt pieces, care must be taken when placing BioArt in a
figure.
Each template is a complete image, and it is not possible to show one piece in between the front and back
of another piece. However, you may export your figure to be post-edited in vector editing software (such as
Adobe Illustrator) to achieve this effect.
Chapter 7: CHEMINFORMATICS 175
FLIPPING BIOART
To flip the clipart graphics, just hold down the shift key while placing them. The preview will then show
you the flipped graphic.
You can also manually specify whether a clipart is flipped or not by right-clicking on it with nothing selected,
selecting the Format Clipart. . . menu item and then changing the Flip on/off choice in the Clipart section.
GRAPH REDUCTION
To reduce molecule graphs, execute the following steps:
1. Select the structure with the graphs you would like to be reduced.
2. Expand the Structure|Graph Reduction submenu and select the preferred reduction method.
REDUCE 0◦ (LONE)
REDUCE 1◦ (TERMINALS)
Will remove all selected atoms that have only one bond attached to them. This process will stop after the
first iteration.
REPEATEDLY REDUCE 1◦
Will remove all selected atoms that have only one bond attached to them. This process will continue until
it has pruned all terminal chains from the selection.
REDUCE 1◦ + 0◦
REDUCE 2◦ (CHAINS)
Will remove all chains from a molecule, leaving single bonds connecting any remaining 3◦ atoms.
176 Chapter 7: CHEMINFORMATICS
REDUCE 2◦ + 1◦ + 0◦
Will remove all lone, terminal and chain atoms, leaving a simplified core that represents the embedded ring
structure of a graph.
HYDROGENS
Hydrogens do not need to be drawn on structures as they are implicitly declared. At any time, hydrogens
can be added to a structure as text in atom labels or as atoms with bonds attached.
By default, implicit hydrogens are automatically rendered on any element labels that are visible. To disable
the auto-rendering of implicit hydrogens, uncheck the Show Implicit Hydrogens visual specification in
the Hydrogens section of the Atom section of the Visuals tab in the Preferences window.
You can also disable the auto-rendering of implicit hydrogens for a specific atom by executing the following
steps:
This will stop the auto-rendering of implicit hydrogens on that atom. To restore the implicit hydrogen
auto-rendering, follow the same steps as above, but choose the Show Implicit Hydrogens menu item.
To add hydrogens to a structure as atoms as shown in Figure 7.10, execute the following steps:
2. Expand the Structure|Add/Remove Hydrogens submenu and select the From Selection menu
item.
To add hydrogens as text into atom labels as shown in Figure 7.11, change the Add as setting in the
Hydrogens section in the Preferences window, under the Visuals tab, under the Atoms subtab to
Text. After doing so hydrogens will be explicitly added as text when using the Add/Remove Hydrogens
functions.
You can modify how hydrogens are added to carbon atoms: whether they are always added, only added to
unsaturated carbons or never added to carbons. These options are available in the Preferences window,
under the Visuals tab, under the Atoms subtab in the Carbons section.
IUPAC NAMING
Using ChemDoodle, you can import a structure from an IUPAC name or generate an IUPAC name from a
structure.
NAME TO STRUCTURE
To parse an IUPAC name and generate a chemical structure, execute the following steps:
1. Select the Parse IUPAC Name. . . menu item from the Structure menu.
2. Enter the IUPAC name at the prompt and select the Accept button.
STRUCTURE TO NAME
To generate an IUPAC name from a chemical structure, execute the following steps:
1. Select the molecule you would like to produce an IUPAC name for.
The IUPAC name for the selected structure will be displayed in a message window that will appear. You
can then paste this name into the document or to the system clipboard.
178 Chapter 7: CHEMINFORMATICS
At times, it may be more convenient to have an IUPAC name associated with a molecule, and have that
name automatically update while drawing. This is possible using autoupdating labels, which are covered in
detail in the SHAPES chapter. To attach an auto-updating label to a molecule to display the IUPAC name,
execute the following steps:
2. ISelect the Structure|Attach Updating Label menu item, or press the corresponding button in the
Content toolbar.
3. In the popup that appears, make sure IUPAC Name is selected in the drop-down selection.
As you edit or move your molecule, the updating label will update accordingly. To copy the IUPAC name
from an updating label to the system clipboard, right click on the label with a selection tool and select the
Copy Text menu item.
There are many options you can define to control how ChemDoodle generates IUPAC names. These options
are listed in the Preferences window, in the Functions tab.
Default: Off
On: 1-Chloromethane
Off: Chloromethane
Default: On
On: 1-Butene
Off: But-1-ene
Default: On
On: Methane
Off: methane
Chapter 7: CHEMINFORMATICS 179
Append Warnings
Default: Off
On: 2,2,2-Trimethylpropane (Unusual valences)
Off: 2,2,2-Trimethylpropane
Default: On
On: Perchloromethane
Off: Tetrachloromethane
Default: On
On: Bis(2-napthyl)methane
Off: Di-2-naphthylmethane
Default: Off
On: 9-(1,2-Dimethylpentyl)anthracene
Off: 2-(9-Anthryl)-3-methylhexane
Default: Off
On: 2-Butyrylpyridine
Off: 1-(2-Pyridyl)-1-butanone
Default: On
On: Ethylamine
Off: Ethanamine
Default: On
On: Hexanoic acid
Off: Pentanecarboxylic acid
180 Chapter 7: CHEMINFORMATICS
Default: Off
On: 3-Formylhexanedial
Off: 1,2,4-Butanetricarbaldehyde
Substituents
Default: Off
On: 1-Oxo-1,2-dihydronaphthalene
Off: 2H-Naphthalen-1-one
Default: On
On: Isopentane
Off: 2-Methylbutane
Use Ortho/Meta/Para
Default: On
On: p-Diethylbenzene
Off: 1,4-Diethylbenzene
Default: On
On: 1H-Silole
Off: Sila-2,4-cyclopentadiene
Default: Off
On: 1H-Pyrid-2-one
Off: 1H-Pyridin-2-one
Default: On
On: [10]Annulene
Off: 1,3,5,7,9-Cyclodecapentaene
Chapter 7: CHEMINFORMATICS 181
Default: On
On: Cyclopentaazane
Off: Pentazacyclopentane
Default: On
On: Biphenyl
Off: Phenylbenzene
Default: On
On: 2,2´-Binaphthalene
Off: 2,2´-Binaphthyl
Default: Off
On: (E)-2-Butene
Off: 2-Butene
Default: Off
On: 2-(2-(1-(2-Aminoethoxy)ethoxy)ethoxy) propiononitrile
Off: 2-2-[1-(2-Aminoethoxy)ethoxy]ethoxypropiononitrilePentazacyclopentane
KEKULÉ STRUCTURES
ChemDoodle contains a function for assigning double bonds to a structure so that pi electron delocalization is
maximized. Both frames of single bonds and substructures consisting of only resonance bonds are considered.
182 Chapter 7: CHEMINFORMATICS
To easily draw Kekulé structures, you may begin by just drawing a single bond frame. This way, ChemDoodle
can optimally assign double bonds to the structure. If there are other bond types present, ChemDoodle will
not Kekulize the structure. However, the Structure|Saturate function will change all bond types to single
bonds.
For example, corannulene is generated from a Kekulization of a single bond frame in Figure 7.12.
In some cases, structures may be read into ChemDoodle with resonance bonds. It may be necessary to
present a Kekulé structure instead of the resonance model. When Kekulizing a structure with resonance
bonds, only the resonance bonds will be affected.
For example, the aromatic rings in Viagra are Kekulized in Figure 7.13.
Figure 7.13: Kekulizing the Aromatic Rings in the Resonance Model for Viagra
Chapter 7: CHEMINFORMATICS 183
You can also delocalize a Kekulé structure. Do this by selecting the content to delocalize and select the
Structure|Delocalize menu item.
LABEL EXPANSION
Atom labels can be much more than just an element symbol. They may contain implicit hydrogens or
chemical shorthand notations or abbreviations. ChemDoodle can expand these condensed labels to their all
atom models.
EXPANDING LABELS
1. Select the atoms with labels to be expanded using any of the selection tools.
IMPLICIT HYDROGENS
Implicit hydrogens can be presented as text in an atom label. They may be added automatically, can be
added manually using the Atom Label tool or globally using the Add/Remove Hydrogens function
with the appropriate visual specifications set.
When expanded, implicit hydrogens are ignored. So the label “NH2” will become an “N” label when
expanded.
CONDENSED LABELS
Chains and functional groups may be denoted with a condensed label. For instance, a carboxy group may
be denoted by a “COOH” atom label or an ethyl group may be denoted by “CH2CH3”.
When expanded, condensed labels will be replaced by the all atom model of the fragment as shown below
in the figure on the right.
(a) Condensed Atom Labels (b) Expanded Structure for Same Molecule
1. Linear Chains - Stringing elements together will place them in a chain, so “CCCC” or
“CH2CH2CH2CH3” denotes a n-butyl group.
2. Repeating Chains - Using parentheses to begin a label will denote a repeating chain, so “(CH2)4”
will represent butane radical. If this label is attached to two bonds, they will be placed on opposite
ends.
3. Multiple Attachments - Using parentheses (not at the start of the label) will denote multiple
attachments, so the label “C(CH3)3” will denote a t-butyl group.
4. Single and Double Bonds - If no bonds are placed between elements, then single bonds are used
to connect them. The “-” (minus) character will also specify a single bond connection and the “=”
(equals) character will specify a double bond connection. Therefore, “CC” and “C-C” both specify an
ethyl group while “C=C” will specify a vinyl group.
5. Radical Formulas - Radical formulas are recognized and must start with a carbon label and the
second token must be a number. So “C3F7” will be recognized as a perfluoropropyl radical. Keep in
mind radical formulas can be ambiguous, and ChemDoodle will only be able to match the elemental
composition of the formula; ChemDoodle will not be able to know which isomer you prefer.
ABBREVIATIONS
In addition to condensed formulas, abbreviations can be used to define fragments in atom labels. For instance,
the “Ph” abbreviation defines a phenyl group. All supported abbreviations are listed in the Symbols widget
in the Abbreviations section. When expanded, abbreviations will be replaced by the all atom model they
define as shown below in the figure on the right.
(a) A Molecule with Abbreviations (b) Expanded Structure for Same Molecule
ChemDoodle can only expand abbreviations that represent discrete molecules, monovalent or divalent frag-
ments. ChemDoodle will attempt to interpret abbreviations properly based on their valency. For instance,
the “CO2” abbreviation with a valency of zero is a carbon dioxide molecule while that same label with a
valency of two denotes an ester group.
2. Type the abbreviation label to be used in atom labels in the Abbreviation Label text field.
3. Type the full name of the abbreviation in the Full Description/Name text field.
Chapter 7: CHEMINFORMATICS 185
4. Provide the SMILES string for the full atom model of the abbreviation in the SMILES for Abbre-
viation text field. If the valency of the abbreviation is greater than zero, then the attachment atom is
the first atom defined by the SMILES string. If the abbreviation is divalent, then the last atom defined
in the SMILES string will be used as the second attachment atom.
5. Select the valency of the abbreviation using the Valency drop down selection.
ChemDoodle will update to recognize the added abbreviation and when used, that abbreviation will be
expanded to the SMILES string defined.
Abbreviations and condensed notations can be combined. For instance, the atom label “CPh3” denotes a
triphenylmethyl group.
MOLECULAR FORMULAS
Sometimes you may intend to input a molecular formula into an atom label, to calculate a molecular weight,
for instance. If a molecular formula is input, then ChemDoodle will associate that atom with an isomer
of the molecular formula, as best it can as shown in Figure 7.16. Your calculations of weight then will be
correct, however, other calculations will need to be scrutinized for accuracy. For accurate calculations, make
sure to draw a correct structure or structural formula.
To quickly create a Lewis Dot Structure from a drawn molecule, execute the following steps:
1. Select the molecule you would like to generate a Lewis Dot Structure from.
The created Lewis Dot Structure will then appear below the selected structure. This function will work on
the majority of structures and will automatically place lone pairs to satisfy the octet rule. Output of this
function is show in Figure 7.17. You may wish to post edit these structures or change their scales for the
optimal figures.
186 Chapter 7: CHEMINFORMATICS
Figure 7.17: ChemDoodle generates Lewis Dot Structures for drawn molecules.
To manually create Lewis Dot Structures, you can modify a few options in ChemDoodle. Then as you draw,
the tools will be optimized for Lewis Dot Structures and allow you to create them easily.
• Use Lewis Dot Style (Preferences>Visuals>Bonds>Options) - Enable this option to change from
rendering standard bond order bonds to their Lewis Dot Structure equivalent.
• Chain Angle (Preferences>Functions>Tools>Cleaning) - Set the chain angle to 180◦ to have the
clean tool clean structures to 90◦ angles.
MACROMOLECULE BUILDERS
ChemDoodle provides a few tools for building complex molecule geometries.
If you are using these tools to create large structures, we recommend you enable the Ring Search Cutoff
option in Preferences, under the Functions tab in the Performance section.
All structures generated by these tools are defined by 3D coordinates, so you can use the Rotate in 3D
tool in the Content toolbar to change the perspective.
CARBON NANOTUBES
To create carbon nanotubes, select the Carbon Nanotube Builder button ( ) in the Macromolecular
Tool group button in the Drawing toolbar. You can then place a carbon nanotube by executing the
following steps:
1. Press the mouse down on the Doodle Board where you would like the base of the carbon nanotube
to sprout from.
Chapter 7: CHEMINFORMATICS 187
2. While the mouse is pressed down, move the mouse horizontally to change the width of the carbon
nanotube. The carbon nanotube will expand the number of rings present in the loop to fit a width
that reaches the mouse pointer.
3. While the mouse is pressed down, move the mouse vertically to change the height of the carbon
nanotube. The carbon nanotube will expand the number of loops present to fit a height that reaches
the mouse pointer.
4. By default, zigzag geometries are created, hold down the shift key to create armchair geometries
instead.
5. Release the mouse when you are satisfied with the current geometry to place it.
ChemDoodle will automatically place double bonds in the carbon nanotube. While using the tool to create
carbon nanotubes, a preview will be displayed without double bonds to more easily view the output, and
a description will be displayed to the bottom right of the mouse pointer stating whether the geometry is
zigzag or armchair or other statistics about the geometry as shown in Figure 7.18.
(a) Zigzag Carbon Nanotube Geometry (b) Armchair Carbon Nanotube Geometry
PRISMS
To create prisms, select the Prism Builder button in the Macromolecular Tool group button ( ) on
the Macromolecular Tool group button in the Drawing toolbar. You can then place a carbon nanotube
by executing the following steps:
1. Press the mouse down on the Doodle Board where you would like the center of the prism to be
located.
2. While the mouse is pressed down, move the mouse horizontally to change the width of the prism. The
prism will expand the number of rings present to fit a width that reaches the mouse pointer.
3. Release the mouse when you are satisfied with the current geometry to place it.
While using the tool to create prisms, a preview will be displayed with a description to the bottom right of
the mouse pointer stating statistics about the geometry as shown in Figure 7.19.
188 Chapter 7: CHEMINFORMATICS
NEWMAN PROJECTIONS
To build graphics for Newman Projections, execute the following steps:
6. In the Elements section, select the Use Circles checkbox, make sure Coloring is set to User Chosen
and Radius Convention is set to Constant, and then set the Constant Radius to the preferred
size. You will now see a black circle appear over the central carbon.
7. In the Atom Settings window, under the Colors section, change the Text Color to white. You
should now see a figure just like Figure 7.20.
10. Rotate the second structure to the desired torsion for the Newman Projection.
11. Using a lasso tool, move the second drawn structure over the first to complete the Newman Projection.
You can then edit the terminal labels to display the structure desired as is shown in Figure 7.21. You may
wish to save a copy of this structure as a file for later use.
RING PERCEPTION
Rings are cycles of atoms and are important, because ChemDoodle uses them to define graphics such as
which direction double bonds face and for calculations such as aromaticity detection. There are several
published algorithms to define rings in structures producing different ring sets.
• Smallest Set of Smallest Rings - The smallest set of smallest rings (SSSR) is the standard for
defining ring sets in flat 2D structures.
• Euler Facet Rings - he Euler facet ring set is better than the SSSR at defining essential rings in 2D
depictions of 3D structures. It is defined by all the rings that make up the faces of a 3D object when
the 2D chemical graph is placed on a 3D sphere.
Ring sets can be exploded from the structure. In other words, they will be laid out around the structure to
show the rings and where they are contained. To explode ring sets, execute the following steps:
2. Expand the Structure|Rings submenu and select the desired set to explode.
In very complex structures, the exploded ring diagram will be highly overlapped. Just stack the rings (in
the Content menu) to view them all clearly.
PERFORMANCE CONSIDERATIONS
When dealing with heavily embedded structures, such as zeolites or MOFs, the algorithms may become very
CPU intensive. In these cases, you can disable deep searching for rings by selecting Ring Search Cutoff
in the Functions panel in the Preferences window.
190 Chapter 7: CHEMINFORMATICS
SEQUENCE TOOL
ChemDoodle provides a tool for generating sequence structures for common polymer types. The following
polymer types are supported:
To generate sequences, use the Sequence tool ( ) in the Macromolecular Tool group button in the
Drawing toolbar. To draw a sequence, execute the following steps:
1. Click on the current document where you want the sequence to originate from. The endpoints of the
sequence will appear. For amino acid sequences, a water molecule will appear.
2. A single atom will be surrounded by a blue circle; this is the appending atom. All changes to the
sequence append directly to this atom. You can hover over other atoms and click to set a new appending
atom.
3. Use the keyboard to type the one letter hotkeys for the residues in the sequence set. For instance,
pressing the A key will append an alanine residue, and pressing the R key will append an arginine
residue.
Sequences will automatically wrap to stay within the margins of the current document as shown in Fig-
ure 7.22.
Use this tool to easily create macromolecular structures, and to quickly calculate properties such as weights
and isotopic distributions.
STEREOCHEMISTRY
The stereochemistry of chiral centers and double bonds can be determined by selecting the Struc-
ture|Stereochemistry functions. An attribute object will be associated with the stereocenter to denote
the stereochemical configuration. Several conventions can be used.
Centers can be forced into a particular configuration in addition to determining the configurations based on
the 2D layout.
CHIRAL CENTERS
Cahn-Ingold-Prelog (CIP) priority rules are used to resolve rectus (R) and sinestra (S) enantiomers. Meso
centers are also resolved with lower case rectus (r) and sinestra (s) identifiers.
Forcing a configuration will interchange the protruding and recessed bonds, if necessary. If only single bonds
are present, then the appropriate wedge bonds will be placed when a configuration is forced.
Chapter 7: CHEMINFORMATICS 191
DOUBLE BONDS
CIP priority rules are used to resolve entgegen (E) or zusammen (Z) configurations around double bonds.
The less systematic cis/trans conventions can also be used to define olefin enantiomers. The E/Z system will
work for any double bond presented, while the cis/trans conventions will not return results in ambiguous
cases.
Forcing double bond stereochemistry will flip both substituents on one atom’s side of the double bond
through the double bond axis, if necessary.
RESOLVING STEREOCHEMISTRY
1. Select the structures or parts of structures with stereocenters to be resolved with the selection tools.
3. Choose the appropriate Assign menu item to resolve stereocenters of that type.
You may also access these functions through the right-click menu.
3. If that object is a potential stereocenter, then the Stereochemistry submenu will be present. Expand
this submenu.
STRUCTURE PERSPECTIVE
Even though ChemDoodle generates graphics for structures in two dimensions, the underlying structures are
defined in three dimensions.
ChemDoodle will read in 3D coordinates from all chemical files and provides functions for rotating structures
in 3D.
While ChemDoodle has some 3D editing features, it is not a molecular modeler and is not
the appropriate tool for building 3D coordinates for structures.
3. Click the mouse down and drag to rotate the structure in 3D.
By default, mouse movements while rotating structures in 3D will rotate the structure around the x- and y-
axes based on horizontal and vertical movement respectively. You can also set the 3D rotations to be defined
by a quaternion trackball in the Preferences window under the General tab if that is more comfortable
for you.
As when rotating structures in 2D, there will also be a rotation anchor present during 3D rotation. Before
selecting the 3D rotation tool, you can move the rotation anchor to a strategic position other than the center,
such as over atom positions. This makes it easy to rotate structures around atoms in 3D space.
UNIQUE IDS
IDs can be automatically added as attributes for atoms and bonds. To do so, select the appropriate choice
in the View|Unique IDs submenu.
ChemDoodle contains a zero/ionic bond order specifically for these cases. You can use this bond order by
selecting the Zero/Ionic bond type button ( ) in the Bonds palette in the Drawing toolbar. Any atoms
connected with this bond type will be spatially linked and can be sent to cheminformatics algorithms such
as molecular formula generation and structure cleaning.
Most file types do not recognize zero order bonds, so saving these bond types and loading
them into other applications may not produce desired results.
CHAPTER 8
Reactions
194 Chapter 8: REACTIONS
Contents
OVERVIEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
OVERVIEW
Reactions can be drawn in ChemDoodle using structures and arrow shapes. Almost any type of reaction
or mechanism can be drawn. ChemDoodle also contains tools for explicitly defining reactions for various
purposes.
This section introduces the new user to reactions within ChemDoodle. It covers the following topics:
ARROW TYPES
Many different types of arrows can be easily created using the Arrows palette described in the INTRO-
DUCTION chapter. This section briefly goes over the different styles and presets.
ARROWHEAD STYLES
Arrowhead styles can be set to both the start and end of the arrow. Several arrowhead styles (half- heads)
can be flipped over the arrow axis. The following arrowhead styles are provided:
• Full Indented -
• Full -
• Unfilled Full -
• Chevron -
• Half Indented -
• Half -
• Unfilled Half -
196 Chapter 8: REACTIONS
• Hook -
Both the arrowhead length and angle can be changed to match any look. To change the arrowhead length
and angle, execute the following steps:
2. Right-click on the arrow and select the Format Line. . . menu item.
3. Scroll down to the Reaction section in the Format Line window that appears.
4. In the Arrow at Start and Arrow at End sections, use the Length and Angle sliders to edit the
arrowheads.
Instead of opening the shape settings window, you can easily toggle the display of arrowheads on the ends
of objects that support arrowheads by hovering the object and pressing the left arrow ← key (to toggle
start) or right arrow → key (to toggle end).
CONNECTOR STYLES
A connector is the line that connects the start and end arrows, if any. The following connector styles are
provided:
• Solid -
• Dashed -
• Wavy -
• Doubled -
• No Go (cross) -
• No Go (slash) -
• Rearrangement -
Many different types of arrows can be drawn from the Arrows palette. The following describes how these
tools can be used to build common arrow types.
Chapter 8: REACTIONS 197
BUILDING REACTIONS
Reaction figures can be drawn by placing structures next to arrow shapes to describe reaction schemes. This
method will create a visual diagram for the reaction, but underlying semantics will not exist. In other words,
there is no formal definition of the reaction reactants or products. To address this, ChemDoodle provides a
reaction building system to explicitly define reactions and reaction schemes.
IMPLICITLY
1. Draw the arrow you would like to represent the reaction arrow.
2. Draw any reactants and place them to the left of the arrow shape.
3. Draw any products and place them to the right of the arrow shape.
4. Select the arrow shape and all reactants and products using the selection tools.
5. Press the Reaction|Build Implied Reaction menu item to define the reaction.
Chapter 8: REACTIONS 199
All structures with midpoints to the left of the arrow shape’s midpoint will be defined as reactants in the
reaction while all structures with midpoints to the right of the arrow shape’s midpoint will be defined as
products in the reaction.
EXPLICITLY
To explicitly define a reaction, first select the arrow shape you would like to use to represent the reaction
arrow using the selection tools. Then press the Reaction|Edit Reaction. . . menu item. Open the Edit
Reaction window for that selected arrow, as shown in Figure 8.1.
The Edit Reaction window is a drag and drop interface. All molecules in the current document are
displayed in the bottom tray, while the left and right trays correspond to the constituent reactants and
products respectively. Just drag and drop molecules from the bottom tray into the other two to set up the
reaction. Once a molecule has been placed, it will be grayed out in the bottom tray and no longer selectable.
You can transfer a placed molecule between the products and reactants by dragging the molecule between
the side trays. You can remove a molecule from the reaction completely by dragging and dropping it back
in the bottom tray. Press the Done button in the Reaction Builder window to set the reaction.
To add reaction conditions above and below the reaction arrow, first select the arrow shape you would like
to add conditions to using the selection tools. Then press the Reaction|Edit Reaction. . . menu item to
open the Edit Reaction window for the selected arrow.
The Edit Reaction window contains two text editors for adding text above and below the reaction arrow.
Click on a text area and type to add text. You can format the text using the text formatting tools above
the text areas.
200 Chapter 8: REACTIONS
Use the Symbols widget to input characters into the reaction condition text areas that are not present on
the keyboard.
Press the Done button in the Reaction Builder window to set the reaction.
After building a reaction, plus symbols will automatically be added at the midpoints between the constituent
reactants and products. This feature can be turned off in the Preferences window under the Visuals tab
under the Reactions tab as shown in Figure 8.2. Simply uncheck the Automatically Place Pluses option.
If you want to add your own custom text, use Text Area objects. Text Area objects are discussed in the
SHAPES chapter.
DISSOLVING REACTIONS
To dissolve a built reaction, select the arrow the reaction is defined by with a selection tool, then select the
Reaction|Dissolve Reactions menu item.
Chapter 8: REACTIONS 201
CLEANING REACTIONS
To clean a reaction, execute the following steps:
1. Define the reaction implicitly or explicitly using the instructions in the previous section.
2. Select the arrow shape of the reaction you would like to clean using the selection tools.
The reaction arrow will be horizontally leveled and resized to its text adhering to the Text Buffer visual
specification. Then the reaction arrow and constituent molecules will be aligned according to their vertical
centers and distributed horizontally with a buffer space. The entire reaction is then centered horizontally. If
the reaction is too wide for the document, the reactants and arrow are then stacked above the products so
that both groups are mutually centered as shown in Figure 8.3.
The settings for determining how reactions are laid out can be defined in the Preferences window under
the Visuals tab under the Reactions tab as shown in Figure 8.3 above.
You can adjust the double line spacing for equilibrium arrows, decide whether or not pluses should be
automatically drawn, set the text buffer for conditions text and the buffer between constituent reaction
objects. You can also set the default settings for arrowheads.
ChemDoodle can clean multiple reactions at the same time, but currently can only properly clean discrete
reactions. Cleaning complex reaction schemes with a given molecule defined in several different reactions
may not produce desired results.
CHAPTER 9
Spectra
Chapter 9: SPECTRA 203
Contents
OVERVIEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
OVERVIEW
ChemDoodle understands several spectroscopy and spectrometry techniques. These spectra can be loaded
and edited to create graphics. This section introduces the new user to spectra within ChemDoodle. It covers
the following topics:
INSERTING SPECTRA
Spectra can be read in from the JCAMP-DX format which is the standard defined by IUPAC. The currently
supported JCAMP formats are for nuclear magnetic resonance spectroscopy (NMR), infrared spectroscopy
(IR), mass spectrometry (MS) and chemical structures.
2. In the file chooser that appears, change the format filter on the bottom to IUPAC JCAMP-DX.
3. Find the JCAMP file on your computer and select it with the file chooser.
4. Press the Open button at the bottom-right of the file chooser to load the spectrum.
The spectrum will be loaded and displayed in the center of a new document.
SPECTRA TYPES
Both continuous and discontinuous spectra are supported. An example of NMR input is shown in Figure 9.1.
An example of IR input is shown in Figure 9.2. An example of MS input is shown in Figure 9.3.
JCAMP NTUPLES
ChemDoodle can understand multiple spectra from a single JCAMP file when described by the NTUPLES
specification. Multiple spectra will be placed in a vertical column in the document on load.
UNINTERPRETABLE SPECTRA
Some producers make non-conforming or custom JCAMP files. Therefore, ChemDoodle may not be able to
understand a JCAMP file. If ChemDoodle was not able to interpret any spectra from the JCAMP file, you
will see the message shown in Figure 9.4. Please send us the JCAMP file if you encounter this problem so
that we may improve our compatibility with the format.
206 Chapter 9: SPECTRA
Figure 9.4: ChemDoodle could not understand the spectrum in the JCAMP file.
SAVING SPECTRA
Be very careful when overwriting spectra to formats other than the ChemDoodle Document. ChemDoodle
only reads and writes the information that is relevant to the display of its graphics, and other data will be
lost. If saving third party spectra files for any reason, always save them as a new file.
SIMULATING SPECTRA
ChemDoodle can simulate spectra for various techniques. Currently the following techniques are imple-
mented:
1. Select a the chemical structure you would like to simulate a spectrum for using the selection tools.
The generated spectrum will then appear on the Doodle Board. Very intensive simulations may take a
few seconds to complete.
Chapter 9: SPECTRA 207
EDITING SPECTRA
SIMULATING SPECTRA
To move spectra, use a selection tool, either the lasso or the rectangular marquee. Make sure that no content
is currently selected by emptying the current selection. Execute the following steps:
1. Hover the mouse pointer over the spectrum so an open hand mouse cursor appears and the two spectrum
anchor points are drawn as shown in Figure 9.5.
REMOVING SPECTRA
• Use a selection tool to hover the mouse pointer over the spectrum until an open hand mouse cursor
appears and the two spectrum anchor points are drawn as shown in Figure 9.5. Then press either the
backspace or delete key.
• Use the Eraser tool to hover the mouse pointer over the spectrum so the two spectrum anchor points
are drawn. Then click with the mouse.
• Select the spectrum using any of the selection tools. Then press either the delete or backspace key.
Expanding the spectrum will fit the entire range and domain of the plot to the display rectangle. Execute
the following steps.
Editing the perspective will allow you to modify how the plot fits in the viewing rectangle and will also allow
you to edit the axes and title. These functions are presented in the Spectrum Edit window as shown in
Figure 9.6.
To change the plot domain, click and drag the sliders presented directly under the spectrum. The sliders
display, from left to right, the minimum domain cutoff, the magnitude of the domain, and the maximum
domain cutoff. You can also change the plot domain by clicking and dragging on the main spectrum panel.
Click on the placement where you would like the domain to begin, then drag to where you would like the
domain to end and release the mouse. A dotted grey line will display while dragging to show you the new
domain. Additionally, holding the shift key while dragging on the spectrum will translate the domain of
the spectrum.
To change the range scale, click and drag the vertical slider directly to the right of the spectrum. You can
also change the range scale by using the mouse scroll gesture on the main spectrum panel. Scroll up to
increase the range scale and scroll down to decrease the range scale.
To change the title of the spectrum, in the Spectrum Edit window shown in Figure 9.6, click on the Title
text field located at the bottom-left and type in the desired title.
Chapter 9: SPECTRA 209
X-axis options are presented in the X Axis section of the Spectrum Edit window shown in Figure 9.6.
You can choose to show or hide the x-axis by clicking the Show check box. You can choose whether or not
to flip the domain by clicking the Flip check box. You can adjust the increments for the major and minor
tick spacings using the Major Tick Spacing and Minor Tick Spacing drop-down selections. The values
in the drop-down selections are exponents for base 10. You can change the title of the x-axis by clicking on
the Unit text field and typing the desired title.
Y-axis options are presented in the Y Axis section of the Spectrum Edit window shown in Figure 9.6.
You can choose to show or hide it by clicking the Show check box. The Baseline Bump check box will
positively offset the plot by a small value. You can adjust the increment for the major tick spacing using
the Tick Spacing drop-down selection. The values in the drop-down selection are exponents for base 10.
You can change the title of the y-axis by clicking on the Unit text field and typing the desired title.
SHOWING GRIDS
2. Right-click on the spectrum and select the Format Spectrum. . . menu item.
3. Scroll down to the Grid section and select the Show Grid checkbox.
The color and thickness of the grid lines can also be set in this format window. A grid appears as shown in
Figure 9.7.
2. Right-click on the spectrum and select the Format Spectrum. . . menu item.
3. Scroll down to the Integration Line section and select the Show for NMR Spectra checkbox.
210 Chapter 9: SPECTRA
The color and thickness of the integration line can also be set in this format window. While intended for
NMR spectra, integration lines can be added to any plot if desired. An integration line appears as shown in
Figure 9.8.
Contents
OVERVIEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
3D GRAPHICS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
OVERVIEW
All graphics in ChemDoodle are fully customizable. Visual specifications for the graphics can be defined for
the entire document, groups of objects or individual objects.
This section introduces the new user to ChemDoodle document settings and visual specifications. It covers
the following topics:
DOCUMENT SETTINGS
Document settings are the variables that determine how graphics are rendered in a document. They are also
called visual specifications when referring to an individual object. All together, they form the document’s
style sheet.
STYLE SHEETS
Style sheets can be chosen when creating formatted documents. The creation of formatted documents is
discussed in CHEMDOODLE BASICS.
In addition to creating or conforming ChemDoodle documents to the preset style sheets, you can create
your style sheets in ChemDoodle Document Settings files that can be used later. There is an Edit|Export
Document Settings. . . function for this purpose. In the Preferences window, under the Visuals tab,
under the Page subtab, there is also a Create Chemical Document Settings File button at the bottom
of the options. Execute the following steps to create a new ChemDoodle Document Settings file with your
completed style sheet:
1. Cycle through all the tabs in the Visuals group of the Preferences window. Set each option on each
tab to the desired value.
2. Click on the Create Chemical Document Settings File button in the Preferences window under
the Visuals tab under the Page tab.
3. A new window will appear. Type in the name of the ChemDoodle Document Settings file.
4. Choose three fonts to cascade through. This is important because different operating systems have
different font sets and you may have selected a font not accessible on another operating system. Serif
and SansSerif will always be defined on all operating systems, so select those fonts in the third option
as wild cards.
All Chemical Document Settings files are saved to the presets folder in the ChemDoodleSettings folder lo-
cated in your operating system’s standard Documents folder. Any functions for using ChemDoodle Document
Settings files or for conforming documents will now list the new style sheet.
If you want to use Chemical Document Settings files provided by other users of ChemDoodle, just copy their
214 Chapter 10: VISUAL SPECIFICATIONS
file into the presets folder in the ChemDoodleSettings folder located in your operating system’s standard
Documents folder. If you have ChemDoodle open while copying the file, close and restart it. The copied
style sheet will then be accessible in ChemDoodle.
When you globally change the visual specifications for a document, ChemDoodle will ask you if you would
like the changed settings to become the new default settings. There are two cases when this happens:
Just click Yes to set the changed settings as the default settings. Now when a new document is opened,
the current default settings will be used to define the graphics. Alternatively, you may answer No to the
question, and later, if you decide to indeed use the current document settings as the default document
settings, then select the Edit|Remember Document Settings. . . menu item.
To restore the original default document settings, open the Preferences window and click the Restore
Defaults button at the bottom of the window. Then close the window and select Yes when asked to set
the current settings as the new default settings.
INDIVIDUAL SETTINGS
SETTING TYPES
All visual specifications provided in ChemDoodle are listed in the Preferences window under the Visuals
tab as shown in Figure 10.1.
Chapter 10: VISUAL SPECIFICATIONS 215
Each visual specification consists of a title to the left and a component to the right. These components
include:
• On/Off Choices - Click the check box to choose whether the specification is used or not. For
example, the following check box will enable or disable the Clear Bond Overlaps visual specification.
• Single Option Choices - Choose one of the options from a group exclusively to define it as the
value to use for the specification. For example one option can be chosen from the following group set
to determine the value for the Covalent Style specification.
• Number Sliders - Define a number value by clicking and dragging the slider or by explicitly typing
the value in the text field. Some number components will be associated with a dimension drop down
selection to easily set values in other units, such as centimeters instead of pixels. For example, slide
the slider or type a value into the text box of the following number component to define the value for
the Bond Line Thickness specification.
Some number components define angles, and an angle swivel will be provided instead of a
slider. Click and drag to the angle you want on the swivel to set the angle.
216 Chapter 10: VISUAL SPECIFICATIONS
• Color Buttons - Click on color buttons and use the color selection window that appears to select a
new color. For example, the following color button will determine bond line color.
All objects drawn after changing the visual specifications in the Preferences window will conform to the
new specifications. All visual specifications are listed in the following sections.
PAGE
Colors
Text
Horizontal Spacing - A number slider to set the horizontal whitespace between each label token.
Vertical Spacing - A number slider to set the vertical whitespace between each label token.
Minimize Line Spacing - A toggle that collapses line spacing to reduce whitespace in atom labels. Enabled
by default. Deselect this to force uniform line spacing between the baselines of each line.
Subscript Reduction - A number slider to set the size of subscript font relative to the label font.
Subscript Shift - A number slider to set the magnitude of the offset from the label font baseline for drawing
subscripts.
Superscript Reduction - A number slider to set the size of superscript font relative to the label font.
Superscript Shift - A number slider to set the magnitude of the offset from the label font ascent to draw
superscripts from.
Dimensions
Page Size - A specialized component for setting the page size. Set the width and height by typing in the
text boxes or select a standard size from the drop down selections. The button to the left of the text
fields will swap the width and height.
Ångströms / Bond Length - A number slider for setting the ratio between Ångströms and the Bond Length
specification in pixels. This specification is useful when finding covalent bonds and when reading in files
with Ångströms coordinates.
Margins
ATOMS
Colors
Labels
Buffer Type - A single option choice that changes the shape of the label buffer. The default setting will
shape the buffer as a convex hull around the label. The other choice will set the buffer as a rectangle
around the label.
Buffer Space - A number slider to set the amount of whitespace between atom text and the bonds connected
to that atom.
Vertical Alignment - A number slider to control the baseline for rendering text relative to the center of the
atom.
Token Stacking - A single option choice to set whether atom labels will stack all tokens, stack only the second
token or will never stack tokens.
Stack Lone/Terminal - An on/off choice to set whether lone and terminal atoms will stack their label tokens.
Hydrogens
Add as - A single option choice to determine if hydrogens are added as text to labels or as atoms with bonds
attached.
Add to Carbons - A single option choice to set how hydrogens add to carbons; hydrogens can always add to
carbons, can only add to unsaturated carbons or will never add to carbons.
Show Implicit Hydrogens - An on/off choice to set whether implicit hydrogens are automatically rendered or
not.
Carbons
Display Carbon Labels -A single option choice to set if carbon labels display always, only on lone and hidden
carbons, only on hidden carbons, or never show.
Hidden Carbon Angle - An angle number slider for setting the hidden carbon angle. The hidden carbon
angle is the deviation from 180◦ between bonds on a carbon atom that only has two bonds attached to
it.
Show Terminal Labels - An on/off choice to set whether terminal carbon labels are displayed or not.
Show Attributed Labels - An on/off choice to set whether attributed carbon labels are displayed or not.
218 Chapter 10: VISUAL SPECIFICATIONS
Elements
Use Circles - An on/off choice for controlling if element labels are rendered as text or as circles.
Coloring - A single option choice for determining whether user chosen colors, CPK colors, Jmol colors, or
PyMOL colors are used for element labels.
Radius Convention - A single option choice to control if circles are rendered with a constant radius, the
atomic radius of their element, the covalent radius of their element or the van der Waals radius of their
element.
Constant Radius - A number slider to set the constant radius with which to render element atom circles.
Border Width - A number slider to set the width of the circle outlines when atoms are rendered as circles.
ATTRIBUTES
Colors
Fill/Text - A color button for the text color of attribute labels and graphics.
Logistics
Optimal Distance - A number slider to control the maximum distance an attribute can be translated away
from the object it defines.
Text
Font Size Reduction - A number slider to control the font size reduction of attribute text from its defined
font. This is so attribute text is smaller than the text of the object with which is associated.
Charges
Surround with a Circle - An on/off choice to set whether charges are rendered with a circle around them.
Circle Line Width - A number slider that determines the width of the charge circle in pixels.
Electrons
Separation - A number slider to set the separation distance between electrons or electrons and charges in
paired attributes such as electron pairs and radical cation symbols.
Stereochemistry
BONDS
Colors
Use Gradient - An on/off choice for rendering bonds with a gradient between the constituent atom colors.
Split Color - An on/off choice for rendering bonds that will split the bond color between the constituent
atom colors.
Settings
Bond Length - A number slider to define the optimal length for bonds. This affects anything that depends
on bond length including drawing bonds and cleaning structures.
Bond Line Thickness - A number slider to define the width of bond lines.
Bold Bond Thickness - A number slider to define the width of bold bonds.
Wedge Thickness - A number slider to define the width of the wide end of wedge bonds.
Unsaturated Spacing - A number slider to define the spacing between bond lines in higher order bonds.
Clip Angle - An angle number slider to define the angle at which non-symmetrical double bonds will clip the
second bond line.
Hash Width - A number slider to define the width of hashes in bonds rendered with a hash.
Hash Spacing - A number slider to define the width of the spacing between hashes in bonds rendered with
a hash.
Hash Offset - A number slider to define the translation from the origin of hashes in bonds rendered with a
hash.
Dot Size - A number slider to determine the size of dots in zero-order ionic bonds.
Arrow Length - A number slider to define the arrowhead length of covalent bonds.
Arrow Angle - An angle number slider to define the arrowhead angle of covalent bonds.
Stroke
Texture - A number slider for setting the magnitude of texture in stroke styles. For instance, a higher number
will cause Bristle strokes to look more bristled.
Bond Ends - A single option choice to set how bond ends are rendered; with no cap, a round cap or a square
cap.
220 Chapter 10: VISUAL SPECIFICATIONS
Options
Join Bond Connections - An on/off choice to define whether the rendering engine will merge bond ends
together for more aesthetic graphics.
Double Bond Asymmetry - A single option choice to set when double bonds will be rendered asymmetrically:
always, when between two carbons, only in rings or never.
Anchor cis interior - An on-off choice that forces the second unsymmetrical line to face the interior of cis
configuration.
Heteroatom Retraction - An on/off choice that defines whether asymmetric double bonds will retract the
second line from an atom or not based on whether that atom is a heteroatom.
Terminal Retraction - An on/off choice that defines whether terminal double bonds will retract the second
line from a terminal atom or not.
Unsaturated Spacing - A single option choice for setting whether unsaturated bonds are rendered with an
absolute spacing or with a relative spacing between bond lines. Changing this specification will place the
corresponding visual specification in the Settings section.
Autocenter Hashes - An on/off choice which automatically centers hashes for aesthetic appeal and may use
whitespace buffers at bond ends. When enabled, the Hash Offset setting has no effect.
Even Hashes - An on/off choice to determine if the Hash Width and Hash Offset specifications only affect
Bold Dashed and Recessed bonds.
Clear Bond Overlaps - An on/off choice to determine if an overlapped bond will erase the section of overlap.
Covalent Style - A single option choice to set if covalent bonds are rendered as Polar Covalent bonds with
a slash in the stroke, or as Coordinate Covalent bonds.
Indent Arrow Bond - An on/off choice to set if covalent bond arrowheads are indented.
Use Lewis Dot Style - An on/off choice to draw bonds as if they are part of a Lewis dot structure.
RINGS
Fused
Favor Aromatics - An on/off choice to force double bonds in fused systems to face aromatic rings over
non-aromatic rings.
Double Bond Orientation - A single option choice to determine if double bonds in fused ring systems will
face larger rings or smaller rings.
Aromatics
Use Circles for Aromatics - A single option choice to render aromatics with a circle instead of in Kekulé
form. Never will never show aromatic circles, always displaying the second bond line. Always will
always show the aromatic circle. Resonance Bond Rings Only will not alter Kekulé structures, but
any rings that are defined by All Resonance Bonds will display an aromatic circle.
Circle Radius - A number slider to define the diameter of the aromatic circle relative to the dimensions of
the ring.
Chapter 10: VISUAL SPECIFICATIONS 221
REACTIONS
Double Line Spacing - A number slider to define the spacing between the lines in equilibrium arrows.
Automatically Place Pluses - An on/off choice to set whether reactions automatically place plusses between
constituent reactants and products.
Text Buffer - A number slider to define the buffer between the text set as the reaction conditions and the
ends of the associated arrow when the text is centered. This value times two will determine the default
length that arrows without associated text are cleaned to when cleaning reactions.
Constituent Buffer - A number slider to define the spacing between reaction constituents when cleaning
reactions.
Arrowheads
Angle - An angle number slider to define the arrowhead angle of arrow shapes.
SHAPES
Colors
Borders and Lines - A color button for the lines and borders of shapes.
Settings
Shapes Add - A single option choice to set whether shapes are drawn in front of atoms or behind atoms.
Strokes
Hash Width - A number slider to define the width of hashes in shapes rendered with a hash.
Hash Spacing - A number slider to define the width the spacing between hashes in shapes rendered with a
hash.
Hash Offset - A number slider to define the translation from the origin of hashes in shapes rendered with a
hash.
Fills
Paint Fill - An on/off choice that determines whether shapes are filled with the current Fill color.
222 Chapter 10: VISUAL SPECIFICATIONS
Shadows
Translation -A number slider to define the distance from the shape the shadow should be rendered.
Angle - An angle number slider to define the angle in relation to the shape to place the shadow.
Brackets
Wideness - A number slider to define the width of bracket lips relative to the standard size.
Orbitals
Length Multiplier - A number slider to define the default extent of orbitals in bond lengths. So if the length
multiplier is one, then all orbitals placed will have a length of one bond length.
Stroke Shaded Lobes - An on/off choice to set whether shaded lobes in orbitals will also be outlined.
Paths
Rectangles
Rounded Arc Width - A number slider to define the width of the corner arcs in rounded rectangles.
Rounded Arc Height - A number slider to define the height of the corner arcs in rounded rectangles.
Rulers
Show Major Ticks -An on/off choice to set if major ticks are shown in rulers.
Show Minor Ticks - An on/off choice to set if minor ticks are shown in rulers.
Show Measurement - An on/off choice to set if the value of the distance measured is show in rulers.
SPECTRA
Colors
Plot Strokes
Thickness - A number slider to define the width of solid strokes in spectrum plots.
Hash Width - A number slider to define the width of hashes in spectrum plots rendered with a hash.
Hash Spacing - A number slider to define the width the spacing between hashes in spectrum plots rendered
with a hash.
Hash Offset - A number slider to define the translation from the origin of hashes in spectrum plots rendered
with a hash.
Grids
Show - An on/off switch to set whether spectrum grids are shown by default.
Integration Lines
Show for NMR Spectra - An on/off switch to set whether spectrum integration lines are shown by default.
Thickness - A number slider to define the line thickness of spectrum integration lines.
To edit the visual specifications of a single object, execute the following steps:
1. Switch to a selection tool and make sure the current selection is empty.
2. Hover the mouse pointer over the object for which the visual specifications are to be changed.
3. Right-click on the object and select the Format Object. . . menu item or double-click on the object.
4. Change the visual specifications in the window that appears. You will see the graphics update in
real-time on the Doodle Board.
5. Click the Done button in the Preferences window to set the changes.
You can also press the Cancel button to cancel all changes.
224 Chapter 10: VISUAL SPECIFICATIONS
To edit the visual specifications of a group of objects, execute the following steps:
2. Select all of the content for which the visual specifications are to be changed.
4. Change all the visual specifications in the Visuals tab to your preference. You will see the graphics
update in real-time on the Doodle Board.
5. Click the Done button in the Preferences window to set the changes.
You can also press the Cancel button to cancel all changes.
To conform a group of objects to the current style sheet, perform the following steps:
2. Select all of the content for which the visual specifications are to be changed.
All content will conform to the visual specifications defined in the document’s style sheet. This function will
also change fonts and scale structures to match the defined bond length.
To conform the entire document to a different style sheet, perform the following steps:
2. In the window that appears, choose the style sheet you prefer from the drop-down selection.
3. You will be asked if you would like to conform atom text by changing fonts; choose Yes or No.
4. If the bond length has changed, you will be asked if you would like the structures to be scaled to match
the new values; choose Yes or No.
The entire document will now conform to the chosen style sheet.
Chapter 10: VISUAL SPECIFICATIONS 225
3D GRAPHICS
The main ChemDoodle program is a tool for generating 2D graphics; to generate 3D Graphics, you can use
ChemDoodle 3D, which has its own user guide. However, ChemDoodle does handle 3D input and you can
create orthographic 2D scenes of your 3D data. That being said, with all of the bond types and atom labels
showing, the figure may not be very clear.
We have several suggestions for creating better looking 2D orthographic scenes of your 3D data:
• Change all bonds to plain single bonds, and include double bonds if necessary.
• Change the visual specifications to show all atoms as circles instead of as text labels.
• Change the visual specifications to render atoms with their Jmol colors.
• Change the visual specifications to render bonds with a gradient between their constituent atoms.
• Increase the bond overlap buffer visual specification to clearly show bond overlaps.
For high quality perspective 3D scenes, or other representations in three dimensions, use ChemDoodle 3D.
ChemDoodle provides several bond stroke styles to style your structures for presentations, posters and more
casual media. To change bond stroke styles, select the bonds to be changed with a selection tool and use
the Strokes drop downs in the General toolbar.
The default bond line stroke width is 1.2 pixels. This is not sufficient to see some stroke styles and the value
will need to be increased. Other stroke styles, such as the Brush style, will not display well for really short
bonds and structures rendered with those styles should be expanded.
• Basic -
• Bristle -
• Brush -
• Calligraphy -
226 Chapter 10: VISUAL SPECIFICATIONS
• Charcoal -
• Scribble -
• Wobble -
The graphics defined by ChemDoodle are always exact and based on very precise coordinates. However,
the screen that you use to display ChemDoodle and bitmap images that are output will need to define the
graphics in a much less precise resolution. Algorithms have been developed to minimize the perception of
this loss of resolution and ChemDoodle provides full access to control how the graphics are rendered. In
contrast, note that scalable vector graphics are exact and based on precise coordinates and are therefore
resolution-less. The following settings will only affect the display of graphics on your computer monitor and
the output of bitmap graphics; scalable vector graphics will not be affected.
ANTI-ALIASING
Anti-aliasing controls whether or not the geometry rendering methods will attempt to reduce aliasing artifacts
along the edges of shapes. Anti-aliasing is enabled by default.
A typical antialiasing algorithm works by blending the existing colors of the pixels along the boundary of
a shape with the requested fill paint according to the estimated partial pixel coverage of the shape. This
function reduces the appearance of jagged edges. Figure 10.2(a) is a structure rendered without anti-aliasing
enabled, while Figure 10.2(b) is a structure rendered with anti-aliasing enabled.
Chapter 10: VISUAL SPECIFICATIONS 227
Font fractional metrics controls whether the positioning of individual character glyphs takes into account the
sub-pixel accuracy of the scaled character advances of the font or whether such advance vectors are rounded
to an integer number of whole device pixels. This hint only recommends how much accuracy should be used
to position the glyphs and does not specify or recommend whether or not the actual rasterization or pixel
bounds of the glyph should be modified to match. Font fractional metrics are disabled by default to produce
better graphics for bitmap images and for the computer screen. In ChemDoodle, this property does not
affect printing. Since printing is usually with a high resolution device, ChemDoodle will always enable font
fractional metrics for printer rendering.
Rendering text to a low resolution device like a screen will necessarily involve a number of rounding operations
as the high quality and very precise definition of the shape and metrics of the character glyphs must be
matched to discrete device pixels. Ideally the positioning of glyphs during text layout would be calculated
by scaling the design metrics in the font according to the point size, but then the scaled advance width
will not necessarily be an integer number of pixels. If the glyphs are positioned with sub-pixel accuracy
according to these scaled design metrics then the rasterization would ideally need to be adjusted for each
possible sub-pixel origin.
Unfortunately, scaling each glyph customized to its exact sub-pixel origin during text layout would be
prohibitively expensive, so a simplified system based on integer device positions is typically used to lay out
the text. The rasterization of the glyph and the scaled advance width are both adjusted together to yield
text that looks good at device resolution and has consistent integer pixel distances between glyphs so that
the glyphs are uniformly and consistently spaced and readable.
This process of rounding advance widths for rasterized glyphs to integer distances means that the character
density and the overall length of a string of text will be different from the theoretical design measurements
due to the accumulation of a series of small differences in the adjusted widths of each glyph. The specific
differences will from glyph to glyph, some being wider and some being narrower than their theoretical design
measurements. Thus the overall difference in character density and length will vary with a number of factors
including the font, the specific device resolution being targeted, and the glyphs chosen to represent the string
being rendered. As a result, rendering the same string at multiple device resolutions can yield widely varying
228 Chapter 10: VISUAL SPECIFICATIONS
When font fractional metrics are enabled, the true font design metrics are scaled by the point size and
used for layout with sub-pixel accuracy. The average density of glyphs and total length of a long string
of characters will therefore more closely match the theoretical design of the font, but readability may be
affected since the distance separating individual pairs of characters may not always be consistent depending
on how the sub-pixel accumulation of the glyph origins meshes with the device pixel grid. Enabling this
hint may be desirable when text layout is being performed that must be consistent across a wide variety of
output resolutions. Specifically, this hint may be desirable in situations where the layout of text is being
previewed on a low resolution device like a screen for output that will eventually be rendered on a high
resolution printer or typesetting device.
When disabled, the scaled design metrics are rounded or adjusted to integer distances for layout. The
distances between any specific pair of glyphs will be more uniform on the device, but the density and total
length of long strings may no longer match the theoretical intentions of the font designer. Disabling this
hint will typically produce more readable results on low resolution devices like computer monitors.
Disabling Font Fractional Metrics can lead to more readable text on the computer screen,
but will cause adverse effects in the text layout. If you see text overlapping and becoming
inconsistent at different scales, make sure this option is re-enabled.
DITHERING
Dithering controls how closely to approximate a color when storing to a destination with limited color
resolution. Dithering is enabled by default.
Some rendering destinations may support a limited number of color choices which may not be able to
accurately represent the full spectrum of colors that can result during rendering operations. For such a
destination, dithering controls whether rendering is done with a flat solid fill of a single pixel value which is
the closest supported color to what was requested, or whether shapes will be filled with a pattern of colors
which combine to better approximate that color.
RENDERING ALGORITHM
This setting provides a high level recommendation as to whether to bias algorithm choices more for speed
or quality when evaluating tradeoffs. This hint could be consulted for any rendering or image manipulation
operation, but decisions will usually honor other, more specific settings in preference to this setting. The
rendering algorithm is set to Quality by default.
The alpha interpolation setting is a general setting that provides a high level recommendation as to whether
to bias alpha blending algorithm choices more for speed or quality when evaluating tradeoffs. The alpha
interpolation algorithm is set to Quality by default.
This setting controls the choice of alpha blending calculations that sacrifice some precision to use fast lookup
tables or lower precision SIMD instructions. This hint could also control whether or not the color and alpha
values are converted into a linear color space during the calculations for a more linear visual effect at the
expense of additional per-pixel calculations.
Chapter 10: VISUAL SPECIFICATIONS 229
The color rendering algorithm controls the accuracy of approximation and conversion when storing colors
into a destination image or surface. The color rendering algorithm is set to Quality by default.
When a rendering or image manipulation operation produces a color value that must be stored to a desti-
nation, it must first convert that color into a form suitable for storing to the destination image or surface.
Minimally, the color components must be converted to bit representations and correctly ordered or an index
into a color lookup table must be chosen before the data can be stored to the destination memory. Without
this minimal conversion, the data in the destination would likely represent random, incorrect or possibly
even unsupported values. Algorithms to quickly convert the results of rendering operations into the color
format of most common destinations are well known and fairly optimal to execute.
Simply performing the most basic color format conversion to store colors to a destination can potentially
ignore a difference in the calibration of the color space of the source and destination or ignore other factors
such as the linearity of the gamma correction. Unless the source and destination color space are identical,
to correctly perform a rendering operation with the most care taken for the accuracy of the colors being
represented, the source colors should be converted to a device independent color space and the results then
converted back to the destination color space. Furthermore, if calculations such as the blending of multiple
source colors are to be performed during the rendering operation, greater visual clarity can be achieved if
the intermediate device independent color space is chosen to have a linear relationship between the values
being calculated and the perception of the human eye to the response curves of the output device.
STROKE CONTROL
Stroke control defines whether a rendering implementation should or is allowed to modify the geometry of
rendered shapes for various purposes. Stroke control is set to Best Compromise by default.
Some implementations may be able to use an optimized platform rendering library which may be faster than
traditional software rendering algorithms on a given platform, but which may also not support floating point
coordinates. Some implementations may also have sophisticated algorithms which perturb the coordinates
of a path so that wide lines appear more uniform in width and spacing.
If an implementation performs any type of modification or ”normalization” of a path, it should never move
the coordinates by more than half a pixel in any direction.
When stroke control is set to Normalize, geometry will be altered to improve uniformity or spacing of lines
and overall aesthetics. The compromise is that geometry will be offset to fit to the pixel resolution of the
rendering device. A consequence is that lines that are parallel may not appear exactly parallel, such as in
double bonds.
When stroke control is set to Pure, geometry will be left unmodified and rendered with sub-pixel accuracy.
There will be noticeable lightness and bolding in straight lines that are vertical or horizontal.
Figure 10.3 shows a rectangle and structure displayed with stroke control set to Pure, while Figure 10.4
shows the same objects with stroke control set to Normalize.
230 Chapter 10: VISUAL SPECIFICATIONS
Figure 10.3: A structure and rectangle rendered with stroke control set to Pure. Note the bolding and blurring
of the horizontal and vertical lines.
Figure 10.4: A structure and rectangle rendered with stroke control set to Normalize. Note that parallel lines
are not preserved.
For even better graphics, a third option called Best Compromise is provided. This option will use pure
stroke control for all chemical structures. All other shapes will first be analyzed for vertical and horizontal
lines, and any found will be rendered with normalized stroke control while the rest of the graphics will be
rendered with pure stroke control.
IMAGE SCALING
Image scaling controls how image pixels are filtered or resampled during an image rendering operation.
This will have noticeable effects on images that are not rendered in their natural scale. The image scaling
algorithm is set to Progressive Bilinear by default.
Implicitly images are defined to provide color samples at integer coordinate locations. When images are
rendered upright with no scaling onto a destination, the choice of which image pixels map to which device
pixels is obvious and the samples at the integer coordinate locations in the image are transferred to the pixels
at the corresponding integer locations on the device pixel grid one for one. When images are rendered in a
scaled, rotated, or otherwise transformed coordinate system, then the mapping of device pixel coordinates
back to the image can raise the question of what color sample to use for the continuous coordinates that
lie between the integer locations of the provided image samples. Interpolation algorithms define functions
Chapter 10: VISUAL SPECIFICATIONS 231
which provide a color sample for any continuous coordinate in an image based on the color samples at the
surrounding integer coordinates.
Progressive Bilinear is better than Bicubic which is better than Bilinear which is better than Nearest-
Neighbor at producing reasonable graphics of stretched or shrunken bitmap images. The better the algo-
rithm used, the longer the runtime.
CHAPTER 11
Sharing Information
Chapter 11: SHARING INFORMATION 233
Contents
OVERVIEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
PRINTING . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
PAGE SETUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
FLIPPING THE PAGE ORIENTATION . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
PRINT PREVIEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
PRINTING A DOCUMENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
234 Chapter 11: SHARING INFORMATION
OVERVIEW
ChemDoodle has advanced functions for interacting with other applications on your computer. This is essen-
tial for importing graphics into word processors or for transferring chemical data into modeling applications.
This section introduces the new user to ChemDoodle’s system clipboard capabilities. It covers the following
topics:
• How to copy data and graphics from ChemDoodle into other applications.
• How to copy data and graphics from other applications into ChemDoodle.
MIME TYPES
A MIME type is an identifier to define the data it is associated with. For example, a structure can be
represented in MDL MOLFile format. The MDL MOLFile format is a plain text format and can be associated
with the MIME type, text/plain. However, this is a very generic description and other applications will only
recognize it as plain text, rather than as a chemical structure. Therefore a different MIME type is associated
with this data, chemical/x-mdl-molfile, to define it as a structure in the MDL MOLFile format. In this
manner, other applications will recognize this data as a chemical.
ChemDoodle follows the MIME standards put forth by the Chemical MIME Project
(https://www.ch.ic.ac.uk/chemime/). This should be regarded as the standard; however, many
chemical software developers do not follow these rules, thereby causing issues when transferring data
between chemical applications.
Additionally, since many items can be present on the system clipboard at once, applications may paste a
certain data type by default that may not be the data you want to paste. For instance, Microsoft Word can
Chapter 11: SHARING INFORMATION 235
paste both text data types and image data types. If both are present on the system clipboard, Microsoft
Word will automatically select the text data type when pasting, even if you wanted the image to be pasted.
There can even be different image types, confusing the situation further.
Therefore, ChemDoodle allows you to define which data is placed on the system clipboard and how the data
is to be used when working with other applications.
CLIPBOARD SETTINGS
ChemDoodle can transfer data to almost any application that has been created. But it is impossible for
ChemDoodle to determine which data should be transferred. Therefore, you need to set the appropriate
Copy Settings to make sure any ambiguities are resolved with the application you are pasting to. Copy
Settings can be set in the Preferences window under the Advanced tab as shown in Figure 11.1. These
settings will allow you to explicitly control what data ChemDoodle will transfer to other applications.
NON-CHEMICAL TEXT
Text may be copied from ChemDoodle that isn’t a chemical, for instance a calculated thermodynamic
property or a formatted IUPAC name. ChemDoodle supports the following text types for communicating
with the system clipboard:
• Hyper Text Markup Language (HTML) - The formatted text is presented in HTML format.
This is great for working with web editors and most word processing tools.
• Rich Text Format (RTF) - The formatted text is presented in RTF format. This is a very common
formatted text protocol that most applications can receive.
236 Chapter 11: SHARING INFORMATION
CHEMICAL DATA
There are three main types of chemical data that may be transferred:
• Text Types - Contains a line or lines of text that will be interpretable by other applications. Some
chemical formats are also listed here to be pasted as text into other applications. All text data will be
interpreted as text by other applications and any chemical significance will be lost unless the receiving
application intends to receive the chemical data as text and will create the chemical from it. Only one
text data type will be placed on the system clipboard at a time.
• Image Types - This group contains both bitmap and vector images. Bitmap images are not scalable
in resolution. Vector images are much more versatile and will remain crisp and clear regardless of
resizing or transformation. Bitmap and vector images are discussed in detail in the next section.
• Chemical Types - Chemical types include structure information. Only chemical programs will see
these.
Therefore, to work with other applications, first decide what type of data you would like to transfer and
what types of data the other application accepts. Then set the appropriate copy settings to continue. By
default, ChemDoodle is set up for the optimal communication of graphics into common word processors.
OTHER TYPES
Some other non-MIME type based clipboard specifications are also available for working with a number of
programs. ChemDoodle includes the MDLCT and MDLSK clipboard formats for communicating chemical
data on Windows.
There are two types of images, bitmap and vector. Bitmap images are traditional images and define a
rectangle of pixels and their colors, while vector images define drawing instructions for rendering it. When
resizing, the bitmap will become blurry, pixelated and lose its quality while the vector image will remain
crisp and clear. Figure 11.2a shows a bitmap image of a structure, while Figure 11.2b shows a vector image
of the same structure. Both were created by ChemDoodle. Try zooming in on both images using your PDF
reader and you can see the difference in quality for yourself.
Bitmap images will suffer from this issue with any change of resolution, including printing to a printer.
Because of this, we recommend you insert vector images into your documents. The only downside to using
vector graphics is that some programs may not support them. ChemDoodle compatibility with third party
applications is discussed in APPENDIX: THIRD PARTY APPLICATIONS .
If you must use a bitmap image, then ChemDoodle provides high resolution options (such as scaling and
DPI control) for some bitmap formats as discussed in the IMAGE OUTPUT OPTIONS section later in this
chapter.
To copy data from ChemDoodle into other applications, execute the following steps:
1. Determine which data you would like to transfer and the types of data that the other application
can accept and configure the copy settings in the Preferences window under the Advanced tab
accordingly.
2. Select the objects on the Doodle Board that you would like to copy using the content selection tools.
3. Click on the Edit|Copy menu item or press its menu accelerator keyboard shortcut which is ctrl
+ C ( command + C on Mac OS X).
4. Use the Paste function present in the other application to paste the content. If the other application
has a Paste Special. . . function, you may use that to specify which data type to paste.
The Copy As functions are preset shortcuts for placing specific chemical data on the system clipboard
without changing the data types to be copied in the Advanced tab of the Preferences window.
Select the content in the document to be copied and then select one of the menu items in the Edit|Copy
As. . . submenu. The most popular data types are supported. These functions will place both text and
chemical data on the system clipboard for maximum compatibility with third party applications. This
function will not place image data on the system clipboard.
Most text that is copied is unformatted text, but there will be many times when you would like to preserve
the formatting of text between applications, such as when copying a molecular formula or IUPAC name.
You can copy formatted text from most objects in ChemDoodle that present formatted text. This includes
objects like updating labels and atom labels. Just right-click on the object with a selection tool while nothing
is selected and choose the Copy Text menu item. You can then paste that formatted text into another
application.
Certain widgets, such as the Properties widget will also place formatted text on the system clipboard.
238 Chapter 11: SHARING INFORMATION
2. Click on the Edit|Paste menu item or press its menu accelerator keyboard shortcut which is ctrl
+ V ( command + V on Mac OS X) to paste the highest priority data to the Doodle Board.
1. If your mouse pointer is hovering over the document, the center of the pasted content will be located
at the mouse pointer.
2. If the mouse pointer is not hovering over the document, and the lasso is active, then the pasted content
will appear to the bottom-right of the lassoed content.
3. If the mouse pointer is not hovering over the document and the lasso is inactive, then the pasted
content will appear at the top left of the current viewed page of the document.
In most cases, ChemDoodle collages pasted between currently edited documents will retain their original
styling. Instead of selecting the Conform to Document Settings function after pasting you can save some
time and directly paste and conform the settings by choosing the Edit|Paste and Match Style menu item.
PASTE SPECIAL. . .
Since an application can place different data types on the system clipboard, the data that ChemDoodle
pastes may not always be the desired type. In general, ChemDoodle pastes chemical data in preference to
images, and images in preference to text. If you would like to paste data that is not chosen by default by
ChemDoodle, click on the Edit|Paste Special. . . menu item. A window will appear listing all ChemDoodle
compatible data as shown in Figure 11.3. Just select the list item you would like to paste and press the
Paste button.
Chapter 11: SHARING INFORMATION 239
Sometimes it may be necessary to handle text data from the system clipboard. For instance, a chemical
application may paste the MOLFile format in plain text, or you may be copying a SMILES string from a
web browser. ChemDoodle provides the Paste Text as Chemical function to conveniently handle this
situation. To paste text content from another application as chemical data, execute the following steps:
1. Use the copy function present in the other application to place the text on the system clipboard.
3. Depending on the type of data being represented by the text (which you will know), select the appro-
priate menu item in the submenu to paste.
Using this method, any of the line notations that ChemDoodle understands can be pasted as chemical data.
Additionally, there is an XYZ-Like Data menu item for pasting text as chemical data in an XYZ-like
format. This option will automatically scan the text to extract atom labels and positions. The final menu
item in this submenu is Guess Chemical Format. This will detect the chemical format of the text data
on the system clipboard and paste the chemical data accordingly, which is perfect for ASCII or XML data
types, such as MOLFiles or CML. This function will alert you if no chemical format could be associated with
the text data.
240 Chapter 11: SHARING INFORMATION
• Joint Photographic Experts Group {.jpg, .jpeg, .jpe, .jfif, .jfi, .jif}
• Joint Photographic Experts Group {.jpg, .jpeg, .jpe, .jfif, .jfi, .jif}
ChemDoodle will automatically embed chemical data in certain image formats. When these images are
inserted into ChemDoodle, they will be checked for chemical information and that chemical information will
be loaded if found.
To export all of the objects in the current document to an image, execute the following steps:
2. A file chooser will appear. Select the location you would like to have the image saved in and type in
a name for the file if you do not like the default name. You do not need to type in an extension as
ChemDoodle will do this for you.
3. After you are satisfied with a location and name, select the image type of the image to be exported.
4. After selecting the file type to be used, press the Save button to export your document as an image.
5. If options are available, a window will be shown to allow you to set the options. Define the settings to
your preference and then click the Done button.
To export specific objects in the current document to an image, execute the following steps:
3. A file chooser will appear. Select the location you would like to have the image saved in and type in
a name for the file if you do not like the default name. You do not need to type in an extension as
242 Chapter 11: SHARING INFORMATION
4. After you are satisfied with a location and name, select the image type of the image to be exported.
5. After selecting the file type to be used, press the Save button to export the selected objects to an
image.
6. If options are available, a window will be shown to allow you to set the options. Define the settings to
your preference and then click the Done button.
There are several options that you can define for output images. Some options are only available for bitmap
or vector types, while other options are available for both.
You can control the image border buffer, or the amount of space surrounding the graphics in an image, by
changing the Border Buffer setting in the Preferences window under the Advanced tab. The default
image border buffer is three (3) pixels. This setting affects both bitmap and vector graphics.
This setting will determine the scale of the output image. The larger the scale, the larger the output image.
Vector graphics can be rescaled at any time, and therefore this setting is only available for bitmap images.
You will need to scale bitmap images to a larger size if you want to use a higher resolution, but retain the
same dimensions.
This setting will instruct printers and other renderers how to scale the image. The higher the DPI setting,
then the crisper the image will look, but the smaller it will appear. By default, the DPI setting is 300 dpi.
Currently, only the JPEG and PNG output support this option. Vector graphics are resolution-less, and
therefore this setting is only available for bitmap images.
If the bitmap image type supports transparency, this option will be available.
In vector graphics, text is output as shapes, so they are no longer recognized as text by other applications.
If you prefer to preserve the characters for editing in other applications, then deselect this option. Note that
the font you use for the text must be present on the system that you open the image in, or the font you used
will be replaced with something similar, but not identical.
Chapter 11: SHARING INFORMATION 243
INSERTING IMAGES
For any of the image formats that ChemDoodle can read, you can import files of that format into your
documents. To do so, execute the following steps:
2. In the file chooser that appears, navigate to and select the image you would like to insert.
If you selected an image file type that is not understood by ChemDoodle, a message will appear to notify
you of the issue.
In addition to inserting images via the File menu, you may also simply drag compatible images from your
file system or from other applications on to the Doodle Board.
ROUNDTRIP EDITING
Roundtrip editing is a very advanced feature for allowing ChemDoodle content to transfer between applica-
tions by embedding it into images. In most cases, ChemDoodle will automatically perform this embedding
for you. Through roundtrip editing, you can copy ChemDoodle content into your word processor for instance,
and then later copy that content back into ChemDoodle for re-editing.
Make sure you always save your drawings and figures in a ChemDoodle Document and never
rely on a third party application to save your ChemDoodle data. The third party application
may change how it works and you may lose your data!
SUPPORT
Roundtrip editing requires that both ChemDoodle and the application you are inserting the ChemDoodle
content into work together. Currently, ChemDoodle supports roundtrip editing with OpenOffice on Linux
and with any applications that understand Object Linking and Embedding (OLE) on Windows, or that
preserve PDF comments on Mac OS X. This covers a large number of applications that most scientists use
and we are actively working to expand the range of applications with which ChemDoodle supports roundtrip
editing.
WINDOWS
Setup
No additional setup is required for roundtrip editing on Windows. The OLE server is automatically registered
when ChemDoodle is installed.
Clipboard Settings
By default, in Advanced Preferences, OLE is enabled. OLE is required to be enabled for roundtrip
editing to work on Windows.
244 Chapter 11: SHARING INFORMATION
Procedure
Roundtrip editing is very simple on Windows. Just copy in ChemDoodle and paste into the receiving
application. Some applications may not paste the OLE object by default. In this case, make sure to use a
provided Paste Special function in the receiving application to choose the OLE object
There are two ways to edit the content after it has been pasted:
1. Copy the embedded object from the receiving application and paste back into ChemDoodle to recover
the objects. Once you have finished editing, again copy in ChemDoodle and paste back into the
receiving application to replace the original object.
2. As of version 6 of ChemDoodle, embedded objects may be edited through standard OLE embedded
object activation. Double clicking the object inside the receiving application will start ChemDoodle if
it is not already running, and load the content of the object for editing in a new tab. After you have
made your changes, close the tab, and a dialog box asking if you would like to update the OLE object
will appear. Select Yes to update the object in the receiving application.
Figure 11.4: An Activated ChemDoodle Embedded Object within Microsoft Word 2010
Figure 11.4 shows an activated ChemDoodle embedded object within Microsoft Word 2010. The hash marks
on the object indicate that it is open in ChemDoodle for editing, and disappear once the object is closed.
Not all Windows applications support OLE, and roundtrip editing is not possible with those applications.
Troubleshooting
You may encounter error messages with roundtrip editing on Windows. We document the most common
cases here.
The error in Figure 11.5 appears only if our OLE server is corrupted by the user in the installation folder.
Chapter 11: SHARING INFORMATION 245
Make sure that the installation folder is not modified and important files are not removed.
It is possible for an OLE object within another application to become corrupted. This is usually due to
something specific in that particular application. If a ChemDoodle OLE object becomes corrupted, it will
display a pop up with the following text: “This object has become corrupted. You will have to delete it and
paste the figure from ChemDoodle again.” In that case, please re-paste that object into the application. If
you are aware of a reproducible way to corrupt an object in a particular application, please inform iChemLabs
Customer Service (click on Help|Contact Customer Service menu item).
Under unusual circumstances, ChemDoodle may display a popup indicating that a particular OLE action
could not be completed. If you encounter this error, please notify iChemLabs Customer Service concerning
the circumstances that led to the error.
MAC OS X
Setup
Clipboard Settings
By default, in Advanced Preferences, PDF is enabled. PDF is required to be enabled for roundtrip
editing to work on Mac OS X.
Procedure
Roundtrip editing is very simple on Mac OS X. Just copy in ChemDoodle and paste into the receiving appli-
cation. To edit the content, copy the image from the receiving application and paste back into ChemDoodle
to recover the objects. Once you have finished editing, again copy in ChemDoodle and paste back into the
receiving application to replace the original image.
Some applications may not paste the PDF by default. In this case, use a provided Paste Special function
in the receiving application to choose the PDF.
Not all applications on Mac OS X preserve PDF comments, and roundtrip editing is not possible with those
applications.
Note the following workarounds only apply to iWork ’09; the most recent iWork does not
permit roundtrip editing.
246 Chapter 11: SHARING INFORMATION
iWork Pages corrupts PDF comments, so roundtrip editing will fail directly from Pages. There are two
workarounds available. The first workaround consists of the following two steps:
1. Copy the figure from Pages into Keynote and then copy in Keynote and paste into ChemDoodle to
recover the data.
2. Use the Inspector to retrieve the unaltered PDF directly from Pages.
1. When working with figures pasted into Pages from ChemDoodle, open the Inspector by clicking on
the nspector button in Pages’ top toolbar.
2. In the Inspector, click on the Metrics icon , and then click on the ChemDoodle figure so that
droppedImage.pdf appears as in Figure 11.6.
3. Drag the droppedImage.pdf file onto the Doodle Board in ChemDoodle to recover the data.
LINUX
Forward
We did our best to provide as simple a procedure as possible, but given the state of LInux distributions,
there are some inconveniences to deal with. We will do our best to continue to improve this procedure, but
your help is required to submit issues to the OpenOffice and LibreOffice development teams and urge them
to improve their software and APIs.
Setup
Roundtrip editing on Linux requires that the user install our ChemDoodle OpenOffice plugin. The plugin
is named ChemDoodle.oxt and can be found in the resources folder in the ChemDoodle installation folder.
4. In the file chooser that appears, locate the ChemDoodle.oxt file in the resources folder and select it.
If the plugin is successfully registered, it will appear in the Extension Manager as shown in Figure 11.7.
Figure 11.7: The Extension Manager with the ChemDoodle Plugin Properly Registered
Clipboard Settings
In ChemDoodle’s Advanced Preferences, both PNG (720dpi) and ChemDoodle Collage are required
to be enabled for roundtrip editing to work on Linux. Other raster image types should be disabled.
248 Chapter 11: SHARING INFORMATION
Procedure
To insert a ChemDoodle object into OpenOffice or LibreOffice, execute the following steps:
2. Select the content you wish to copy and use a copy function in ChemDoodle.
3. In the Office application you want to insert the object into, open the Object submenu in the Insert
menu and select OLE Object. . . (Figure 11.8)
4. In the window that appears, select ChemDoodle Embedded Object and select the OK button.
(Figure 11.9)
1. Select the inserted ChemDoodle object that you wish to edit, and double-click on it.
Chapter 11: SHARING INFORMATION 249
5. Reselect the content and follow the procedure for inserting the ChemDoodle object into OpenOffice or
LibreOffice above to replace the previous object.
Troubleshooting
The following warning means that you should enable the PNG (720dpi) option and disable the PNG
option in Advanced Preferences for the best quality images.
The following warning means that you should enable ChemDoodle Collage in Advanced Preferences.
The following warning means that PNG (720dpi) needs to be enabled in Advanced Preferences.
The following warning means you need to read the CLIPBOARD SETTINGS section above again.
250 Chapter 11: SHARING INFORMATION
A: OpenOffice/LibreOffice does not support vector graphics through their Embedded Object insertion.
Please contact the appropriate Office development teams to urge them to add this functionality. For now,
we use a 720 dpi image so print quality will still be excellent.
A: This is apparently a bug in OpenOffice/LibreOffice, please contact the appropriate Office development
teams to urge them to fix this.
A: This is what OpenOffice/LibreOffice requires to execute the object. Please contact the appropriate Office
development teams to urge them to improve this.
Q: Why can’t I just paste the object? Why do I need to go through the menu to insert it?
A: Implementing direct pasting of the object exhibits many inconsistencies which make it unsuitable for reg-
ular use. This is something we are trying to work around. Please contact the appropriate Office development
teams to urge them to fix this.
PRINTING
The document can be printed from ChemDoodle. In most cases, the procedure is identical to other applica-
tions you use on your operating system. You can define settings, preview, and print.
PAGE SETUP
By selecting the File|Page Setup. . . menu item, you will be able to set the printer settings. The window
that appears will be identical to the window that appears in other applications on your operating system.
Here, you can select the printer and set up the page orientation.
In some cases, you may wish to print your document in landscape mode. To do this, execute the following
steps:
2. In the window that appears, find the appropriate setting for page orientation, and change it to land-
scape.
3. Press the confirm button in the window to save your settings and close it.
4. A dialog box will appear asking if you would like to swap the width and height of the current document
in ChemDoodle. If this is appropriate for your document, select Yes, otherwise, select No.
Chapter 11: SHARING INFORMATION 251
The orientation of the printed document and its size are distinct. Printing in landscape mode
simply means that the printer prints your content at a 90 degree angle. It does not alter
your document in any way. So in some cases, you may want to flip the dimensions of your
document and reorient your figures before printing in landscape mode.
This procedure gives you maximum control over your documents, by allowing you to control the dimensions
of your document and separately to control the orientation in which your document is printed.
PRINT PREVIEW
To preview your document before you print, select the File|Print Preview menu item. Click the OK
button on the bottom right when you are finished to close the preview. Only the content that should appear
in the printed version will appear in the preview; no warnings, highlights or other interface decorations will
be present.
PRINTING A DOCUMENT
252
APPENDIX A
Managing ChemDoodle
254 Appendix A: MANAGING CHEMDOODLE
OVERVIEW
The chapters in this user guide explain how to use ChemDoodle to draw and work with chemical figures.
There are other functions for managing the application itself.
This section shows the new user how to manage ChemDoodle. It covers the following topics:
• Updating ChemDoodle.
UPDATING CHEMDOODLE
ChemDoodle will check for official iChemLabs updates and will automatically update to the latest available
version for you if you allow it to do so.
To check for updates, just click the Help|Check For Updates menu item. If no update is available,
you will see a confirmation message stating that your copy of ChemDoodle is up-to-date. If there is an
update available, you will see an Update Available window appear listing all the changes introduced by
the update. Just click the Update button to proceed. ChemDoodle will close to perform the update, so
make sure to save your files before continuing.
You must have administrator privileges to update ChemDoodle. If you see a message stating
that you cannot update because you do not have the necessary permissions, please double
check that you ran ChemDoodle as administrator (on Windows for instance) or contact your
system administrator to help you.
The auto-updater will then open. It will download the latest ChemDoodle updates, verify the contents
with our server, and then proceed to update ChemDoodle. The updater can be seen in Figure A.1. It may
take several minutes to complete. After the updater completes, it will notify you that it is ready and that
ChemDoodle will be reopened. Just click the Ok button to close the updater and continue. Your version of
ChemDoodle has now been updated.
Appendix A: MANAGING CHEMDOODLE 255
By default, ChemDoodle will automatically check for updates while loading. You can disable this feature in
the Preferences window under the Online tab. You may always manually check for updates by using the
menu item mentioned above.
A common issue on Windows Vista/7+ is to enable administrator privileges for ChemDoodle to update. If
ChemDoodle states that you do not have the necessary administrator privileges on these platforms, perform
the following steps:
1. Exit ChemDoodle.
If this process does not work, you will need to consult with a system administrator to update ChemDoodle.
SKIPPING UPDATES
If you wish to ignore the current update, when the Update Available window is displayed, just select
the Skip this Version button as shown in Figure A.2. You will no longer be notified that this update is
available. You will still be notified of subsequent updates, which you may also skip.
To obtain an update that was skipped, select the Help|Check For Updates menu item.
256 Appendix A: MANAGING CHEMDOODLE
Figure A.2: The Update Available Window with the Skip this Update Button
PURCHASING UPGRADES
Major version upgrades to ChemDoodle must be purchased. When a major version upgrade becomes avail-
able, you will still be presented with the Update Available window. However, instead of an Update
button, a Purchase Upgrade button will be presented. Click on the Purchase Upgrade button to be
directed to the upgrade purchase page. After purchasing the upgrade, again check for updates. The Update
button will then be showing and you may proceed with the update as described in the previous sections.
When deactivating ChemDoodle and switching to a new computer, your custom preferences
and other user settings will be lost. If you have settings files (templates, chemical document
settings), those can be copied to the new ChemDoodleSettings folder that will appear after
ChemDoodle is activated on the new computer.
Once the deactivation procedure has begun, it cannot be cancelled. Make sure you record your activation
code, which will be displayed in the Details section of the deactivation confirmation message, so you can
use it again. You should also have a record of your code from the email receipt you received upon purchasing
it.
Once you accept the confirmation message, ChemDoodle will close and your copy will be deactivated. You
may now use your activation code to activate ChemDoodle on a new computer.
Appendix A: MANAGING CHEMDOODLE 257
You may log into your iChemLabs account at anytime in ChemDoodle by choosing the File|Sync with
Online Account. . . menu item. The login window will also have an option to link your iChemLabs account
with your copy of ChemDoodle. If selected, ChemDoodle will automatically log into your iChemLabs account
while it starts up. You can then change these settings at any time in the Preferences window under the
Online tab.
All customers receive a free account to use this feature. Your username is the email address your activation
code is associated with, and your password is the last four characters of your activation code. The password
must be either in all uppercase or all lowercase.
Currently, the following iChemLabs applications integrate with your iChemLabs account:
• ChemDoodle
• ChemDoodle 3D
• ChemDoodle Mobile
APPENDIX B
Chemical File Types
Appendix B: CHEMICAL FILE TYPES 259
OVERVIEW
ChemDoodle can currently read and write 24 different chemical file types. This section discusses the following
issues:
• Warnings about saving your documents in a format other than the ChemDoodle Document format.
ChemDoodle will try to interpret all third party files as best as possible, so if you do find a file that doesn’t
read well, please send it to us so we can improve our compatibility.
That being said, it is very important that you carefully consider whether to allow ChemDoodle to save
over third party data files as ChemDoodle may not retain all essential information that the other program
requires. When saving third party files, ChemDoodle will display a warning as a reminder before allowing
you to continue. These warnings can be disabled in the Preferences window under the Saving tab.
Instead, we recommend that you first save a copy of that file to edit, instead of saving over files created by
other applications.
260 Appendix B: CHEMICAL FILE TYPES
If you are unsure about whether your document will be saved in its entirety to a third party format, first
check with this documentation. If you are still concerned, save a test file in ChemDoodle, close the document
you just saved, and then reopen the file in ChemDoodle. If some content is missing or any object properties
have changed in some way, then the format you are trying to save to does not support those objects and/or
properties or ChemDoodle does not yet support the output of those objects and/or properties for that format.
FILE ANNOTATIONS
Annotations can be read and written to files where possible. Each document has its own set of annotations.
To view previously defined annotations, edit them or create your own, select the File|Annotations. . . menu
item. Then edit the fields shown in Figure B.1.
All data associated with a file will be saved in ChemDoodle Documents. Other users that open your an-
notated ChemDoodle Document files will be able to easily access them. Other file types may be able to
save annotations as well, read their documentation in the following sections for the extent of annotation
functionality.
1. Choose a recognized input filefigure with the file chooser that appears after clicking the Choose Input
button. Use the file format filter at the bottom of the file chooser to select different file formats.
2. Choose the location to store the output by clicking the Choose Location button or by manually
typing in the path to the file. You can change the name of the output file this way.
3. Choose an output format and extension from the drop-down selection below the output location.
When complete, ChemDoodle will display statistics about the conversion or any issues encountered.
APPENDIX C
Third Party Applications
264 Appendix C: THIRD PARTY APPLICATIONS
OVERVIEW
ChemDoodle works with many third party applications. The most common applications are listed in this
section. It is not an comprehensive list. Discussed in this section are:
MICROSOFT OFFICE
WORD
On Windows and Mac OS X, text, images and scalable vector graphics can be transferred.
For scalable vector graphics, if using Word on Windows, Windows Enhanced Metafile must be selected
in the copy settings. For scalable vector graphics, if using Word 2004 on Mac OS X, Macintosh Vector
PICT must be selected in the copy settings; Word 2008 and all future versions on Mac OS X require PDF
to be selected in the copy settings. Make sure all bitmap image types are deselected.
Round trip editing is functional on Windows with Microsoft Office using ChemDoodle’s OLE library. Round
trip editing is functional on Mac OS X with Microsoft Office 2011 (at update 14.0.1 or more recent).
POWERPOINT
Same as Word.
EXCEL
Same as Word.
Appendix C: THIRD PARTY APPLICATIONS 265
APPLE IWORK
PAGES
Text, images and scalable vector graphics can be transferred. For scalable vector graphics, PDF must be
selected in the copy settings. Round-rip editing is supported via the workaround detailed in the Round-Trip
Editing section of SHARING INFORMATION.
KEYNOTE
NUMBERS
OPENOFFICE
WRITER
On all operating systems, text, images and scalable vector graphics can be transferred. For scalable vector
graphics, if using Writer on Windows, Windows Enhanced Metafile must be selected in the copy settings.
For scalable vector graphics, if using Writer on Mac OS X, Macintosh Vector PICT must be selected in
the copy settings. For scalable vector graphics, if using Writer on Linux, OpenDocument Graphics must
be selected in the copy settings.
CALC
On all platforms, text, images and scalable vector graphics can be transferred.
For Mac OS X, first save ChemDoodle content as Macintosh Vector PICTs and then insert or drag and
drop the file into Calc.
IMPRESS
Same as Calc.
ADOBE PRODUCTS
PHOTOSHOP
Images and scalable vector graphics can be transferred. For scalable vector graphics, PDF must be selected
in the copy settings.
ILLUSTRATOR
Scalable vector graphics can be transferred. First, save content as PDF and then open, insert or drag
and drop the file into Illustrator. For direct pasting, make sure all vector graphics are disabled except for
Windows Enhanced Metafile on Windows or Macintosh Vector Pict on Mac OS X.
Appendix C: THIRD PARTY APPLICATIONS 267
BROWSERS
Most browsers will support image and scalable vector graphic output from ChemDoodle for display in web
pages. The best scalable vector graphic formats to use are SVG and PDF.
For information of ChemDoodle Web Components browser compatibility, visit the ChemDoodle Web Com-
ponents website: https://web.chemdoodle.com.
OTHER
ChemDoodle is compatible with any application that supports the data ChemDoodle places on the system
clipboard. Because ChemDoodle expertly handles Windows Enhanced Metafiles, Macintosh Vector PICT 2,
PDF and OpenDocument Graphics, scalable vector graphics can be directly pasted into all native applications.
Round-trip editing will be supported with any application that supports OLE on Windows, or that will
preserve PDF comments on Mac OS X.
APPENDIX D
Elemental Data
Appendix D: ELEMENTAL DATA 269
OVERVIEW
ChemDoodle has access to an extensive database of elemental data compiled from published resources. This
section introduces the new user to ChemDoodle’s chemical data. It covers the following topics:
ELEMENTAL DATABASE
The elemental database allows ChemDoodle to perform many tasks, from filling the dynamic periodic table
to deducing covalent bonds to calculating a molecular mass. The data itself can be viewed by opening various
data tables in ChemDoodle or by using the dynamic periodic table. The data tables are found in the View
menu. Currently ChemDoodle provides three data tables:
• Elemental Data - Displays all data in the elemental database not contained in other tables.
• Ionization Energies - Displays all published ionization energies for the elements.
• Isotopes - Displays all published isotopes, their masses, natural abundances and half-lives. Where to
find references for the data.
Each table is interactive, and you can click on a column header to reorder the content by that column. By
clicking again you can reverse the order of that column. By pressing down and dragging, you can reorder
the columns to more easily correlate different columns.
REFERENCES
All data within ChemDoodle’s databases are associated with a unit (if not dimensionless) and the reference
source it originated from so you may assess its quality. The entire set of references can be viewed at any
time by selecting the Help|References menu item as shown in Figure D.1. Non-data related references are
also displayed in this list, including filetype specifications and algorithms.
270 Appendix D: ELEMENTAL DATA
You may hover over elements and click on them for additional information. There may also be groups listed
in the top region. Hovering over a group will desaturate all other groups. This is shown in Figure D.3 when
the mouse pointer hovers over the Other Non-Metals group.
Appendix D: ELEMENTAL DATA 271
The table is customizable and you can choose from several format options, including the display of atomic
mass, names and electron configurations in addition to the element symbol. The block in the bottom-left
corner of the periodic table will display the current format of each element as shown in Figure D.4.
You can also customize graphical options, such as the element border colors and text color.
In addition to the traditional classifications display, you can also choose to display these other features of
the elements:
• CPK Colors - Displays each element with its CPK (Corey, Pauling, Koltun) color.
• State of Matter - Each element is colored based on its state of matter at the set temperature. Solids
are black, liquids are blue and gases are red. Unknown states are grey. A temperature slider will
appear in the controls to set the temperature which is displayed on the top right of the figure.
• Years of Discovery - Each element is colored if discovered before the set year of discovery. A year
slider will appear in the controls to set the year of discovery which is displayed on the top right of the
figure.
Each display format shows off interesting properties and makes for great in-class demonstrations, such as
the State of Matter display shown in Figure D.5.
272 Appendix D: ELEMENTAL DATA
To print the periodic table, click the Print button at the bottom-right of the window. The References
button will display ChemDoodle’s references and the Close button will close the Interactive Periodic
Table window.
APPENDIX E
How NMR is Simulated
274 Appendix E: HOW NMR IS SIMULATED
ALGORITHMS
The NMR simulation algorithms are a free and experimental feature provided in ChemDoodle. The algo-
rithms are continuously developed and improved.
SHIFT PREDICTION
ChemDoodle estimates chemical shifts for all hydrogen or carbon atoms for which incremental constants
are available. The algorithm is an empirical approach and begins by identifying key functional groups in a
structure. The identified functional groups are used to determine base values for the estimated shifts of the
nuclei.
After determining a base shift, a breadth-first algorithm is employed to look at the chemical environment
surrounding each nucleus. Based on the functional groups around it, incremental constants are added to
the base shift to calculate the estimated shift. Other contributions may be included such as ring strain and
other algorithms.
SPLITTING
Splitting is determined by a table of typical j-constant magnitudes and the spin of the interacting nuclei.
Splitting is calculated for all spins. Splitting magnitudes are determined from Pascal’s triangle.
ROOF EFFECTS
The magnitude for roof effects are determined by the resolution of the spectrum, set by the Pulse Frequency
parameter, and the relative adjacency of the interacting peaks. The simulated roof effects will show a leaning
of the split peak towards the peak that is splitting it. Peaks split by multiple peaks will lean towards all of
them.
SOLVENT PEAKS
Solvent peaks are simulated using the same algorithms. Splitting from deuterium occurs. The magnitude
ratio for solvent to solute peaks is determined by the Dilution parameter.
1
H RAPID EXCHANGE
If the temperature is above 273K, rapid exchange will occur for hydrogen bonded protons. These peaks will
merge into a single broadened peak with a shift calculated at their weighted average. The shift will then be
moved downfield relative to the magnitude of the temperature.
Appendix E: HOW NMR IS SIMULATED 275
1
H ANISOTROPIC EFFECTS
If the solvent or solute contain aromatic or antiaromatic rings, then 1 H nuclei will be appropriately shielded
or deshielded based on the solvent/solute ratio and the types of rings involved.
1
H DIASTEREOTOPIC PAIRS
If a methylene is adjacent to a stereocenter, then the two methylene protons will be separated into individual
peaks. The peaks will be separated by 0.3 ppm centered around the predicted shift for the methylene group.
The choice of nucleus to be shifted upfield or downfield is random.
13
C QUATERNARY CARBON INTENSITY REDUCTIONS
To simulate a lack of Overhauser effects, quaternary carbons have their peak intensities reduced by 33
percent.
LIMITATIONS
ChemDoodle can only predict shifts for nuclei where environments are well described in its database. Func-
tional groups that are not described well will have poorly calculated shifts and may result in values around
0 ppm, which should be ignored.
Since incremental constants do not take into account structure topography, 3D conformations will be poorly
analyzed. It is essential that you fully scrutinize all NMR simulation results from ChemDoodle.
To learn more about the algorithms implemented in ChemDoodle and their accuracy, obtain the references
listed under the Algorithms > Spectroscopy > Nuclear Magnetic Resonance section of ChemDoodle’s reference
list. The reference list can be viewed by selecting the Help|References menu item in the Help menu.
APPENDIX F
ChemDoodle Web Components
Appendix F: CHEMDOODLE WEB COMPONENTS 277
OVERVIEW
In addition to creating graphics and chemical files, ChemDoodle can also create dynamic web components.
This feature utilizes another iChemLabs technology, the ChemDoodle Web Components library. This ap-
pendix covers the following topics:
• ChemDoodle rendering features that are available in the ChemDoodle Web Components library.
• How generated components work for both desktop and mobile browsers.
1. Select the File|Generate Web Component. . . menu item. Make sure to first have drawn or loaded
any content you wish to be displayed on the Doodle Board.
2. If you had selected a molecule or spectrum before opening this window, then an appropriate viewer will
be selected. Otherwise, choose the Type of component you would like to create.
3. If you did not previously select content for the component and the Type of component chosen requires
content, then click on the Select button and choose the content to be displayed in the component.
4. As is shown in Figure F.1, set the size of the component and the component name (a random name is
generated for you to avoid name clashes).
5. Define any visual specifications for the component. It will inherit compatible visual specifications from
the current document style sheet in ChemDoodle.
6. In the Relevant Startup Parameters tree, select any Javascript variables or functions you would
like to define. Placeholders for them will be generated in the Javascript code.
278 Appendix F: CHEMDOODLE WEB COMPONENTS
7. Press the Preview button to preview your ChemDoodle Web Component in your main browser as
shown with Apple Safari in Figure F.2.
9. Click the Generate button to generate the Javascript for the component.
Paste the generated Javascript directly in your webpage (in the ¡body¿ tag) in the location you prefer the
component to appear. You must first install the ChemDoodle Web Components library for your webpage
for these components to work. Installation instructions are provided on the official ChemDoodle Web Com-
ponents website at https://web.chemdoodle.com/installation/download.
1. Draw all structures and spectra to be used in your webpage on the Doodle Board.
3. In the file chooser that appears, select the location and the name of the file to be saved.
4. In the drop-down selection for the file type, choose iChemLabs ChemDoodle Javascript Data.
All structures and spectra on the Doodle Board will be saved to the ChemDoodle JSON format in
Javascript. To use this file, link it into the HTML page as a Javascript resource or copy and paste the
source of the file into your Javascript code. Use the variable names declared in that file to use them.
Molecules begin with ’molecule’ and spectra begin with ’spectrum’. You should rename these variables to
not clash with other declared Javascript variables if necessary. These data structures can be used as is, such
as for immediate loading into components via load functions.
Appendix F: CHEMDOODLE WEB COMPONENTS 279
2. A window will appear (Figure F.3). Select the Choose Input button and locate the PDB file you
would like to optimize.
3. The output file path will be automatically generated for the same containing folder and name, but
with an extension of .js. Click the Choose Location button to change the location of the output
file. ChemDoodle will automatically change the extension to .js.
4. When satisfied with the paths, select the Optimize button. Depending on the size of the PDB file,
this function may take several seconds to complete.
5. To use the Javascript file with ChemDoodle Web Components, just include it in your web project, and
import it as a URI resource into the HTML page on which it is used. The PDB will be represented as
a Molecule data structure with the same name as the input file, prepended by the string “pdb ”. For
instance, if you optimized the file “1BNA.pdb”, then you can load the variable pdb 1BNA directly into
your component with the loadMolecule() function.
When using ChemDoodle 3D to optimize PDB files to JSON, you will be provided with two options:
1. Only include HETATM atoms - This option will only output HETATM atoms, ignoring the residue
atoms. If you have a very large structure and you only wish to see the ribbons or nucleic acids, then this
will dramatically reduce the data size and improve performance. Ribbons and other macromolecular
features will still be displayed, as will any HETATM atoms, including ligands.
2. Calculate Residue to Ligand distances - If you select this option, ligand atom distances to the
closest residue atom will be calculated and output. This is useful for advanced components that show
nearby residue structures using the functions in the ChemDoodle Web Components.
280 Appendix F: CHEMDOODLE WEB COMPONENTS
There is no difference between generating components for desktop browsers versus for mobile browsers.
The only consideration would be the size of the component. The ChemDoodle Web Component generator
contains a drop down selection to the right of the dimension panel containing preset sizes for mobile devices.
Use it to quickly set standard sizes if preferable.
RENDERING COMPATIBILITY
Even though ChemDoodle and the ChemDoodle Web Components library are in the same family of products,
their feature sets are not identical. Many graphical features and visual specifications provided in ChemDoodle
are not yet available in ChemDoodle Web Components.
Use the ChemDoodle Web Component window in ChemDoodle to help guide you through the available
visual specifications in the ChemDoodle Web Components library. Use the Preview button to ensure your
graphics will be correctly represented to your satisfaction.
You can update the ChemDoodle Web Components in ChemDoodle manually by replacing the corresponding
files in the resources folder in the ChemDoodle installation folder with the latest from the ChemDoodle
Web Components website. Please note that while this will allow you to use the latest ChemDoodle Web
Components with ChemDoodle, it will not add new features to ChemDoodle and it may require an update
from iChemLabs before it works completely.
LICENSE
The ChemDoodle Web Components library is licensed under version 3 of the GNU GENERAL PUBLIC
LICENSE: https://www.gnu.org/licenses/gpl-3.0.html
The license protects the code if one changes it or integrates it with a proprietary product. If you are
concerned about how the license will affect you, then you should contact us. If you do not fully understand
the GPL license or your answer is ‘yes’ to any of the following questions, then you should contact us before
using this library.
• Will you be integrating this library with another product that you will be distributing to the public in
any form?
• Will you need access to iChemLabs cloud services (using the ChemDoodle.iChemLabs package)?
Not under the GPL license. Rebranding is identical to removing our copyright notice on the source code,
which is also prohibited.
ATTRIBUTIONS
Attributions on webpages for the use of ChemDoodle and ChemDoodle Web Components are greatly appre-
ciated.
Several ChemDoodle Web Component badges are provided for this purpose at
https://web.chemdoodle.com/installation/badges.
FURTHER INFORMATION
For further information regarding the ChemDoodle Web Components, including webpage installation instruc-
tions, the most recent version and updates, advanced programming and use of the API, examples and browser
compatibility, visit the official ChemDoodle Web Components website at https://web.chemdoodle.com.
APPENDIX G
ChemDoodle Mobile
Appendix G: CHEMDOODLE MOBILE 283
OVERVIEW
ChemDoodle Mobile is the mobile companion to ChemDoodle desktop. ChemDoodle Mobile is free for all
customers of ChemDoodle desktop. This section lists:
SUPPORTED PLATFORMS
ChemDoodle Mobile is supported on both iOS and Android.
IOS
ChemDoodle Mobile can be installed on iPhones, iPod Touches and iPads via
the iTunes App Store. You can find ChemDoodle Mobile for iOS here:
https://itunes.apple.com/us/app/chemdoodle-mobile/id435468742?mt=8.
ANDROID
ChemDoodle Mobile can be installed on phones running the Android operating system via the Google Play
Store here: https://play.google.com/store/apps/details?id=com.iChemLabs.ChemDoodleMobile.
CALCULATIONS
• IUPAC Name
• Molecular Formula
• Empirical Formula
• Molecular Mass
• Monoisotopic Mass
• Degree of Unsaturation
• Molar Refractivity
• logP
• Complexity
SPECTRA
• 1 H NMR
13
• C NMR
Appendix G: CHEMDOODLE MOBILE 285
To create data in ChemDoodle for use in ChemDoodle Mobile, execute the following steps:
1. Draw the structure to be loaded into ChemDoodle Mobile in a new document in ChemDoodle.
2. Log into your online account by using the File|Sync with Online Account. . . menu item.
6. Press the Load button in ChemDoodle Mobile and then select From Account.
7. Choose the file you just saved from ChemDoodle desktop to load it.
Structures you saved in ChemDoodle Mobile can be edited in ChemDoodle by executing the steps above in
reverse order.
ChemDoodle Mobile can only handle one molecule a time. If you load a large document with
many molecules and shapes, only the first molecule will be used. If you then save that file in
ChemDoodle Mobile, you will override the original file and lose the additional structures and
shapes present in that file.
APPENDIX H
Technical Support
Appendix H: TECHNICAL SUPPORT 287
• Check the system requirements for ChemDoodle at the beginning of this user guide to ensure that your
system is supported.
• Read the TROUBLESHOOTING section of this appendix and follow the possible resolution tactics
outlined there.
• Double check that your problem is reproducible and outline the exact steps executed to cause it.
• Take screenshots of any relevant graphical issues or popup errors in their entirety.
• Make note of any steps you have taken in attempting to correct the problem.
This function will automatically pre-populate fields as appropriate in our support ticket system at sup-
port.ichemlabs.com. Fill in the remaining fields and open a ticket. You may also attach supporting files.
288 Appendix H: TECHNICAL SUPPORT
FEATURE REQUESTS
We are happy to receive feature requests from users. You can submit a request using the customer service
form as described in the previous section of this appendix.
Features that are not beyond the scope of ChemDoodle will be included in a future update. However, some
features may take a long time to implement, so please be patient when requesting new features. If a feature
is beyond the scope of ChemDoodle we will attempt to explain why in a response to the feature request.
The following steps describe how our feature request system works and how we prioritize the features that
we work on.
1. All feature requests (from customers and non-customers) are considered and are reported to our de-
velopment tracking system.
2. Feature requests are associated with a score based on the popularity of the request. Each feature
begins with a score of 0. The score is then incremented by 1 for each unique customer that requests
that feature (including the initial request if done by a customer). Non-customers that request features
do not affect feature scores.
3. Once each month, we reevaluate the scores and plan our development around the features with the
highest scores.
Therefore, to get the features you want implemented in ChemDoodle as fast as possible, do the following
two things:
• Let us know about the feature you would like to see implemented by contacting us using the method
described in the previous section.
• Get as many unique ChemDoodle customers to request the same feature as possible.
The iChemLabs newsfeed RSS can also be viewed by selecting the Help|iChemLabs Newsfeed menu item.
Appendix H: TECHNICAL SUPPORT 289
TROUBLESHOOTING
WINDOWS
Occasionally when you open ChemDoodle it will ask about connections, select “Keep Blocking”. ChemDoo-
dle creates a local socket to open files that are double-clicked, generating this warning. ChemDoodle never
accesses the internet unless you allow it to.
Sometimes the JRE can corrupt and you may see weird behavior when using ChemDoodle. Restart your
computer to resolve these issues.
MAC OS X
If you have updated ChemDoodle and notice that the new filetype associations aren’t being recognized in
Finder, restart your computer. The filetypes should now be recognized in Finder.
PERFORMANCE IMPROVEMENTS
HARDWARE
If you see a severe lag in responsiveness in ChemDoodle, then there is likely a scarcity of system resources.
Try the following solutions.
SOFTWARE
Apart from hardware upgrades, a few features in ChemDoodle can be changed to improve performance.
1. Disable the application rendering decorations in the Preferences window under the General tab in
the Decorations section.
2. Change the rendering parameters to the options that favor speed in the Preferences window under
the Advanced tab in the Document Rendering section.
3. Enable Advanced Hardware Acceleration in the Preferences window under the Advanced tab
in the Performance section. This option is disabled by default, as some users may not have graphics
cards which are compatible with this feature. But, if ChemDoodle is running slowly for you, give this
option a try.