Вы находитесь на странице: 1из 908

CS Product Registration

Registering your
CS Product
For faster response and accuracy, use the Web:
Please complete the
registration card at right.
www.cambridgesoft.com/register/
Registering your product
makes you eligible to USER INFORMATION
receive update and Register today and
upgrade information, Name
receive free:
technical support, and a Title
free subscription to Firm Warranty technical support
ChemBioNews.Com, a
Street
publication for Scientists ChemBioNews.Com publica-
with Computers. City State Zip
tion
Country for Scientists with Computers
www.cambridgesoft.com Tel Fax
Visit our homepage for Information on new releases
Email
more information about
CS products and services. Serial No. Purchase Date
Please copy serial number from CS Installation Instructions.

Technical Support
Warranty technical
support available. QUESTIONNAIRE (OPTIONAL)
For details please see:
1. Product you are registering (check one):
www.cambridgesoft.com/ o ChemOffice o ChemDraw o Chem3D o Inventory o Other
services/contact/
o BioOffice o BioDraw o BioAssay o E-Notebook
o Chem &Bio Office Enterprise o Chem &Bio Office Workgroup
o The Merck Index o ChemACX

2. System running CS software (check one):


o Microsoft Windows o Apple Macintosh o Other

3. Please check one that best describes you:


o Commercial o Academic o Student o Govt/Non Profit o Other

4. Your discipline:
o Analytical Chem. o Inorganic Chem. o Biochemistry o Chemical Engineering
o Physical Chem. o Organic Chem. o Pharmacology o Biology
o Proteomics o Genomics o Information o Other

Thank You! Enjoy your software!


!

US 1 617 588-9300 FAX 1 617 5889390 WWW www.cambridgesoft.com


EU 00 800 875 20000 FAX +44 1223 464990 EMAIL info@cambridgesoft.com
MAIL 100 CambridgePark Drive Cambridge, MA 02140 USA
!
Please remove this portion before mailing.
NO POSTAGE
NECESSARY
IF MAILED
IN THE
UNITED STATES

BUSINESS REPLY MAIL


FIRST-CLASS PERMIT NO. 5067 CAMBRIDGE, MA

POSTAGE WILL BE PAID BY ADDRESSEE

Product Registration
CambridgeSoft Corporation
100 CambridgePark Drive
Cambridge, MA 021409802 USA
Users Guide

Chem & Bio Office Desktop 2006


for Windows

Chem & Bio Office is an integrated suite including


Chem & Bio Draw for chemical structure drawing,
Chem & Bio 3D for molecular modeling and analysis,
BioAssay for biological data retrieval and visualization,
Inventory for managing and searching reagents,
E-Notebook for electronic journal and information,
ChemFinder for searching and information integration, and
ChemInfo for chemical and reference databases.

Chem & Bio Office


Chem & Bio 3D, Finder and E-Notebook


License Information

ChemOffice, BioOffice ChemDraw, Chem3D, ChemINDEX, ChemFinder, and ChemInfo programs, all resources
in the ChemOffice, ChemDraw, Chem3D, ChemFinder, and ChemInfo application files, and this manual are
Copyright 1986-2006 by CambridgeSoft Corporation (CS) with all rights reserved worldwide. MOPAC 2002 is
Copyright 1993-2006 by Fujitsu Limited with all rights reserved. Information in this document is subject to
change without notice and does not represent a commitment on the part of CS. Both these materials and the right
to use them are owned exclusively by CS. Use of these materials is licensed by CS under the terms of a software license
agreement; they may be used only as provided for in said agreement.

ChemOffice, ChemDraw, Chem3D, CS MOPAC, ChemFinder, Inventory, E-Notebook, BioAssay, and ChemInfo
are not supplied with copy protection. Do not duplicate any of the copyrighted materials except for your personal
backups without written permission from CS. To do so would be in violation of federal and international law, and
may result in criminal as well as civil penalties. You may use ChemOffice, ChemDraw, Chem3D, CS MOPAC,
ChemFinder, Inventory, E-Notebook, BioAssay, and ChemInfo on any computer owned by you; however, extra
copies may not be made for that purpose. Consult the CS License Agreement for Software and Database Products for
further details.

Trademarks

ChemOffice, BioOffice, ChemDraw, Chem3D, ChemINDEX, ChemFinder, ChemInfo and ChemACX are
registered trademarks of CambridgeSoft Corporation (Cambridge Scientific Computing, Inc.).

The Merck Index is a registered trademark of Merck & Co., Inc. 2006 All rights reserved.

MOPAC 2002 is a trademark of Fujitsu Limited.

Microsoft Windows, Windows 2000, Windows XP, and Microsoft Word are registered trademarks of Microsoft Corp.

Apple Events, Macintosh, Laserwriter, Imagewriter, QuickDraw and AppleScript are registered trademarks of Apple
Computer, Inc. Geneva, Monaco, and TrueType are trademarks of Apple Computer, Inc.

The ChemSelect Reaction Database is copyrighted by InfoChem GmbH 1997.

AspTear is copyrighted by Softwing.

InChI is a trademark of the International Union of Pure and Applied Chemistry. InChI Material in ChemDraw
is IUPAC 2005.

SCHRDINGER Jaguar

GAMESS is copyrighted by Ames Laboratory

Copyright 1986-2006 CambridgeSoft Corporation (Cambridge Scientific Computing, Inc.) All Rights Reserved.
Printed in the United States of America.

All other trademarks are the property of their respective holders.


CambridgeSoft End-User License Agreement for Software Products

Important: This CambridgeSoft Software License Agreement (Agreement) is a legal agreement between you, the
end user (either an individual or an entity), and CambridgeSoft Corporation (CS) regarding the use of CS Software
Products, which may include computer software, the associated media, any printed materials, and any online or
electronic documentation. By installing, copying, or otherwise using any CS Software Product, you signify that you
have read the CS End User License Agreement and agree to be bound by its terms. If you do not agree to the
Agreements terms, promptly return the package and all its contents to the place of purchase for a full refund.

CambridgeSoft Software License

1. Grant of License. CambridgeSoft (CS) Software Products are licensed, not sold. CS grants and you hereby accept
a nonexclusive license to use one copy of the enclosed Software Product (Software) in accordance with the terms of
this Agreement. This licensed copy of the Software may only be used on a single computer, except as provided below.
You may physically transfer the Software from one computer to another for your own use, provided the Software is
in use (or installed) on only one computer at a time. If the Software is permanently installed on your computer (other
than a network server), you may also use the Software on a portable or home computer, provided that you use the
software on only one computer at a time. You may not (a) electronically transfer the Software from one computer to
another, (b) distribute copies of the Software to others, or (c) modify or translate the Software without the prior writ-
ten consent of CS, (d) place the software on a server so that it is accessible via a public network such as the Internet,
(e) sublicense, rent, lease or lend any portion of the Software or Documentation, (f ) modify or adapt the Software or
merge it into another program, (g) modify or circumvent the software activation, or (h) reverse engineer the software
activation so as to circumvent it. The Software may be placed on a file or disk server connected to a network, provid-
ed that a license has been purchased for every computer with access to that server. You may make only those copies
of the Software which are necessary to install and use it as permitted by this agreement, or are for purposes of back-
up and archival records; all copies shall bear CSs copyright and proprietary notices. You may not make copies of any
accompanying written materials.

With a fixed license, the software cannot be installed on more than the number of computers equivalent to the num-
ber of fixed licenses purchased. For example, a 10-user fixed license means the software can be installed on no more
than 10 different computers. A fixed license cannot be installed on a server. With a concurrent license, the software
can be installed on any number of computers at the organization, but the number of computers using the software at
any one time cannot exceed the number of concurrent licenses purchased. For example, a 10-user concurrent license
can be installed on 20 computers, but no more than 10 users can be using it at any one time. If the number of users
of the software could potentially exceed the number of licensed copies, then Licensee must have a reasonable mech-
anism or process in place to assure that the number of persons using the software does not exceed the number of
copies. CambridgeSoft reserves the right to conduct periodic audits no more than once per year to review the imple-
mentation of this agreement at the Licensees site. At CambridgeSofts request, Licensee will provide a knowledgeable
employee to assist in said audit

2. Ownership. The Software is and at all times shall remain the sole property of CS. This ownership is protected by
the copyright laws of the United States and by international treaty provisions. Upon expiration or termination of this
agreement, you shall promptly return all copies of the Software and accompanying written materials to CS. You may
not modify, decompile, reverse engineer, or disassemble the Software.

3. Assignment Restrictions. You may not rent, lease, or otherwise sublet the Software or any part thereof. You may
transfer on a permanent basis the rights granted under this license provided you transfer this Agreement and all copies
of the Software, including prior versions, and all accompanying materials. The recipient must agree to the terms of
this Agreement in full and register this transfer in writing with CS.
4. Use of Included Data. All title and copyrights in and to the Software product, including but not limited to any
images, photographs, animations, video, audio, music, text, applets, Java applets, and data files and databases (the
Included Data), are owned by CS or its suppliers.

You may not copy, distribute or otherwise make the Included Data publicly available.

Licensed users of ChemOffice Enterprise and Workgroup and the accompanying Plugin software products may
access, search, and view the Included Data and may transmit the results of any search of the Included Data to other
users of the licensed ChemOffice Enterprise and Workgroup software products within your organization only, provided
that such transmission is via an internal corporate (or university) network and is not accessible by the public.

You may not install the Included Data on non-licensed computers nor distribute or otherwise make the Included
Data publicly available.

You may use the Software to organize personal data, and you may transmit such personal data over the Internet pro-
vided that the transmission does not contain any Included Data.

All rights not specifically granted under this Agreement are reserved by CS.

5. Separation of Components. The Software is licensed as a single product. Its component parts may not be sepa-
rated for use on more than one computer, except in the case of ChemOffice Enterprise. ChemOffice Enterprise
includes licenses for ChemDraw ActiveX and licenses for Chem3D ActiveX. The ActiveX software products may be
installed on computers other than that one on which ChemOffice Enterprise is installed. However, each copy of the
ActiveX is individually subject to the provisions of Paragraphs 1 through 4 of this Agreement.

6. Educational Use Only of Student Licenses. If you are a student enrolled at an educational institution, the CS
License Agreement grants to you personally a license to use one copy of the enclosed Software in accordance with the
terms of this Agreement. In this case the CS License Agreement does not permit commercial use of the Software nor
does it permit you to allow any other person to use the Software.

7. Termination. You may terminate the license at any time by destroying all copies of the Software and documenta-
tion in your possession. Without prejudice to any other rights, CS may terminate this Agreement if you fail to com-
ply with its terms and conditions. In such event, you must destroy all copies of the Software Product and all of its
component parts.

8. Confidentiality. The Software contains trade secrets and proprietary know-how that belong to CS and are
being made available to you in strict confidence. ANY USE OR DISCLOSURE OF THE SOFTWARE, OR USE OF ITS
ALGORITHMS, PROTOCOLS OR INTERFACES, OTHER THAN IN STRICT ACCORDANCE WITH THIS LICENSE
AGREEMENT, MAY BE ACTIONABLE AS A VIOLATION OF OUR TRADE SECRET RIGHTS.

CS Limited Warranty

Limited Warranty. CSs sole warranty with respect to the Software is that it shall be free of errors in program logic
or documentation, attributable to CS, which prevent the performance of the principal computing functions of the
Software. CS warrants this for a period of thirty (30) days from the date of receipt.
CSs Liability. In no event shall CS be liable for any indirect, special, or consequential damages, such as, but not lim-
ited to, loss of anticipated profits or other economic loss in connection with or arising out of the use of the software
by you or the services provided for in this agreement, even if CS has been advised of the possibility of such damages.
CSs entire liability and your exclusive remedy shall be, at CSs discretion, either (A) return of any license fee, or (B)
correction or replacement of software that does not meet the terms of this limited warranty and that is returned to
CS with a copy of your purchase receipt.
NO OTHER WARRANTIES. CS DISCLAIMS OTHER IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, AND IMPLIED WAR-
RANTIES ARISING BY USAGE OF TRADE, COURSE OF DEALING, OR COURSE OF PERFORMANCE. NOTWITH-
STANDING THE ABOVE, WHERE APPLICABLE, IF YOU QUALIFY AS A CONSUMER UNDER THE MAGNUSON-
MOSS WARRANTY ACT, THEN YOU MAY BE ENTITLED TO ANY IMPLIED WARRANTIES ALLOWED BY LAW FOR
THE PERIOD OF THE EXPRESS WARRANTY AS SET FORTH ABOVE. SOME STATES DO NOT ALLOW LIMITATIONS
ON IMPLIED WARRANTIES, SO THE ABOVE LIMITATION MIGHT NOT APPLY TO YOU. THIS WARRANTY GIVES
YOU SPECIFIC LEGAL RIGHTS, AND YOU MAY ALSO HAVE OTHER RIGHTS WHICH VARY FROM STATE TO STATE.

No Waiver. The failure of either party to assert a right hereunder or to insist upon compliance with any term or con-
dition of this Agreement shall not constitute a waiver of that right or excuse a similar subsequent failure to perform
any such term or condition by the other party.

Governing Law. This Agreement shall be construed according to the laws of the Commonwealth of Massachusetts.

Export. You agree that the Software will not be shipped, transferred, or exported into any country or used in any man-
ner prohibited by the United States Export Administration Act or any other export laws, restrictions, or regulations.

End-User License Agreement for CambridgeSoft Database Products

Important: This CambridgeSoft End-User License Agreement is a legal agreement between you (either an individual
or a single entity) and CambridgeSoft Corporation for the CambridgeSoft supplied database product(s) and may
include associated media, printed materials, and online or electronic documentation. By using the database prod-
uct(s) you agree that you have read, understood and will be bound by this license agreement.

Database Product License

1. Copyright Notice. The materials contained in CambridgeSoft Database Products, including but not limited to,
ChemACX, ChemIndex, and The Merck Index, are protected by copyright laws and international copyright treaties,
as well as other intellectual property laws and treaties. Copyright in the materials contained on the CD and internet
subscription products, including, but not limited to, the textual material, chemical structures representations,
artwork, photographs, computer software, audio and visual elements, is owned or controlled separately by
CambridgeSoft Corporation (CS).

CS is a distributor (and not a publisher) of information supplied by third parties. Accordingly, CS has no editorial
control over such information. Database Suppliers (Supplier) individually own all right, title, and interest, includ-
ing copyright, in their databaseand retain all such rights in providing information to Customers.

The materials contained in The Merck Index are protected by copyright laws and international copyright treaties, as
well as other intellectual property laws and treaties. Copyright in the materials contained on the CD and internet sub-
scription products, including, but not limited to, the textual material, chemical structures representations, artwork,
photographs, computer software, audio and visual elements, is owned or controlled separately by the Merck & Co.,
Inc., (Merck) and CambridgeSoft Corporation (CS).

2. Limitations on Use. Except as expressly provided by copyright law, copying, redistribution, or publication,
whether for commercial or non-commercial purposes, must be with the express permission of CS and/or Merck. In
any copying, redistribution, or publication of copyrighted material, any changes to or deletion of author attribution
or copyright notice, or any other proprietary notice of CS, Merck, or other Database producer are prohibited.
3. Grant of License, CD/DVD Databases. CambridgeSoft Software Products are licensed, not sold. CambridgeSoft
grants and you hereby accept a nonexclusive license to use one copy of the enclosed Software Product (Software) in
accordance with the terms of this Agreement. This licensed copy of the Software may only be used on a single com-
puter, except as provided below. You may physically transfer the Software from one computer to another for your own
use, provided the Software is in use (or installed) on only one computer at a time. If the Software is permanently
installed on your computer (other than a network server), you may also use the Software on a portable or home com-
puter, provided that you use the software on only one computer at a time. You may not (a) electronically transfer the
Software from one computer to another, (b) distribute copies of the Software to others, or (c) modify or translate the
Software without the prior written consent of CambridgeSoft, (d) place the software on a server so that it is accessi-
ble via a public network such as the Internet, (e) sublicense, rent, lease or lend any portion of the Software or
Documentation, or (f ) modify or adapt the Software or merge it into another program. The Software may be placed
on a file or disk server connected to a network, provided that a license has been purchased for every computer with
access to that server. You may make only those copies of the Software which are necessary to install and use it as per-
mitted by this agreement, or are for purposes of backup and archival records; all copies shall bear CambridgeSofts
copyright and proprietary notices. You may not make copies of any accompanying written materials.

4. Assignment Restrictions for CD/DVD databases. You may not rent, lease, or otherwise sublet the Software or
any part thereof. You may transfer on a permanent basis the rights granted under this license provided you transfer
this Agreement and all copies of the Software, including prior versions, and all accompanying materials. The recipi-
ent must agree to the terms of this Agreement in full and register this transfer in writing with CambridgeSoft.

5. Revocation of Subscription Access. Any use which is commercial and/or non-personal is strictly prohibited, and
may subject the Subscriber making such uses to revocation of access to this Paid Subscription Service, as well as any
other applicable civil or criminal penalties. Similarly, sharing a Subscriber password with a non-Subscriber or other-
wise making this Paid Subscription Service available to third parties other than the Authorized User as defined above
is strictly prohibited, and may subject the Subscriber participating in such activities to revocation of access to the Paid
Subscription Services; and, the Subscriber and any third party, to any other applicable civil or criminal penalties under
copyright or other laws. In the case of an authorized site license, a Subscriber shall cause any employee, agent or other
third party which the Subscriber allows to use the Paid Subscription Service materials to abide by all of the terms and
conditions of this Agreement. In all other cases, only the Subscriber is permitted to access the Paid Subscription
Service materials. Should CambridgeSoft become aware of any use that might cause revocation of the license, they
shall notify the Subscriber. The Subscriber shall have 90 days from date of notice to correct such violation before any
action will be taken.

6. Trademark Notice. THE MERCK INDEX is a trademark of Merck & Company Incorporated, Whitehouse
Station, New Jersey, USA and is registered in the United States Patent and Trademark Office. CambridgeSoft and
ChemACX are trademarks of CambridgeSoft Corporation, Cambridge,Massachusetts, USA and are registered in the
United States Patent and Trademark Office, the European Union (CTM) and Japan.

Any use of the marks in connection with the sale, offering for sale, distribution or advertising of any goods and serv-
ices, including any other website, or in connection with labels, signs, prints, packages, wrappers, receptacles or adver-
tisements used for the sale, offering for sale, distribution or advertising of any goods and services, including any other
website, which is likely to cause confusion, to cause mistake or to deceive, is strictly prohibited.

7. Modification of Databases, Websites, or Subscription Services. CS reserves the right to change, modify, sus-
pend or discontinue any or all parts of any Paid Subscription Services and databases at any time.
8. Representations and Warranties. The User shall indemnify, defend and hold CS, Merck, and/or other Supplier
harmless from any damages, expenses and costs (including reasonable attorneys fees) arising out of any breach or
alleged breach of these Terms and Conditions, representations and/or warranties herein, by the User or any third party
to whom User shares her/his password or otherwise makes available this Subscription Service. The User shall cooper-
ate in the defense of any claim brought against CambridgeSoft, Merck, and/or other Database Suppliers.

In no event shall CS, Merck, and/or other Supplier be liable for any indirect, special, or consequential damages, such
as, but not limited to, loss of anticipated profits or other economic loss in connection with or arising out of the use
of the software by you or the services provided for in this agreement, even if CS, Merck, and/or other Supplier has
been advised of the possibility of such damages. CS and/or Mercks entire liability and your exclusive remedy shall be,
at CSs discretion a return of any pro-rata portion of the subscription fee.

The failure of either party to assert a right hereunder or to insist upon compliance with any term or condition of this
Agreement shall not constitute a waiver of that right or excuse a similar subsequent failure to perform any such term
or condition by the other party.

This Agreement shall be construed according to the laws of the Commonwealth of Massachusetts, United States of
America.
: IS IT OK TO COPY MY COLLEAGUES Q: So I'm never allowed to copy software for any other

Q SOFTWARE?
NO, its not okay to copy your colleagues
software. Software is protected by federal copyright law,
reason?

A: Thats correct. Other than copying the software you


which says that you can't make such additional copies purchase onto a single computer and making another
without the permission of the copyright holder. By copy for archival purposes only or purposes only of
maintenance or repair, the copyright law prohibits
protecting the investment of computer software
you from making additional copies of the software for
companies in software development, the copyright law any other reason unless you obtain the permission of
serves the cause of promoting broad public availability of the software company.
new, creative, and innovative products. These companies
devote large portions of their earnings to the creation of Q: At my company, we pass disks around all the time.
new software products and they deserve a fair return on We all assume that this must be okay since it was
their investment. The creative teams who develop the the company that purchased the software in the
softwareprogrammers, writers, graphic artists and first place.
othersalso deserve fair compensation for their efforts.
Without the protection given by our copyright laws, they A: Many employees dont realize that corporations are
would be unable to produce the valuable programs that bound by the copyright laws, just like everyone else.
have become so important to our daily lives: educational Such conduct exposes the company (and possibly the
persons involved) to liability for copyright
software that teaches us much needed skills; business
infringement. Consequently, more and more
software that allows us to save time, effort and money; corporations concerned about their liability have
and entertainment and personal productivity software written policies against such softlifting. Employees
that enhances leisure time. may face disciplinary action if they make extra copies
of the companys software for use at home or on
Q: That makes sense, but what do I get out of additional computers within the office. A good rule to
purchasing my own software? remember is that there must be one authorized copy
of a software product for every computer upon which
A: When you purchase authorized copies of software it is run
programs, you receive user guides and tutorials, quick
reference cards, the opportunity to purchase Q: Can I take a piece of software owned by my
upgrades, and technical support from the software company and install it on my personal computer at
home if instructed by my supervisor?
publishers. For most software programs, you can read
about user benefits in the registration brochure or A: A good rule of thumb to follow is one software
upgrade flyer in the product box. package per computer, unless the terms of the license
agreement allow for multiple use of the program. But
Q: What exactly does the law say about copying some software publishers licenses allow for remote
software? or home use of their software. If you travel or
telecommute, you may be permitted to copy your
A: The law says that anyone who purchases a copy of software onto a second machine for use when you are
software has the right to load that copy onto a single not at your office computer. Check the license care-
computer and to make another copy for archival fully to see if you are allowed to do this.
purposes only or, in limited circumstances, for
purposes only of maintenance or repair. It is illegal Q: What should I do if become aware of a company
that is not compliant with the copyright law or its
to use that software on more than one computer or to
software licenses?
make or distribute copies of that software for any
other purpose unless specific permission has been A: Cases of retail, corporate and Internet piracy or non-
obtained from the copyright owner. If you pirate compliance with software licenses can be reported on
software, you may face not only a civil suit for the Internet at http://www.siia.net/piracy/report.asp
damages and other relief, but criminal liability as well, or by calling the Anti-Piracy Hotline:
including fines and jail terms of up to one year (800) 388-7478.
Q: Do the same rules apply to bulletin boards and user SIIA also offers a number of other materials designed to
groups? I always thought that the reason they got help you comply with the Federal Copyright Law. These
together was to share software. materials include:

A: Yes. Bulletin boards and user groups are bound by the


"It's Just Not Worth the Risk" video.
copyright law just as individuals and corporations.
This 12minute video, available $10, has helped over
However, to the extent they offer shareware or public 20,000 organizations dramatize to their employees the
domain software, this is a perfectly acceptable implications and consequences of software piracy.
practice. Similarly, some software companies offer
bulletin boards and user groups special demonstration
versions of their products, which in some instances Dont Copy that Floppy video
may be copied. In any event, it is the responsibility of This 9 minute rap video, available for $10, is designed
the bulletin board operator or user group to respect to educate students on the ethical use of software.
copyright law and to ensure that it is not used as a
vehicle for unauthorized copying or distribution.
Other education materials including, Software Use
Q: I'll bet most of the people who copy software don't and the Law, a brochure detailing the copyright law
even know that they're breaking the law. and how software should be used by educational
institutions, corporations and individuals; and several
A: Because the software industry is relatively new, and posters to help emphasize the message that unauthorized
because copying software is so easy, many people are copying of software is illegal.
either unaware of the laws governing software use or
choose to ignore them. It is the responsibility of each
To order any of these materials, please send your request to:
and every software user to understand and adhere to
copyright law. Ignorance of the law is no excuse. If SIIA Anti-Piracy Materials
you are part of an organization, see what you an do to Software & Information Industry Association
initiate a policy statement that everyone respects. 1090 Vermont Ave, Sixth Floor,
Also, suggest that your management consider Washington, D.C. 20005
conducting a software audit. Finally, as an individual, (202) 289-7442
help spread the word that users should be software
legal. We urge you to make as many copies as you would like
in order to help us spread the word that unauthorized
copying of software is illegal.
Q: What are the penalties for copyright infringement?

A: The Copyright Act allows a copyright owner to


recover monetary damages measured either by: (1) its
actual damages plus any additional profits of the
infringer attributable to the infringement, or (2)
statutory damages, of up to $150,000 for each copy-
righted work infringed. The copyright owner also has
the right to permanently enjoin an infringer from
engaging in further infringing activities and may be
awarded costs and attorneys fees. The law also
permits destruction or other reasonable disposition of
all infringing copies and devices by which infringing
copies have been made or used in violation of the
copyright owners exclusive rights. In cases of willful
infringement, criminal penalties may also be assessed
against the infringer.
A Guide to CambridgeSoft Manuals
Ch Ch
Ch em En em
em Fin te
M Dr
aw &
de
r
& rp
an ris
&
Bi
an in
g Ch Bi
oD
&
E-
Ch
em
Bi
o
O
d
Da
e
W o
O
ua St
an
em
& ra
N
ot
eb
&
Bi ffi
ce
ta ork
ba gr
ffi
ce
Includes ls da
rd Bio
w oo
k
o
3D se
s
ou
p

Chem & Bio Draw


Chem & Bio 3D
Chem & Bio Finder
Software

BioAssay Desktop
BioViz Desktop
Inventory Desktop
E-Notebook Desktop

ChemDraw/Excel
Desktop Applications

Struct <=> Name


CombiChem/Excel
ChemNMR
ChemFinder/Office
MOPAC, GAMESS, MM2
CS Gaussian, Jaguar Interface

Chem & Bio Office Enterprise


E-Notebook Enterprise, Workgroup
Enterprise Solutions

Document Enterprise
BioAssay Enterprise, Workgroup
BioSAR Enterprise
Inventory Enterprise, Workgroup
Registration Enterprise
Formulations & Mixtures
Oracle Cartridge

The Merck Index


ChemACX, ChemMSDX
Sigma Aldrich MSDS
Databases

ChemINDEX, NCI & AIDS, ChemRXN


Ashgate Drugs, Traditional Chinese Medicines
ChemSynth, ChemReact68
Medicinal Chemistry

Structure Drawing Tips


Tips

Searching Tips
Importing SD Files
Contents
Chem & BioOffice Introduction . . . . . 23 The Standard Toolbar . . . . . . . . . . . . . . . .40
About Chem3D . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 The Building Toolbar . . . . . . . . . . . . . . . . .40
The Model Display Toolbar . . . . . . . . . . .41
About ChemFinder . . . . . . . . . . . . . . . . . . . . . . . . 23
ChemFinder/Office . . . . . . . . . . . . . . . . . . . . 23 The Surfaces Toolbar . . . . . . . . . . . . . . . . .41
The Movie Toolbar . . . . . . . . . . . . . . . . . . .42
About CombiChem/Excel . . . . . . . . . . . . . . . . . . 23 The Demo Toolbar . . . . . . . . . . . . . . . . . . .42
About E-Notebook . . . . . . . . . . . . . . . . . . . . . . . . 24 The Calculation Toolbar . . . . . . . . . . . . . .42
About This Users Guide . . . . . . . . . . . . . . . . . . . 24 The ChemDraw Panel . . . . . . . . . . . . . . . . . .42
Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 The Model Information Panel . . . . . . . . . . .43
Additional Information . . . . . . . . . . . . . . . . . . . . . 24 The Output and Comments Windows . . . .44
Quick Reference Card . . . . . . . . . . . . . . . . . . 25 Model Building Basics . . . . . . . . . . . . . . . . . . . . . .44
Help System . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 Internal and External Tables . . . . . . . . . . . . .44
CambridgeSoft Web Pages . . . . . . . . . . . . . . 25 The Model Setting Dialog Box . . . . . . . . . . .45
Installation and System Requirements . . . . 25 Model Display . . . . . . . . . . . . . . . . . . . . . . . . .46
Microsoft Windows Requirements .25 Model Data Labels . . . . . . . . . . . . . . . . . . .46
Site License Network Installation Atom Types . . . . . . . . . . . . . . . . . . . . . . . . .47
Instructions . . . . . . . . . . . . . . . . . . . . . . . . . 26 Rectification . . . . . . . . . . . . . . . . . . . . . . . . .48
Bond Lengths and Bond Angles . . . . . . .48
Section I: Chem3D Introduction . . . . . 27 The Model Explorer . . . . . . . . . . . . . . . . . . . .48
Model Coordinates . . . . . . . . . . . . . . . . . . . . .48
About Chem3D . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Z-matrix . . . . . . . . . . . . . . . . . . . . . . . . . . . .48
COEA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Cartesian Coordinates . . . . . . . . . . . . . . . .49
About CS MOPAC . . . . . . . . . . . . . . . . . . . . . 27
The Measurements Table . . . . . . . . . . . . .49
About Gaussian . . . . . . . . . . . . . . . . . . . . . . . . 27
About Jaguar . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 Chapter 2: Chem3D Tutorials . . . . . . . 51
Whats New in Chem3D 10? . . . . . . . . . . . . . . . . 28 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51
For Users of Chem3D 9 . . . . . . . . . . . . . . . . . . . . 28 Tutorial 1: Working with ChemDraw . . . . . . . .51
For Users of Chem3D Versions 6 to 8 . . . 31 Tutorial 2: Building Models with the
Chapter 1: Chem3D Basics . . . . . . . . . 33 Bond Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52
The Graphical User Interface . . . . . . . . . . . . . . . 33 Tutorial 3: Building Models with the
Model Window . . . . . . . . . . . . . . . . . . . . . . . . 33 Text Building Tool . . . . . . . . . . . . . . . . . . . . . . . . .56
Rotation Bars . . . . . . . . . . . . . . . . . . . . . . . . 34 Replacing Atoms . . . . . . . . . . . . . . . . . . . . . . .56
Preferences Dialog Box . . . . . . . . . . . . . . . . . 34 Using Labels to Create Models . . . . . . . . . . .57
Menus and Toolbars . . . . . . . . . . . . . . . . . . . . 35 Using Substructures . . . . . . . . . . . . . . . . . . . .58
The File Menu . . . . . . . . . . . . . . . . . . . . . . . 35 Tutorial 4: Examining Conformations. . . . . . . .59
The Edit Menu . . . . . . . . . . . . . . . . . . . . . . 35 Tutorial 5: Mapping Conformations with
The View Menu/Model Display the Dihedral Driver . . . . . . . . . . . . . . . . . . . . . . . .62
Toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 Rotating two dihedrals . . . . . . . . . . . . . . . .62
The Structure Menu . . . . . . . . . . . . . . . . . . 38 Customizing the Graph . . . . . . . . . . . . . . .63

Chem & BioOffice 2006 /Contents


Tutorial 6: Overlaying Models . . . . . . . . . . . . . . 63 Total Charge Density . . . . . . . . . . . . . . . . . . . 92
Tutorial 7: Docking Models . . . . . . . . . . . . . . . . 65 Total Spin Density . . . . . . . . . . . . . . . . . . . . . 92
Tutorial 8: Viewing Molecular Surfaces . . . . . . 68 Molecular Electrostatic Potential . . . . . . . . 92
Molecular Orbitals . . . . . . . . . . . . . . . . . . . . . 93
Tutorial 9: Mapping Properties onto Surfaces 69
Administrator

Visualizing Surfaces from Other Sources . . . . 93


Tutorial 10: Computing Partial Charges . . . . . . 71
Chapter 4: Building and Editing
Chapter 3: Displaying Models. . . . . . . 75
Models. . . . . . . . . . . . . . . . . . . . . . . . . . 95
Structure Displays . . . . . . . . . . . . . . . . . . . . . . . . . 75
Setting the Model Building Controls . . . . . . . . . 95
Model Types . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Displaying Solid Spheres . . . . . . . . . . . . . . . . 77 Building with the ChemDraw Panel . . . . . . . . . 96
Setting Solid Sphere Size . . . . . . . . . . . . . 78 Unsynchronized Mode . . . . . . . . . . . . . . . . . 96
Displaying Dot Surfaces . . . . . . . . . . . . . . . . 78 Name=Struct . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Coloring Displays . . . . . . . . . . . . . . . . . . . . . . 79 Building with Other 2D Programs . . . . . . . 97
Coloring by Element . . . . . . . . . . . . . . . . . 79 Building With the Bond Tools . . . . . . . . . . . . . . 97
Coloring by Group . . . . . . . . . . . . . . . . . . 79 Creating Uncoordinated Bonds . . . . . . . . . . 98
Coloring by Partial Charge . . . . . . . . . . . . 79 Removing Bonds and Atoms . . . . . . . . . . . . 98
Coloring by depth for Chromatek Building With The Text Tool . . . . . . . . . . . . . . . 99
stereo viewers . . . . . . . . . . . . . . . . . . . . . . 80 Using Labels . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Red-blue Anaglyphs . . . . . . . . . . . . . . . . . . 80 Changing atom types . . . . . . . . . . . . . . . . 100
Depth Fading3D enhancement: . . . . . . . 80 The Table Editor . . . . . . . . . . . . . . . . . . . 100
Perspective Rendering . . . . . . . . . . . . . . . . 80 Specifying Order of Attachment . . . . . . 100
Coloring the Background Window . . . . . . . 81 Using Substructures . . . . . . . . . . . . . . . . . . . 100
Coloring Individual Atoms . . . . . . . . . . . . . . 81 Building with Substructures . . . . . . . . . . . . 101
Displaying Atom Labels . . . . . . . . . . . . . . . . 81 Example 1. Building Ethane with
Setting Default Atom Label Display Substructures . . . . . . . . . . . . . . . . . . . . . . 101
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 Example 2. Building a Model with a
Displaying Labels Atom by Atom . . . . . 82 Substructure and Several Other
Displaying Group Labels . . . . . . . . . . . . . . . 82 Elements . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Displaying Measurements . . . . . . . . . . . . . . . 82 Example 3. Polypeptides . . . . . . . . . . . . 102
Using Stereo Pairs. . . . . . . . . . . . . . . . . . . . . . 83 Example 4. Other Polymers . . . . . . . . . . 103
Using Hardware Stereo Graphic Replacing an Atom with a Substructure . 103
Enhancement . . . . . . . . . . . . . . . . . . . . . . . . . 83 Building From Tables . . . . . . . . . . . . . . . . . . . . . 103
Molecular Surface Displays . . . . . . . . . . . . . . . . . 84 Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Extended Hckel . . . . . . . . . . . . . . . . . . . . . . 85 Changing an Atom to Another Element . . . . 104
Displaying Molecular Surfaces . . . . . . . . . . . 85 Changing an Atom to Another Atom
Setting Molecular Surface Types . . . . . . . 86 Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Setting Molecular Surface Isovalues . . . . 87
Changing Bonds . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Setting the Surface Resolution . . . . . . . . 88
Creating Bonds by Bond Proximate
Setting Molecular Surface Colors . . . . . . 88 Addition . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Setting Solvent Radius . . . . . . . . . . . . . . . . 88
Adding Fragments . . . . . . . . . . . . . . . . . . . . . . . 106
Setting Surface Mapping . . . . . . . . . . . . . . 89
View Focus. . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Partial Surfaces . . . . . . . . . . . . . . . . . . . . . . 89
Solvent Accessible Surface . . . . . . . . . . . . . . 91 Setting Measurements . . . . . . . . . . . . . . . . . . . . . 107
Connolly Molecular Surface . . . . . . . . . . . . . 91 Setting Bond Lengths . . . . . . . . . . . . . . . . . 108


CambridgeSoft
Setting Bond Angles . . . . . . . . . . . . . . . . . . . 108 Aligning to an Axis . . . . . . . . . . . . . . . . . . . .123
Setting Dihedral Angles . . . . . . . . . . . . . . . . 108 Aligning to a Plane . . . . . . . . . . . . . . . . . . . .123
Setting Non-Bonded Distances . . . . . . . . . 108 Resizing Models . . . . . . . . . . . . . . . . . . . . . . . . . .124
Atom Movement When Setting Centering a Selection . . . . . . . . . . . . . . . . . .124
Measurements . . . . . . . . . . . . . . . . . . . . . . . . 108 Using the Zoom Control . . . . . . . . . . . . . . .124
Setting Constraints . . . . . . . . . . . . . . . . . . . . 109 Scaling a Model . . . . . . . . . . . . . . . . . . . . . . .124
Setting Charges . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 Changing the Z-matrix . . . . . . . . . . . . . . . . . . . .125
Setting Serial Numbers . . . . . . . . . . . . . . . . . . . . 109 The First Three Atoms in a Z-matrix . . . .125
Changing Stereochemistry . . . . . . . . . . . . . . . . . 110 Atoms Positioned by Three Other
Inversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 Atoms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .125
Reflection . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 Positioning Example . . . . . . . . . . . . . . . .126
Refining a Model . . . . . . . . . . . . . . . . . . . . . . . . . 111 Positioning by Bond Angles . . . . . . . . . .127
Rectifying Atoms . . . . . . . . . . . . . . . . . . . . . . 112 Positioning by Dihedral Angle . . . . . . . .127
Cleaning Up a Model . . . . . . . . . . . . . . . . . . 112 Setting Origin Atoms . . . . . . . . . . . . . . . .127

Chapter 5: Manipulating Models . . . 113 Chapter 6: Inspecting Models . . . . . . 129


Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 Model Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .129
Selecting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 Pop-up Information. . . . . . . . . . . . . . . . . . . . . . .129
Selecting Single Atoms and Bonds . . . . . . 113 Non-Bonded Distances . . . . . . . . . . . . . .130
Selecting Multiple Atoms and Bonds . . . .114 Measurement Table . . . . . . . . . . . . . . . . . . . . . . .131
Deselecting Atoms and Bonds . . . . . . . . . . 114 Editing Measurements . . . . . . . . . . . . . . . . .131
Selecting Groups of Atoms and Bonds . . 114 Optimal Measurements . . . . . . . . . . . . . . . .131
Using the Selection Rectangle . . . . . . . .114 Non-Bonded Distances in Tables . . . . . . .132
Defining Groups . . . . . . . . . . . . . . . . . . . . 115 Showing the Deviation from Plane . . . .132
Selecting a Group or Fragment . . . . . . . 115 Removing Measurements from a Table 132
Selecting Atoms or Groups by Distance . 116 Displaying the Coordinates Tables . . . . . .133
Showing and Hiding Atoms . . . . . . . . . . . . . . . . 116 Internal Coordinates . . . . . . . . . . . . . . . . .133
Showing Hs and Lps . . . . . . . . . . . . . . . . . . . 117 Cartesian Coordinates . . . . . . . . . . . . . . .133
Showing All Atoms . . . . . . . . . . . . . . . . . . . . 117 Comparing Models by Overlay . . . . . . . . . . . . .134
Hydrogen Bonding and Polar Hydrogen Working With the Model Explorer . . . . . . . . .136
Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 Model Explorer Objects . . . . . . . . . . . . . . .136
Moving Atoms or Models . . . . . . . . . . . . . . . . . 118 Creating Groups . . . . . . . . . . . . . . . . . . . .138
Moving Models with the Translate Tool . 119 Adding to Groups . . . . . . . . . . . . . . . . . . .138
Rotating Models . . . . . . . . . . . . . . . . . . . . . . . . . . 119 Pasting Substructures . . . . . . . . . . . . . . . .138
X- Y- or Z-Axis Rotations . . . . . . . . . . . . . 120 Deleting Groups . . . . . . . . . . . . . . . . . . . .139
Rotating Fragments . . . . . . . . . . . . . . . . . . . . 120 Using the Display Mode . . . . . . . . . . . . .139
Trackball Tool . . . . . . . . . . . . . . . . . . . . . . . . 120 Coloring Groups . . . . . . . . . . . . . . . . . . . .139
Internal Rotations . . . . . . . . . . . . . . . . . . . . . 120 Resetting Defaults . . . . . . . . . . . . . . . . . . .139
Using the Rotation Dial . . . . . . . . . . . . . . 120 Animations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .139
Rotating Around a Bond . . . . . . . . . . . . . 122 Creating and Playing Movies . . . . . . . . . . . .139
Rotating Around a Specific Axis . . . . . . 122 Spinning Models . . . . . . . . . . . . . . . . . . . . . .140
Rotating a Dihedral Angle . . . . . . . . . . . . 122 Spin About Selected Axis . . . . . . . . . . . .140
Changing Orientation . . . . . . . . . . . . . . . . . . . . . 122 Editing a Movie . . . . . . . . . . . . . . . . . . . . . . .140
Movie Control Panel . . . . . . . . . . . . . . . . . . .140

Chem & BioOffice 2006 /Contents


Chapter 7: Printing and Exporting Chapter 8: MM2 and MM3
Models. . . . . . . . . . . . . . . . . . . . . . . . . 143 Computations . . . . . . . . . . . . . . . . . . . 157
Printing Models . . . . . . . . . . . . . . . . . . . . . . . . . . 143 MM2 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Specifying Print Options . . . . . . . . . . . . . . . 143 Minimize Energy . . . . . . . . . . . . . . . . . . . . . . . . . 157
Administrator

Printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144 Running a Minimization . . . . . . . . . . . . . . . 159


Exporting Models Using Different File Queuing Minimizations . . . . . . . . . . . . . . . . 159
Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144 Example: Minimizing Ethane . . . . . . . . 159
Publishing Formats . . . . . . . . . . . . . . . . . . . 145 Example: Comparing Two Stable
Image Format Features . . . . . . . . . . . . . . 145 Conformations of Cyclohexane . . . . . 161
WMF and EMF . . . . . . . . . . . . . . . . . . . . 146 Molecular Dynamics . . . . . . . . . . . . . . . . . . . . . . 163
BMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 Performing a Molecular Dynamics
EPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 Computation . . . . . . . . . . . . . . . . . . . . . . . . 164
TIF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 Dynamics Settings . . . . . . . . . . . . . . . . . . 164
GIF and PNG and JPG . . . . . . . . . . . . . 147 Job Type Settings . . . . . . . . . . . . . . . . . . . 165
3DM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147 Example: Computing the Molecular
AVI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147 Dynamics Trajectory for a Short
Formats for Chemistry Modeling Segment of PTFE . . . . . . . . . . . . . . . . . . 166
Applications . . . . . . . . . . . . . . . . . . . . . . . . . 147 Compute Properties . . . . . . . . . . . . . . . . . . . . . . 167
Alchemy . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Showing Used Parameters . . . . . . . . . . . . . . . . . 169
Cartesian Coordinates . . . . . . . . . . . . . . . 148
Repeating an MM2 Computation . . . . . . . 169
Connection Table . . . . . . . . . . . . . . . . . . . 148
Using JDF Files . . . . . . . . . . . . . . . . . . . . . . . 169
Gaussian Input . . . . . . . . . . . . . . . . . . . . . 149
Gaussian Checkpoint . . . . . . . . . . . . . . . 149 Chapter 9: MOPAC Computations. . 171
Gaussian Cube . . . . . . . . . . . . . . . . . . . . . 149 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Internal Coordinates . . . . . . . . . . . . . . . . 149
Minimizing Energy . . . . . . . . . . . . . . . . . . . . . . . 172
MacroModel Files . . . . . . . . . . . . . . . . . . 150
Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
Molecular Design Limited
Optimizing Geometry . . . . . . . . . . . . . . . . . 173
MolFile (.MOL) . . . . . . . . . . . . . . . . . . . 150
TS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
MSI ChemNote . . . . . . . . . . . . . . . . . . . . 150
BFGS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
MOPAC Files . . . . . . . . . . . . . . . . . . . . . 150
LBFGS . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
MOPAC Graph Files . . . . . . . . . . . . . . . 153
Adding Keywords . . . . . . . . . . . . . . . . . . . . . 174
Protein Data Bank Files . . . . . . . . . . . . . 153
Optimize to Transition State . . . . . . . . . 174
ROSDAL Files (RDL) . . . . . . . . . . . . . . 153
Example: Locating the Eclipsed
Standard Molecular Data (SMD) . . . . 153
Transition State of Ethane . . . . . . . . . . 175
SYBYL Files . . . . . . . . . . . . . . . . . . . . . . . 153
Computing Properties . . . . . . . . . . . . . . . . . . . . 176
Job Description File Formats . . . . . . . . . . 153
MOPAC Properties. . . . . . . . . . . . . . . . . . . 177
JDF Files . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Heat of Formation, DHf . . . . . . . . . . . . 177
JDT Files . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Gradient Norm . . . . . . . . . . . . . . . . . . . . . 177
Exporting With the Clipboard . . . . . . . . . . . . 154 Dipole Moment . . . . . . . . . . . . . . . . . . . . 178
Copying to ChemDraw . . . . . . . . . . . . . . . . 154
Charges . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
Copying to Other Applications . . . . . . . . . 154
Mulliken Charges . . . . . . . . . . . . . . . . . . . 178
Embedding Models in Other
Charges From an Electrostatic
Applications . . . . . . . . . . . . . . . . . . . . . . . . . 155
Potential . . . . . . . . . . . . . . . . . . . . . . . . . . 178
Background Effects and Images . . . . . . 156
Wang-Ford Charges . . . . . . . . . . . . . . . . . 179


CambridgeSoft
Electrostatic Potential . . . . . . . . . . . . . . . 179 Computing Properties . . . . . . . . . . . . . . . . . . . . .199
Molecular Surfaces . . . . . . . . . . . . . . . . . . 179 Job Description File Formats . . . . . . . . . . . . . .199
Polarizability . . . . . . . . . . . . . . . . . . . . . . . . 179 JDT Format . . . . . . . . . . . . . . . . . . . . . . . .199
COSMO Solvation in Water . . . . . . . . . . 180 JDF Format . . . . . . . . . . . . . . . . . . . . . . . .199
Hyperfine Coupling Constants . . . . . . . 180 Running a Gaussian Input File . . . . . . . . . .200
Spin Density . . . . . . . . . . . . . . . . . . . . . . . . 181 Running a Gaussian Job . . . . . . . . . . . . . . . .200
Example 1: The Dipole Moment of Repeating a Gaussian Job . . . . . . . . . . . . . .201
Formaldehyde . . . . . . . . . . . . . . . . . . . . . 182
Example 2: Comparing Cation Chapter 11: GAMESS Computations 203
Stabilities in a Homologous Series GAMESS Overview . . . . . . . . . . . . . . . . . . . . . .203
of Molecules . . . . . . . . . . . . . . . . . . . . . . . 182 Minimize Energy . . . . . . . . . . . . . . . . . . . . . . . . .203
Example 3: Analyzing Charge The Job & Theory Tab . . . . . . . . . . . . . . . . .204
Distribution in a Series Of Mono- The General Tab . . . . . . . . . . . . . . . . . . . . . .204
substituted Phenoxy Ions . . . . . . . . . . . 183 Specifying Properties to Compute . . . . . . .205
Example 4: Calculating the Dipole Specifying the General Settings . . . . . . . . .205
Moment of meta-Nitrotoluene . . . . . . . 184 Saving Customized Job Descriptions. . . . . . . .205
Example 5: Comparing the Stability
Running a GAMESS Job . . . . . . . . . . . . . . . . . .206
of Glycine Zwitterion in Water
and Gas Phase . . . . . . . . . . . . . . . . . . . . . 185 Chapter 12: Jaguar . . . . . . . . . . . . . . . 207
Example 6: Hyperfine Coupling Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .207
Constants for the Ethyl Radical . . . . . . 186 Minimizing Energy . . . . . . . . . . . . . . . . . . . . . . . .207
Example 7: UHF Spin Density
Optimize to Transition State . . . . . . . . . . . . . . .208
for the Ethyl Radical . . . . . . . . . . . . . . . . 187
Example 8: RHF Spin Density Predicting Spectra . . . . . . . . . . . . . . . . . . . . . . . . .209
for the Ethyl Radical . . . . . . . . . . . . . . . . 188 Computing Properties . . . . . . . . . . . . . . . . . . . . .209
MOPAC Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188 Advanced Mode . . . . . . . . . . . . . . . . . . . . . . . . . .210
Using the *.out file . . . . . . . . . . . . . . . . . . . . 188
Creating an Input File . . . . . . . . . . . . . . . . . . 189 Appendix A: Substructures. . . . . . . . . 211
Running Input Files . . . . . . . . . . . . . . . . . . . 189 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .211
Running MOPAC Jobs . . . . . . . . . . . . . . . . 190 Attachment point rules . . . . . . . . . . . . . . . . .211
Repeating MOPAC Jobs . . . . . . . . . . . . . . . 190 Angles and measurements . . . . . . . . . . . . . .211
Creating Structures From ARC Files . . . .190 Defining Substructures . . . . . . . . . . . . . . . . . . . .212
Chapter 10: Gaussian . . . . . . . . . . . . . 193
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193 Appendix B: Keyboard Modifiers . . . 213
New Gaussian Interface . . . . . . . . . . . . . . . . . . . 193 Rotation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .213
Predicting Spectra . . . . . . . . . . . . . . . . . . . . . 193 Zoom and Translate . . . . . . . . . . . . . . . . . . . . . .213
Multi-step Jobs . . . . . . . . . . . . . . . . . . . . . . . . 194 Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .214
Partial Optimizations . . . . . . . . . . . . . . . . . . 195 Standard Selection . . . . . . . . . . . . . . . . . . .214
Input Template . . . . . . . . . . . . . . . . . . . . . . . 195 Radial Selection . . . . . . . . . . . . . . . . . . . . .214
Advanced Mode . . . . . . . . . . . . . . . . . . . . . . . 196
Support for DFT Methods . . . . . . . . . . . . . 196 Appendix C: Atom Types . . . . . . . . . . 217
Minimizing Energy. . . . . . . . . . . . . . . . . . . . . . . . 196 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .217
Other Options . . . . . . . . . . . . . . . . . . . . . . . . 198
Assigning Atom Types . . . . . . . . . . . . . . . . . . . .217

Chem & BioOffice 2006 /Contents


Atom Type Characteristics . . . . . . . . . . . . . 217 FORTRAN Formats . . . . . . . . . . . . . . . . 250
Defining Atom Types . . . . . . . . . . . . . . . . . . . . . 218
Appendix F: Parameter Tables . . . . . 251
Appendix D: 2D to 3D Conversion . . 219 Parameter Table Overview . . . . . . . . . . . . . . . . 251
Administrator

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219 Parameter Table Use . . . . . . . . . . . . . . . . . . . . . . 251


Stereochemical Relationships . . . . . . . . . . . 219 Parameter Table Fields . . . . . . . . . . . . . . . . . . . . 252
Example 1 . . . . . . . . . . . . . . . . . . . . . . . . . 219 Atom Type Numbers . . . . . . . . . . . . . . . . . . 252
Example 2 . . . . . . . . . . . . . . . . . . . . . . . . . 219 Quality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
Example 3 . . . . . . . . . . . . . . . . . . . . . . . . . 220 Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
Example 4 . . . . . . . . . . . . . . . . . . . . . . . . . 220 Estimating Parameters . . . . . . . . . . . . . . . . . . . . 253
Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
Creating Parameters . . . . . . . . . . . . . . . . . . . . . . 253
The Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
Appendix E: File Formats . . . . . . . . . 221
Symbol. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
Editing File Format Atom Types. . . . . . . . . . . 221 Covalent Radius . . . . . . . . . . . . . . . . . . . . . . 254
Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221 Color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
Description. . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Atom Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
File Format Examples . . . . . . . . . . . . . . . . . . . . 221 Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
Alchemy File . . . . . . . . . . . . . . . . . . . . . . . . . 221 Symbol. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
FORTRAN Formats . . . . . . . . . . . . . . . . 222 van der Waals Radius . . . . . . . . . . . . . . . . . . 255
Cartesian Coordinate Files . . . . . . . . . . . . . 223 Text Number (Atom Type) . . . . . . . . . . . . 255
Atom Types in Cartesian Coordinate Charge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223 Maximum Ring Size . . . . . . . . . . . . . . . . . . . 255
The Cartesian Coordinate File Format 223 Rectification Type . . . . . . . . . . . . . . . . . . . . . 255
FORTRAN Formats . . . . . . . . . . . . . . . . 226 Geometry . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
Cambridge Crystal Data Bank Files . . . . . 226 Number of Double Bonds, Triple
Internal Coordinates File . . . . . . . . . . . . . . 227 Bonds, and Delocalized Bonds . . . . . . . . 256
Bonds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228 Bound-to Order . . . . . . . . . . . . . . . . . . . . . . 256
FORTRAN Formats . . . . . . . . . . . . . . . . 229 Bound-to Type . . . . . . . . . . . . . . . . . . . . . . . 256
MacroModel. . . . . . . . . . . . . . . . . . . . . . . . . . 229
Substructures . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
FORTRAN Formats . . . . . . . . . . . . . . . . 230
MDL MolFile . . . . . . . . . . . . . . . . . . . . . . . . 231 References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
Limitations . . . . . . . . . . . . . . . . . . . . . . . . . 233 Reference Number . . . . . . . . . . . . . . . . . . . . 257
FORTRAN Formats . . . . . . . . . . . . . . . . 233 Reference Description . . . . . . . . . . . . . . . . . 257
MSI MolFile . . . . . . . . . . . . . . . . . . . . . . . . . . 233 Bond Stretching Parameters . . . . . . . . . . . . . . . 257
FORTRAN Formats . . . . . . . . . . . . . . . . 237 Bond Type . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
MOPAC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237 KS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
FORTRAN Formats . . . . . . . . . . . . . . . . 238 Length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
Protein Data Bank Files . . . . . . . . . . . . . . . 239 Bond Dipole . . . . . . . . . . . . . . . . . . . . . . . . . 258
FORTRAN Formats . . . . . . . . . . . . . . . . 240 Record Order . . . . . . . . . . . . . . . . . . . . . . . . . 258
ROSDAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242 Angle Bending . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
SMD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242 Angle Type . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
SYBYL MOL File. . . . . . . . . . . . . . . . . . . . . 245 KB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
FORTRAN Formats . . . . . . . . . . . . . . . . 247 XR2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
SYBYL MOL2 File . . . . . . . . . . . . . . . . . . . 247 XRH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259


CambridgeSoft
XH2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260 Appendix G: Computation Concepts. 269
Record Order . . . . . . . . . . . . . . . . . . . . . . . . . 260 Computational Methods Overview . . . . . . . . .269
Pi Atoms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260 Uses of Computational Methods . . . . . . . .270
Atom Type . . . . . . . . . . . . . . . . . . . . . . . . . . . 260 Choosing the Best Method . . . . . . . . . . . . .270
Electron . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260 Molecular Mechanics Methods
Ionization . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260 Applications Summary . . . . . . . . . . . . . .271
Repulsion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260 Quantum Mechanical Methods
Pi Bonds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261 Applications Summary . . . . . . . . . . . . . .271
Bond Type. . . . . . . . . . . . . . . . . . . . . . . . . . . . 261 Potential Energy Surfaces . . . . . . . . . . . .273
dForce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261 Potential Energy Surfaces (PES) . . . . . .273
dLength . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261 Single Point Energy Calculations . . . . . .273
Record Order . . . . . . . . . . . . . . . . . . . . . . . . . 261 Geometry Optimization . . . . . . . . . . . . .274
Electronegativity Adjustments . . . . . . . . . . . . . 261 Molecular Mechanics Theory in Brief . . . . . . .275
MM2 Constants . . . . . . . . . . . . . . . . . . . . . . . . . . 262 The Force-Field . . . . . . . . . . . . . . . . . . . . . . .276
Cubic and Quartic Stretch Constants . . . . 262 MM2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .276
Type 2 (-CHR-) Bending Force Bond Stretching Energy . . . . . . . . . . . . .277
Parameters for C-C-C Angles . . . . . . . . . . 262 Angle Bending Energy . . . . . . . . . . . . . . .277
Stretch-Bend Parameters . . . . . . . . . . . . . . . 263 Torsion Energy . . . . . . . . . . . . . . . . . . . . .278
Sextic Bending Constant . . . . . . . . . . . . . . . 263 Non-Bonded Energy . . . . . . . . . . . . . . . .278
Dielectric Constants . . . . . . . . . . . . . . . . . . . 263 van der Waals Energy . . . . . . . . . . . . . . . .279
Electrostatic and van der Waals Cutoff Parameters for van der Waals
Cutoff Parameters . . . . . . . . . . . . . . . . . . . . 263 Interactions . . . . . . . . . . . . . . . . . . . . . . . .279
Electrostatic Energy . . . . . . . . . . . . . . . . .279
MM2 Atom Types . . . . . . . . . . . . . . . . . . . . . . . . 263
charge/charge contribution . . . . . . . . . .280
Atom type number . . . . . . . . . . . . . . . . . . . . 263
dipole/dipole contribution . . . . . . . . . . .280
R* . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
dipole/charge contribution . . . . . . . . . . .280
Eps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Cutoff Parameters for Electrostatic
Reduct . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Interactions . . . . . . . . . . . . . . . . . . . . . . . .280
Atomic Weight . . . . . . . . . . . . . . . . . . . . . . . . 264
OOP Bending . . . . . . . . . . . . . . . . . . . . . .281
Lone Pairs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Pi Bonds and Atoms with Pi Bonds . . .281
Torsional Parameters . . . . . . . . . . . . . . . . . . . . . . 264
Stretch-Bend Cross Terms . . . . . . . . . . .281
Dihedral Type. . . . . . . . . . . . . . . . . . . . . . . . . 265
User-Imposed Constraints . . . . . . . . . . .282
V1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Molecular Dynamics Simulation . . . . . . . .282
V2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Molecular Dynamics Formulas . . . . . . .282
V3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Methods Available in CS MOPAC . . . . . .283
Record Order . . . . . . . . . . . . . . . . . . . . . . . . . 267
RHF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .283
Out-of-Plane Bending . . . . . . . . . . . . . . . . . . . . . 267 UHF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .283
Bond Type. . . . . . . . . . . . . . . . . . . . . . . . . . . . 267 Configuration Interaction . . . . . . . . . . . .283
Force Constant. . . . . . . . . . . . . . . . . . . . . . . . 267 Approximate Hamiltonians in MOPAC . . . . .284
Record Order . . . . . . . . . . . . . . . . . . . . . . . . . 267 Choosing a Hamiltonian . . . . . . . . . . . . . . .284
VDW Interactions . . . . . . . . . . . . . . . . . . . . . . . . 268 MINDO/3 Applicability and
Record Order . . . . . . . . . . . . . . . . . . . . . . . . . 268 Limitations . . . . . . . . . . . . . . . . . . . . . . . .284
MNDO Applicability and Limitations .285
AM1 Applicability and Limitations . . . .285

Chem & BioOffice 2006 /Contents


PM3 Applicability and Limitations . . . . 286 Chapter 13: ChemFinder Basics . . . . 303
MNDO-d Applicability and The ChemFinder GUI . . . . . . . . . . . . . . . . . . . . 303
Limitations . . . . . . . . . . . . . . . . . . . . . . . . 287 The ChemFinder Toolbars . . . . . . . . . . . . . 306
Main Toolbar. . . . . . . . . . . . . . . . . . . . 306
Administrator

Appendix H: MM2 . . . . . . . . . . . . . . . 289 Form Toolbar . . . . . . . . . . . . . . . . . . . . 306


Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289 Search Toolbar . . . . . . . . . . . . . . . . . . 307
MM2 Parameters. . . . . . . . . . . . . . . . . . . . . . 289 Record Toolbar . . . . . . . . . . . . . . . . . . 307
Other Parameters . . . . . . . . . . . . . . . . . . . . . 289 Text Toolbar . . . . . . . . . . . . . . . . . . . . 307
Viewing Parameters . . . . . . . . . . . . . . . . . . . . . . 289 The Status Bar . . . . . . . . . . . . . . . . . . . . . . . . 307
Editing Parameters . . . . . . . . . . . . . . . . . . . . . . . 290 GUI Improvements in ChemFinder 10 . . . . . 308
Find and Replace 308
The MM2 Force Field in Chem3D . . . . . . . . . 290 Struct=Name from the Context Menu. 308
Chem3D Changes to Allingers Force Field . 290 Opening ChemFinder . . . . . . . . . . . . . . . . . . . . 309
Charge-Dipole Interaction Term . . . . . . . 290
Using ChemFinder with Databases . . . . . . . . 309
Quartic Stretching Term . . . . . . . . . . . . . . . 291
The Database Model . . . . . . . . . . . . . . . . . . 310
Electrostatic and van der Waals
Understanding Forms and Databases . . 311
Cutoff Terms . . . . . . . . . . . . . . . . . . . . . . . . 291
Pi Orbital SCF Computation . . . . . . . . . . . 291 Chapter 14: ChemFinder Tutorials . . 313
Sample Databases 313
Appendix I: MOPAC . . . . . . . . . . . . . 293 Tutorial 1: Creating Forms . . . . . . . . . . . . . . . . 313
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293 Creating Data Boxes . . . . . . . . . . . . . . . . . . 314
MOPAC Background . . . . . . . . . . . . . . . . . 293 Editing Data Boxes . . . . . . . . . . . . . . . . . . . 315
Deleting Data Boxes 316
Potential Functions Parameters . . . . . . . . . . . . 293
Creating and Saving a Form . . . . . . . . . . . . 316
Adding Parameters to MOPAC . . . . . . . . . . . . 294
Tutorial 2: Opening a Database . . . . . . . . . . . . 317
Using Keywords . . . . . . . . . . . . . . . . . . . . . . . . . 294 Connecting a Database to a Form . . . . . . 317
Automatic Keywords . . . . . . . . . . . . . . . . . . 294 Assigning Fields to Data Boxes . . . . . . . . . 318
Additional Keywords . . . . . . . . . . . . . . . . . . 295
Tutorial 3: Creating Your Own Database . . . 319
Specifying the Electronic Configuration . . . . 296 Adding Records. . . . . . . . . . . . . . . . . . . . . . . 320
Even-Electron Systems . . . . . . . . . . . . . . . . 297
Tutorial 4: Searching a Database . . . . . . . . . . . 321
Ground State, RHF . . . . . . . . . . . . . . . . . 297
Opening the Demo Database . . . . . . . . . . 322
Ground State, UHF . . . . . . . . . . . . . . . . . 298
Text Searching . . . . . . . . . . . . . . . . . . . . . . . . 323
Excited State, RHF . . . . . . . . . . . . . . . . . 298
Formula Searching . . . . . . . . . . . . . . . . . . 323
Excited State, UHF . . . . . . . . . . . . . . . . . 298
Name Searching . . . . . . . . . . . . . . . . . . . . 325
Odd-Electron Systems . . . . . . . . . . . . . . . . 298
Numerical Searching . . . . . . . . . . . . . . . . . . 325
Ground State, RHF . . . . . . . . . . . . . . . . . 298
Substructure Searching . . . . . . . . . . . . . . . . 326
Ground State, UHF . . . . . . . . . . . . . . . . . 298
Combined Searching . . . . . . . . . . . . . . . . . . 327
Excited State, RHF . . . . . . . . . . . . . . . . . 299
Excited State, UHF . . . . . . . . . . . . . . . . . 299 Tutorial 5: Reaction Queries . . . . . . . . . . . . . . . 327
Sparkles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299 Opening A Specific Database . . . . . . . . . . 327
Introduction . . . . . . . . . . . . . . . . . . . . 301 Searching for Reactants . . . . . . . . . . . . . . . . 328
Searching for Products . . . . . . . . . . . . . . . . 328
About ChemFinder . . . . . . . . . . . . . . . . . . . . . . . 301
Searching by Reaction Type . . . . . . . . . . . . 329
Whats New in ChemFinder 10? . . . . . . . . . . . 301 Search Over List . . . . . . . . . . . . . . . . . . . . . . 330
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
Tutorial 6: Using BioViz . . . . . . . . . . . . . . . . . . 330


CambridgeSoft
Tutorial 7: Working with Subforms . . . . . . . . . 332 Ordering Objects . . . . . . . . . . . . . . . . . . . . . .353
Creating a Subform . . . . . . . . . . . . . . . . . . . . 332 Aligning and Distributing Objects . . . . . . .354
Chapter 15: Creating and Editing Changing the Layout of an Existing Form . . .354
Forms . . . . . . . . . . . . . . . . . . . . . . . . . 335 Securing Forms . . . . . . . . . . . . . . . . . . . . . . . . . . .356
Setting Security Options . . . . . . . . . . . . . . .356
Selecting a Database . . . . . . . . . . . . . . . . . . . . . . 335
Disabling Security . . . . . . . . . . . . . . . . . . . . .360
Opening an Existing Chemical Database . 335
Overriding Security . . . . . . . . . . . . . . . . . . . .360
Selecting the Data to Display . . . . . . . . . . . 336
Opening a Secured MS Access Database . 337 Chapter 16: Relational Data and
Creating a Database . . . . . . . . . . . . . . . . . . . 337 Subforms . . . . . . . . . . . . . . . . . . . . . . 361
Creating Forms Automatically. . . . . . . . . . . . . . 338 Accessing Relational Data Using Subforms . 361
Saving a Form . . . . . . . . . . . . . . . . . . . . . . . . 339 Creating a Subform . . . . . . . . . . . . . . . . . . . . . . .361
Creating Forms Manually . . . . . . . . . . . . . . . . . . 340 Subform Generator . . . . . . . . . . . . . . . . . . . .361
Using the Form Tools . . . . . . . . . . . . . . . . . 340 Generating Subforms Automatically . .362
Creating a New Form . . . . . . . . . . . . . . . . . . 340 Subform Changes in ChemFinder 9 . . . . .362
Using the Grid . . . . . . . . . . . . . . . . . . . . . . . 340 Changing the Layout of an Existing
Creating Boxes . . . . . . . . . . . . . . . . . . . . . . . . 340 Subform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .364
Creating Frames . . . . . . . . . . . . . . . . . . . . . . . 341
Working with Subforms . . . . . . . . . . . . . . . . . . .365
Creating Boxes with Frames . . . . . . . . . . . . 341
Searching a Subform . . . . . . . . . . . . . . . . . . .365
Automatic Labels . . . . . . . . . . . . . . . . . . . 342
Adding Plain Text . . . . . . . . . . . . . . . . . . . . . 342 Viewing Subform Data in a Table . . . . . . . . . .365
Adding a Button . . . . . . . . . . . . . . . . . . . . . . 343 Using Scripts in Subforms . . . . . . . . . . . . . .365
Adding a Checkbox. . . . . . . . . . . . . . . . . . . . 343 Chapter 17: Working with Data. . . . . 367
Adding Pictures . . . . . . . . . . . . . . . . . . . . . . . 343 Overview 367
Creating and Editing Tabs . . . . . . . . . . . . . . 344
Opening Databases . . . . . . . . . . . . . . . . . . . . . . .367
Creating Forms with the Database Tree . . . . . 344 Read-Only Access . . . . . . . . . . . . . . . . . . . . .367
Setting Box Properties. . . . . . . . . . . . . . . . . . . . . 345 Multi-user Access. . . . . . . . . . . . . . . . . . . . . .367
Setting Data Box Styles . . . . . . . . . . . . . . . . 345 Secured Access . . . . . . . . . . . . . . . . . . . . . . . .368
Viewing Structures . . . . . . . . . . . . . . . . . . . . 346
Browsing Databases . . . . . . . . . . . . . . . . . . . . . . .369
Viewing Structures in Chem3D Format 347
The Data Table . . . . . . . . . . . . . . . . . . . . . . .369
Setting Fixed and Live Data . . . . . . . . . . . .348
R-Group Tables . . . . . . . . . . . . . . . . . . . . .370
Adding a Data Box Menu . . . . . . . . . . . . . . 348
Creating a Database . . . . . . . . . . . . . . . . . . . . . . .371
Adding Scroll Bars. . . . . . . . . . . . . . . . . . . . . 349
Creating Tables . . . . . . . . . . . . . . . . . . . . . . .372
Hiding Data Boxes . . . . . . . . . . . . . . . . . . . . 349
Deleting Tables . . . . . . . . . . . . . . . . . . . . . . .372
Customizing Text . . . . . . . . . . . . . . . . . . . . . 349
Attaching Tables from Other
Customizing Fonts . . . . . . . . . . . . . . . . . . 349
Applications . . . . . . . . . . . . . . . . . . . . . . . . .373
Customizing Numbers . . . . . . . . . . . . . . . 350
Attaching Files from a File-Based
Setting Color . . . . . . . . . . . . . . . . . . . . . . . . . . 351
Database . . . . . . . . . . . . . . . . . . . . . . . . . .373
Editing Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352 Attaching Files from a Non File-Based
Selecting Objects on a Form . . . . . . . . . . . . 352 Database . . . . . . . . . . . . . . . . . . . . . . . . . .373
Moving Objects 352
Creating Fields . . . . . . . . . . . . . . . . . . . . . . . .374
Resizing Objects . . . . . . . . . . . . . . . . . . . . . . 352
Deleting Fields . . . . . . . . . . . . . . . . . . . . . . . .376
Deleting Objects . . . . . . . . . . . . . . . . . . . . . . 353
Adding Multiple Structures . . . . . . . . . . . . .376
Reversing and Restoring Changes . . . . . . . 353

Chem & BioOffice 2006 /Contents


Adding Structures to Non-Chemical Synchronization of Plots . . . . . . . . . . . . . . . 392
Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . 377 Changing the Display . . . . . . . . . . . . . . . . . . . . . 393
Backing up Databases . . . . . . . . . . . . . . . . . 377
Moving Databases . . . . . . . . . . . . . . . . . . . . 377 Chapter 19: Importing and Exporting
Data. . . . . . . . . . . . . . . . . . . . . . . . . . . 395
Administrator

Creating a Portal Database . . . . . . . . . . . . . . . . 377


Supported File Formats 395
Entering Data into a Database . . . . . . . . . . . . . 378
Importing Data . . . . . . . . . . . . . . . . . . . . . . . . . . 395
Clearing the Form. . . . . . . . . . . . . . . . . . . . . 378
Importing Structures 395
Adding New Data. . . . . . . . . . . . . . . . . . . . . 378 Importing Structure Data and Reaction
Committing the New Data . . . . . . . . . . . . . 379 Data Files . . . . . . . . . . . . . . . . . . . . . . . . . . . 397
Duplicating Records. . . . . . . . . . . . . . . . . . . 379 Using Log Files . . . . . . . . . . . . . . . . . . . . . 398
Undoing Data Entry . . . . . . . . . . . . . . . . . . 379 Reading a Structure . . . . . . . . . . . . . . . . . . . 398
Editing Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380 Drag and Drop . . . . . . . . . . . . . . . . . . . . . 399
Editing Data . . . . . . . . . . . . . . . . . . . . . . . . . 380 Importing Text Files . . . . . . . . . . . . . . . . . . 399
Sorting Data . . . . . . . . . . . . . . . . . . . . . . . . . . 380 Exporting Data Files . . . . . . . . . . . . . . . . . . . . . . 400
Sorting Fields . . . . . . . . . . . . . . . . . . . . . . 380 Saving Structures. . . . . . . . . . . . . . . . . . . . . . 401
Sorting from the Data Table . . . . . . . . . 380 Exporting an ASCII File . . . . . . . . . . . . . . . 401
Sorting in Reverse Order . . . . . . . . . . . . 380 Exporting a Word file . . . . . . . . . . . . . . . . . 401
Sorting Languages Other Than English 381 Export to SDFile . . . . . . . . . . . . . . . . . . . . . 402
Resetting the Database . . . . . . . . . . . . . . 381
Editing Structures . . . . . . . . . . . . . . . . . . . . . 381 Chapter 20: Searching . . . . . . . . . . . . 403
Working with Structures Using Text Searches . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
ChemDraw . . . . . . . . . . . . . . . . . . . . . . . . 382 Numeric Searches . . . . . . . . . . . . . . . . . . . . . . . . 404
Viewing Models using Chem3D . . . . . . 383
Molecular Formula Searches . . . . . . . . . . . . . . . 404
Styled Text . . . . . . . . . . . . . . . . . . . . . . . . . . . 383
Undoing Changes . . . . . . . . . . . . . . . . . . . . . 384 Date Searches . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405
Redoing Changes . . . . . . . . . . . . . . . . . . . . . 384 Find List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405
Deleting Data . . . . . . . . . . . . . . . . . . . . . . . . 384 Structure Searches . . . . . . . . . . . . . . . . . . . . . . . . 406
Changing the Database Scheme . . . . . . . . . . . . 384 Search Type . . . . . . . . . . . . . . . . . . . . . . . . . . 406
Normal Searching . . . . . . . . . . . . . . . . . . . 406
Chapter 18: Visualizing Data Exact Searching . . . . . . . . . . . . . . . . . . . . 406
With BioViz. . . . . . . . . . . . . . . . . . . . . 385 Similarity Searching . . . . . . . . . . . . . . . . . 407
Improvements in Version 10 . . . . . . . . . . . . . . 385 Substructure Searching . . . . . . . . . . . . . . . . 407
Better Selecting And Mouse-overs . . . . . . 385 Fragment Searching . . . . . . . . . . . . . . . . . 407
More plotting flexibility . . . . . . . . . . . . . . . . 385 Full Structure Searching . . . . . . . . . . . . . . . 408
Details Window. . . . . . . . . . . . . . . . . . . . . . . 386 Stereochemistry . . . . . . . . . . . . . . . . . . . . 408
Removal of Empty Points . . . . . . . . . . . . . 386 3D Properties . . . . . . . . . . . . . . . . . . . . . . 408
Histogram Improvements . . . . . . . . . . . . . 386 Searching with R-Groups . . . . . . . . . . . . . . 408
Creating a Plot . . . . . . . . . . . . . . . . . . . . . . . . . . . 387 Alternative Groups . . . . . . . . . . . . . . . . . 408
BioViz Options . . . . . . . . . . . . . . . . . . . . . . . 388 Defining an Alternative Group . . . . . . . 409
Statistical Analysis . . . . . . . . . . . . . . . . . . . . . . . . 389 Reaction Searches . . . . . . . . . . . . . . . . . . . . . . . . 410
Cleaning Up the PlotSorting and Filtering . 390 Reaction Centers . . . . . . . . . . . . . . . . . . . . . . 410
Filtering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390 Atom-to-Atom Mapping . . . . . . . . . . . . . . . 411
Filter Slider Adjustment . . . . . . . . . . . . . 391 Searching for Reactants . . . . . . . . . . . . . . . . 412
Searching for Products . . . . . . . . . . . . . . . . 412
Plotting Searches . . . . . . . . . . . . . . . . . . . . . . . . . 392


CambridgeSoft
Searching for Intermediates . . . . . . . . . . . .412 Setting the Recent File List Size . . . . . . .432
Combined Searches . . . . . . . . . . . . . . . . . . . . . . . 412 Customizing the Favorites Tree . . . . . . . . . . . .432
SQL Searches . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413 Customizing Toolbars . . . . . . . . . . . . . . . . . . . . .433
Searching Procedures . . . . . . . . . . . . . . . . . . . . . 413 Using the Periodic Table. . . . . . . . . . . . . . . . . . .434
Setting Search Type Preferences . . . . . . . .413 ChemFinder Automation Language (CAL) . .435
Setting Search Details Preferences . . . .414 Getting CAL Help . . . . . . . . . . . . . . . . . . . . .435
Setting Stereochemical Search Creating a Script . . . . . . . . . . . . . . . . . . . . . . .435
Preferences . . . . . . . . . . . . . . . . . . . . . . . . 415 Debugging a Script . . . . . . . . . . . . . . . . . . . .436
Entering Query Mode . . . . . . . . . . . . . . . . . 416 Trigger Scripts . . . . . . . . . . . . . . . . . . . . . . . .437
Entering and Submitting a Query . . . . . . . 416 Communicating with Other Applications . . . .437
Stopping a Search . . . . . . . . . . . . . . . . . . . . . 417 Using Scripts . . . . . . . . . . . . . . . . . . . . . . . . . .437
Refining a Search . . . . . . . . . . . . . . . . . . . . . . 417 Using Visual Basic . . . . . . . . . . . . . . . . . . . . .438
Entering a Structural Query . . . . . . . . . . . .417 Using Microsoft Access with ChemFinder439
Using the Current Molecule as a Query 418
Finding the Current Molecule . . . . . . . .418 Chapter 22: ChemFinder/Oracle . . . 441
Entering a Reaction Query . . . . . . . . . . . . . 418 Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .441
Special Structure Searches . . . . . . . . . . . . . . . . . 419 Opening an Oracle Database . . . . . . . . . . . . . . .442
Managing Queries . . . . . . . . . . . . . . . . . . . . . . . . 421 Searching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .443
The Queries context menu . . . . . . . . . . . . . 422 Handling Lists . . . . . . . . . . . . . . . . . . . . . . . . . . .443
Domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423 Setting Oracle Preferences . . . . . . . . . . . . . . . . .444
Saving and Restoring Lists . . . . . . . . . . . . . 423
Updating and Adding Data . . . . . . . . . . . . . . . .444
Saving a Hit List . . . . . . . . . . . . . . . . . . . . 424
Restoring a Hit List . . . . . . . . . . . . . . . . . 424 Loading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .445
Search Examples. . . . . . . . . . . . . . . . . . . . . . . . . . 425 Indexing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .446
Working with Multiple Hit Lists . . . . . . 425 CAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .447
Using Atom Lists . . . . . . . . . . . . . . . . . . . 426
Chapter 23: ChemFinder/Office. . . . 449
Atom Types and Bond Types . . . . . . . .426
Searching Fullerenes . . . . . . . . . . . . . . . . . 426 The ChemFinder/Office Graphical User
Searching Link Nodes and Multivalent Interface (GUI) . . . . . . . . . . . . . . . . . . . . . . . . . . .449
Rs (MVRs) . . . . . . . . . . . . . . . . . . . . . . . . 426 Selecting Files to Search . . . . . . . . . . . . . . . . . . .450
Searching More Than One Substructure 427 Selecting Files From the File Menu . . . . . .450
Selecting Files With the Look In Tab . . . .450
Chapter 21: Customizing ChemFinder429 Searching by Chemical Structure . . . . . . . . . . .451
Setting Preferences . . . . . . . . . . . . . . . . . . . . . . . . 429
Searching by Multiple Properties . . . . . . . . . . .452
Display Preferences . . . . . . . . . . . . . . . . . . . . 429
Browsing Search Results . . . . . . . . . . . . . . . . . . .453
Structure Display . . . . . . . . . . . . . . . . . . . . 429
Using Keyboard Shortcuts . . . . . . . . . . . 430 Saving Files or Data Sources . . . . . . . . . . . . . . .454
Scaling Structures . . . . . . . . . . . . . . . . . . . 430 Saving Search Results as .sdf Files . . . . . . .454
Framing Pictures . . . . . . . . . . . . . . . . . . . . 430 Saving Data Sources as .dsd Files . . . . . . .454
Grid Spacing . . . . . . . . . . . . . . . . . . . . . . . . 430 Saving Lists of Directory Paths as
Color Preferences . . . . . . . . . . . . . . . . . . . . . 430 .dsd Files . . . . . . . . . . . . . . . . . . . . . . . . . . . .454
General Preferences . . . . . . . . . . . . . . . . . . . 431 Searching .dsd Files . . . . . . . . . . . . . . . . . . . . . . .455
Structure Registration Options . . . . . . . 431 Sending a File to Another Application . . . . . .455
ChemFinder Opening Options . . . . . . . 431 Refining Your Search . . . . . . . . . . . . . . . . . . . . .457

Chem & BioOffice 2006 /Contents


Using the Search Tools . . . . . . . . . . . . . . . . 457 Appendix K: Formula Input Rules . . 475
Refining Your Query With the Search Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457
Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475
Changing ChemFinder/Office Settings . . . . . 459
Administrator

Customizing the ChemFinder/Office Appendix L: Similarity Rules . . . . . . . 477


Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
Complete Structure Similarity . . . . . . . . . . . . . . 477
Changing the ChemFinder/Office
Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . 460 Substructure Similarity . . . . . . . . . . . . . . . . . . . . 478

Chapter 24: Using ChemFinder/Office Appendix M: CAL Commands . . . . . 479


with CombiChem . . . . . . . . . . . . . . . . 461 New in ChemFinder 479
CombiChem Overview . . . . . . . . . . . . . . . . 461 CAL Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479
Working with Reaction Templates . . . . . . . . . 461 Menu Commands . . . . . . . . . . . . . . . . . . . . . . . . 479
Reaction Template Basics . . . . . . . . . . . . . . 461
Box Creation Commands . . . . . . . . . . . . . . . . . 480
Entering a Template . . . . . . . . . . . . . . . . . . . . . . 461
Box Manipulation Commands . . . . . . . . . . . . . 481
Using ChemDraw or the ChemDraw
ActiveX control: . . . . . . . . . . . . . . . . . . . . . 462 Program Execution Commands . . . . . . . . . . . . 482
Using a ChemFinder database: . . . . . . . . . 462 General Commands . . . . . . . . . . . . . . . . . . . . . . 483
File Commands . . . . . . . . . . . . . . . . . . . . . . . . . . 484
Appendix J: Structural Query Features465 Database Commands . . . . . . . . . . . . . . . . . . . . . 484
General Properties . . . . . . . . . . . . . . . . . . . . . . . 465 Variable Commands . . . . . . . . . . . . . . . . . . . . . . 485
Atoms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465 Environment Variables . . . . . . . . . . . . . . . . . . . 487
Bonds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465 Script-Only Commands . . . . . . . . . . . . . . . . . . . 487
Substituents . . . . . . . . . . . . . . . . . . . . . . . . . . 466
Charges and Radicals . . . . . . . . . . . . . . . . . . 466 Appendix N: CS Oracle Cartridge . . 491
Isotopes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467
Stereochemistry . . . . . . . . . . . . . . . . . . . . . . . 467 Pre-Setup Procedures 491
Relative Tetrahedral Stereochemistry . 468 Fast-Move Caching Scheme . . . . . . . . . . . . . . . 491
MDL File Formats . . . . . . . . . . . . . . . . . . 468 Configuration Via CF_SETTINGS Table . . . 492
Normalization . . . . . . . . . . . . . . . . . . . . . . . . 469 Working with Reaction Templates . . . . . . . . . 495
Atom Properties . . . . . . . . . . . . . . . . . . . . . . . . . 469 Reaction Template Basics . . . . . . . . . . . . 495
Special Atom Types . . . . . . . . . . . . . . . . . . . 469
Chapter 25: CombiChem/Excel . . . . 495
Atom Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . 469
Atom Not-Lists . . . . . . . . . . . . . . . . . . . . . . . 470 Working with CombiChem/Excel . . . . . . . . . 495
Substituents: Exactly . . . . . . . . . . . . . . . . . . 470 Initializing CombiChem/Excel . . . . . . . . . 495
Substituents: Up To . . . . . . . . . . . . . . . . . . . 470 Using Help . . . . . . . . . . . . . . . . . . . . . . . . . . . 496
Substituents: Free Sites . . . . . . . . . . . . . . . . 471 Using CombiChem/Excel with secured
Implicit Hydrogens . . . . . . . . . . . . . . . . . . . 471 databases like ChemACX: . . . . . . . . . . . . . 496
Unsaturation . . . . . . . . . . . . . . . . . . . . . . . . . 471 Creating a New CombiChem Workbook 497
Adding a Reaction Template to the
Bond Properties . . . . . . . . . . . . . . . . . . . . . . . . . . 472
Reaction Worksheet . . . . . . . . . . . . . . . . . . 498
Special Bond Types . . . . . . . . . . . . . . . . . . . 472
Processing the Reaction Template . . . . . . 498
Topology . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472
Working with Reactant Lists . . . . . . . . . . . 499
Reaction Center. . . . . . . . . . . . . . . . . . . . . . . 472
Searching Databases . . . . . . . . . . . . . . . . 499


CambridgeSoft
Reactant List Format . . . . . . . . . . . . . . . . . . 500 Working with Folders . . . . . . . . . . . . . . . . . . . . .517
Structure Column . . . . . . . . . . . . . . . . . . . 500 Creating a Folder . . . . . . . . . . . . . . . . . . . . . .517
Use (Y/N) . . . . . . . . . . . . . . . . . . . . . . . . . 500 Adding a Reference to the Folder . . . . . . .517
Other Data . . . . . . . . . . . . . . . . . . . . . . . . . 500 Working with the User Configuration
Creating Experiments . . . . . . . . . . . . . . . . . . 500 Folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .518
Using the Products Only Option . . . . . 501 Working with Reactants Collections . . . . . . . .518
Working With Experiments . . . . . . . . . . . .501 Adding a New Reactant to an E
Configuring Plates . . . . . . . . . . . . . . . . . . . 501 xisting Reactant Collection . . . . . . . . . . . .518
Assigning Plates . . . . . . . . . . . . . . . . . . . . . 502 Adding a New Reactant Collection . . . . . .519
Browsing Plates . . . . . . . . . . . . . . . . . . . . . 502
Working with Table of Contents . . . . . . . . . . .519
Viewing Related Structures . . . . . . . . . . . 502
Hiding Columns . . . . . . . . . . . . . . . . . . . . . . .519
Using CombiChem with ChemFinder/Office503 Showing Columns . . . . . . . . . . . . . . . . . . . . .520
Chapter 26: Introducing Sorting Items in the TOC . . . . . . . . . . . . . .520
E-Notebook 10.0 . . . . . . . . . . . . . . . . . 505 Working with Templates. . . . . . . . . . . . . . . . . . .520
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505 Working with MS Office Sections,
Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506 Reactions, and other Sections . . . . . . . . . . . . . .521
Reaction Sections . . . . . . . . . . . . . . . . . . . . . .521
About the E-Notebook Guide . . . . . . . . . . . . . 508
Captured Image Sections . . . . . . . . . . . . . . .521
Getting Started in E-Notebook . . . . . . . . . . . .508 Ancillary Data Sections . . . . . . . . . . . . . . . .522
Logging In . . . . . . . . . . . . . . . . . . . . . . . . . . . . 508 Table Sections . . . . . . . . . . . . . . . . . . . . . . . .522
Start Menu Login . . . . . . . . . . . . . . . . . . . 508 Spectrum and Spectra Sections. . . . . . . . . .522
Logging in with Internet Explorer . . . .509 MS Word Sections . . . . . . . . . . . . . . . . . . . . .522
Navigation Overview . . . . . . . . . . . . . . . . . . 509 MS Excel Spreadsheet Sections . . . . . . . . .522
Security Overview . . . . . . . . . . . . . . . . . . . . . 509
Send2ENotebook and Send2File . . . . . . . . . . .523
E-Notebook Overview . . . . . . . . . . . . . . . . . . . . 510
Working with Send2ENotebook . . . . . . . . . . .523
Chapter 27: Working with E-Notebook513 Working with Send2File . . . . . . . . . . . . . . . . . . .525
Notebooks, Pages, Experiments, and Other Working Offline . . . . . . . . . . . . . . . . . . . . . . . . . .526
Collections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513
Chapter 28: E-Notebook Features . . 527
Working with the User Collection . . . . . . . . . . 514
Adding a New Collection to the User Browsing the Collection Tree . . . . . . . . . . . . . .527
Collection. . . . . . . . . . . . . . . . . . . . . . . . . . . . 514 Showing and Hiding Collections . . . . . . . .528
Adding a Reference within the User Hiding the Collection Tree . . . . . . . . . . . . .528
Collection. . . . . . . . . . . . . . . . . . . . . . . . . . . . 514 Limiting Collection Browsing . . . . . . . . . . .528
Browsing up to the User Group . . . . . . . .515 Browsing from Home. . . . . . . . . . . . . . . . . .529
Browsing at a Higher Level . . . . . . . . . . . . .529
Working with Notebooks . . . . . . . . . . . . . . . . . . 515
Browsing the Entire Collection Tree . . . .530
Creating a Notebook . . . . . . . . . . . . . . . . . . 515
E-Notebook Workflows . . . . . . . . . . . . . . . . . . .530
Working with Pages and Experiments . . . . . . 516
Reactions in E-Notebook . . . . . . . . . . . . . .530
Creating a Page or Experiment . . . . . . . . . 516
Drawing and Analyzing Reactions . . . .531
Creating a Page or Experiment from
Drawing a Structure or Reaction . . . . . .531
a Template . . . . . . . . . . . . . . . . . . . . . . . . . . . 516
Expanding the Drawing Window . . . . .531
Closing and Reopening Pages and
Working with ISIS/ Draw . . . . . . . . . . . . . .531
Experiments . . . . . . . . . . . . . . . . . . . . . . . . . 516
Drawing a Structure or Reaction . . . . . .531
Working with the Inbox . . . . . . . . . . . . . . . . . . . 517

Chem & BioOffice 2006 /Contents


Working with the Name=Struct Feature 532 Chapter 29: Working with Data in
Working with the Reaction Toolbar . . . . . 532 E-Notebook . . . . . . . . . . . . . . . . . . . . 553
Adding Structures with the Working with Chemical Structure Data . . 553
Reaction Toolbar . . . . . . . . . . . . . . . . . . 533 Drawing a Structure . . . . . . . . . . . . . . . . . 553
Administrator

Filtering Acronyms with the Expanding the Drawing Window . . . . . 554


Reaction Toolbar . . . . . . . . . . . . . . . . . . 534 Working with Images in Chemical
Defining a New Acronym with tructure Fields . . . . . . . . . . . . . . . . . . . . . . . 554
the Reaction Toolbar . . . . . . . . . . . . . . . 535 Inserting an Image a Structure . . . . . . . 554
Deleting a Structure with the Annotating the Image . . . . . . . . . . . . . . . 554
Reaction Toolbar . . . . . . . . . . . . . . . . . . 535 Working with Database Tables . . . . . . . . . 554
Working with the Stoichiometry Table . . 535 Working with MS Excel Spreadsheets . . . 555
Adding Information to the Importing an MS Excel document . . . . 555
Stoichiometry Table . . . . . . . . . . . . . . . . 536 Working with Captured Image Sections . 556
Removing Reactants and Products Importing and Exporting a PDF File . 556
from the Stoichiometry Table . . . . . . . 537 Importing an Image File . . . . . . . . . . . . . 557
Working with Salts and Solvates Annotating an Image File . . . . . . . . . . . . 557
in a Reaction Section . . . . . . . . . . . . . . . 538 Working with Image Viewer Sections . . . 557
Working With Batch Explorer. . . . . . . . . . 538 Importing and Exporting an Image File 558
Panning Experiments in Batch To export the Image file: . . . . . . . . . . . . 558
Explorer . . . . . . . . . . . . . . . . . . . . . . . . . . 540 Working with MS Word Sections . . . . . . . 558
Flipping Experiments in Batch Working with MS PowerPoint Slideshow
Explorer . . . . . . . . . . . . . . . . . . . . . . . . . . 540 Sections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559
Saving Experiments as Bitmap in Importing and Exporting an
Batch Explorer . . . . . . . . . . . . . . . . . . . . 541 MS PowerPoint slideshow . . . . . . . . . . 559
Copying Experiments in Batch Working with Property Lists . . . . . . . . . . . 560
Explorer . . . . . . . . . . . . . . . . . . . . . . . . . . 541 Adding Properties to Property Lists . . 561
Printing Experiments in Batch Removing Properties from a Property
Explorer . . . . . . . . . . . . . . . . . . . . . . . . . . 542 List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561
Selecting Experiments in Batch Setting and Editing Values in a
Explorer . . . . . . . . . . . . . . . . . . . . . . . . . . 543 Property List . . . . . . . . . . . . . . . . . . . . . . 561
Working with Autotext . . . . . . . . . . . . . . . . 543 Working with Enumerated Lists in
Inserting Reactants and Products Property Lists . . . . . . . . . . . . . . . . . . . . . 562
with AutoText . . . . . . . . . . . . . . . . . . . . . 543 Working with Numerical Units in
Adding Items from the AutoText Property Lists . . . . . . . . . . . . . . . . . . . . . 563
Pane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544 Creating a Reference within a
Inserting Links with Autotext . . . . . . . . 545 Property List . . . . . . . . . . . . . . . . . . . . . . 564
Inserting Custom Autotext . . . . . . . . . . 546 Working with Spectrum and Spectra
Creating New Autotext Definitions . . . 546 Sections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 566
Working with Solvents in a Reaction Adding a Spectrum . . . . . . . . . . . . . . . . . 567
Section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548 Replacing a Spectrum . . . . . . . . . . . . . . . 567
Using the Inbox . . . . . . . . . . . . . . . . . . . . . . . . . . 549 Zooming in on a Spectrum Peak . . . . . 567
Working Offline . . . . . . . . . . . . . . . . . . . . . . 550 Other Fields in a Spectrum Section . . . 567
Working With the Offline Folder . . . . . 550 Working with Styled Text . . . . . . . . . . . . . . 568
Creating an Offline Folder . . . . . . . . . . . 551 Working with Subsections . . . . . . . . . . . . . 568
Working with Subsections in Button


CambridgeSoft
View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569 Collections that Cannot be
Working with Ancillary Data Sections . . . 569 Deleted if Modified . . . . . . . . . . . . . . . . .587
Working with Table Sections . . . . . . . . . . . 570 Collections that Cannot be
Adding Columns and Rows to a Table 570 Renamed . . . . . . . . . . . . . . . . . . . . . . . . . .587
Removing Columns and Rows Copying Collections that
from a Table . . . . . . . . . . . . . . . . . . . . . . . 571 Contain References . . . . . . . . . . . . . . . . .587
Organizing Columns and Rows Creating a Collection. . . . . . . . . . . . . . . . . . .588
in a Table . . . . . . . . . . . . . . . . . . . . . . . . . . 572 Organizing Collections . . . . . . . . . . . . . . . . .588
Resizing Columns and Rows in a Table 573 Moving Collections within a
Pivoting a Table . . . . . . . . . . . . . . . . . . . . . 573 Container Collection . . . . . . . . . . . . . . . .588
Adding Information to a Table Cell . . . 573 Moving Collections between
Working with Structures and Images Container Collections . . . . . . . . . . . . . . .589
in Tables . . . . . . . . . . . . . . . . . . . . . . . . . . 573 Creating a Reference within the
Changing Information in a Table Cell . 575 Collection Tree . . . . . . . . . . . . . . . . . . . . .589
Working with Numerical Units in Duplicating a Collection within a
Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 575 Container Collection . . . . . . . . . . . . . . . .590
Creating a Reference within a Table Copying a Collection . . . . . . . . . . . . . . . .591
Cell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 575 Renaming a Collection . . . . . . . . . . . . . . .591
Blocking of References in Tables . . . . . 576 Deleting a Collection . . . . . . . . . . . . . . . .591
Validation of Values in Tables . . . . . . . . 576 Viewing Collection Properties . . . . . . . . . .592
Working with URL Displays . . . . . . . . . . . . 577 Importing and Exporting Collections . . . .593
Rendering in E-Notebook . . . . . . . . . . . . . . . . . 577 Importing a Collection . . . . . . . . . . . . . . .593
Exporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577 Exporting a Collection . . . . . . . . . . . . . . .593
Printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 579 Changing Collection Security Properties .593
E-Signatures . . . . . . . . . . . . . . . . . . . . . . . . . . 580 Collection Security . . . . . . . . . . . . . . . . . .594
Signing and Closing . . . . . . . . . . . . . . . . . 580 Transition Security . . . . . . . . . . . . . . . . . .595
Reviewing a Document . . . . . . . . . . . . . . 581 Performing a Collection Transition . . . . . .597
Countersigning a Document . . . . . . . . . 581 Exporting a Collection or Section to
MS Word . . . . . . . . . . . . . . . . . . . . . . . . . . . .597
Chapter 30: Working with Sections Printing Collections . . . . . . . . . . . . . . . . . . . .597
and Collections . . . . . . . . . . . . . . . . . . 583 Printing Multiple Collections at Once .597
Working with Sections . . . . . . . . . . . . . . . . . . . . 583 Performing a Collection Transition . . . . . . . . .598
Creating a Section . . . . . . . . . . . . . . . . . . . . . 583 Working with Form Tools . . . . . . . . . . . . . . . . .598
Changing a Section . . . . . . . . . . . . . . . . . . . . 583 The New Section Tool . . . . . . . . . . . . . . . . .598
Removing a Section . . . . . . . . . . . . . . . . . . . 584 The Duplication Collection Tool . . . . . . . .599
Moving a Section within a Collection . . . . 584 The New Child Collection Tool . . . . . . . . .599
Renaming a Section . . . . . . . . . . . . . . . . . . . . 584 The New Sibling Collection Tool . . . . . . .600
Duplicating a Section within a Collection 585
Duplicating a Section between Collections585 Chapter 31: Changes and Audit Trail 601
Exporting Sections to MS Word . . . . . . . .585 Working with the Changes Icon. . . . . . . . .601
Printing Sections . . . . . . . . . . . . . . . . . . . . . . 585 Saving Changes to a Collection . . . . . . . . .601
Working with Collections . . . . . . . . . . . . . . . . . . 585 Clicking the Changes Icon . . . . . . . . . . .602
Behaviors of Collections in E-Notebook. 586 Selecting Annotate Last Change
Auto-Numbered Collections . . . . . . . . . 586 from the Collection Menu . . . . . . . . . . .602
Collections that Cannot be Deleted . . . 586 Saving Changes by Browsing to

Chem & BioOffice 2006 /Contents


Another Collection . . . . . . . . . . . . . . . . . 602 Reaction Centers . . . . . . . . . . . . . . . . . . . 621
Saving Changes through Autosave . . . . 602 Atom-to-Atom Mapping . . . . . . . . . . . . 622
Saving Changes through Backup Searching for Reactants . . . . . . . . . . . . . . 622
and Restore . . . . . . . . . . . . . . . . . . . . . . . 602 Searching for Products . . . . . . . . . . . . . . 623
Administrator

Annotation of Changes . . . . . . . . . . . . . . . . 603 Searching with the Search Location Field . . . 623
Providing Required Annotation . . . . . . 603 Searching with Collection Attributes . . . . . . . 623
Providing Unprompted, Optional
Searching with the Property Query and
Annotation . . . . . . . . . . . . . . . . . . . . . . . . 604
Table Query Fields . . . . . . . . . . . . . . . . . . . . . . . 624
Working with the History Pane . . . . . . . . . 604
Adding Properties to the Field . . . . . . . . . 625
Specifying an Annotation through
Removing Properties from the Field . . . . 625
the History Pane . . . . . . . . . . . . . . . . . . . 605
Search Options . . . . . . . . . . . . . . . . . . . . . . . 625
Visual Display of Changes . . . . . . . . . . . . . 606
Searching for Text with the Query Text Field626
Chapter 32: Searching . . . . . . . . . . . . 609 Basic Text Searching . . . . . . . . . . . . . . . . . . 626
Conducting a Search . . . . . . . . . . . . . . . . . . . . . . 609 Exact Phrase Matching . . . . . . . . . . . . . . 627
Working with Query Results . . . . . . . . . . . 609 Wildcard Searching . . . . . . . . . . . . . . . . . 627
Viewing Items in a Results List . . . . . . . 609 Advanced Text Searching . . . . . . . . . . . . . . 627
Saving a Results List . . . . . . . . . . . . . . . . 610 Escape Characters . . . . . . . . . . . . . . . . . . 627
Customizing the Display of Search ABOUT . . . . . . . . . . . . . . . . . . . . . . . . . . . 628
Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610 AND (&) . . . . . . . . . . . . . . . . . . . . . . . . . . 628
Saving a Query . . . . . . . . . . . . . . . . . . . . . 610 EQUIValence (=) . . . . . . . . . . . . . . . . . . 629
Running a Saved Query . . . . . . . . . . . . . 610 Fuzzy (?) . . . . . . . . . . . . . . . . . . . . . . . . . . . 629
Refining a Search . . . . . . . . . . . . . . . . . . . . . 611 MINUS (-) . . . . . . . . . . . . . . . . . . . . . . . . . 630
Using the E-Notebook Search Types . . . 611 NEAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 630
Searching for Sections . . . . . . . . . . . . . . . 612 NOT (~) . . . . . . . . . . . . . . . . . . . . . . . . . . 631
Collections Search . . . . . . . . . . . . . . . . . . 613 OR (|) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 632
Chemical Structure Search . . . . . . . . . . . 614 Soundex (!) . . . . . . . . . . . . . . . . . . . . . . . . . 632
General Query Properties . . . . . . . . . . . . . . 615 Stem ($) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 633
Atoms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615
Chapter 33: Introducing CombiChem
Bonds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 616
Substituents . . . . . . . . . . . . . . . . . . . . . . . . 616
for E-Notebook. . . . . . . . . . . . . . . . . . 635
Charges and Radicals . . . . . . . . . . . . . . . . 617 Setting up the Generic Reaction . . . . . . . . . . . 635
Isotopes . . . . . . . . . . . . . . . . . . . . . . . . . . . 617 Adding a Generic Reaction . . . . . . . . . . . . 635
Atom Properties . . . . . . . . . . . . . . . . . . . . . . 617 Preparing a Reaction from an Existing
Special Atom Types . . . . . . . . . . . . . . . . . 617 Experiment . . . . . . . . . . . . . . . . . . . . . . . . . . 636
Atom Lists . . . . . . . . . . . . . . . . . . . . . . . . . 618 Managing CombiChem Reactants . . . . . . . . . . 637
Substituents: Exactly . . . . . . . . . . . . . . . . 618 Adding Reactants from a Chemical
Substituents: Up To . . . . . . . . . . . . . . . . . 618 Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . 637
Substituents: Free Sites . . . . . . . . . . . . . . 619 Importing Reactants from a Chemical
Unsaturation . . . . . . . . . . . . . . . . . . . . . . . 619 Database . . . . . . . . . . . . . . . . . . . . . . . . . . 637
Bond Properties . . . . . . . . . . . . . . . . . . . . . . 620 Adding Reactants Manually . . . . . . . . . . 638
Special Bond Types . . . . . . . . . . . . . . . . . 620 Checking Reaction Sites . . . . . . . . . . . . . . . 639
Topology . . . . . . . . . . . . . . . . . . . . . . . . . . 620 Editing Reactants . . . . . . . . . . . . . . . . . . . . . 639
Reaction Center . . . . . . . . . . . . . . . . . . . . 620 Removing Reactants from a CombiChem
Reaction Searching . . . . . . . . . . . . . . . . . . . . 621 Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 640


CambridgeSoft
Removing a Selected Reactant . . . . . . . . 640 Changing the Grouping Order . . . . . . . .651
Removing All Reactants from a Setting Product Grid Options . . . . . . . . . .651
CombiChem Library . . . . . . . . . . . . . . . . 640
Chapter 34: Miscellaneous Topics . . 653
Enumerating and Managing CombiChem
Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 640 Using the Session Manager . . . . . . . . . . . . . . . .653
Ending a Session . . . . . . . . . . . . . . . . . . . . . .653
Working with the Enumeration Template640
Creating an Enumeration Template . . . 640 Refreshing E-Notebook . . . . . . . . . . . . . . . . . . .654
Showing an Enumeration Template . . . 641 Viewing User Information . . . . . . . . . . . . . . . . .654
Updating an Enumeration Template . . 641
Chapter 35: Managing Section
Removing an Enumeration Template . 641
Enumerating Products . . . . . . . . . . . . . . . . . 642
Types and Forms . . . . . . . . . . . . . . . . 655
Enumerating All of the Products Creating a New Section Type . . . . . . . . . . . . . .655
of a Generic Reaction . . . . . . . . . . . . . . . 642 Managing Fields within a Section Type . . . . . .656
Enumerating Selected Products of Adding a Field to a Section Type . . . . . . . .656
a Generic Reaction . . . . . . . . . . . . . . . . . 642 Managing Summary Fields in a Table of
Exporting Products to an SD File . . . . . . . 642 Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . .657
Removing Products from a CombiChem Library Managing Form Tools . . . . . . . . . . . . . . . . . . . . .658
643 Adding a Form Tool to a Section Type . .658
Using the CombiChem Navigator and Viewing and Editing the Properties
Structure Window . . . . . . . . . . . . . . . . . . . . . . . . 643 of a Form Tool . . . . . . . . . . . . . . . . . . . . . . .659
Using the CombiChem Navigator . . . . . . . 643 Removing a Form Tool from a
Using the Navigator when in Section Type . . . . . . . . . . . . . . . . . . . . . . . . .660
Products Mode . . . . . . . . . . . . . . . . . . . . . 644 Managing the Standard Form Tools . . . . .660
Using the Navigator in Reactants Mode 644 Managing the Next Step Form Tool . . .661
Viewing and Hiding the Docked Managing the New Section Form Tool 661
CombiChem Navigator . . . . . . . . . . . . . 645 Managing the New Subsection
Viewing the Navigator as a Floating Section Form Tool . . . . . . . . . . . . . . . . .661
Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 645 Managing the Spectrum Form Tool . . .662
Docking the Navigator at Another Managing the Active Document
Location . . . . . . . . . . . . . . . . . . . . . . . . . . . 645 Form Tool . . . . . . . . . . . . . . . . . . . . . . . . .662
Using the Structure Window. . . . . . . . . . . . 646 Managing the Insert Reference
Viewing and Hiding the Docked Form Tool . . . . . . . . . . . . . . . . . . . . . . . . .663
CombiChem Structure Window . . . . . 646 Managing the Print Multiple
Viewing the Structure Window Form Tool . . . . . . . . . . . . . . . . . . . . . . . . .663
as a Floating Palette . . . . . . . . . . . . . . . . 647 Managing Section Listeners . . . . . . . . . . . . . . . .663
Docking the Structure Window at Adding a Section Listener to a
Another Location . . . . . . . . . . . . . . . . . . 647 Section Type . . . . . . . . . . . . . . . . . . . . . . . . .664
Managing Plate Layout and Structure Viewing and Editing the Properties
Palette Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . 648 of a Section Listener . . . . . . . . . . . . . . . . . .664
Editing Structure Palette Display Settings 648 Removing a Section Listener from a
Editing Reactant Layout Settings . . . . . . . . 648 Section Type . . . . . . . . . . . . . . . . . . . . . . . . .665
Editing Product Layout Settings . . . . . . . .649 Managing the Standard Section Listeners 666
Specifying Empty Wells in the Plate . . . 650 Managing the Required Section
Changing the Size of the Plate . . . . . . . . 650 Listener . . . . . . . . . . . . . . . . . . . . . . . . . . .666

Chem & BioOffice 2006 /Contents


Managing the Fixed Section Name Managing the Standard Collection
Listener . . . . . . . . . . . . . . . . . . . . . . . . . . . 666 Commands . . . . . . . . . . . . . . . . . . . . . . . . . . 685
Managing the Audit Section Listener . 666 Managing the Export to MS Word
Configuring a Form . . . . . . . . . . . . . . . . . . . . . . 666 Collection Command . . . . . . . . . . . . . . . 685
Administrator

Configuring a New Form . . . . . . . . . . . . . . 667 Managing the Export to PDF


Setting the Fields in Boxes . . . . . . . . . . . 668 Collection Command . . . . . . . . . . . . . . . 685
Reconfiguring an Existing Form . . . . . . . . 669 Managing the Print Collection
Adding a Field to an Existing Form . . 669 Command . . . . . . . . . . . . . . . . . . . . . . . . . 686
Rearranging Boxes in a Form . . . . . . . . 670 Managing Section Commands . . . . . . . . . . . . . 686
Deleting a Box from a Form . . . . . . . . . 670 Adding Commands to a Section Type . . . 686
Showing and Hiding the Max Button Viewing and Editing the Properties of a
for a Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . 671 Section Command . . . . . . . . . . . . . . . . . . . 686
Hiding the Max Button . . . . . . . . . . . . . . 671 Removing a Command from a Section
Showing the Max Button . . . . . . . . . . . . 671 ype . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 687
Showing and Hiding the Name of a Box 672 Managing the Standard Section
Hiding the Box Name . . . . . . . . . . . . . . . 672 Commands . . . . . . . . . . . . . . . . . . . . . . . . . . 687
Showing the Name of a Box . . . . . . . . . 673 Managing the Export to MS Word
Resizing Boxes in a Form . . . . . . . . . . . . . . 673 Section Command . . . . . . . . . . . . . . . . . 687
Changing the Weight of a Box . . . . . . . 673 Managing the Print Section Command 688
Changing the Dimensions of a Box
Manually . . . . . . . . . . . . . . . . . . . . . . . . . . 674
Chapter 37: Managing Rendering in
Clearing Fields when Configuring a Form675 E-Notebook . . . . . . . . . . . . . . . . . . . . 689
Hiding Fields and Boxes when Configuring a Rendering Template . . . . . . . . . 689
Configuring a Form . . . . . . . . . . . . . . . . . . 675 Designing a Rendering Template . . . . . . . . . . . 690
Hiding a Box . . . . . . . . . . . . . . . . . . . . . . . 675 Rendering Tags . . . . . . . . . . . . . . . . . . . . . . . 691
Hiding Fields in a Form . . . . . . . . . . . . . 676 Templates for Headers and Footers . . . . . 691
Changing Box Orientation . . . . . . . . . . . . . 676 Section Metadata Tags . . . . . . . . . . . . . . . . . 692
Managing Export Templates for Section Managing the MS Word Section Renderers. . 692
ypes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 677 Managing the Fixed Text After Word
Creating the Export Template for a Renderer . . . . . . . . . . . . . . . . . . . . . . . . . . . . 692
Section Type. . . . . . . . . . . . . . . . . . . . . . . . . 678 Managing the Full History Word Renderer693
Editing the Export Template for a Managing the Tracked History Word
Section Type. . . . . . . . . . . . . . . . . . . . . . . . . 678 Renderer . . . . . . . . . . . . . . . . . . . . . . . . . . . . 693
Section Metadata Tags . . . . . . . . . . . . . . 679 Managing the Standard Field Renderers . . . . . 694
Standard Field Types . . . . . . . . . . . . . . . . 679 Managing the Fixed Table Field Renderer694
Page Breaks . . . . . . . . . . . . . . . . . . . . . . . . 681 Managing the NonBlank Property
Chapter 36: Managing Commands . . 683 Field Renderer . . . . . . . . . . . . . . . . . . . . . . . 694
Managing the One Property Value
Managing Collection Commands. . . . . . . . . . . 683 Field Renderer . . . . . . . . . . . . . . . . . . . . . . . 694
Adding a Command to a Collection
Managing the One Table Value Field
Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 683
Renderer . . . . . . . . . . . . . . . . . . . . . . . . . . . . 694
Viewing and Editing the Properties of a Managing the Property Value Field
Collection Command . . . . . . . . . . . . . . . . . 684
Renderer . . . . . . . . . . . . . . . . . . . . . . . . . . . . 695
Removing a Command from a
Collection Type . . . . . . . . . . . . . . . . . . . . . . 684


CambridgeSoft
Chapter 38: Managing Fields . . . . . . 697 Modifying Properties without
Managing Field Listeners . . . . . . . . . . . . . . . . . . 697 Obscuring Data . . . . . . . . . . . . . . . . . . . .716
Adding a Field Listener . . . . . . . . . . . . . . . . 697 Managing Database Values in
Managing Generic Field Listeners . . . . . . . 698 Property Lists . . . . . . . . . . . . . . . . . . . . . .716
Managing the Block User Edit Field Managing Enumerated Values in
Listener . . . . . . . . . . . . . . . . . . . . . . . . . . . 698 Property Lists . . . . . . . . . . . . . . . . . . . . . . . .718
Managing the Block Edit Cell Field Editing an Enumerated Values List: . . .718
Listener . . . . . . . . . . . . . . . . . . . . . . . . . . . 698 Managing Property List Listeners . . . . . . .719
Managing the Copy Default Field Managing the Formula Listener . . . . . . .720
Listener . . . . . . . . . . . . . . . . . . . . . . . . . . . 699 Managing the Block Reference In
State Property List Listener . . . . . . . . . .721
Managing Data Fields . . . . . . . . . . . . . . . . . . . . . 699
Managing the Person Property List
Managing Active Document Fields . . . . . . 699
Listener . . . . . . . . . . . . . . . . . . . . . . . . . . .721
Managing Active Document Field
Listeners . . . . . . . . . . . . . . . . . . . . . . . . . . 700 Managing the Chemical Properties
Property List Listener . . . . . . . . . . . . . . .722
Managing the Prevent External
Link Active Document Field Listener 700 Managing the Validate Value Property
List Listener . . . . . . . . . . . . . . . . . . . . . . .722
Managing the Extract Links
Document Listener . . . . . . . . . . . . . . . . . 700 Managing Spectrum Fields . . . . . . . . . . . . .722
Managing Stored Document Fields . . . . . .723
Managing AutoText Fields . . . . . . . . . . . . . 700
Managing Subsection Fields . . . . . . . . . . . .723
Managing AutoText Field Listeners . . . . . 702
Managing Subsection Field Listeners . .725
Managing the AutoText Color Field
Listener . . . . . . . . . . . . . . . . . . . . . . . . . . . 702 Managing the Button View
Subsection Listener . . . . . . . . . . . . . . . . .725
Managing Chemical Structure Fields . . . . . 702
Managing the Hide Tools
Managing Chemical Structure Field
Subsection Listener . . . . . . . . . . . . . . . . .725
Listeners . . . . . . . . . . . . . . . . . . . . . . . . . . 703
Managing Table Fields . . . . . . . . . . . . . . . . .725
Configuring E-Notebook with
ISIS/Draw Tool . . . . . . . . . . . . . . . . . . . 704 Creating a Table Field . . . . . . . . . . . . . . .726
Configuring the Appearance of a Table 727
Managing Database Table Fields . . . . . . . . 705
Managing Database Values in Tables . .728
Creating a Database Table Field . . . . . . 705
Managing Enumerated Values in Tables 729
Configuring a Database Table Field . . . 705
Managing Table Listeners . . . . . . . . . . . .730
Managing Database Value Fields . . . . . . . . 707
Managing URL Display Fields . . . . . . . . . .732
Configuring a Database Value Field . . . 708
Managing Excel Fields . . . . . . . . . . . . . . . . . 708 Managing Search Fields . . . . . . . . . . . . . . . . . . . .733
Managing Break Link Excel Listener . . 709 Chemical Query Fields . . . . . . . . . . . . . . . . .733
Managing Hide Addins Excel Listener 709 Collection Query Fields . . . . . . . . . . . . . . . .734
Managing Remove Macros Field Collection Type Query Fields . . . . . . . . . . .735
Listener . . . . . . . . . . . . . . . . . . . . . . . . . . . 710 Join Type Fields . . . . . . . . . . . . . . . . . . . . . . .735
Managing PowerPoint Fields . . . . . . . . . . . 710 Property Query Fields . . . . . . . . . . . . . . . . .736
Managing Context Sensitive Help Fields . 710 Query Text Fields . . . . . . . . . . . . . . . . . . . . .736
Managing Captured Image Fields . . . . . . . 711 State Query Fields . . . . . . . . . . . . . . . . . . . . .737
Managing Property Lists . . . . . . . . . . . . . . . 712 Table Query Fields . . . . . . . . . . . . . . . . . . . .737
Creating a Property List . . . . . . . . . . . . . . 713 Unannotated Version Query Fields . . . . . .738
Managing Enumerated Values in Search Location Fields . . . . . . . . . . . . . . . . .738
Property Lists . . . . . . . . . . . . . . . . . . . . . . 714 Managing the Add-In Configuration . . . . . . . .739

Chem & BioOffice 2006 /Contents


Changing a Field Type . . . . . . . . . . . . . . . . . 740 Managing the Change Display
Adding a new Field Type . . . . . . . . . . . . . . 740 Collection Listener . . . . . . . . . . . . . . . . . 756
Deleting a Field Type. . . . . . . . . . . . . . . . . . 740 Managing the Clear Value Collection
Time Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . 740 Listener . . . . . . . . . . . . . . . . . . . . . . . . . . . 756
Administrator

Managing Units in Property Lists and Tables 741 Managing the Delete Spawn Collection
Specification of Units . . . . . . . . . . . . . . . . . 743 Listener . . . . . . . . . . . . . . . . . . . . . . . . . . . 757
Entry of data . . . . . . . . . . . . . . . . . . . . . . . . . 743 Managing the Parent Prefix Collection
Listener . . . . . . . . . . . . . . . . . . . . . . . . . . . 757
Chapter 39: Managing Collection Managing the Database Procedure
Types . . . . . . . . . . . . . . . . . . . . . . . . . . 745 Collection Listener . . . . . . . . . . . . . . . . . 757
Creating a New Collection Type . . . . . . . . . . . 746 Managing the Fixed Name Collection
Adding a Section Type to a Collection Type. 747 Listener . . . . . . . . . . . . . . . . . . . . . . . . . . . 757
Having a Section Appear by Default . . . . 748 Managing the Offline Collection
Listener . . . . . . . . . . . . . . . . . . . . . . . . . . . 758
Removing a Section Type from a Collection
Managing the Owner Full Control
Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 748
Collection Listener . . . . . . . . . . . . . . . . . 758
Managing Contained Collection Types. . . . . . 749 Managing the No Create Offline
Adding a Contained Collection Type . . . . 749 Collection Listener . . . . . . . . . . . . . . . . . 758
Changing the Relationship between a Managing the Parent Prefix Collection
Contained Collection Type and the Listener . . . . . . . . . . . . . . . . . . . . . . . . . . . 758
arent Collection Type . . . . . . . . . . . . . . . . . 750 Managing the Prevent Reference Copy
Removing a Contained Collection Type Collection Listener . . . . . . . . . . . . . . . . . 759
from a Collection Type . . . . . . . . . . . . . . . 750 Managing the Prevent Delete when
Managing Contained Reference Types . . . . . . 750 Referenced Collection Listener . . . . . . 759
Adding a Contained Reference Type . . . . 751 Managing the Refresh Database Table
Changing the Relationship between a Privilege Change Collection Listener . 759
Contained Reference Type and the Managing the Section List Collection
Parent Collection Type . . . . . . . . . . . . . . . 752 Listener . . . . . . . . . . . . . . . . . . . . . . . . . . . 760
Removing a Contained Reference Managing the Security Collection
Type from a Collection Type . . . . . . . . . . 752 Listener . . . . . . . . . . . . . . . . . . . . . . . . . . . 760
Configuring Relationships to Unspecified Managing the Sequence Collection
Types of Collections . . . . . . . . . . . . . . . . . . . . . . 752 Listener . . . . . . . . . . . . . . . . . . . . . . . . . . . 760
Managing Collection Listeners . . . . . . . . . . . . . 753 Managing the Unduplicatable
Adding a Collection Listener to a Collection Listener . . . . . . . . . . . . . . . . . 761
Collection Type . . . . . . . . . . . . . . . . . . . . . . 753 Managing the Unique Child
Viewing and Editing the Properties Collection Listener . . . . . . . . . . . . . . . . . . 761
of a Collection Listener . . . . . . . . . . . . . . . 754 Managing the User Collection Listener 761
Removing a Collection Listener from a Managing Templates . . . . . . . . . . . . . . . . . . . . . . 761
Collection Type . . . . . . . . . . . . . . . . . . . . . . 754 Managing Collection Type Form Tools. . 762
Managing the Standard Collection Managing the Duplicate Collection
Listeners . . . . . . . . . . . . . . . . . . . . . . . . . . . . 755 Form Tool . . . . . . . . . . . . . . . . . . . . . . . . 762
Managing the Auto Number Collection Managing the Structure Form Tool . . . 762
Listener . . . . . . . . . . . . . . . . . . . . . . . . . . . 755 Managing the Next Step Form Tool . . 763
Managing the Audit Collection Managing the New Section Form Tool 763
Listener . . . . . . . . . . . . . . . . . . . . . . . . . . . 756 Managing the New Child Collection


CambridgeSoft
Form Tool . . . . . . . . . . . . . . . . . . . . . . . . . 763 Managing the Sign Version Transition
Managing the New Sibling Collection Listener . . . . . . . . . . . . . . . . . . . . . . . . . . .775
Form Tool . . . . . . . . . . . . . . . . . . . . . . . . . 763 Managing the Unlocked Contents
Managing Search Types . . . . . . . . . . . . . . . . . . . 764 Transition Listener . . . . . . . . . . . . . . . . .775
Creating a Search Type . . . . . . . . . . . . . . . . . 764 Managing the View Signed Versions
Managing the Standard Search Engines . .765 Transition Listener . . . . . . . . . . . . . . . . .776
Collection Search Engine . . . . . . . . . . . .766 Configuring Change Control Options . . . . . . .776
Section Search Engine . . . . . . . . . . . . . . . 766 Managing Visual Display of Changes . . . .776
Chemical Structure Search Engine . . . .766 Enabling Visual Display of Changes
Creating a Search Form . . . . . . . . . . . . . . . . 766 from Collection Creation Onward . . .777
Viewing and Editing the Properties Enabling Visual Display of Changes
of a Search Engine . . . . . . . . . . . . . . . . . . . . 767 with a Transition . . . . . . . . . . . . . . . . . . .777
Managing States and Transitions . . . . . . . . . . . 768 Configuring Annotation Options . . . . .778
Adding States to a Collection Type . . . . . . 768 Configuring Autosave . . . . . . . . . . . . . . .779
Configuring a Transition between States . 769 Managing Export Templates of Collection
Managing Transition Listeners . . . . . . . . . . 770 Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .779
Associating a Transition Listener Creating and Editing the Export
with a Transition . . . . . . . . . . . . . . . . . . . 770 Templates for a Collection Type . . . . . . .780
Viewing and Editing the Properties Creating the Export Templates for a
of a Transition Listener . . . . . . . . . . . . . 771 Collection Type . . . . . . . . . . . . . . . . . . . .780
Removing a Transition Listener Editing the Header and Footer
from a Transition . . . . . . . . . . . . . . . . . . 771 Information . . . . . . . . . . . . . . . . . . . . . . . .781
Managing the Standard Transition
Listeners . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 772
Chapter 40: User Administration . . . 783
Managing the Annotate Transition Creating a User . . . . . . . . . . . . . . . . . . . . . . . . . . .783
Listener . . . . . . . . . . . . . . . . . . . . . . . . . . . 772 Creating a User Group . . . . . . . . . . . . . . . . . . . .784
Managing the Change Display Changing a User's Properties . . . . . . . . . . . . . . .784
Transition Listener . . . . . . . . . . . . . . . . . 772 Changing the Security Properties of a
Managing Change Security Transition User Collection . . . . . . . . . . . . . . . . . . . . . . .784
Listener . . . . . . . . . . . . . . . . . . . . . . . . . . . 773
Managing Confirm Transition Listener 773 Chapter 41: Managing E-Notebook
Managing the Export Transition Security . . . . . . . . . . . . . . . . . . . . . . . . 787
Listener . . . . . . . . . . . . . . . . . . . . . . . . . . . 773 Managing Collection Security . . . . . . . . . . . . . .787
Managing the Final Print Transition Collection Security. . . . . . . . . . . . . . . . . . . . .788
Listener . . . . . . . . . . . . . . . . . . . . . . . . . . . 773 Transition Security. . . . . . . . . . . . . . . . . . . . .791
Managing the Locked Container Managing the Security Properties of a
Transition Listener . . . . . . . . . . . . . . . . . 774 Collection Type . . . . . . . . . . . . . . . . . . . . . . . . . . .792
Managing the Print Transition Listener 774 Collection Type Security . . . . . . . . . . . . . . .793
Managing the Required Non-Blank Managing the Security Properties of a
Properties Transition Listener . . . . . . . 774 Section Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . .796
Managing the Required Rows Section Type Security . . . . . . . . . . . . . . . . . .796
Transition Listener . . . . . . . . . . . . . . . . . 775
Using the Session Manager . . . . . . . . . . . . . . . .798
Managing the Required Properties Ending a Session . . . . . . . . . . . . . . . . . . . . . .799
Transition Listener . . . . . . . . . . . . . . . . . 775

Chem & BioOffice 2006 /Contents


Chapter 42: Summary of the <refresh> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 808
Standard Add-Ins . . . . . . . . . . . . . . . . 801
Collection Listeners . . . . . . . . . . . . . . . . . . . . . . 801 Appendix O: Technical Support . . . . 809
Transition Listeners . . . . . . . . . . . . . . . . . . . . . . 802 Serial Numbers . . . . . . . . . . . . . . . . . . . . . . . . . . . 809
Administrator

Section Listeners . . . . . . . . . . . . . . . . . . . . . . . . . 802 Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . 809


Form Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 802 Performance . . . . . . . . . . . . . . . . . . . . . . . . . . 810
System Crashes . . . . . . . . . . . . . . . . . . . . . . . 810
Search Engines . . . . . . . . . . . . . . . . . . . . . . . . . . . 803
Field Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 803
Appendix P: Accessing the
Field Listeners . . . . . . . . . . . . . . . . . . . . . . . . . . . 804 CambridgeSoft Web Site . . . . . . . . . . 811
Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 805
Registering Online . . . . . . . . . . . . . . . . . . . . . . . . 811
Rendering Add-ins . . . . . . . . . . . . . . . . . . . . . . . 806
Accessing the Online ChemDraw Users
Chapter 43: Using the Batch Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 812
Import Facility . . . . . . . . . . . . . . . . . . 807 Accessing CambridgeSoft Technical Support 812
<batch>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 807 Finding Information on ChemFinder.com . . 812
<import> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 807 Finding Chemical Suppliers on ACX.com . . . 813
<target> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 807 Finding ACX Structures and Numbers . . . . . 813
<collectionType> . . . . . . . . . . . . . . . . . . . . . . . . 807 ACX Structures . . . . . . . . . . . . . . . . . . . . . . . 813
ACX Numbers . . . . . . . . . . . . . . . . . . . . . . . 814
<childReference> . . . . . . . . . . . . . . . . . . . . . . . . 807
Browsing ChemStore.com . . . . . . . . . . . . . . . . . 814
<source> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 808
<log> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 808 Browsing CambridgeSoft.com . . . . . . . . . . . . . 815
Using the ChemOffice SDK . . . . . . . . . . . . . . . 815
<alert> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 808


CambridgeSoft
Chem & BioOffice Introduction
Overview physical properties, notes, and tables of data. It
takes the place of that box of index cards youve
This Users Manual provides information about been using to jot notes about interesting molecules
Chem3D, ChemFinder, CombiChem/Excel, and reactions, but does it much better! With
E-Notebook, and related Desktop Addins. The ChemFinder, you can search through data
Desktop Addins incorporate features of efficiently and quickly, and you can organize the
ChemDraw, ChemFinder, and Chem3D into data instantly.
Microsoft Office applications promoting data
ChemFinder is integrated with the following
sharing within organizations that have standardized
CambridgeSoft products:
on MS Office for word processing and
spreadsheets. ChemDraw
Section I describes Chem3D. Section II describes Chem3D
ChemFinder and its addin, ChemFinder/Office. ChemDraw/Excel
Section III describes CombiChem/Excel, and
ChemFinder/Office
Section IV describes E-Notebook.

NOTE: You can use the CombiChem engine as a Microsoft


ChemFinder/Office
Excel add-in or with E-Notebook, ChemFinder/Office, ChemFinder/Office helps you to build databases
and other applications. by extracting information from various sources.
With ChemFinder/Office you can browse Word
About Chem3D documents or Excel spreadsheets to find chemical
structures. You can also browse ChemFinder
Chem3D is an application designed to enable databases and ChemDraw, Isis/Draw, or SD files.
scientists to model chemicals. It combines powerful In addition to browsing, ChemFinder/Office can
building, analysis, and computational tools with a search these files by chemical structure or formula,
easy-to-use graphical user interface, and a powerful or by molecular weight.
scripting interface.
Chem3D provides computational tools based on About CombiChem/Excel
molecular mechanics for optimizing models,
conformational searching, molecular dynamics, and Using the CombiChem engine you can perform the
calculating single point energies for molecules. following tasks:
Add combinatorial library syntheses to Excel
About ChemFinder workbooks and other documents.
ChemFinder is a database management system for Search for reactants (starting materials) in avail-
anyone who works with chemical information. It able chemicals databases and import them into
provides a place to store chemical structures, a document.

Chem & BioOffice 2006/ Chem & BioOffice Introduction 23


About Chem3D
Choose which reactants to use to create to get an overview of the product and how it works.
product libraries (experiments). Chapter 2 in each section, Tutorials, demonstrates
Find related structures in reactant and product most of the features of the application. Perform the
listings. tutorials in the order they are presented.
Administrator

Experienced users can skip to Chapter 3 and the


Assign reactants and products to automated subsequent chapters, which provide more detailed
synthesis well plates. information.
Calculate properties of reactants and products
to determine which ones might be the most Conventions
desirable.
The following notations are used throughout this
About E-Notebook users guide:

Use E-Notebook instead of your paper laboratory Ultra The Ultra symbol indicates that a feature is
notebook. With E-Notebook, you can make notes
about experiments, projects, reactions, and other available in the Ultra version only.
laboratory tasks and data. You can create MS Word,
MS Excel, spectra, table, and reaction sections for
Pro The Pro symbol indicates that a feature is
your data. You can also see the notes of other
people who share the E-Notebook database. You available in both the Pro and Ultra versions.
control access to E-Notebook with the
E-Notebook Administrator. Features that are available in the Standard version
are not indicated by a symbol.
About This Users Guide
NOTE: Notes such as this are used to highlight
This Users Manual contains information for the information supplemental to the main text.
Chem & BioOffice 2006 desktop applications for
Windows. It assumes that you are familiar with the
Shortcut key sequences are indicated with a + sign,
basics of your Windows operating system. If you
for example: Use the command: Ctrl+H to toggle
are not, please refer to your system manual before
hidden Hydrogens and lone pairs.
using the applications. Some of the material
describes tasks that must be performed in A bold font is used to indicate that you are to take
conjuction with other integrated CambridgeSoft a particular action, for example: From the Help
products. The material on the Addins describes Menu, choose Help Contents.
tasks that must be performed in conjuction with
Microsoft Excel or Word. If you are not familiar Additional Information
with these products, please consult the relevant
Users Manual for more detailed information. Additional sources of ChemOffice information are:
The chapters in this guide are organized by task. The Quick Reference Cards.
They are intended to help you familiarize yourself
The Help system
with the ChemOffice applications and start using
them as quickly and efficiently as possible. New CambridgeSoft Web Pages.
users should read the Basics chapter in each section http://www.cambridgesoft.com/support

24Chem & BioOffice Introduction CambridgeSoft


About E-Notebook
Quick Reference Card
For Access
The ChemOffice Quick Reference Cards are information
located in the back of the manual. The cards about
provide summaries of ChemOffice Desktop
Application commands and features. Because many Software Devel- http://sdk.cambridge-
of the instructions require knowledge of the opers kit soft.com/
interface elements, use the Quick Reference card as
you perform the tutorials in Chapter 2: Tutorials.
Purchasing http://chemstore.cambridge-
CambridgeSoft soft.com/
Help System products and
ChemOffice applications provide some or all of the chemicals
following types of Help:
HelpAn HTML reference guide. Installation and System
Context-sensitive Help Help topics Requirements
related to user interface objects. To access
Before installation, see the ReadMeFirst and any
Context sensitive Help type Shift+F1.
other ReadMe documents on the installation CD-
ToolTipsShort descriptions of user inter- ROM.
face objects displayed by pointing.
Status BarThe lower left corner of the GUI Microsoft Windows Requirements
displays useful information as you work.
Windows 2000 or XP
CambridgeSoft Web Pages Microsoft Office add-ins require Office
The following table contains the addresses of 2000, 2003, or XP
ChemDraw-related web pages. Screen resolution must be 800 x 600 or higher.
ChemDraw plug-ins/ActiveX controls support
For Access Microsoft IE 6.x, Netscape 7.x and 8.x, Mozilla
information
1.x, and Firefox 1.x.
about
The Chem3D ActiveX control supports Microsoft
Technical Support http://www.cambridge- IE 6.x, Netscape 7.x and 8.0, Mozilla 1.x, and
soft.com/services Firefox 1.x.

ChemDraw Plugin http://www.cambridge- NOTE: Windows XP Service Pack 2 includes security


soft.com/services/documen- features that automatically block active content. This means
tation/chemdrawplugin/ that by default, Internet Explorer blocks ChemDraw and
Chem3D ActiveX controls. To activate them, you must
Chem3D http://www.cambridge- choose the option to allow blocked content from the bar
ActiveX control soft.com/services/documen- appearing under the address bar notifying you that the
tation/chem3dcontrol/ security settings have blocked some of the content of the page.
IE does not remember this information, so you must repeat

Chem & BioOffice 2006/ Chem & BioOffice Introduction 25


Additional Information
the activation each time you access the page. Site License Network Installation Instruc-
If you visit a site frequently, you can add it to the list of tions
trusted sites in IEs security settings.
If you have purchased a site license, please see the
following web site for network installation
Administrator

instructions:
http://www.cambridgesoft.com/services/sl/

26Chem & BioOffice Introduction CambridgeSoft


Additional Information
Section I Chem3D: Introduction
About Chem3D MOPAC Pro

MOPAC Ultra is the full MOPAC implementation,


Chem3D is an application designed to enable
and is only available as an optional addin. The CS
scientists to model chemicals. It combines powerful MOPAC Ultra implementation provides support
building, analysis, and computational tools with a for previously unavailable features such as
easy-to-use graphical user interface, and a powerful MOZYME and PM5 methods.
scripting interface.
MOPAC Pro allows you to compute properties,
Chem3D provides computational tools based on
perform simple (and some advanced) energy
molecular mechanics for optimizing models,
minimizations, optimize to transition states, and
conformational searching, molecular dynamics, and
compute properties. The CS MOPAC Pro
calculating single point energies for molecules.
implementation supports MOPAC sparkles, has an
improved user interface, and provides faster
COEA calculations. It is included in some versions of
Chem3D, or may be purchased as an optional
Initially developed for Chem3D third-party addin. Contact CambridgeSoft sales or your local
interfaces (MOPAC, Gaussian, etc.), COEA reseller for details.
(ChemOffice Extension Architecture) is a
compatible, extendable architecture that can:
CAUTION
Allow any ChemOffice application to perform If you have CS MOPAC installed on your computer from
calculations using MOPAC, Gaussian, or other a previous Chem3D or ChemOffice installation,
COEA driver.
upgrading to version 10 will remove your existing
Allow third-party software providers to embed MOPAC installation. See the ReadMe for instructions
their products in CambridgeSoft products. on saving your existing MOPAC menu extensions.

About CS MOPAC See Chapter 9, MOPAC Computations on


page 171 for more information on using CS
CS MOPAC is an implementation of the well MOPAC.
known semi-empirical modeling application
MOPAC, which takes advantage of the easy-to-use
interface of Chem3D. CS MOPAC currently
About Gaussian
supports MOPAC 2002.
Gaussian is a cluster of programs for performing
There are two CS MOPAC options available with semi-empirical and ab initio molecular orbital (MO)
Chem3D 10: calculations. Gaussian is not included with CS
Chem3D, but is available from SciStore.com,
MOPAC Ultra http://scistore.cambridgesoft.com/software/.

Chem & BioOffice 2006 /Chem3D Introduction 27


When Gaussian is correctly installed, Chem3D New Gaussian Interface
communicates with it and serves as a graphical Predicting Spectra
front end for Gaussians text-based input and
Multi-step Jobs
output.
Partial Optimizations
Administrator

Chem3D is compatible with Gaussian 03 for Input Template


Windows, and requires the 32-bit version.
Advanced Mode
About Jaguar Support for DFT Methods
New SCHRDINGER Jaguar Interface
SCHRDINGER Jaguar is a high-performance
ab initio package for both gas and solution phase Hydrogen Bonding and Polar Hydrogen
simulations, with particular strength in treating Display
metal containing systems. It is a practical quantum Partial Surfaces
mechanical tool for solving real-world problems. Displaying Group Labels
The new Chem3D interface is the only Windows Displaying Measurements
platform GUI for Jaguar. The Demo Toolbar
Image Format Features
Whats New in Chem3D Embedding Models in Other Applications
10? Background Effects and Images
The major emphasis in Chem3D 10 development More Browser Support
was on improving support for calculations. The
following is a list of Chem3D enhancements in For Users of Chem3D 9
Chem & BioOffice 2006:
The following table lists things that have changed or
Enhancements to Chem3D 10 include: moved on the Chem3D 10.GUI.

Feature Chem3D 9 Chem3D 10

Preferences dialog box: on the General tab on the Picture tab


Image export settings

Preferences dialog box: GUI tab Collapse Single Top Level Fragment
Collapse Fragments With Only One
Child

Preferences dialog box: Popup Group Name


tab

28 Introduction CambridgeSoft
Whats New in Chem3D 10?
Feature Chem3D 9 Chem3D 10

Preferences dialog box: Chem- Do Cleanup When Synchronizing


Draw tab

Model Settings dialog box: Hydrogen Bonds


Model Display Modes
Lone Pairs

Model Settings dialog box: Atom Display tab Atom & Bond tab

Bond Size

Model Settings dialog box: Colors and Fonts tab: Background tab
Background

Model Settings dialog box: Highlighted Selected Color


Colors and Fonts tab:

Model Display toolbar Background Effect tool

Residue Label tool

File Menu Import (SDFiles and SYBYL)

Print Preview

View Menu Start Spinning Model Demo Demo toolbar (spinning and
rocking demos, with settings)
Spectrum Viewer

Structure Menu>Measurements Display Distance

Display Bond Angle

Display Dihedral

Chem & BioOffice 2006 /Chem3D Introduction 29


For Users of Chem3D 9
Feature Chem3D 9 Chem3D 10

Structure Menu Set Target Fragment


Administrator

Clear Target Fragment

Fast Overlay

Unmap Atoms

Show Atom Map Labels

Calculations Menu Dihedral Driver

Surfaces Menu Advanced Molecular Surfaces

Model Explorer: Atom Serial Numbers These settings only appear at the
Context Menu (at Fragment or atom level.
AtomSymbols
Group level)
Atom Dots

Model Explorer: Group Labels


Context Menu
Export to File

Context Menu>Select Select All options

Context Menu>Select> Selects new atoms; deselects orig- Selects new atoms; original atom
Select Atoms Within Distance of inal atom remains selected
Selection or Select Atoms Within
Radius of Selection Centroid

Context Menu>Select> Selects new atoms; original atom Selects new atoms; deselects orig-
Select Atoms Within Distance of remains selected inal atom
Selection or Select Atoms Within
Radius of Selection Centroid
(with Shift key held down)

Context Menu>Visibility Objects are still selected after Objects automatically deselected
change after change

30 Introduction CambridgeSoft
For Users of Chem3D 9
Feature Chem3D 9 Chem3D 10

Context Menu Set Bond Angle Measurement or Set Display Bond Angle Measurement
when selecting atoms that define a Dihedral Measurement or Display Dihedral Measurement
bond angle or a dihedral

For Users of Chem3D The Measurements table has been augmented


by three other tables: the Model Explorer, the
Versions 6 to 8 Cartesian Coordinates table, and the Z-Matrix
Many features of Chem3D changed in version 9. table. See The Model Explorer on page 48,
Please note the following: and Model Coordinates on page 48for more
details.
The rotation bars are now dynamic rather than
permanently displayed. See Rotation Bars on Menus and toolbars have changed. Consult the
page 34 for details. relevant sections of the manual for details.
Internal rotations have changed. See Rotating
Models on page 119 for details on how to
perform internal rotations.

Chem & BioOffice 2006 /Chem3D Introduction 31


For Users of Chem3D 9
Administrator

32 Introduction CambridgeSoft
For Users of Chem3D 9
Chapter 1: Chem3D Basics
The Graphical User Inter- (Cartesian coordinates, Z-Matrix, and
Measurement), and the ChemDraw Panel. At the
face bottom of the GUI is a Status bar which displays
information about the active frame of your model
The Graphical User Interface (GUI) is the part of
and about hidden atoms in your model. The GUI is
Chem3D that you interact with to perform tasks.
shown in Rotation mode with the dynamic Rotation
The GUI consists of a model window, menus,
bars showing, the ChemDraw panel open, and the
toolbars and dialog boxes. It can also include up to
Tables panel set to Auto-Hide.
three optional panels that display Output and
Comments boxes, the Model Explorer and tables Figure 1-1: Chem3D GUI

Building Toolbar Computation Toolbar Model Display Toolbar ChemDraw Panel


tab
Title bar
Menu bar
Standard
Toolbar

Active
Window
Tab

Model
Explorer tab

Model window

Status bar

Model Window the model, it appears in the Output window or the


Status bar.
The Model window is the work space where you do
your modeling. If there is textual information about

Chem & BioOffice 2006 /Chem3D Chem3D Basics 33


The following table describes the objects in the Click on a bar and drag to rotate a model around
Model window. that axis. The Rotate About a Bond bar is only
active when a bond or dihedral is selected. Freehand
Object Description rotation is accomplished by dragging in the main
Administrator

window. The cursor changes to a hand when


Model area The workspace where a molec- you are in freehand rotation mode.
ular model is viewed, built,
You can turn off the display (but not the function)
edited, or analyzed. The origin
of the bars with the Show Mouse Rotation Zones
of the Cartesian axes (0,0,0) is
checkbox on the GUI tab of the Preferences dialog
always located at the center of
box (File > Preferences).
this window, regardless of how
the model is moved or scaled. Model display window tabs now have context
The Cartesian axes do not move menus (right-click menus) for saving and closing.
relative to the window.
Figure 2: Window tab context menus

Active Window Chem3D 10 can open multiple


tab models simultaneously. The tab
selects the active window.

Rotation Bars
Chem3D 9 introduces dynamic (auto-hide) rotation
bars. The rotation bars only appear on your screen Preferences Dialog Box
when you are actually using them. To view the GUI customization now includes style options,
dynamic rotation bars you must do two things: window settings, and Model Explorer display
options. The VS 2005 (Whidbey) style option
Activate rotation mode by selecting the Track-
includes smart docking of toolbars. Change settings
ball tool. on the GUI tab of the Preferences dialog box.
Mouse over the rotation bar area.
Figure 1-2: Rotation bars
Z-axis X-axis

Bond axis Y-axis

34 Chem3D Basics CambridgeSoft


Figure 3: GUI Preferences dialog Model SettingsDisplays the Model
Settings dialog box. Set defaults for display
modes and colors, model building, atom and
ligand display, atom labels and fonts, movie and
stereo pair settings, and atom/bond popup
label information.
PreferencesDisplays the Preferences
dialog box. Set defaults for image export,
calculation output path, OpenGL settings and
including hydrogens in CDX format files.
Sample FilesAccesses example models.

The Edit Menu


In addition to the usual Edit functions, you can use
the Edit menu to copy the model in different
formats, to clear the model window, and to select all
Menus and Toolbars or part of the model.

All Chem3D commands and functions can be Copy asPuts the model on the Clipboard in
accessed from the menus or toolbars. The toolbars ChemDraw format, as a SMILES string, or in
contain icons that offer shortcuts to many bitmap format.
commonly used functions. You can activate the Copy As ChemDraw StructurePuts the
Toolbars you want from the Toolbars submenu of model on the Clipboard in CDX format. You
the View menu. may only paste the structure into an application
that can accept this format, for example Chem-
Toolbars can be attached to any side of the GUI, or Draw, ChemFinder, or Chem3D.
can be torn off and placed anywhere on the
Copy As SMILESPuts the model on the
screen for convenience.
Clipboard as a SMILES string. You may only
paste the structure into an application that can
TIP: Most Toolbar commands are duplicated from the accept this format.
menus, and are intended as a convenience. If you only use a
command infrequently, you can save clutter by using the menu Copy As PicturePuts the model on the
commands. Clipboard as a bitmap. You may only paste the
structure into an application that can accept
bitmaps.
The File Menu
NOTE: The application you paste into must recognize the
In addition to the usual File commands, you use the
format. For example, you cannot paste a ChemDraw
File menu to access the Chem3D Templates and structure into a Microsoft Word document.
Preferences, and the Model Settings.

Import FileImport MOL2 and SD files into Paste SpecialPreserves coordinates when
Chem3D a document. The import utility accu- pasting a Chem3D model from one document
rately preserves model coordinates. to another.

Chem & BioOffice 2006 /Chem3D Chem3D Basics 35


ClearClears the model window of all struc- Red and Blue glassesA toggle switch to
tures. set the display for optimal viewing with red-
Select AllSelects the entire model. blue 3D glasses to create a stereo effect.
Select FragmentIf you have selected an Stereo PairsA toggle switch to enhance
Administrator

atom, selects the fragment that atom belongs three dimensional effect by displaying a
to. model with two slightly different
orientations. It can also create orthogonal
The View Menu/Model Display Toolbar (simultaneous front and side) views. The
degree of separation is set on the Stereo View
Use the View menu to select the view position and tab of the Model Settings dialog box.
focus, as well as which toolbars, tables, and panels
are visible. The Model Display submenu of the PerspectiveA toggle switch to create a
View menu duplicates all of the commands in the perspective rendering of the model by
Model Display toolbar. consistent scaling of bond lengths and atom
sizes by depth. The degree of scaling is
View PositionThe View Position submenu controlled by the Perspective Field of View
gives you options for centering the view, fitting slider on the Model Display tab of the Model
the window, and aligning the view with an axis. Settings dialog box.
View FocusThe View Focus submenus is Depth FadingA toggle switch to create a
used to set the focus. See View Focus on realistic depth effect, where more distant
page 107 parts of the model fade into the background.
Model DisplayDuplicates the Model The degree of fading is controlled by the
Display toolbarContains tools to control the Depth Fading Field of View slider on the
display of the model. These tools are dupli- Model Display tab of the Model Settings
cated on the View menu.. dialog box.
Show Atom LabelsA toggle switch to Model AxesDisplays or hides the Model
display or hide the atom labels. axes.
Show Serial NumbersA toggle switch to View AxesDisplays or hides the view
display or hide the atom numbers. axes.
Show Atom DotsDisplays or hides atom
dot surfaces for the model. The dot surface is NOTE: When both axes overlap and the Model axes
based on VDW radius or Partial Charges, as are displayed, the View axes are not visible.
set in the Atom Display table of the Model
Background ColorDisplays the
Settings dialog box.
Background color select toolbar. Dark
Show Atom SpheresDisplays or hides backgrounds are best for viewing protein
atom spheres for the model. The radius is ribbon or cartoon displays. Selecting red-
based on VDW radius or Partial Charges, as blue or Chromatek 3D display will
set in the Atom Display table of the Model automatically override the background color
Settings dialog box. to display the optimal black background.
Show Hs and LpsA toggle switch to Background colors are not used when
display or hide hydrogen atoms and lone printing, except for Ribbon displays. When
pairs. saving a model as a GIF file, the background

36 Chem3D Basics CambridgeSoft


will be transparent, if you have selected that visualization operations, such as iterations
option for Image Export in the Preferences from a computation. They can be viewed in
dialog box. Chem3D, or saved in Windows AVI movie
Color BySelects the model coloring format. The commands are reproduced on
scheme. See Coloring Displays on page 79 the Movie menu.
for more information. Calculation toolbarPerforms MM2
ToolbarsClick the name of a toolbar to minimization from a desktop icon. The
select it for display. Click again to deselect. You spinning- arrow icon shows when any
can attach a toolbar to any side of the GUI by calculation is running, and the Stop icon can
dragging it to where you want it attached. If be used to stop a calculation before its
you are using a floating toolbar, you can change preset termination.
its shape by dragging any of its edges.
Status barDisplays the Status bar, which
Standard toolbarContains standard file, displays information about the active frame
edit, and print tools. The commands are of your model.
duplicated on the File and Edit menus.
CustomizeDisplays the Customize
Building toolbarContains the Select,
dialog box. Customizing toolbars is a
Translate, Rotate, and Zoom tools in
standard MS Windows operation, and is not
addition to the model building tools
described in Chem3D documentation.
bonds, text building tool, and eraser. These
tools are not duplicated on any menu. This Model ExplorerDisplays a hierarchical tree
toolbar is divided into safe and unsafe representation of the model. Most useful when
tools. The four safe tools on the left working with complex molecules such as
control only the view they do not affect proteins, the Model Explorer gives you highly
the model in any way. This includes the new granular control over the model display.
safe select tool and the new translate
tool . The old select tool is now ChemDraw PanelDisplays the ChemDraw
called the Move tool. Although it can also be Panel. Use the ChemDraw Panel to build mole-
used to select, its primary use is to move cules quickly and easily with familiar Chem-
atoms and fragments. Draw drawing tools. You can import, export,
edit, or create small molecules quickly and
Model Display toolbarContains tools to
easily using the ChemDraw ActiveX tools
control the display of the model. These tools
palette.
are duplicated on the View menu.
Surfaces toolbarContains tools to Cartesian TableDisplays the Cartesian
calculate and display a molecular surface. Coordinates table. Cartesian Coordinates
Molecular Surface displays provide describe atomic position in terms of X-, Y-,
information about entire molecules, as and Z-coordinates relative to an arbitrary
opposed to the atom and bond information origin.
provided by Structure displays. Z-Matrix TableDisplays the internal coor-
Movies toolbarContains tools for the dinates, or Z-Matrix, table. Internal coordi-
creation and playback of movies. Chem3D nates are the most commonly used coordinates
movies are animations of certain for preparing a model for further computation.

Chem & BioOffice 2006 /Chem3D Chem3D Basics 37


Measurements TableDisplays the Bond AnglesDisplays bond angles in the
Measurements table.The Measurements table Measurements Table. The Actual values
displays bond lengths, bond angles, dihedral come from the model and the Optimal
angles, and ring closures. values come from Angle Bending
Administrator

Parameters and other external tables.


Parameters TablesDisplays a list of
external tables that are used by Chem3D to Dihedral AnglesDisplays dihedral angles
construct models, perform computations and in the Measurements Table. The Actual
display results. values come from the model and the
Optimal values come from Angle Bending
Output BoxDisplays the Output box,
Parameters and other external tables.
which presents textual information about the
model, iterations, etc. ClearClears the entire Measurement
Comments BoxDisplays the Comments
table. If you only want to clear part of the
box, a place for user comments that is stored table, select the portion you want to clear,
with the file. and choose Delete from the context menu.

Dihedral ChartOpens the window The Model Position submenu


displaying results of Dihedral Driver MM2 Center Model on OriginResizes and
computation. See Tutorial 5: Mapping centers the model in the model window after
Conformations with the Dihedral Driver on a change to the model is made.
page 62 for more information.
Center Selection on OriginResizes and
Status BarDisplays or hides the Status Bar. centers the selected portion of the model in
Start Spinning Model DemoSpins the the model window.
model on the Y axis. Use stop calculation Align Model With X AxisWhen two
on the Calculations toolbar to stop the demo. atoms are selected, moves them to the X-
axis.
Full ScreenActivates the full screen display.
Align Model With Y-axisWhen two
The Structure Menu atoms are selected, moves them to the Y-
axis.
The Structure menu commands populate the
Align Model With Z-axisWhen two
Measurements table and control movement of the atoms are selected, moves them to the Z-
model. axis.
The Measurements submenu Align Model With XY PlaneWhen
Set MeasurementsSets a three atoms are selected, moves them to the
measurementbond length, angle, or XY-plane.
distanceaccording to what is selected. Align Model With XZ PlaneWhen
Bond LengthsDisplays bond lengths in three atoms are selected, moves them to the
the Measurements Table. The Actual values XZ-plane.
come from the model and the Optimal Align Model With YZ PlaneWhen
values come from the Bond Stretching three atoms are selected, moves them to the
Parameters external table. YZ-plane.

38 Chem3D Basics CambridgeSoft


The Reflect Model submenu Position by DihedralsPositions an atom
relative to three previously positioned atoms
Through XY PlaneReflects the model
using a bond distance, a bond angle, and a
through the XY plane by negating Z
dihedral angle. For more information on
coordinates. If the model contains any chiral
changing the internal coordinates see
centers this will change the model into its
Setting Dihedral Angles on page 108.
enantiomer. Pro-R positioned atoms will
become Pro-S and Pro-S positioned atoms Position by Bond AnglesPositions an
will become Pro-R. All dihedral angles used atom relative to three previously positioned
to position atoms will also be negated. atoms using a bond distance and two bond
angles. For more information on changing
Through XZ PlaneReflects the model the internal coordinates see Setting Bond
through the XZ plane by negating Y Angles on page 108.
coordinates. If the model contains any chiral
centers this will change the model into its Detect StereochemistryScans the model
enantiomer. Pro-R positioned atoms will and lists the stereocenters in the Output box.
become Pro-S and Pro-S positioned atoms InvertInverts the isomeric form. For
will become Pro-R. All dihedral angles used example, to invert a model from the cis- form
to position atoms will also be negated. to the trans- form, select one of the stereo
centers and use the Invert command.
Through YZ PlaneReflects the model
through the YZ plane by negating X Deviation from PlaneWhen you select four
coordinates. If the model contains any chiral or more atoms, outputs the RMS deviation
centers this will change the model into its from the plane to the Output window.
enantiomer. Pro-R positioned atoms will Add CentroidAdds a centroid to a selected
become Pro-S and Pro-S positioned atoms model or fragment. At least two atoms must be
will become Pro-R. All dihedral angles used selected. The centroid and bonds to the
to position atoms will also be negated. selected atoms are displayed, and bond
lengths can be viewed in the tool tips. To delete
Invert Through OriginReflects the
a centroid, select it and press the Delete or
model through the origin, negating all
Backspace key.
Cartesian coordinates. If the model contains
any chiral centers this will change the model RectifyFills the open valences for an atom,
into its enantiomer. Pro-R positioned atoms usually with hydrogen atoms. This command is
will become Pro-S and Pro-S positioned only useful if the default automatic rectification
atoms will become Pro-R. All dihedral is turned off in the Model Settings dialog box.
angles used to position atoms will also be Clean UpCorrects unrealistic bond lengths
negated. and bond angles that may occur when building
models, especially when you build strained ring
The Set Z-Matrix submenu systems.
Set Origin Atom(s) fileSets the selected OverlayThe Overlay submenu provides all
atom(s) as the origin of the internal of the commands to enable you to compare
coordinates. Up to three atoms may be fragments by superimposing one fragment in a
selected. Setting Measurements on page model window over a second fragment. Two
107 types of overlay are possible: quick, and mini-

Chem & BioOffice 2006 /Chem3D Chem3D Basics 39


mization. See Tutorial 6: Overlaying Models Figure 1-4: The Building toolbar
on page 63, and Comparing Models by
Overlay on page 134 for information on each Safe Select tool (view only)
overlay type.
Administrator

Translate tool
DockThe Dock command enables you to
position a fragment into a desired orientation Trackball tool
and proximity relative to a second fragment. Rotation Dial activator
Each fragment remains rigid during the
docking computation. Zoom tool

The Standard Toolbar Move tool

The Standard toolbar contains tools for standard Single Bond tool
Windows functions, including up to 20 steps of
Undo and Redo. Double Bond tool

Figure 1-3: The Standard toolbar Triple Bond tool

New File Uncoordinated Bond tool


Open File
Save File Text tool

Eraser tool
Copy
Cut
Paste
The Rotation Dial, activated by clicking the arrow
Undo under the Trackball tool, lets you rotate a model an
exact amount. Select an axis, then drag the dial or
type a number into the box.
Redo
Figure 1-5: The Rotation dial
Print

About Chem3D

The Building Toolbar


For detailed descriptions of the tools see Building
The Building toolbar contains tools that allow you With the Bond Tools on page 97, Rotating
to create and manipulate models. The tools are Models on page 119, and Resizing Models on
shown below. page 124.

40 Chem3D Basics CambridgeSoft


The Model Display Toolbar The Surfaces Toolbar
The Model Display toolbar contains tools for all of The Surfaces toolbar controls the display of
the Chem3D display functions. The Model type and molecular surfaces. In most cases, you will need to
Background color tools activate menus that let you do either an Extended Hckel, MOPAC, or
choose one of the options. All of the remaining Gaussian calculation before you can display
tools are toggle switchesclick once to activate; surfaces.
click again to deactivate.
Figure 1-7: The Surfaces toolbar
Figure 1-6: The Model Display toolbar

Model type Surface

Solvent radius
Background Color

Stereo Visualization Display mode

Red-Blue Stereo
Color Mapping
Chromatek Stereo

Perspective Surface color

Depth Fading
Resolution

Model Axes
HOMO/LUMO selection
View Axes

Isovalues
Atom labels

Atom numbers
Color A

Full screen mode


Color B
Spinning model demo

For more information on Surfaces, see Molecular


Surface Displays on page 84.

Chem & BioOffice 2006 /Chem3D Chem3D Basics 41


The Movie Toolbar Figure 1-9: The Demo toolbar

The Movie toolbar controls the creation and


playback of animations. You can animate certain
visualization operations, such as iterations from a
Administrator

computation, by saving frames in a movie. Movies


can be saved as Windows AVI video files. Spin Rock Axis Speed Amplitude Stop

Figure 1-8: The Movie toolbar Set the Speed and the rocking Amplitude. Choose
and axis. In addition to the X, Y, and Z axes, you
Play
may select a bond to spin or rock, and use the
Selected option. Stop the demo by either clicking
Stop the Spin or Rock button a second time, or use the
Stop button.
First frame
The Calculation Toolbar
Previous Frame The Calculation toolbar provides a desktop icon for
performing the most common calculation, MM2
Position minimization. It also provides a Stop button and a
calculation running indicator that work with all
calculations.
Next frame
Figure 1-10:The Calculation toolbar
Last frame

Calculation indicator
Delete

MM2 minimization
Delete all

Stop button
Properties

The ChemDraw Panel


For more information on Movies, see Creating
and Playing Movies on page 139. Chem3D 10 makes it easier than ever to create or
edit models in ChemDraw. The ChemDraw panel is
The Demo Toolbar activated from the View menu. By default it opens
on the right side of the GUI, but like the toolbars
A new Demo toolbar lets you set properties for you can have it float or attach it anywhere you
spinning and rocking models. like.

42 Chem3D Basics CambridgeSoft


Figure 1-11: The ChemDraw panel The Model Information
Close panel
Auto-Hide
Panel
The Model information panel contains information
Synchronize about the model in the top-most tabbed window
Draw > 3D add
and its display. You can display one or more of the
Draw>3D following tables in the area:
replace
Model Explorer
3D>Draw
Measurements
Clean up
structure Cartesian Coordinates
Clear Z-Matrix table
Lock Tables are linked to the structure so that selecting
Name=Struct an atom, bond, or angle in either will highlight both.
Numerical values in the tables can be edited or cut
and pasted to/from other documents (text or Excel
worksheets), and the changes are displayed in the
structure.
ChemDraw
ActiveX tool
All of the tables have an Auto-hide feature to
palette minimize their display. For more information on
Model Tables, see Model Coordinates on page
Use the 3D > Draw icon to drag a Chem3D model 48.
into the ChemDraw panel. Figure 1-12: The Z-Matrix table
To create a model in ChemDraw, click in the Column Field Name Cell
ChemDraw panel to activate the ChemDraw Record
Heading
Selector Column Divider
toolbar. Use the Draw>3D Add or Draw>3D Replace
icons to put the model in Chem3Dor select the
Synchronize icon to draw in both simultaneously.
You can also create a model by typing the name of
a compoundor a SMILES stringinto the
Name=Struct box. When you finish editing, add
or replace your Chem3D model by clicking the
appropriate icon.

Chem & BioOffice 2006 /Chem3D Chem3D Basics 43


The following table describes the elements of the 1. Right-click in the window and choose Export.
Measurement table. A Save As dialog box appears.
2. Enter a name for the file, select a file format
Table Element Description (.html or .txt) and click Save.
Administrator

Column Heading Contains field names To save information with the clipboard:
describing the information in 1. Select the text you want to save.
the table.
2. Right-click in the window and choose Copy.
Alternately, you can choose Select All from the
Record Selector Used to select an entire
context menu.
record. Clicking a record
selector highlights the corre- 3. Paste into the document of your choice.
sponding atoms in the model You must use Copy Paste to restore information
window. from a saved file.
You can remove information from the Output
Field Name Identifies the type of infor- window without affecting the model.
mation in the cells with
which it is associated. To remove messages:
1. Select the text you want to delete.
Column Divider Used to change the width of
the column by dragging. 2. Do one of the following:
From the context menu, choose Clear.
Cell Contains one value of one Press the Delete or Backspace key.
field in a record. All records The Comments window gives you a place to add
in a given table contain the notes and comments about the model. When you
same number of cells. save a model, comments are also saved.

The Output and Comments Model Building Basics


Windows As you create models, Chem3D applies standard
parameters from external tables along with user-
The Output and Comments boxes are typically selected settings to produce the model display.
found at the bottom of the GUI window. You can There are several options for selecting your desired
have them float if you wish, or move them to display settings: you can change defaults in the
another side of the window. You can select Auto- Model Settings dialog box, use menu or toolbar
hide to minimize them. commands, or use context-sensitive menus (right-
click menus) in the Model Explorer. You can also
Calculations on models and other operations view and change model coordinates.
produce messages that are displayed in the Output
window.You can save the information in the Internal and External Tables
Output window either directly or using the
clipboard. To save information directly: Chem3D uses two types of parameter tables:

44 Chem3D Basics CambridgeSoft


Model Building Basics
Internal tablesContain information about a To view an external table:
specific model. Point to Parameter Tables on the View menu,
Examples of internal tables are: then choose the table to view.

TIP: You can superimpose multiple tables if you


Measurements table
attach them to an edge of the GUI. One table will be
Z-Matrix table visible and the others will display as selection tabs.
Attached tables have the Auto-hide feature.
Internal coordinates table
To auto-hide a table:
External tablesContain information used
Push the pin in the upper right corner of the
by all models.
table.
Examples of external tables are: The table minimizes to a tab when you are not
using it.
Elements, Atom Types, and Substructures
tables that you use to build models. The Model Setting Dialog
Torsional Parameters tables that are used by Box
Chem3D when you perform an MM2 The Chem3D Model Settings dialog box allows
computation. you to configure settings for your model.
Tables that store data gathered during To open the Chem3D Model Settings dialog box:
Dihedral Driver conformational searches. From the File menu, choose Model Settings.
Standard MeasurementsStandard The Model Settings dialog box appears:
measurements are the optimal (or equilibrium) Figure 1-13: The Settings dialog box
bond lengths and angles between atoms based on
their atom type. The values for each particular atom
type combination are actually an average for many
compounds each of which have that atom type (for
example, a family of alkanes). Standard
measurements allow you to build models whose 3D
representation is a fair approximation of the actual
geometry when other forces and interactions
between atoms are not considered.

For more information on External Tables, see


Parameter Tables on page 251.

To view an internal table:

Choose the table from the View menu.

Chem & BioOffice 2006 /Chem3D Chem3D Basics 45


Model Building Basics
The settings are organized into tabbed panels. To In the Model Settings dialog box, select the
select a control panel, click one of the tabs at the Atom Labels tab, and check the box next to
top of the dialog box. Show Element Symbols and Show Serial
Numbers.
Administrator

Model Display
The serial number for each atom is assigned in the
The model of ethane shown below displays the order of building. However, you can reserialize the
cylindrical bonds display type (rendering type) with atoms. For more information see Setting Serial
the element symbols and serial numbers for all Numbers on page 109.
atoms.
The element symbol comes from the Elements
Figure 1-14: Model display table. The default color used for an element is also
Atom serial numbers defined in the Elements table. For more
Element symbols information, see Coloring by Element on page 79
and The Elements on page 254.

Model Data Labels


When you point to an atom, information about the
atom appears in a model label pop-up window. By
default, this information includes the element
symbol, serial number, atom type, and formal
charge.

Figure 1-15 shows the model label for the C(1)


To specify the rendering type do one of the atom of ethane.
following:
Figure 1-15: Atom labels
From the View menu, point to Model Display,
then Display Mode, and select a rendering type.
Activate the Model Display toolbar, click the
arrow next to the Model Display icon ,
and select a rendering type.
In the Model Settings dialog box, choose
Model Display, and select a rendering type.

To specify the display of serial numbers and


element symbols, do one of the following:
On the View menu, point to Model Display,
then click Show Serial Number or Show Atom
Label.
Activate the Model Display toolbar and click
the Atom Labels and Serial Numbers icons.

46 Chem3D Basics CambridgeSoft


Model Building Basics
The model data changes when you point to a bond If you select four contiguous atoms the dihedral
instead of an atom. angle appears in the model label. If you select two
bonded or non-bonded atoms, the distance
Figure 1-16 shows the model label for the bond
between those atoms appears.
between C(1) and C(2).
Figure 1-16: Bond labels To specify what information appears in atom, bond,
and angle labels:

In the Model Settings dialog box, select the


Pop-up Info tab, then select the information you
want to display.

Atom Types

Atom types contain much of the Chem3D chemical


intelligence for building models with reasonable 3D
geometries. If an atom type is assigned to an atom,
you can see it in the model data when you point to
it. In the previous illustration of pointing
information, the selected atom has an atom type of
C Alkane.
The model data changes to reflect the atoms that
are selected in the model. For example, when three An atom that has an atom type assigned has a
contiguous atoms H(3)-C(1)-C(2) are selected, the defined geometry, bond orders, type of atom used
model label includes the atom you point to and its to fill open valences (rectification), and standard
atom type, the other atoms in the selection, and the
bond length and bond angle measurements
angle.
(depending on the other atoms making up the
Figure 1-17: Model label bond).
these atoms are selected
they are displayed in yellow The easiest way to build models uses a dynamic
in Chem3D
assignment of atom types that occurs as you build.
For example, when you change a single bond in a
model of ethane to a double bond, the atom type is
automatically changed from C Alkane to C Alkene.
In the process, the geometry of the carbon and the
number of hydrogens filling open valences changes.

You can also build models without assigning atom


types. This is often quicker, but certain tasks, such
as rectification or MM2 Energy Minimization, will
also correct atom types because atom types are
required to complete these tasks.

Chem & BioOffice 2006 /Chem3D Chem3D Basics 47


Model Building Basics
To assign atom types as you build: The Model Explorer
In the Chem3D Model Settings dialog box,
The Model Explorer allows users to explore the
select the Model Build tab, then check the
hierarchical nature of a macromolecule and alter
Correct Atom Types checkbox.
Administrator

properties at any level in the hierarchy. Display


To assign atom types after building: modes and color settings are easy to control at a
fine-grained level. Properties of atoms and bonds
Select the atom(s) and use the Rectify command
are easy to access and change.
on the Structure menu.
Atom type information is stored in the Atom Types The Model Explorer is designed as a hierarchical
table. To view the Atom Types table: tree control that can be expanded/collapsed as
necessary to view whatever part of the model you
From the View menu, select Parameter Tables, wish. Changes are applied in a bottom-up manner,
then select atom types.xml. so that changes to atoms and bonds override
changes at the chain or fragment level. You can
Rectification show/hide/highlight features at any level. Hidden
or changed features are marked in the hierarchical
Rectification is the process of filling open valences tree with colored icons, so you can easily keep track
of the atoms in your model, typically by adding of your edits. See Working With the Model
hydrogen atoms. Explorer on page 136 for more information.
To rectify automatically as you build, do the
following: Model Coordinates
In the Chem3D Model Settings dialog box, Each of the atoms in your model occupies a
select the Model Build tab, then check the position in space. In most modeling applications,
Rectify checkbox. there are two ways of representing the position of
If you activate automatic rectification in the Model each atom: internal coordinates and Cartesian
Settings dialog box, you have the option of coordinates. Chem3D establishes internal and
showing or hiding hydrogens. If you turn off Cartesian coordinates as you build a model.
automatic rectification, the Show Hs and Lps
command on the Model Display submenu of the Z-matrix
View menu is deactivated, and you will not have the
option of displaying hydrogens. Internal coordinates for a model are often referred
to as a Z-matrix (although not strictly correct), and
Bond Lengths and Bond Angles are the most commonly used coordinates for
preparing a model for further computation.
You can apply standard measurements (bond Changing a Z-matrix allows you to enter relations
lengths and bond angles) automatically as you build between atoms by specifying angles and lengths.
or apply them later. Standard measurements are
determined using the atom types for pairs of You display the Z-Matrix table by selecting it from
bonded atoms or sets of three adjacent atoms, and the View menu. You can edit the values within the
are found in the external tables Bond Stretching table, or move atoms within the model and use the
Parameters.xml and Angle Bending Parameters.xml. Set Z-matrix submenu of the Structure menu. You

48 Chem3D Basics CambridgeSoft


Model Building Basics
can copy and paste tables to text (.txt) files or Excel Figure 1-19: Cartesian coordinates
spreadsheets using the commands in the context
(right-click) menu.
Figure 1-18 shows an example of the internal
coordinates (Z-matrix) for ethane:7
Figure 1-18: Internal coordinates

The Measurements Table


The Measurements table displays bond lengths,
bond angles, dihedral angles, and ring closures.
Cartesian Coordinates When you first open a Measurements Table, it will
Cartesian coordinates are also commonly accepted be blank.
as input to other computation packages. They To display data in a Measurements Table:
describe atomic position in terms of X-, Y-, and
Z-coordinates relative to an arbitrary origin. Often, From the Structure menu, point to Measure-
the origin corresponds to the first atom drawn. ments, then select the information you wish to
However, you can set the origin using commands in display.
the Model Position submenu of the Structure menu. Figure 1-20 shows the display of Bond Lengths and
Instead of editing the coordinates directly in this Bond Angles for ethane:
table, you can save the model using the Cartesian Figure 1-20: The Measurements table
Coordinates file format (.cc1 or .cc2), then edit that
file with a text editor. You can also copy and paste
the table into a text file or Excel worksheet using
the commands in the context (right-click) menu.

NOTE: If you do edit coordinates in the table, remember to


turn off Rectify and Apply Standard Measurements in
the Model Build panel of the Model Settings dialog while you
edit so that other atoms are not affected.

An example of the Cartesian coordinates for ethane


is shown in Figure 1-19.

If you edit the Actual field, you change the value in


the model, and see atoms in the model move.

Chem & BioOffice 2006 /Chem3D Chem3D Basics 49


Model Building Basics
If you edit the Optimal value, you apply a constraint. To delete records:
These values are used only in Clean Up (on the
Structure menu) and MM2 computations. Select the records and click Delete on the
context menu.
Administrator

Deleting Measurement Table Data


Deleting records in a Measurements table does
You can isolate the information you in the not delete the corresponding atoms.
Measurements table by deleting the records that
you do not want to view. For example, you could To clear the entire table:
display bond lengths, then delete everything except
the carbon-carbon bonds. This would make them On the Measurement submenu of the Struc-
easier to compare. ture menu, select Clear.

50 Chem3D Basics CambridgeSoft


Model Building Basics
Chapter 2: Chem3D Tutorials
Overview From the File menu, open the Model Settings
dialog box. Click the Reset button.
The following section gives detailed examples of
some general tasks you can perform with Chem3D. Open a new model window if one is not already
For examples of MOPAC calculations, see Chapter opened. To view models as shown in this tutorial,
9, MOPAC Computations on page 171. select Cylindrical Bonds from the drop-down menu
of the Model Display mode tool on the Model
In this section: Display toolbar.
Tutorial 1: Working with ChemDraw on Figure 2-21: Setting the model display mode
page 51.
Tutorial 2: Building Models with the Bond
Tools on page 52.
Tutorial 3: Building Models with the Text
Building Tool on page 56.
Tutorial 4: Examining Conformations on
page 59. The installation default for the ChemDraw panel is
Tutorial 5: Mapping Conformations with the activated, hidden. You should see a tab labeled
Dihedral Driver on page 62. ChemDraw on the upper right side of the GUI.
Tutorial 6: Overlaying Models on page 63. Figure 2-22: The ChemDraw tab
Tutorial 7: Docking Models on page 65.
Tutorial 8: Viewing Molecular Surfaces on
page 68. ChemDraw tab
Tutorial 9: Mapping Properties onto
Surfaces on page 69.
Tutorial 10: Computing Partial Charges on
page 71.

Tutorial 1: Working with If you do not see the tab:


ChemDraw 1. From the View menu, select ChemDraw Panel.
The following tutorial introduces model building The ChemDraw Panel opens in its default
with Chem3D. It assumes that no defaults have position, attached to the right edge of the
been changed since installation. If what you see is model window.
not like the description, you may need to reset the
defaults. To reset defaults: If the tab is visible:

Chem & BioOffice 2006 /Chem3D Chem3D Tutorials 51


Tutorial 1: Working with ChemDraw
2. Click the ChemDraw tab to open the panel. You can turn off the hot linking by clicking the
Synchronize button. If you do this, you will need to
TIP: The panel default is Auto-hide. If you want the use the 3D>Draw and Draw>3D buttons to copy
panel to stay open, push the pin on the upper right. models between the windows.
Administrator

pin
Figure 2-24: ChemDraw panel functions
Synchronize Draw>3D replace Name=Struct
Cleanup text box
3. Click in the ChemDraw panel it.
A blue line appears around the ChemDraw
Panel model window, and the ChemDraw tools Draw>3D add 3D>draw Clear Lock
palette appears.
4. On the ChemDraw tools palette, select the TIP: Use Ctrl+A to select the model you want to copy.
Benzene Ring tool.
5. Click in the panel to place a benzene ring.
Tutorial 2: Building
The ChemDraw structure is converted into a
3D representation. Models with the Bond
Figure 2-23: Creating a 3D model from the Chem- Tools
Draw panel
Draw ethane using a bond tool.
1. Click the Single Bond tool .
2. Point in the model window, drag to the right
and release the mouse button.
A model of ethane appears. When you rotate
the model in a later step, you will see the other
hydrogen.
Figure 2-25: Ethane model

You can work with the model in Chem3D. The 2D


and 3D models are hot-linked, so any change in one
changes the other:
1. Double-click one of the hydrogens in the 3D
model.
A text box appears. NOTE: If you are using default settings, hydrogens are
displayed automatically.
2. Type OH in the text box, then hit the Enter key.
3. A phenol molecule is displayed in both the To see the three-dimensionality of your model you
Chem3D model window and the ChemDraw can perform rotations using the Trackball tool. The
window. Trackball Tool mimics a sphere in which your

52 Chem3D Tutorials CambridgeSoft


Tutorial 2: Building Models with the Bond Tools
model is centered. You can rotate your model by 3. Release the mouse button when the model is
rotating the sphere. You have a choice of free-hand orientated approximately like this:
rotation, or rotating around the X, Y, or Z axis.
Figure 2-26: Orienting a model
To perform free-hand rotation of the model with
the Trackball tool:

1. Click the Trackball tool .


2. Point near the center of the model window and
hold down the mouse button.
3. Drag the cursor in any direction to rotate the
model.
Examine the atoms and bonds in the model using
CAUTION the Select tool.

Users familiar with earlier versions of Chem3D should be 1. Click the Select tool .
aware of changed behavior: the Trackball tool rotates the
2. Move the pointer over the far left carbon.
view only, it does not change the atoms Cartesian
coordinates.
NOTE: Depending on how much you rotated the
model, the far left carbon might be C(2).
To rotate around an axis:
An information box appears next to the atom
1. Move the cursor to the edge of the model you are pointing at. The first line contains the
window. atom label. In this case, you are pointing to
C(1). The second line contains the name of the
As you mouse over the edge of the window, the atom type, C Alkane.
rotation bars will appear.
Figure 2-27: Viewing the atom label
NOTE: Rotation bars are only available when you
are using the Trackball tool.

2. Drag on one of the bars to rotate the model on


that axis.
One of the bars is labeled Rotate About Bond.
You wont be able to select that one. Youll
cover rotating around bonds later.

TIP: Once you start dragging, you dont have to stay


within the rotation bars boundaries. Your model will
only rotate around the chosen axis no matter where you
3. Move the pointer over the C-C bond to display
drag your mouse.
its bond length and bond order.

Chem & BioOffice 2006 /Chem3D Chem3D Tutorials 53


Tutorial 2: Building Models with the Bond Tools
Figure 2-28: Viewing bond length Figure 2-30: Viewing a dihedral angle
Administrator

To display information about angles, select several


atoms. Change the ethane model to an ethylene model.

1. Click C(1), then Shift+click C(2) and H(7). 1. Click the Double Bond tool .
2. Point at any of the selected atoms or bonds. 2. Drag the mouse from C(1) to C(2).
The angle for the selection appears. 3. Point to the bond.
Figure 2-29: Viewing bond angles The bond length decreases and the bond order
increases.
Figure 2-31: Changing the bond length by changing
bond order

To display information about contiguous atoms:


1. Hold the Shift key and select four contiguous
atoms. Continue to build on this model to build
2. Point at any portion of the selection. cyclohexane.
The dihedral angle formed by those four atoms
1. Click the Select tool .
is displayed.
2. Click the double bond.
3. Right click, point to Bond(s), then to Order, and
choose Single Bond.
The bond order is reduced by one.
Hide the hydrogens to make it easier to build.

54 Chem3D Tutorials CambridgeSoft


Tutorial 2: Building Models with the Bond Tools
On the Model Display submenu of the View Figure 2-34: Viewing model data when closing a ring
menu, deselect Show Hs and Lps.
The hydrogens are hidden.

Add more atoms to the model:

1. Click the Single Bond tool .


2. Drag upward from the left carbon.

3. Another C-C bond appears.

Figure 2-32: Building with the bond tool: step 1

2. Release the mouse button to close the ring.

Figure 2-35: Building cyclohexane with the bond tool

4. Continue adding bonds until you have 6


carbons as shown below.
Figure 2-33: Building with the bond tool: step 5

Add serial numbers and atom labels.

1. On the Model Display submenu of the View


menu, select Show Serial Numbers, or click the
Serial Number icon on the Model Display
toolbar.
2. On the Model Display submenu of the View
menu, select Show Atom Labels, or click the
Create a ring: Atom Label icon on the Model Display
toolbar.
1. Drag from one terminal carbon across to the
other. NOTE: The serial numbers that appear do not reflect
a normal ordering because you started with a smaller
The pointing information appears when you
model and built up from it.
drag properly.

Chem & BioOffice 2006 /Chem3D Chem3D Tutorials 55


Tutorial 2: Building Models with the Bond Tools
You can reserialize the atoms as follows: For more information about MM2 and energy
minimization see Chapter 8, MM2 and MM3
1. Select the Text Building tool . Computations on page 157 andAppendix H:
2. Click the first atom. MM2.
Administrator

A text box appears on the atom. After the minimization is complete:


Figure 2-36: Adding atom labels and numbers
1. From the File menu, choose Save.
2. Select a directory in which to save the file.
3. Type tut1 in the text box at the bottom of the
dialog box.
4. Click Save.
5. Click the model window to activate it.
3. Type the number you want to assign to this
6. From the File menu, choose Close Window.
atom (1 for this example).
4. Press the Enter key. Tutorial 3: Building
The first atom is renumbered as (1).
Models with the Text
5. Double-click each of the atoms in the order
you want them to be numbered. Building Tool
Each time you double-click an atom to serialize This tutorial illustrates alternative methods to build
it, the new serial number is one greater than the models using the Text Building Tool. You will start
serial number of the previously serialized atom. by opening the file you saved in the first tutorial:
6. From the Model Display submenu of the View 1. From the File menu, choose Open.
menu, choose Show Hs and Lps and examine
the model using the Trackball Tool . 2. Locate and select the file, tut1, that you created
in the previous tutorial.
The hydrogens appear as far apart as possible.
3. Click Open.
Because you built the structure by using bond tools,
you may have distorted bond angles and bond Replacing Atoms
lengths.
To change one element into another:
To correct for distorted angles and lengths:
1. Click the Text Building tool .
1. From the Edit menu, choose Select All.
2. Click a hydrogen atom attached to C(1).
All of the atoms in the model are selected.
A text box appears.
2. From the Structure menu, choose Clean Up
3. Type C.
Structure.
To locate an energy minimum for your structure NOTE: Element symbols and substructure names are
which represents a stable conformation of your case sensitive. You must type an uppercase C to create a
model, click the MM2 Minimize Energy tool carbon atom.

on the Calculation toolbar. 4. Press the Enter key.

56 Chem3D Tutorials CambridgeSoft


Tutorial 3: Building Models with the Text Building Tool
The hydrogen attached to C(1) is changed to a Using Labels to Create
carbon. The valence is filled with hydrogens to
form a methyl group because Automatic
Models
Rectification is turned on. You can also create models by typing atom labels
You dont have to select the Text tool in order to (element symbols and numbers) into a text box.
use it. Double-clicking with any other tool selected Figure 2-37: Creating a model with the text box
has the same effect as single-clicking with the Text CH3
tool. To demonstrate this, lets replace two more H2 H
hydrogens using an alternative method: H3C C C C CH3
H

1. Select the Trackball tool so that you can OH


rotate your model to get a better view of what
To build the model of 4-methyl-2-pentanol shown
you are building.
above:
2. Double-click two more hydrogens to change
1. From the File menu, choose New, or click the
them to methyl groups.
new file tool on the Standard toolbar.
TIP: Notice that the C you entered previously in the 2. Click the Text Building tool .
Text tool remains as the default until you change it. You only 3. Click in the empty space in the model window.
have to double-click, and press the Enter key. A text box appears where you clicked.
4. In the text box, type
Now, refine the structure to an energy minimum to CH3CH(CH3)CH2CH(OH)CH3.
take into account the additional interactions
You type labels as if you were naming the
imposed by the methyl groups by clicking the MM2
structure: pick the longest chain of carbons as
tool on the Calculation toolbar.
the backbone, and specify other groups as
When the minimization is complete: substituents. Enclose substituents in
parentheses after the atom to which they are
1. From the File menu, choose Save As. attached.
2. Type tut2a. 5. Press the Enter key.

3. Select a directory in which to save the file. TIP: The Text building tool will also accept structures in
4. Click Save. SMILES notation, either typed in or cut and pasted from
other documents.
Save a copy of the model using a different name:
Another, simpler, way of building this model is to
1. From the File menu, choose Save As.
type Pentane in the Name=Struct text box then
2. Type tut2b. modify the appropriate hydrogens.
3. Select a directory in which to save the file. Refine the model as follows.
4. Click Save. 1. Click the Select tool
Well be using these two copies of your model in 2. Select the model by dragging diagonally across
later tutorials. it.

Chem & BioOffice 2006 /Chem3D Chem3D Tutorials 57


Tutorial 3: Building Models with the Text Building Tool
3. From the Structure menu, choose Clean Up. Using Substructures
If you want a more accurate representation of a low
Labels are useful to build simple structures.
energy conformation, optimize the geometry of the
However, if you make larger, more complex
model by clicking the MM2 tool on the
Administrator

structures, you will find it easier to use a


Calculation toolbar.
combination of labels and pre-defined
To specify text equivalent to the structure of substructures.
1,2-dimethyl cyclopentane shown below:
Over 200 substructures are pre-defined in
Figure 2-38: More complex models with the text box Chem3D. These substructures include the most
H2
C
commonly used organic structures.
H 2C CH2
TIP: Pre-defined substructures are listed in the
CH CH substructures.xml file. You can view the list by pointing to
Parameter Tables on the View menu and selecting
H 3C CH3 Substructures. Text typed in the text box is case sensitive.
You must type it exactly as it appears in the Substructures
1. From the File menu, choose New. table.
2. Click the Text Building tool .he
3. Click in the empty space in the model window. Build a model of nitrobenzene:
4. Type CH(CH3)CH(CH3)CH2CH2CH2. 1. From the File menu, choose New.
5. Press the Enter key. 2. Click the Text Building tool .
The trans-isomer appears. 3. Click the empty space in the model window.
6. Select the model and choose Clean Up from the 4. Type Ph(NO2) in the text box.
Structure menu. 5. Press the Enter key.
TIP: You dont have to click the Select tool every time A model of nitrobenzene appears.
you want to select something. Just hold down the letter S The substructure in this example is the phenyl
on your keyboard while working with any building tool, group. Substructures are defined with specific
and you temporarily activate the Select tool. attachment points for other substituents. For
phenyl, the attachment point is C(1).
You cannot specify stereochemistry when you build
models with labels. The structure of 1,2-dimethyl Build a peptide model:
cyclopentane appears in the trans conformation.
1. From the File menu, choose New.
To obtain the cis-isomer: 2. Click the Text Building tool .
1. Click the Select tool . 3. Click an empty space in the Model window.

2. Select C(1). A text box appears.


3. From the Structure menu, choose Invert. 4. Type H(Ala)12OH.

The cis-isomer appears. You can rotate the 5. Press the Enter key.
molecule to see the differences between the 6. Rotate this structure to see the alpha helix that
isomers after you invert the molecule. forms.

58 Chem3D Tutorials CambridgeSoft


Tutorial 3: Building Models with the Text Building Tool
Change the model display type: Tutorial 4: Examining
1. Click the arrow on the right side of the Conformations
Model Display Mode tool on the Model
Display toolbar. This tutorial uses steric energy values to compare
2. Select Wire Frame as the Model Type. two conformations of ethane. The conformation
with the lower steric energy value represents the
TIP: You can also click on the icon. Successive clicks more likely conformation.
cycle through the Display Mode options.
Build ethane:
3. Select the Trackball tool , and rotate the
model so you are viewing it down the center of
1. Draw a single bond in the ChemDraw panel.
the helix as shown in Figure 2-39.
Figure 2-39: Rotating a model with the trackball A model of ethane appears.
2. View the Measurements table:

a. From the Structure menu, point to


Measurements, then choose Bond Lengths.

b. From the Structure menu, point to


Measurement, then choose Bond Angles.

NOTE: If the Measurements table appears along side


the Model Explorer, you can stack the windows by
locking the Model Explorer window open and dragging
the Measurements table on top of it.

The information you chose appears in the


4. Use the Model Display Mode tool to choose Measurements table. The measurements in the
Ribbons as the Model Type to see an alternative Actual and Optimal columns are nearly
display commonly used for proteins. identical. The Actual column represents the
Figure 2-40: Ribbon display measurements for the model in the active
window. The Optimal measurements (for bond
lengths and bond angles only) represent the
standard measurements in the Bond Stretching
and Angle Bending parameter tables.

Chem & BioOffice 2006 /Chem3D Chem3D Tutorials 59


Tutorial 4: Examining Conformations
Figure 2-41: Angle Bending parameter tables This staggered conformation, where the
hydrogens on adjoining carbons are a
maximum distance from one another (which
represents the global minimum on a potential
Administrator

energy plot) represents the most stable


conformation of ethane.
Figure 2-42: Ethane in stable conformation

Chem3D shows the most common conformation


of a molecule. You can rotate parts of a molecule, To examine this result numerically, calculate the
such as a methyl group, to see other conformations. steric energy of this conformation then compare it
to a higher energy (eclipsed) conformation.
Rotate the orientation of the model to obtain a
Newman projection (viewing the model along a 1. From the Calculations menu, point to MM2,
bond.) This orientation helps clarify the then choose Compute Properties.
conformations of ethane. The Compute Properties dialog box appears.
The Properties tab should show Pi Bond Orders
To rotate a methyl group on an ethane model: and Steric Energy Summary selected as the
default. If it does not, select them.
1. Click the Trackball tool .
TIP: Use Shift-click to select multiple properties.
When you mouse over the edges of the model
window, the Rotation Bars appear. 2. Click Run.

Only the X- and Y-rotation bars are active. The Output box appears beneath the model
These Rotations bars are always active because window, with Steric Energy results displayed.
they are not dependent on any atoms being The last line displays the total energy.
selected.
NOTE: The values of the energy terms shown are
2. Click the X-Axis rotation bar and drag to the approximate and may vary slightly based on the type of
right. processor used to calculate them.
As you drag, the status bar shows details about
the rotation. To obtain the eclipsed conformation of ethane,
rotate a dihedral angle (torsional angle). Rotating a
3. Stop dragging when you have an end-on view dihedral angle is a common way of analyzing the
of ethane. conformational space for a model.

60 Chem3D Tutorials CambridgeSoft


Tutorial 4: Examining Conformations
To view dihedral angles: Figure 2-44: Rotating a dihedral angle

1. From the Structure menu, point to


Measurement, then choose Dihedral Angles.
All of the models dihedral angles are added to
the bottom of the Measurements table.
2. Click the H(3)-C(1)C(2)-H(8) dihedral record to
select the corresponding atoms in the model.

NOTE: Although the serial numbers and element


symbols are shown in the Measurements table, they do
not appear in your model. In the Measurements table, notice that the dihedral
for H(3)-C(1)-C(2)-H(8) is now minus 0 degrees, as
To help keep visual track of the atoms as you shown in the model.
change the dihedral angle you can display the serial
numbers and element symbols for the selected Figure 2-45: The Measurements table
atoms.
From the Model Display submenu of the View
menu, select Show Serial Numbers and Show
Element Symbols.

1. Click the arrow next to the Trackball tool, and


tear off the rotation dial by dragging on the
blue bar at the top.
Figure 2-43: The Rotation dial

trackball To compute steric energy:


local axis rotation
1. From the Calculations menu, point to MM2,
dihedral rotation then choose Compute Properties.
dihedral, move other
side NOTE: The property tab defaults should remain as
The Rotation dial should show the angle of the in the previous calculation.
selected dihedral, approximately 60, and
dihedral rotation should be selected. 2. Click Run.

2. Grab the green indicator button, and rotate the The final line in the Output box appears as in
dial to 0.0. Figure 2-46.

Chem & BioOffice 2006 /Chem3D Chem3D Tutorials 61


Tutorial 4: Examining Conformations
Figure 2-46: The Output box To view the conformation at any given point:

1. Point to a location (specific degree or energy


setting) inside the Dihedral Driver Window.
Administrator

A dashed-line box appears. As you move the


NOTE: The values of the energy terms can vary slightly mouse, the box moves to define a specific point
based on the type of processor used to calculate them. on the graph.
Figure 2-47: Using the dihedral driver
The steric energy for the eclipsed conformation
(~3.9 kcal/mole) is greater in energy than that of
the staggered conformation (~1 kcal/mole),
indicating that the staggered configuration is the
conformation that is more likely to exist.

NOTE: As a rule, steric energy values should only be used


for comparing different conformations of the same model. 2. Click on the point of interest.
The model display rotates the dihedral to the
Tutorial 5: Mapping selected conformation.
Conformations with the NOTE: The dihedral is rotated in 5 degree increments
Dihedral Driver through 360 degrees for a total of 72 conformations to
produce the graph. You can view the minimized energy values
The dihedral driver allows you to map the
for each point in the Output window.
conformational space of a model by varying one or
two dihedral angles. At each dihedral angle value,
the model is energy minimized using the MM2 To rotate the other dihedral angle (other end of the
force field and the steric energy of the model is bond):
computed and graphed. After the computation is Right-click in the Dihedral Driver window and
complete you can view the data to locate the models choose Exchange.
with the lowest steric energy values and use these as
starting points for further refinement in locating a Rotating two dihedrals
stationery point.
To rotate two dihedrals:
To use the dihedral driver:
1. Use Shift+click to select two adjacent bonds.
1. Select the bond in your model that defines the
dihedral angle of interest. In this case, the middle atoms position remains
fixed
2. Choose Dihedral Driver from the Calculations
menu. 2. Choose Dihedral Driver from the Calculations
The Dihedral Driver window opens. When the menu.
computation is completed, a graph is displayed The Dihedral Driver window opens. When the
showing the energy (kcal) vs. theta (angle of computation is completed, a graph is displayed
rotation). showing theta 1 vs. theta 2.

62 Chem3D Tutorials CambridgeSoft


Tutorial 5: Mapping Conformations with the Dihedral Driver
Figure 2-48: Two dihedrals in the dihedral driver This tutorial describes the Fast Overlay method.
For the Minimization Method, see Comparing
Models by Overlay on page 134. The
Minimization Method is more accurate, but the Fast
Overlay algorithm is more robust. In both tutorial
examples, you will superimpose a molecule of
Methamphetamine on a molecule of Epinephrine
(Adrenalin) to demonstrate their structural
similarities.

NOTE: The graph is the result of rotating one angle 1. From the File menu, choose New Model.
through 360 in 15 increments while holding the other Open the Model Explorer if it is not already
constant. The second angle is then advanced 15 and the open.
operation is repeated. 2. Choose the Text tool from the Building
Toolbar and click in the model window.
To view the conformation at any given point: A text box appears.
Click any block in the graph. 3. Type Epinephrine and press the Enter key.
A molecule of Epinephrine appears.
The model display rotates both dihedrals to the
selected conformation. TIP: If you leave out the upper case E, Chem3D
will display an Invalid Label error message.
Customizing the Graph
4. Click in the model window again to open
You can use the context menu to set the rotation another text box.
interval used for the computation. You can also 5. Select the entire word Epinephrine, replace it
select display colors for the graph, background, with Methamphetamine, and press the Enter
coordinates, and labels. key.
You also use the context menu to copy the graph, The list of atoms in the Model Explorer is
or its data set, to other applications, or to save the replaced with two Fragment objects, labeled
data. Epinephrine and Methamphetamine.
Figure 2-49: Two fragments

Ultra Tutorial 6: Over-


laying Models
Overlays are used to compare structural similarities Fragment Labels
between models, or conformations of the same
model. Chem3D provides two overlay techniques:

a Fast Overlay algorithm


the traditional do it by hand method based
on minimization calculations

Chem & BioOffice 2006 /Chem3D Chem3D Tutorials 63


Tutorial 6: Overlaying Models
The two fragments are hopelessly jumbled together Figure 2-52: Rotating fragments prior to alignment
at this point, so you might want to separate them
before you proceed.
1. Click one of the fragment names in the Model
Administrator

Explorer.
The entire fragment is selected.
Figure 2-50: Selecting a fragment

At this point, you have to decide which of the


fragments will be the target. In this simple example,
with only two compounds, it doesnt really matter.
You might, however, have cases where you want to
overlay a number of compounds on a specific
target. Chem3D allows multiple overlays. The
Model Explorer makes it easy to hide compounds
you are not actively working with, and to display any
2. Click the Move Objects tool. combination of compounds you want.
3. Drag the selected fragment away from the 1. Click the Epinephrine fragment to select it.
other fragment. 2. Point to Overlay on the context (right-click)
Figure 2-51: Dragging a fragment menu, and click Set Target Fragment.
Figure 2-53: Setting the target

A box or oval indicates the position of the


fragment while you are moving it. The icon on the fragment changes to a target.
TIP: You can rotate a fragment separately from the
whole model by selecting at least one atom in it and using
the Shift key with the trackball tool. Try this to re-
orient the fragments as in the illustration below.

64 Chem3D Tutorials CambridgeSoft


Tutorial 6: Overlaying Models
Figure 2-54: Model Explorer with target selected
Tutorial 7: Docking
Models
The Dock command enables you to position a
fragment into a desired orientation and proximity
3. Select the Methamphetamine fragment. relative to a second fragment. Each fragment
remains rigid during the docking computation.
TIP: The check in the box next to Methamphetamine
The Dock command is available when two or more
does not mean that it is selected, it means that it is
distances between atoms in one fragment and
visible. (Try it. This is how you work with multiple
atoms in a second fragment are specified. These
overlays.) You must click on the fragment name for the
distances are entered into the Optimal field in the
Fast Overlay command to become active.
Measurements table.
4. Choose Fast Overlay from the Overlay You can use docking to simulate the association of
submenu on the context menu. regions of similar lipophilicity and hydrophilicity on
two proximate polymer chains. There are four
The fragments are overlaid. The numbers show
steps:
the serial numbers of the target atoms that the
matching overlay atoms correspond to. A. Build a polymer chain:

TIP: You can designate a group, rather than the entire 1. Open a new Model window and select the Text
fragment, as the target. In some cases, this will give more Building tool.
useful results.
2. Click in the model window.

Figure 2-55: Overlaid fragments A text box appears.


3. Type (AA-mon)3(C2F4)4(AA-mon)3H in the
text box.
4. Press the Enter key.

A polyacrylic acid/polytetrafluoroethylene
block copolymer appears in the model window.
The text, (AA-mon)3, is converted to a polymer
segment with three repeat units of acrylic acid.
The text, (C2F4)4, is converted to a polymer
segment with four repeat units of
tetrafluoroethylene.
B. Build a copy of the chain:

To turn off the Fast Overlay mode: Double-click in the model window well above
and to the right of the first polyacrylic
Choose Clear Target Fragment from the Overlay acid/polytetrafluoroethylene block copolymer
submenu. molecule.

Chem & BioOffice 2006 /Chem3D Chem3D Tutorials 65


Tutorial 7: Docking Models
A second polymer molecule appears above the 1. In the Model Explorer, select C(6) in
first polyacrylic acid/polytetrafluoroethylene Fragment 1.
block copolymer molecule. Hint: Its in the AA-mon 2 group.
C. Orient the chains: 2. Locate the C(98) atom in Fragment 2
Administrator

(AA-mon 12 group) and Ctrl-click to select it


1. Click in the empty space in the model window also.
to deselect any atoms in the model window. 3. In the Structure menu, point to Measurements
2. Click the arrow on the Trackball tool to open and choose Set Distance Measurement.
the Rotation Dial tool. The Measurements table opens, (if it is already
3. Select the Y axis, and drag the dial to show 55. open as a tabbed window, it becomes active)
displaying the C(98)-C(6) pair.
TIP: To get exactly 55 you will probably have to edit 4. Click the Optimal cell.
the value in the number box. After editing, you must 5. Type 5 and press the Enter key.
press the Enter key. The value displayed in the right
The optimal distance between C(6) and C(98)
corner of the dial should be the same as in the number
is specified as 5.000.
box.
To have a reasonable dock, you must specify at least
The resulting model appears as shown in Figure 2- four atom pairs. Repeat steps 1 through 5 for
56 (the second model may appear in a different matching atom pairs throughout the fragments. For
position on your computer): example, if you choose one pair from each group
your list might look like the following:
Figure 2-56: Docking models I

Atoms Actual Optimal

C(1)-C(93) 21.2034 5.0000

C(98)-C(6) 21.1840 5.0000

C(104)-C(12) 21.2863 5.0000

C(108)-C(16) 21.1957 5.0000

C(22)-C(114) 20.6472 5.0000

C(28)-C(120) 20.7001 5.0000


D. set optimal distances between atoms in the
two fragments:
C(34)-C(126) 20.1410 5.0000
The Optimal distance determines how closely
the molecules dock. In this tutorial, you will set C(133)-C(41) 20.3559 5.0000
the distance to 5.

66 Chem3D Tutorials CambridgeSoft


Tutorial 7: Docking Models
Figure 2-58: Recording iterations
Atoms Actual Optimal

C(45)-C(137) 20.3218 5.0000

C(50)-C(142) 20.4350 5.0000

Ignore the distances in the Actual cell because they


iteration
depend on how the second polymer was positioned values
relative to the first polymer when the second
polymer was created.

To begin the docking computation:


Note that while the docking computation proceeds,
1. From the Structure menu, choose Dock.
one molecule remains stationary and the second
The Dock dialog box appears. molecule moves.

Figure 2-57: The Dock dialog box To stop the docking computation before it reaches
its preset RMS values, click Stop Calculation
on the Calculation toolbar. Both docking and
recording are stopped.

The Status bar displays the values describing each


iteration of the docking computation.

Figure 2-59 shows the docked polymer molecules.

Figure 2-59: Docked polymers


2. Type 0.100 for the Minimum RMS Error value
and 0.010 for the Minimum RMS Gradient.

The docking computation stops when the RMS


Error or the RMS Gradient becomes less than
the Minimum RMS Error and Minimum RMS
Gradient value.

3. Click Display Every Iteration.

This allow you to see how much the fragments


have moved after each iteration of the docking
computation. The following illustration shows the distances
between atom pairs at the completion of the
To save the iterations as a movie, click Record Each docking computation. The distances in the Actual
Iteration. cell are close to the distances in the Optimal cell.

Chem & BioOffice 2006 /Chem3D Chem3D Tutorials 67


Tutorial 7: Docking Models
Figure 2-60: The measurements table for docked poly- To view the Highest Occupied Molecular Orbital
mers (HOMO):
4. From the Surfaces menu, point to Choose
Surface, and select Molecular Orbital.
Administrator

5. From the Surfaces menu, point to Molecular


Orbital to see the HOMO/LUMO options.
Select HOMO (N=6).
The pi bonding orbital surface appears.
Figure 2-61: Pi bonding orbital surface

Your results may not exactly match those described


here. The relative position of the two fragments or
molecules at the start of the docking computation
can affect your results. For more accurate results,
lower the minimum RMS gradient.

Tutorial 8: Viewing
Molecular Surfaces NOTE: You may need to rotate the molecule to view
the orbitals.
Frontier molecular orbital theory says that the
highest occupied molecular orbitals (HOMO) and To view the Lowest Unoccupied Molecular Orbital
lowest unoccupied molecular orbitals (LUMO) are (LUMO):
the most important MOs affecting a molecules 1. From the Surfaces menu, point to Molecular
reactivity. This tutorial examines the reactivity of Orbital to see the HOMO/LUMO options.
double bonds by looking at the simplest molecule Select LUMO (N=7).
containing a double bond, ethene.
The pi antibonding orbital surface appears.
Create an ethene model: Figure 2-62: Pi antibonding orbital surface

1. From the File menu, choose New.

2. Draw a double bond in the ChemDraw panel.

A molecule of ethene appears.


Before you can view the molecular orbital surface,
you must calculate it.

3. From the Calculations menu, point to


Extended Huckel and select Calculate Surfaces.

68 Chem3D Tutorials CambridgeSoft


Tutorial 8: Viewing Molecular Surfaces
These are only two of twelve different orbitals The propene radical is displayed.
available. The other ten orbitals represent various Figure 2-64: Propene radical model
interactions of sigma orbitals. Only the pi orbitals
are involved in the HOMO and the LUMO.
Because the HOMO and LUMO control the
reactivity of a molecule, you can conclude that it is
the pi bonding interactions of ethene that control
its reactivity. This is a specific case of a more general
rule: pi bonds are more reactive than sigma bonds.

Tutorial 9: Mapping
Properties onto Surfaces 4. From the Calculations menu, point to Gaus-
sian, and choose Minimize Energy.
5. In the Theory tab, set the Method to PM3, and
NOTE: This example is designed to demonstrate Gaussian the Wave Function to Open Shell (Unrestricted).
minimization. You can also do it using CS MOPAC or
6. Also in the Theory tab, set the Spin Multiplicity
Extended Hckel calculations.
to 2.
The allyl radical, CH2=CHCH2, is a textbook
NOTE: If you are doing this tutorial with CSMOPAC,
example of resonance-enhanced stabilization: there is no Spin Multiplicity setting.
Figure 2-63: The allyl radical
H H This molecule is intended to be a radical, and setting
C C
C
H
the Spin Multiplicity ensures that it is.
H
C
2 2 H
C
2 C
H
2
One of the best ways to view spin density is by
To examine Radicals with Spin Density surfaces: mapping it onto the Total Charge Density surface.
1. From the File menu, choose New. This allows you to see what portions of the total
charge are contributed by unpaired electrons, or
2. Type 1-propene in the ChemDraw
radicals.
Name=Struct text box.
A molecule of 1-propene appears. To view Spin Density mapped onto Total Charge
Density Surface:
Create a radical:
1. In the Properties tab, select Molecular Surfaces
1. Select the H9 hydrogen. and Spin Density (use Shift-click).
2. Press Delete. 2. Press Run.
A dialog box appears asking if you want to turn The calculation toolbar appears.
off rectification. Chem3D is chemically
Figure 2-65: The Calculation toolbar
intelligent, and knows that in most cases
carbon atoms have four substituents. Radicals
are one of the rare exceptions.
3. Click Turn Off Automatic Rectification.

Chem & BioOffice 2006 /Chem3D Chem3D Tutorials 69


Tutorial 9: Mapping Properties onto Surfaces
When the calculation is finished, select the 2. On the Surfaces toolbar, point to Surface and
Trackball tool and rotate the model back and forth. select Total Charge Density.
It should be completely planar. The icon changes to denote the surface
Figure 2-66: Viewing the minimized model selected.
Administrator

3. On the Surfaces toolbar, point to Display Mode


and choose Translucent.
4. On the Surfaces toolbar, point to Color
Mapping and choose Spin Density.
5. On the Surfaces toolbar, choose Isocharge.
The Isocharge tool appears.
Figure 2-68: Using the Isocharge tool

To complete this tutorial, you will need to adjust a


number of surface settings. For convenience,
activate the Surfaces toolbar.

1. From the View menu, point to Toolbars, and


choose Surfaces. 6. Set the isocharge to 0.0050. (The number in the
middle is the current setting.)
The Surfaces toolbar appears. Drag it into the
workspace for added convenience. NOTE: Isovalues are used to generate the surface. You
can adjust this value to get the display you want. The
Figure 2-67: The Surfaces toolbar
illustration below was made with the setting of 0.0050.
Surface
Figure 2-69: Viewing the total charge density surface
Solvent radius

Display mode

Color Mapping

Surface color

Resolution

HOMO/LUMO selection

Isovalues

Color A Most of the surface is grey, indicating that there is


no contribution to it from unpaired electrons. The
Color B
areas of red centered over each of the terminal

70 Chem3D Tutorials CambridgeSoft


Tutorial 9: Mapping Properties onto Surfaces
carbons is a visual representation of the expected molecule contributes an integral charge to the
delocalization of the radicalthere is some radical molecule as a whole. This integral contribution is
character simultaneously on both of these carbons. known as the formal charge of each atom.
Now, hide this surface: Certain types of atoms in Chem3D deal with this
explicitly by having non-integral formal charges.
Click the Surfaces icon to toggle the surface
For example, the two oxygen atoms in nitro-
off.
benzene each have charges of -0.500 because there
Determine the raw spin density alone, not mapped is one electron that is shared across the two N-O
onto the charge density surface. bonds.

1. On the Surfaces toolbar, point to Surface, and However, as shown above, electrons in molecules
select Total Spin Density. actually occupy areas of the molecule that are not
associated with individual atoms and can also be
2. From the Surfaces menu, point to Surfaces,
attracted to different atomic nucleii as they move
and choose Wire Mesh. across different atomic orbitals. In fact, bonds are a
3. Set Isospin to 0.001. representation of the movement of these electrons
Figure 2-70: Wire mesh surfaces between different atomic nucleii.

Because electrons do not occupy the orbitals of a


single atom in a molecule, the actual charge of each
atom is not integral, but is based on the average
number of electrons in the model that are
occupying the valence shells of that atom at any
given instant. By subtracting this average from the
number of protons in the molecule, the partial
charge of each atom is determined.
Visualizing the partial charge of the atoms in a
molecule is another way to understand the model's
There is a large concentration of unpaired spin over
reactivity. Typically the greater the partial charge on
each of the terminal carbons and a small
an atom, the more likely it is to form bonds with
concentration over the central hydrogen. This extra
other atoms whose partial charge is the opposite
little bit of spin density is not very significantyou
sign.
could not even see it when looking at the mapped
display earlier, but the calculations show that it is, in Using the theories in Extended Hckel, MOPAC,
fact, there. or Gaussian, you can compute the partial charges
for each atom. In the following example, the partial
Tutorial 10: Computing charges for phenol are computed by Extended
Partial Charges Hckel.

To compute the charge of a molecule, the number 1. From the File menu, choose New.
of electrons contributed by each of its atoms can be Click the Text Building tool , click in the
subtracted from the number of protons in the model window, type PhOH in the text box, and
nucleus of each of its atoms. Each atom of a press the Enter key.

Chem & BioOffice 2006 /Chem3D Chem3D Tutorials 71


Tutorial 10: Computing Partial Charges
A molecule of phenol is created. atom a close second). The rest of the molecule has
relatively pale atoms; their partial charges are much
To compute Extended Hckel charges:
closer to zero.
From the Calculations menu, point to
Administrator

Extended Hckel and choose Calculate Charges. In addition to color, you can vary the size of atom
spheres or dot surfaces by partial charge.
Messages are added to the Output box, listing
the partial charge of each atom. 1. Select the Color By Element radio button in
You can graphically display partial charges in the Model Display tab of the Model Settings
following ways: dialog box.

By coloring atoms. 2. Click the Atom Display tab.

By varying the size of atom spheres. 3. Click the Show by Default checkbox in the Solid
Spheres section.
By varying the size of the dot surfaces.
4. Select the Partial Charges radio button.
To display partial charges:
Figure 2-72: Varying atom sphere size as a function
1. From the File menu, choose Model Settings. of partial charge
2. Click the Model Display tab.
3. Select the Color by Partial Charge radio button.
All of the atoms are colored according to a
scale from blue to white to red. Atoms with a
large negative partial charge are deep blue.
Atoms with a large positive partial charge are
deep red. As the magnitude of the charges
approaches 0, the color of the atom becomes
paler.
Figure 2-71: Coloring by partial charge
In this representation, the oxygen atom and its two
adjacent atoms are large because they have relatively
large partial charges of opposite signs. The rest of
the atoms are relatively small.

You can display dot surfaces whose size is specified


by partial charge.

1. Click the VDW Radius radio button in the Solid


Spheres section.

1. Select the Show By Default check box in the Dot


For phenol, the greatest negative charge is on the Surfaces section.
oxygen atom. The greatest positive charge is on the
adjacent carbon atom (with the adjacent hydrogen 2. Click the Partial Charges radio button.

72 Chem3D Tutorials CambridgeSoft


Tutorial 10: Computing Partial Charges
Figure 2-73: Dot surface size as a function of partial In this representation, the oxygen atom and its two
charge adjacent atoms have large dot surface clouds
around them because they have relatively large
partial charges of opposite signs. The rest of the
atoms are relatively small. Their dot surfaces are
obscured by the solid spheres. If another molecule
were to react with this molecule, it would tend to
react where the large clouds are, near the oxygen
atom.

Chem & BioOffice 2006 /Chem3D Chem3D Tutorials 73


Tutorial 10: Computing Partial Charges
Administrator

74 Chem3D Tutorials CambridgeSoft


Tutorial 10: Computing Partial Charges
Chapter 3: Displaying Models
Overview Ribbons
Cartoons
You can display molecular models in several ways,
depending on what information you want to learn To change the default structural display type of a
from them. The atoms and bonds of a model can model:
take on different appearances. These appearances 1. From the File menu, choose Model Settings.
are generically termed rendering types, and the term
model display is used in Chem3D. Depending on the The Chem 3D Model Settings dialog box
type of molecule, certain model displays may offer appears.
advantages by highlighting structural features of 2. Select the Model Display tab.
interest. For example, the Ribbons model display The Model Display control panel of the Chem
might be the option of choice to show the 3D Model Settings dialog box appears.
conformational folding of a protein without the
Figure 3-1: The Model Display control panel
distracting structural detail of individual atoms.
Model display options are divided into two general
types: Model
Display
Structure displays Tab
Molecular surface displays

Structure Displays
Structures are graphical representations based on
the traditional physical three-dimensional
molecular model types. The following structure Default
display types are available from Model Display view Model
of the Chem 3D Model Settings dialog box: Type

Wire Frame
Sticks
Ball and Stick
Cylindrical Bonds
Space Filling 3. Set the new options.

Chem & BioOffice 2006 /Chem3D Displaying Models 75


To change the structural display type of a model
temporarily: Model Type Description

1. Click the arrow on the Model Display tool ,


Ball and Stick Ball and Stick models
and select the display type.
Administrator

show bonds drawn as


Model Types thick lines and atoms are
drawn as filled spheres.
The following table describes the Chem3D model The atom spheres are
types: filled with color that
corresponds to the
Model Type Description element or position of
the atom.
Wire Frame Wire Frame models are
the most simple model Cylindrical Bonds Cylindrical Bond models
type. Bonds are displayed
are similar to Ball and
as pixel-wide lines.
Stick models except that
Atoms are not displayed
all bond types are drawn
explicitly, but each half of
as cylinders.
a bond is colored to
represent the element
color for the atom at that
end. Wire Frame models
are well suited for
extremely large models
such as proteins.

Sticks Stick models are similar


to Wire Frame, however,
the bonds are slightly
thicker. As this model
type is also fairly fast, it is
another good choice for
visualizing very large
models such as proteins.

76 Displaying Models CambridgeSoft


Model Type Description Model Type Description

Space Filling Space Filling models are Cartoons Cartoon models, like
more complex to draw Ribbon models, show
and slowest to display. large protein molecules
Atoms are scaled to in a form that highlights
100% of the van der secondary and tertiary
Waals (VDW) radii speci- structure.
fied in the Atom Types
table. The following caveats
apply to the Ribbon and
NOTE: The VDW radii Cartoon model display
are typically set so that types:
overlap between
non-bonded atoms in They do not provide
space filling models pop-up information.
indicates a significant
They should be
(approximately 0.5
kcal/mole) repulsive printed as bitmaps.
interaction.
Displaying Solid Spheres
Ribbons Ribbons models show In Ball and Stick, Cylindrical Bond, and Space
large protein molecules Filling models, you can display the solid spheres
in a form that highlights representing atoms and control their size.in
secondary and tertiary individual atoms or all atoms.
structure. Ribbon models
can be colored by Group To display solid spheres by default on all atoms:
to help identify the
1. From the File menu, select Model Settings.
amino acid constituents.
Your model must have a 2. Select the Atom Display tab.
protein backbone in 3. In the Solid Spheres section, click the Show By
order to display ribbons. Default checkbox.

Chem & BioOffice 2006 /Chem3D Displaying Models 77


Figure 3-2: Setting solid sphere display Solid Spheres Size%
Atom
Display The value of the Size% slider on the Atom Display
tab tab represents a percentage of the Covalent radius
Administrator

specified for each atom in the Elements Table. This


percentage ranges from 0 (small) to 100 (large).
Show solid
spheres by Thus, when the Atom Size is 100, the atoms are
default scaled to their maximum radii. The value of this
setting affects Ball and Stick and Cylindrical Bond
models.

Displaying Dot Surfaces


You can add dot surfaces to any of the model
display types like the stick model shown below:

To change the display of solid spheres in a model: Figure 3-3: Viewing dot surfaces

From the Model Display submenu of the View


menu, select or deselect Show Atom Dots.

Setting Solid Sphere Size


The maximum radius of the sphere that represents
an atom can be based on the Van der Waals (VDW)
Radius or Partial Charge. To specify which property
to use, select the radio button below the slider.

The VDW Radius is specified using the atom type


of the atom.
The dot surface is based on VDW radius or Partial
The Partial Charge is the result of a calculation:
Charges as set in the Atom Display table of the
Extended Hckel, MOPAC, or Gaussian. If you
Model Settings dialog box.
have not performed a calculation, the partial charge
for each atom is shown as 0, and the model will
To display dot surfaces by default on all atoms:
display as a Stick model. If you have performed
more than one calculation, you can specify the
1. In the Chem 3D Model Settings dialog box,
calculation to use from the Choose Result submenu
click the Atom Display tab.
on the Calculations menu.
2. In the Dot Surfaces area, click the Show By
When sizing by partial charge, the absolute value of Default checkbox.
the charge is used. An atom with a partial charge of
0.500 will have the same radius as an atom with a All atoms currently in the model window display
partial charge of -0.500. the selected option.

78 Displaying Models CambridgeSoft


You can vary the number of dots displayed in a 4. Close and Save the table.
surface by using the density slider. This is useful
when dot surfaces are applied to a very small or very NOTE: You must save the changes before they take
large models. effect.

To change the display of dot surfaces in a model:


Coloring by Group
From the Model Display submenu of the View
menu, select or deselect Show Atom Dots. You may assign different colors to substructures
(groups) in the model.
Coloring Displays To change a color associated with a group in the
You can change the default for the way colors are active model:
used to display your model in the Model Display tab
1. In the Model Explorer, Right-click on the group
of the Model Settings control panel. To make a
name and choose Select Color.
temporary change, use the Color By... command on
the Model Display submenu of the View menu. The The Color dialog box appears.
choices are: 2. Select the color to use and click OK.

Monochrome 3. Save the changes to the Model.

Partial Charge
Coloring by Partial Charge
Chain
When coloring by partial charge, atoms with a
Element highly negative partial charge are deep blue. Atoms
Group with a highly positive partial charge are deep red. As
Depth the partial charge gets closer to 0, the atom is paler.
Atoms with a 0 partial charge are white.
Two of the choices, Monochrome and Chain, are
only available for proteins displayed in the Ribbon The Partial Charge is the result of a calculation
or Cartoon mode. Extended Hckel, MOPAC, or Gaussian. If you
have not performed a calculation, the partial charge
Coloring by Element for each atom is 0. If you have performed more
Color by element is the usual default mode for small than one calculation, you can specify the calculation
to use in the Choose Result submenu of the
molecules. The default colors are stored in the
Calculations menu.
Elements Table.
Figure 3-4: Color by partial charge
To change the color of elements specified in the
Elements table:
1. From the View menu, point to Parameter
Tables, and choose Elements.
The Elements Table opens.
2. Double-click the Color field for an element.
The Color dialog box appears.
3. Select the color to use and click OK.

Chem & BioOffice 2006 /Chem3D Displaying Models 79


Coloring by depth for Chromatek stereo To toggle the effect on or off:
viewers
From the Model Display submenu of the View
Chem3D supports color by depth for menu, choose Red&Blue.
Chromadepth stereo viewers. When you select
Administrator

Color by Depth, the model is colored so that objects


nearer the viewer are toward the red end, and
Depth Fading3D enhancement:
objects further from the viewer toward the blue
The depth fading feature in Chem3D creates a
end, of the spectrum. This creates a stereo effect
when viewed with a Chromadepth stereo viewer. realistic depth effect, by making parts of the model
The effect is best viewed with a dark background. If further from the viewer fade into the background.
Depth shading is activated by selecting the Depth
you use the Chromatek icon on the Model
Fading checkbox on the Stereo and Depth tab of the
Display toolbar to activate this viewing option, Model Settings dialog box, by selecting Depth
rather than the Color By Depth setting, the Fading from the Model Display submenu of the
background color is set automatically to black. View menu, or by clicking the Depth fading icon
To set Color by Depth, do one of the following: on the Toolbar.
Select the Color by Depth radio button on the
Colors and Fonts tab of the Model Settings Perspective Rendering
dialog box.
Use the Color By option of the Model Display Chem3D supports true perspective rendering of
submenu on the View menu. models. This results in a more realistic depiction of
the model, with bond lengths and atom sizes
Red-blue Anaglyphs further from the viewer being scaled consistently.
Chem3D supports viewing with red-blue 3D The field of view slider adjusts the perspective
glasses to create a stereo effect similar to that of the effect. Moving the slider to the right increases the
Chromatek viewer. effect.

To activate red-blue viewing: Figure 3-6: Depth fading settings

1. From the Stereo and Depth tab of the Model


Settings dialog box, select Render Red/Blue
Anaglyphs.
2. Move the Eye Separation slider to adjust the
effect.
Depth Fading,
Figure 3-5: The eye separation slider Perspective, &
field of view slider

80 Displaying Models CambridgeSoft


CAUTION Coloring Individual Atoms
Moving the slider all the way to the left may make the You can mark atoms individually using the Select
model disappear completely. Color command in the Model Explorer.

To change an atom to a new solid color:


Coloring the Background 1. In the Model Explorer, select the atom(s) to
Window change.
2. From the context menu, choose Select Color.
Chem3D allows you to select a color for the
The Color dialog box appears.
background of your models. A black or dark blue
background can be particularly striking for ribbon 3. Select a color and Click OK.
displays intended for full color viewing, whereas a The color of the atom(s) changes to the new
light background is more suitable for print copy. color.
To change the default background color of the To remove a custom atom color from the model
model window: display:

1. In the Colors and Fonts tab of the Model 1. In the Model Explorer, select the atoms whose
Settings control panel, click Background Color. colors you want to change.

Figure 3-7: Background color settings 2. Right-click, point to Apply Atom Color and
choose Inherit Atom Color.
The custom colors are removed from the
selected atoms.

Displaying Atom Labels


Background
color You can control the appearance of element symbols
and serial numbers using the Atom Labels tab in the
Model Settings control panel, and the
corresponding commands in the Model Display
submenu of the View menu.

Setting Default Atom Label Display


Options
The Color dialog box appears.
To set the Element Symbols and Serial Numbers
2. Select a color and click OK. defaults:
1. On the Colors and Fonts tab of the Model
NOTE: The background colors are not saved in PostScript Settings dialog box, select the font, point size
files or used when printing, except when you use the Ribbons and color.
display.
2. Click the Set as Default button.

Chem & BioOffice 2006 /Chem3D Displaying Models 81


All atoms currently in the model window Figure 5: Residue labels
display the selected options.
To toggle the Atom Labels or Serial Numbers at any
time, do one of the following:
Administrator

From the Model Display submenu of the View


menu, choose Show Atom Labels or Show Serial
Numbers.

Click the Atom Label or Serial Numbers


icon on the Model Display Toolbar.

Displaying Labels Atom by Atom


To display element symbols or serial numbers in
Displaying Measurements
individual atoms: You can now display measurements in the model
1. In the Model Explorer, select the atom to view. By default, a measurement will display if you
change. add a single measurement from the Measurements
submenu of the Structure menu, but not if you
2. On the context menu, point to Atom Serial generate a set of measurements. You can select
Number or Atom Symbol and choose Show... which measurements to display by opening the
Measurements Window wide to show the Display
Displaying Group Labels checkboxes.
You can display residue labels in protein structures. Figure 6: Measurements window
The global setting for the model can be changed
with the new Residue button on the Model Display
toolbar. A more granular control is available with
the Group Labels command on the context menus
in the Model Explorer.
Figure 4: Setting Group Labels Figure 3-8: Measurement display

82 Displaying Models CambridgeSoft


Using Stereo Pairs 2. Select Render Stereo Pairs to display two views
of the model next to each other.
Stereo Pairs is a display enhancement technique The right view is the same as the left view,
based on the optical principles of the Stereoscope, rotated about the Y-axis.
the late-Nineteenth century device for 3D viewing
3. Specify the Eye Separation (Stereo Offset) with
of photographs. By displaying two images with a
the slider. This controls the amount of Y-axis
slight displacement, a 3D effect is created.
rotation.
Stereo views can be either Parallel or Reverse (direct 4. Specify the degree of separation by clicking the
or cross-eyed). Some people find it easier to look Separation arrows.
directly, others can cross their eyes and focus on About 5% of the width is a typical separation
two images, creating an enhanced three dimensional for stereo viewing.
effect. In either case, the effect may be easier to
To select whether the views are cross-eyed or direct,
achieve on a printed stereo view of your model than
do one of the following:
on the screen. Keep the images relatively small, and
adjust the distance from your eyes. Select Reverse to rotate the right frame to the
left. If your left eye focuses on the right-hand
To set the Stereo Pairs parameters: model and your right eye focuses on the
left-hand model, the two stereo views can
1. Open the Model Settings dialog box, and overlap.
click the Stereo and Depth tab.
Select Parallel to rotate the right view further to
The stereo views control panel appears. the right.
Figure 3-9: Setting stereo viewing
Using Hardware Stereo
Graphic Enhancement
Chem3D 9.0 provides stereo graphics rendering for
hardware that has stereo OpenGL capabilities.
There are now a variety of stereo graphics cards,
stereo glasses, and 3D monitors that can be driven
by Chem3D. Hardware enhancement is enabled
from the OpenGL tab in the Chem3D Preferences
dialog, which you can access from the File menu.

Chem & BioOffice 2006 /Chem3D Displaying Models 83


Figure 3-10: Setting hardware OpenGL settings Figure 3-11: Setting eye separation
Administrator

Hardware
Stereo

Any 3D window opened after this mode is enabled


will utilize hardware graphics capabilities if they are
available and enabled. Molecular Surface
Displays
NOTE: You must enable stereo in OpenGL in the Molecular Surface displays provide information
display adapter properties control, as well as in Chem3D about entire molecules, as opposed to the atom and
preferences, and select the correct mode for the glasses/monitor bond information provided by Structure displays.
you are using. Surfaces show information about a molecules
physical and chemical properties. They display
aspects of the external surface interface or electron
You can use depth fading and perspective with distribution of a molecule.
hardware enhancement, but should not activate
other stereo modes. Unlike atom and bond data, Molecular Surface
information applies to the entire molecule. Before
any molecular surface can be displayed, the data
TIP: The Eye Separation slider on the Stereo and necessary to describe the surface must be calculated
Depth tab of the Model Settings dialog box can be used to using Extended Hckel or one of the methods
control separation. You should select the Disabled radio available in CS MOPAC or Gaussian. Under
button when using hardware stereo. MOPAC you must choose Molecular Surfaces as
one of the properties to be calculated.

84 Displaying Models CambridgeSoft


Molecular Surface Displays
There is one exception to the requirement that you Displaying Molecular
must perform a calculation before a molecular
surface can be displayed. Solvent Accessible
Surfaces
surfaces are automatically calculated from
To display a surface:
parameters stored in the Chem3D parameters
tables. Therefore, no additional calculations are 1. Decide what surface type to display.
needed, and the Solvent Accessible command on the
Choose Surface submenu is always active. 2. Perform a suitable calculation using Extended
Hckel, CS MOPAC, or Gaussian 03. Include
Extended Hckel the Molecular Surfaces property calculation
whenever it is available.
Extended Hckel is a semi-empirical method that
can be used to generate molecular surfaces rapidly NOTE: CS MOPAC and Gaussian
for most molecular models. For this reason, a brief 03 surfaces calculations are only available in Chem3D
discussion of how to perform an Extended Hckel Ultra.
calculation is given here.
Different calculation types can provide
To compute molecular surfaces using the Extended different results. If you have performed more
Hckel method: than one calculation on a model, for example,
both an Extended Hckel and an AM1
From the Computations menu, point to
calculation, you must choose which calculation
Extended Hckel, and choose Calculate
to use when generating the surface.
Surfaces.
3. From the Calculations menu, point to Choose
NOTE: Before doing an Extended Hckel calculation, Result and select one of your calculations.
Chem3D will delete all lone pairs and dummy atoms. You 4. From the Surfaces menu point to Choose
will see a message to this effect in the Output window. Surface, and select one of the surface types.

At this point, a calculation has been performed and NOTE: The Choose Surface commands are toggle
the results of the calculation are stored with the switchesclick once to display, click again to turn off the
model. display. You can display more than one surface at a
time. When a surface is displayed, its icon is
To compute partial charges using the Extended highlighted.
Hckel method:
Figure 3-12: Displayed surface
From the Computations menu, point to
Extended Hckel, and choose Calculate
Charges.

For each atom in the model, a message is created


listing the atom and its partial charge. If you have
selected Partial Charge in the Pop-up Information tab
of the Model Settings dialog box, then the partial
charges will appear as part of the pop-up
information when you point to an atom. Displayed surface

Chem & BioOffice 2006 /Chem3D Displaying Models 85


Molecular Surface Displays
5. Adjust the display using the surface display
tools. Surface Extended MOPAC Gaussian
Type Hckel
TIP: If you are making a lot of adjustments to the
Administrator

display, activate the Surfaces toolbar and tear off the with Molec- Yes Yes Yes
specific tools you will be using often. ular Orbital
map
For a review of the surface display tools, see The
Surfaces Toolbar on page 41. with Spin No Yes Yes
Density
Not all surfaces can be displayed from all map
calculations. For example, a Molecular Electrostatic
Potential surface may be displayed only following a
with Partial Yes Yes Yes
Gaussian or MOPAC calculation. If a surface is
Charges
unavailable, the command is grayed out in the
submenu.
with Molec- No Yes Yes
To generate surfaces from MOPAC or Gaussian, ular Electro-
you must choose Molecular Surfaces as one of the static Poten-
properties calculated by these programs. The tial map
surface types and the calculations necessary to
display them are summarized in the following table. Total Spin No Yes Yes
Density
NOTE: Spin Density map requires that MOPAC or
Gaussian computations be performed with an open shell Molecular No Yes Yes
wavefunction. Electro-
static
Potential

Surface Extended MOPAC Gaussian Molecular Yes Yes Yes


Type Hckel Orbitals
a.
Calculated automatically from parameters
Solvent NA NA NA stored in the Chem3D parameters tables.
Accessiblea This surface is always available with no
further calculation.
Connolly Yes Yes Yes
Molecular
Setting Molecular Surface Types
Total Yes Yes Yes
Charge Chem3D offers four different types of surface
Density displays, each with its own properties. These types
are shown in the following table:

86 Displaying Models CambridgeSoft


Molecular Surface Displays
Surface Type Description
Surface Type Description
Translucent The surface is
Solid The surface is displayed in solid
displayed as an opaque form, but is partially
form. Solid is a good transparent so you can
choice when you are also see the atoms and
interested in the details bonds within it.
of the surface itself, Translucent is a good
and not particularly compromise between
interested in the surface display styles.
underlying atoms and
bonds. Setting Molecular Surface Isovalues
Wire Mesh The surface is Isovalues are, by definition, constant values used to
displayed as a generate a surface. For each surface property, values
connected net of lines. can be calculated throughout space. For example,
Wire Mesh is a good the electrostatic potential is very high near each
choice when you want atom of a molecule, and vanishingly small far away
to focus on surface from it. Chem3D generates a surface by connecting
features, but still have all the points in space that have the same value, the
some idea of the atoms isovalue. Weather maps are a common example of
and bonds in the the same procedure in two dimensions, connecting
structure. locations of equal temperature (isotherms) or equal
pressure (isobars).
Dots The surface is
displayed as a series of To set the isovalue:
unconnected dots.
1. From the Surfaces menu, choose Isocontour.
Dots are a good choice
if you are primarily NOTE: The exact name of this command reflects the
interested in the type of isovalue in each window. For example, for Total
underlying structure Charge Density Surfaces, it is Isocharge.
and just want to get an
idea of the surface The Isocontour slider appears.
shape. Figure 3-13: Setting surface contour

2. Adjust the slider to the new isovalue.


The new isovalue is the middle value listed at
the bottom of the Isocontour tool.

Chem & BioOffice 2006 /Chem3D Displaying Models 87


Molecular Surface Displays
Setting the Surface Resolution Setting Solvent Radius
The Surface Resolution is a measure of how The Solvent Radius can be set from 0.1 to 10
smooth the surface appears. The higher the using the slider. The default solvent radius is 1.4 ,
resolution, the more points are used to calculate the which is the value for water. Radii for some
Administrator

surface, and the smoother the surface appears. common solvents are shown in the following table:
However, high resolution values can also take a long
time to calculate. The default setting of 30 is a good
compromise between speed and smoothness. Solvent Radius ()
To set the resolution:
Water 1.4
1. From the Surfaces menu, choose Resolution.
The Resolution slider appears. Methanol 1.9
Figure 3-14: Setting surface resolution
Ethanol 2.2

Acetonitrile 2.3

2. Adjust the slider to the desired resolution. Acetone 2.4


The new resolution is the middle value listed at
the bottom of the Resolution tool. Ether 2.4
Setting Molecular Surface Colors
Pyridine 2.4
How you set the color depends on what type of
surface you are working with.
DMSO 2.5
For Solvent Accessible, Connolly Molecular, or
Total Charge Density surfaces, do the following: Benzene 2.6
1. On the Surfaces menu, choose Surface Color.
The Surface Color dialog box appears. Chloroform 2.7
2. Select the new color.
To set the solvent radius:
3. Click OK.
1. From the Surfaces menu, choose Solvent
For the other surface types, where you must specify Radius.
two colors, do the following.
The Radius slider appears.
1. On the Surfaces menu, choose Alpha Color or
Figure 3-15: Setting the surface radius
Beta Color.
The Alpha or Beta Color dialog box appears.
2. Select the new color.
3. Click OK.

88 Displaying Models CambridgeSoft


Molecular Surface Displays
2. Adjust the slider to the desired resolution.
Amino Acid Hydrophobicity
The new radius is the middle value listed at the
bottom of the Radius tool. Cys 2.0

Setting Surface Mapping Trp 1.9


The Mapping Property provides color-coded Ala 1.6
visualization of Atom Colors, Group Colors,
Hydrophobicity, Partial Charges, or Electrostatic Thr 1.2
Potential (derived from partial charges)
superimposed upon the solvent-accessible surface. Gly 1.0

Surface Color is color you have chosen with the Ser 0.6 Middle (White)
Surface Color tool. Atom Color is based on the Pro 0.2
displayed atom colors, which may or may not be the
default element colors. Element Color is based on Tyr 0.7
the default colors in the Elements Table. Group
Color is based on the colors (if any) you specified His 3.0
in the Model Explorer when creating groups.
Gln 4.1
Hydrophobicity is displayed according to a
widely-used color convention derived from amino Asn 4.8
acid hydrophobicities1, where the most Glu 8.2
hydrophobic (lipophilic) is red and the least
hydrophobic (lipophobic) is blue. The following Lys 8.8
table shows molecule hydrophobicity.
Asp 9.2
Amino Acid Hydrophobicity Arg 12.3 Least hydrophobic (Blue)

Phe 3.7 Most hydrophobic (Red) The Partial Charges and Electrostatic Potential
(derived from the partial charges) properties are
Met 3.4
taken from the currently selected calculation. If you
Ile 3.1 have performed more than one calculation on the
model, you can specify which calculation to use
Leu 2.8 from the Choose Result submenu of the
Val 2.6 Calculations menu.
1. Engelman, D.M.; Steitz, T.A.; Goldman,
A., Identifying nonpolar transbilayer Partial Surfaces
helices in amino acid sequences of
membrane proteins, Annu. Rev. Bio- Scientists who study protein-ligand interactions are
phys. Biophys. Chem. 15, 321-353, often interested in generating a molecular surface of
1986. a protein that does not include ligand. Chem3D can

Chem & BioOffice 2006 /Chem3D Displaying Models 89


Molecular Surface Displays
now generate partial Solvent Accessible and Solvent atoms are excluded by default, but may be
Conolly surfaces, either by excluding ligands, or by included with the checkbox. Hidden atoms (usually
excluding selected parts of the model, or both. hydrogens) may also be included or excluded.
To generate a partial surface: Figure 9: Partial surface excluding solvent atoms
Administrator

1. Click Advanced Molecular Surfaces on the


Surfaces menu.
Figure 7: Surfaces menu

After displaying a surface, you can set surface


transparency and reflectivity with the controls in
the middle of the dialog box. (These controls are
grayed out until a surface is displayed.) You can
color the surface by atom, element, or group color,
or by group hydrophobicity, in addition to
monochromatic surfaces of any color.
Figure 10: Setting surface transparency

2. Select the surface type and what you want to


include and exclude in the Advanced Molec-
ular Surfaces dialog box.
Figure 8: Generating a partial surface
You can also restrict the surface either by distance
Set surface type
from the selected group, or by flooding.

Use selected or
unselected atoms
for the surface.
Include/exclude hidden atoms
Include/exclude ligand

90 Displaying Models CambridgeSoft


Molecular Surface Displays
Figure 11: Restricted surface with ligand excluded Figure 3-16: van der Waals surfaces
Solvent accessible surface
van der Waals surface

Solvent probe

Connolly Molecular Surface


Solvent Accessible Surface
The Connolly surface, also called the molecular
The solvent accessible surface represents the surface, is similar to the solvent-accessible surface.
portion of the molecule that solvent molecules can Using a small spherical probe to simulate a solvent,
access. When viewed in the ball and stick it is defined as the surface made by the center of the
representation, a molecule may appear to have solvent sphere as it contacts the van der Waals
many nooks and crannies, but often these features surface. The volume enclosed by the Connolly
are too small to affect the overall behavior of the surface is called the solvent-excluded volume.
molecule. For example, in a ball-and-stick These surfaces are shown in the following
representation, it might appear that a water illustration.
molecule could fit through the big space in the
center of a benzene molecule. The solvent Figure 3-17: Connolly or solvent-excluded surface
accessible surface (which has no central hole) shows
that it cannot. The size and shape of the solvent
accessible surface depends on the particular
solvent, since a larger solvent molecule will
predictably enjoy less access to the crevices and
interstices of a solute molecule than a smaller one.

To determine the solvent-accessible surface, a small


probe sphere simulating the solvent molecule is
rolled over the surface of the molecule (van der
Waals surface). The solvent-accessible surface is
defined as the locus described by the center of the The Connolly Surface of icrn is shown in
probe sphere, as shown in the diagram below. Figure 3-18.

Chem & BioOffice 2006 /Chem3D Displaying Models 91


Molecular Surface Displays
Figure 3-18: Conolly surface of icrn Total Spin Density
The total spin density surface describes the
difference in densities between spin-up and
Administrator

spin-down electrons in any given region of a


molecules space. The larger the difference in a
given region, the more that region approximates an
unpaired electron. The relative predominance of
spin-up or spin-down electrons in regions of the
total spin density surface can be visualized by color
when total spin density is mapped onto another
surface (total charge density). Entirely spin-up
(positive value) electrons are red, entirely
Total Charge Density spin-down (negative) blue, and paired electrons
(neutral) are white.
The Total Charge Density is the electron density in
the space surrounding the nuclei of a molecule, or The total spin density surface is used to examine the
the probability of finding electrons in the space unpaired electrons of a molecule. The surface exists
around a molecule. The default isocharge value of
only where unpaired electrons are present. Viewing
0.002 atomic units (a.u.) approximates the
the total spin density surface requires that both Spin
molecules van der Waals radius and represents
Density and Molecular Surfaces are calculated by
about 95% of the entire three-dimensional space
MOPAC or Gaussian using an Open Shell
occupied by the molecule.
Wavefunction.
The Total Charge Density surface is the best visible
representation of a molecules shape, as determined Molecular Electro-
by its electronic distribution. The Total Charge static Potential
Density surface is calculated from scratch for each
molecule. The Total Charge Density is generally The molecular electrostatic potential (MEP)
more accurate than the Space Filling display.
represents the attraction or repulsion between a
molecule and a proton. Attraction is represented by
For Total Charge Density surfaces, the properties
negative values and repulsion is indicated by
available for mapping are Molecular Orbital, Spin
positive values. Experimental MEP values can be
Density, Electrostatic Potential, and Partial
obtained by X-ray diffraction or electron diffraction
Charges. The color scale uses red for the highest
magnitude and blue for the lowest magnitude of the techniques, and provide insight into which regions
property. Neutral is white. of a molecule are more susceptible to electrophilic
or nucleophilic attack. You can visualize the relative
You can choose the orbital to map onto the surface MEP values by color when MEP is mapped onto
with the Molecular Orbital tool on the Surfaces another surface (total charge density). The most
menu. The orbital number appears in parentheses positive MEP value is red, the most negative blue,
in the HOMO/LUMO submenu. and neutral is white.

92 Displaying Models CambridgeSoft


Molecular Surface Displays
Molecular Orbitals specified for a previously computed surface. If you
have not specified an isocontour value, the default
Molecular orbital (MO) surfaces visually represent value is 0.01.
the various stable electron distributions of a
molecule. According to frontier orbital theory, the NOTE: The default isocontour value for an MO surface
shapes and symmetries of the highest-occupied and imported from a cube file is 0.01 regardless of any previously
lowest-unoccupied molecular orbitals (HOMO and set isocontour value.
LUMO) are crucial in predicting the reactivity of a
species and the stereochemical and regiochemical
outcome of a chemical reaction.
Visualizing Surfaces
from Other Sources
To set the molecular orbital being displayed:
You can use files from sources other than Chem3D
From the Surfaces menu, point to Molecular to visualize surfaces. From Windows sources, you
Orbital to see the HOMO/LUMO options. can open a Gaussian Formatted Checkpoint (.fchk)
Select the orbital. or Cube (.cub) file.
From sources other than Windows, create a
You can specify the isocontour value for any
Gaussian Cube file, which you can open in
computed MO surface using the Isocontour tool on
Chem3D.
the Surfaces menu. The default isocontour value
for a newly computed surface is the value you last

Chem & BioOffice 2006 /Chem3D Displaying Models 93


Visualizing Surfaces from Other Sources
Administrator

94 Displaying Models CambridgeSoft


Visualizing Surfaces from Other Sources
Chapter 4: Building and Editing
Models
Overview Intelligent mode yields a chemically reasonable 3D
model as you build. Fast mode provides a quick way
Chem3D enables you to build or change a model by to generate a backbone structure. You can then turn
three principal methods: it into a chemically reasonable 3D model by using
the Structure menu Rectify and Clean Up tools.
Using the ChemDraw panel, which utilizes
ChemDraw to build and insert or copy and edit To change the Building mode:
models.
1. From the File menu, choose Model Settings.
Using Bond tools, which build using carbon
exclusively. The Model Settings dialog box appears.
Using the Build from Text tool (hereafter 2. Select the Model Building tab.
referred to as the Text tool), which allows you
Figure 4-1: The Model Building controls
to build or edit models using atom labels and
substructures.
Usually, a combination of methods yields the best
results. For example, you might build a carbon
skeleton of a model with ChemDraw or the bond
tools, then change some of the carbons into other
elements with the Text tool. Or you can build a
model exclusively using the Text tool.

In addition, you can use Structure tools to change


bond lengths and angles, or to change
stereochemistry.

Setting the Model


Building Controls
You control how you build by changing options in
the Building control panel in the Model Settings
dialog box. The default mode is all options selected.
You can choose to build in a faster mode, with less
built-in chemical intelligence, by turning off one 3. Select or deselect the appropriate radio
or more of the options. buttons.

Chem & BioOffice 2006 /Chem3D Building and Editing Models 95


Setting the Model Building Controls
The following table describes the Model Build
controls NOTE: For more information about atom types, standard
measurements, and rectification, see Model Building
Basics on page 44.
Control Description
Administrator

Correct Atom Determines whether atom types Building with the Chem-
Types are assigned to each atom as you Draw Panel
build. Atom types, such as C
Alkane specify the valence, Chem3D 10 makes it easier than ever to create or
bond lengths, bond angles, and edit models in ChemDraw. The ChemDraw panel is
geometry for the atom. activated from the View menu. Using ActiveX
technology, it puts the functionality of ChemDraw
Rectify Determines whether the open Pro at your fingertips.
valences for an atom are filled,
To add a new structure to Chem3D:
usually with hydrogen atoms.
1. Open the ChemDraw Panel by selecting it from
Apply Standard Determines whether the stan- the View menu.
Measurements dard measurements associated The ChemDraw panel appears on the right of
with an atom type are applied as the model window.
you build. 2. Click in the panel to activate it.
The Tools palette appears.
Fit Model to Determines whether the entire
Window model is resized and centered in TIP: If you dont see the Tools palette, right-click in
the model window after a the ChemDraw panel, and check the View menu to see
change to the model is made. that it has been activated. There should be a check
mark next to Show Main Tools. While you are at it,
Detect Conju- When selected, all bonds in a you might want to activate other toolbars. Activating the
gated System conjugated system are set at a General tools toolbar, for example, will give you access
bond order of 1.5. When unse- to undo/redo commands.
lected, bonds are displayed as
drawn. Does not affect previ- 3. Build the structure.
ously drawn structures. The model appears simultaneously in both the
ChemDraw and Chem3D model windows.
Bond Proxi- Determines whether a bond is
mate Addition created between a selection of Unsynchronized Mode
(%) atoms. For more information By default, the ChemDraw panel works in
see Creating Bonds by Bond synchronized mode. In this mode, your model
Proximate Addition on page appears simultaneously in the ChemDraw panel
106. and in Chem3D. Editing either model changes the
other automatically. This affords maximum editing
flexibility.

96 Building and Editing Models CambridgeSoft


Building with the ChemDraw Panel
To turn off synchronized mode: The standard measurements are applied to the
structure. For more information see
Click the Synch button at the top left of the Appendix D: 2D to 3D Conversion.
ChemDraw panel. The button toggles synchro-
nization on and off. NOTE: You cannot paste from ISIS/Draw into the
ChemDraw panel, only into the Chem3D model
To copy a model to Chem3D, click either the window. You can, however use the synchronize control to
Add or Replace icon. add the model to the ChemDraw panel.

Name=Struct You can also cut-and-paste, or drag-and-drop,


models to and from ChemDraw to Chem3D or the
The ChemDraw panel has a Name=Struct window ChemDraw panel. See Copying to Other
that allows you to build models by entering a Applications on page 154 for more information on
chemical name or SMILES string. You can also pasting into other applications.
copy names or SMILES strings from other
Non-bond or atom objects copied to the clipboard
documents and paste them, either into the
(arrows, orbitals, curves) are ignored by Chem3D.
Name=Struct window, or directly into the Chem3D Superatoms in ISIS/Draw are expanded if
model window. Chem3D finds a corresponding substructure. If a
corresponding structure is not found, you must
TIP: You can also paste chemical formulas into the define a substructure. For more information see
Chem3D model window. Be aware, however, that a formula Defining Substructures on page 212.
may not represent a unique structure, and the results may not
be correct. Building With the Bond
Tools
Building with Other 2D Use the bond tools to create the backbone structure
Programs of simple models. Bond tools always create bonds
that terminate with carbon atoms. Hydrogens
You can use other 2D drawing packages, such as display automatically by default. You can hide them
ISIS/Draw to create chemical structures then copy to reduce clutter. You can change the carbons or
them into Chem3D for automatic conversion to a hydrogens to other elements after you create the
3D model. generic model.

To build a model with 2D drawings: To create a model using a Bond tool:

1. Choose a bond tool. The Single Bond tool is


1. In the source program, copy the structure to
used in this example.
the clipboard.
2. Point in the model window, and drag in the
2. In Chem3D, from the Edit menu, choose direction you want the bond to be oriented.
Paste.
3. Release the mouse button to complete the
The 2D structure is converted to a 3D model. bond.

Chem & BioOffice 2006 /Chem3D Building and Editing Models 97


Building With the Bond Tools
When Correct Atom Types and Rectify settings ignored in all computations. An uncoordinated
are selected in the Building control panel, the bond allows you to specify a connection between
atom type is set according to the bond tool two atoms without a strict definition of the type of
used (C Alkane in this example) and the bond. This bond is often used in coordination
Administrator

appropriate number of hydrogens are added. complexes for inorganic compounds, where
another element might be substituted.
To add bonds to the model:
4. Point to an atom and drag in the direction you Dummy atoms are also useful for positioning atoms
want to create another atom. in a Z-matrix, perhaps for export to another
Figure 4-1: Adding bonds to a model
application for further analysis. This is a common
use when models become large and connectivities
are difficult to specify.

To add an uncoordinated bond and dummy atom:

1. Select the Uncoordinated Bond tool .


1. Click and hold the 2. Drag in any direction and 2. Point to an atom and drag from the atom.
mouse button on an atom release the mouse button
An uncoordinated bond and a dummy atom
When the Rectify option is set in the Building are added to the model. The atom created is
control panel, the hydrogen is replaced by a labeled Du, the Chem3D element symbol
carbon. for Dummy atoms.
Figure 4-2: Viewing a model with Rectify on
Figure 4-3: Dummy atoms

Dummy atom

5. Repeat adding bonds until you have the model


you want.
After you have the backbone, you can change Removing Bonds and Atoms
the carbons to different heteroatoms. When you remove bonds and atoms:
Creating Uncoordinated Click a bond to remove only that bond.
Bonds Click an atom to remove the atom and all
attached bonds.
Use the Uncoordinated Bond tool to create an
uncoordinated bond with a dummy atom (labeled To remove an atom or bond, do one of the
Du). Uncoordinated Bonds and dummy atoms are following:

98 Building and Editing Models CambridgeSoft


Building With the Bond Tools
If you double click an atom, the contents of the
Click the Eraser tool and click the atom
previous text box are applied to that atom. If
or bond. the atom is one of several selected atoms, then
Select the atom or bond, and from the Edit the contents of the previous text box are
menu, choose Clear. applied to all of the selected atoms.
Select the atom or bond and press Delete. If a tool other than the Text tool is selected,
double-clicking in the model window is equiv-
NOTE: If automatic rectification is on, you will not be able alent to clicking with the Text tool selected.
to delete hydrogen atoms. Turn rectification off when editing Triple-clicking in the model window is equiva-
a model. lent to double-clicking with the Text tool
selected.
Building With The Text The interpretation of the text in a text box depends
on whether atoms are selected as follows:
Tool
If the model window is empty, a model is built
The Text tool allows you to enter text that using the text.
represents elements, atom types (elements with If you have one or more atoms selected, the
specific hybridization), substructures, formal text is added to the model at that selection if
charges, and serial numbers. The text you enter possible. If the specifications for a selected
must be found in either the Elements, Atom Types, atom are violated, the connection cannot be
or Substructures tables. The match must be exact, made.
including correct capitalization. These tables can be
found in the Parameter Tables list on the View If you have a model in the window, but do not
menu. have anything selected, a second fragment is
added, but is not connected to the model.
NOTE: For all discussions below, all the Building control When a text box is visible, you can modify the
panel options in the Chem 3D Model Settings dialog box are selection by Shift+clicking or Shift-dragging
assumed to be turned on. across atoms.

Some general rules about using the Text Tool are as Using Labels
follows:
To use an element symbol in a text box:
Text is case sensitive. For example, the correct
1. Select the Text tool.
way to specify a chlorine atom is Cl. The
correct way to specify the phenyl group 2. Click in the model window.
substructure is to type Ph. PH or ph will not be A text box appears.
recognized.
3. Type C.
Pressing the Enter key applies the text to the
4. Press the Enter key.
model.
Typing a formal charge directly after an A model of methane appears.
element symbol will set the formal charge for The atom type is automatically assigned as a
that atom. For example PhO- will create a C Alkane, and the appropriate number of
model of a phenoxide ion instead of phenol. hydrogens are automatically added.

Chem & BioOffice 2006 /Chem3D Building and Editing Models 99


Building With The Text Tool
To use the same text to add another methyl group: The Table Editor
1. Point to the atom you want to replace, in this To use the Table Editor to enter text in a text box:
example a hydrogen, and click.
1. From the View menu, point to Parameter
Administrator

The text box appears with the previous label. Tables, and choose Atom Types.
2. Press the Enter key.
2. Select the element or atom type in the table.
To add a different element: 3. From the Edit menu, choose Copy.

1. Click a hydrogen atom. 4. Double-click in the Chem3D Model Window.

A text box appears over the atom. 5. In Chem3D, from the Edit menu, choose
Paste.
2. Type N.
The copied text appears in the text box.
3. Press the Enter key.
A nitrogen is added to form ethylamine. Specifying Order of Attachment
To build ethylamine in one step: In both the simple and complex forms for using the
Text tool, you can specify the order of attachment
1. Click in the model window. and repeating units by numbers and parentheses.
A text box appears. For example:
2. Type CH3CH2NH.
Type (CH3)3CNH2 into a text box with no
3. Press the Enter key. atoms selected and press the Enter key.
A model of ethylamine appears. A model of tert-butylamine appears.

Changing atom types Using Substructures


You can use a text box to change the atom type and You can use pre-defined functional groups called
bonding characteristics. substructures to build models. Some advantages for
To change the atom type of some atoms: using substructures in your model building process
are as follows:
1. Click a carbon atom.
Substructures are energy minimized.
A text box appears.
Substructures have more than one attachment
2. Shift+click the other carbon atom. atom (bonding atom) pre-configured.
Both atoms are selected. For example, the substructure Ph for the
3. Type C Alkene. phenyl group has a single attachment point.
The substructure COO for the carboxyl group
4. Press the Enter key.
has attachment points at both the Carboxyl
The atom type and the bond order are changed carbon and the Alcohol Oxygen. These
to reflect the new model of ethyleneamine. You provide for insertion of this group within a
can point at the atoms and bonds to display this model. Similar multi-bonding sites are defined
new information. for all amino acid and other polymer units.

100 Building and Editing Models CambridgeSoft


Building With The Text Tool
Amino Acid substructures come in both alpha The substructure appears in the model
(indicated by the amino acid name alone) and window.
beta (indicated by a - preceding the name of
the amino acid) forms. The dihedral angles When you replace an atom or atoms with a
have been preset for building alpha helix and substructure, the atoms which were bonded to the
beta sheet forms. replaced atoms are bonded to the attachment
points of the substructure. The attachment points
You can use substructures alone or in combi- left by the replaced atoms are also ordered by serial
nation with single elements or atom types. number.
Using a substructure automatically creates a
record in the Groups table that you can use for Example 1. Building Ethane with
easy selection of groups, or coloring by group. Substructures
Substructures are particularly useful for
building polymers. To build a model of ethane using a substructure:
You can define your own substructures and 1. Type Et or EtH into a text box with no atoms
add them to the substructures table, or create selected.
additional tables. For more information, see
Defining Substructures on page 212. 2. Press the Enter key.

To view the available substructures: A model of ethane appears.


From the View menu, point to Parameter Figure 4-4: Ethane model
Tables, and choose Substructures.

Building with Substructures


You must know where the attachment points are
for each substructure to get meaningful structures
using this method. Pre-defined substructures have
attachment points as defined by standard chemistry
conventions. For more information see
Attachment point rules on page 211.
To use a substructure as an independent fragment,
make sure there are no atoms selected.
To insert a substructure into a model, select the
atoms which are bonded to the attachment points
of the substructure.
NOTE: When automatic rectification is on, the free valence
To build a model using a substructure: in the ethyl group is filled with a hydrogen. If automatic
1. Type the name of the substructure into a text
rectification is off, you need to type EtH to get the same result.
box (or copy and paste it from the For substructures with more than one atom with an open
Substructures table). valence, explicitly specify terminal atoms for each open
valence.
2. Press the Enter key.

Chem & BioOffice 2006 /Chem3D Building and Editing Models 101
Building With The Text Tool
Example 2. Building a Model with a The alpha form of the neutral polypeptide
Substructure and Several Other chain composed of Alanine, Glycine, and
Elements Phenylalanine appears.

NOTE: You can use the amino acid names preceded


Administrator

To build a model with substructures and other


with a to obtain the beta conformation, for example
elements:
HAlaGlyPheOH. To generate the
character, type Alt+0223 using the number pad
1. Type PrNH2 into a text box with no atoms
[Option+s.
selected.
2. Press the Enter key. The appropriate bonding and dihedral angles
for each amino acid are pre-configured in the
A model of propylamine appears. substructure.
The appropriate bonding site for the Pr Figure 4-6: HAlaGlyPheOH polypeptide model
substructure is used for bonding to the
additional elements NH2.
Figure 4-5: Propylamine model

Example 3. Polypeptides TIP: To better view the alpha helix formation, use the
Trackball Tool to reorient the model to an end-on view. For
Use substructures for building polymers, such as more information see Trackball Tool on page 120.
proteins:
To change the polypeptide to a zwitterion:
1. Type HAlaGlyPheOH into a text box with no
atoms selected. 1. Select the Text tool.
2. Click the terminal nitrogen.
The additional H and OH cap the ends of the
polypeptide. If you dont cap the ends and A text box appears over the nitrogen atom.
automatic rectification is on, Chem3D tries to 3. Type + and press the Enter key.
fill the open valences, possibly by closing a The charge is applied to the nitrogen atom. Its
ring. atom type changes and a hydrogen atom is
2. Press the Enter key. added.

Ring closing bonds appear whenever the text in 4. Click the terminal oxygen.
a text box contains two or more open valences. A text box appears over the oxygen atom.

102 Building and Editing Models CambridgeSoft


Building With The Text Tool
5. Type - in the text box and press the Enter key. 4. Press the Enter key.
The charge is applied to the oxygen atom. Its The substructure replaces the selected atom.
atom type changes and a hydrogen atom is
removed. For example, to change benzene to biphenyl:
For amino acids that repeat, put parentheses around 1. Click the atom to replace.
the repeating unit plus a number rather than type A text box appears.
the amino acid repeatedly. For example, type
HAla(Pro)10GlyOH. Figure 4-8: Changing a model with the text box

Example 4. Other Polymers


The formation of a PET (polyethylene
terephthalate) polymer with 4 units (a.k.a.: Dacron,
Terylene, Mylar) ia shown below:
Type OH(PET)4H into a text box with no atoms
selected and press the Enter key.
The H and OH are added to cap the ends of
the polymer.
Figure 4-7: PET model 2. Type Ph.
3. Press the Enter key.
Figure 4-9: Biphenyl model

Replacing an Atom with a


Substructure
The substructure you use must have the same
number of attachment points as the atom you are
replacing. For example, if you try to replace a
carbon in the middle of a chain with an Ethyl
substructure, an error occurs because the ethyl
group has only one open valence and the selected
carbon has two.
To replace an individual atom with a substructure:
Building From Tables
1. Click the Text tool.
Cartesian Coordinate tables and Z-Matrix tables
2. Click the atom to replace.
can be saved as text files or in Excel worksheets.
A text box appears. (See Z-matrix on page 48 and Cartesian
3. Type the name of the substructure to add Coordinates on page 49 for more information.)
(case-sensitive). Likewise, tables from text files or worksheets can be

Chem & BioOffice 2006 /Chem3D Building and Editing Models 103
Building From Tables
copied into blank tables in Chem3D to create C-0.4956 0.57820.0037
models. Text tables can use spaces or tabs between
C0.4956 -0.57820.0037
columns.
H0.0552 1.55570.0037
For a Cartesian table, there must be four columns
Administrator

(not including the Serial Number column) or five H-1.1517 0.52520.9233


columns (if the Serial Number column is included.) H-1.1569 0.5248-0.9233
The relative order of the the X-Y-Z columns must
H-0.0552 -1.55570.0037
be preserved; otherwise column order is not
important. H1.1517 -0.52520.9233

For a Z-Matrix table, there must be seven columns H1.1569 -0.5248-


(not including Serial Number column) or eight 0.9233
columns (if the Serial Number column is included.) -----------------------
The column order must NOT be changed.
Example 3: ethenol Z-Matrix table (tab as
To copy a Cartesian or Z-Matrix table into separator)
Chem3D:
C
1. Select the table in the text or Excel file.
C1 1.33
2. Use Ctrl+C to transfer to the clipboard.
O2 1.321 119.73
3. Right-click in a blank table in Chem3D and
H3 0.9782 109 1 180
select Paste.
H2 0.991 119 3 180
Examples H1 0.9892 119.5 3 180
Example 1: chloroethane Cartesian table H1 0.9882 119 3 0
(space character as separator)

C 0 -0.464725 0.336544 0.003670


Changing an Atom to
C 0 0.458798 -0.874491 0.003670
Another Element
Cl 0 0.504272 1.818951 0.003670 To change an atom from one element to another:
H 0 -1.116930 0.311844 0.927304 1. Click the Text tool.
H 0 -1.122113 0.311648 -0.927304 2. Click the atom to change.

H 0 -0.146866 -1.818951 0.003670 A text box appears.


H 0 1.116883 -0.859095 0.923326 3. Type the symbol for the element you want
(case-sensitive).
H 0 1.122113 -0.858973 -0.923295
4. Press the Enter key.
-------------------------
As long as the Text tool is selected, you can double-
Example 2: ethane Cartesian table (tab as separator) click other atoms to make the same change.

104 Building and Editing Models CambridgeSoft


Changing an Atom to Another Element
For example, to change benzene to pyridine: To change more than one atom:

1. Click the atom to replace and type NH2. 1. Use Shift+click to select the atoms to change.

Figure 4-10: Making multiple changes with the text 2. Type the name of the atom type (case sensi-
box tive).
3. Press the Enter key.
For many atom types that change bond order, you
must select all atoms attached to the bond so that
the correct bond forms.
For example, to change ethane to ethene:
1. Select both carbons.
2. Type C Alkene.
2. Press the Enter key. 3. Press the Enter key.

Figure 4-11: Pyridine model


Changing Bonds
To change the bond order of a bond you can use the
bond tools, commands, or the Text tool.
You can change the bond order in the following
ways:
One bond at a time.
Several bonds at once.
By changing the atoms types on the bond.

To change the bond order with the bond tool:


1. Select a bond tool (of a different order).

Changing an Atom to 2. Drag from one atom to another to change.

Another Atom Type To change the bond order using a command:


1. Select a bond.
To change a single atom:
2. From the context menu, point to Set Bond
1. Click the Text tool. Order, and choose a bond order.
2. Click the atom to change.
To change the bond order by changing the atom
A text box appears. type of the atoms on either end of the bond:
3. Type the name of the atom type (case sensi- 1. Click the Text tool.
tive).
2. Shift+click all the atoms that are attached to
4. Press the Enter key. bonds whose order you want to change.

Chem & BioOffice 2006 /Chem3D Building and Editing Models 105
Changing Bonds
3. Type the atom type to which you want to Pairs of atoms whose distance from each other is
change the selected atoms. less than the standard bond length, plus a certain
4. Press the Enter key.
percentage, are considered proximate. The lower
the percentage value, the closer the atoms have to
The bond orders of the bonds change to reflect
Administrator

be to the standard bond length to be considered


the new atom types. proximate. Standard bond lengths are stored in the
Bond Stretching Parameters table.
To change several bonds at once:

1. Open the ChemDraw panel and click in it to


To set the percentage value:
activate the ChemDraw control. 1. From the File menu, choose Model Settings.
2. Choose either selection tool, Lasso or
The Chem 3D Model Settings dialog box
Marquee.
appears.
3. Click the first bond to be changed, then use
2. Select the Model Build tab.
Shift+Click to select the others.
3. Use the Bond Proximate Addition% arrows
4. Right-click in the selected area, and choose the
to adjust the percentage added to the standard
bond type.
bond length when Chem3D assesses the prox-
Figure 4-12: Using a context menu to change bonds imity of atom pairs.
You can adjust the value from 0 to 100%. If the
value is zero, then two atoms are considered
proximate only if the distance between them is
no greater than the standard bond length of a
bond connecting them. For example, if the
value is 50, then two atoms are considered
proximate if the distance between them is no
greater than 50% more than the standard
length of a bond connecting them.

To create bonds between proximate atoms:


5. Click in the Chem3D window to complete the 1. Select the atoms that you want tested for bond
action. proximity.
2. From the context menu, point to Bond(s) and
Creating Bonds by Bond
choose Proximate.
Proximate Addition
If they are proximate, a bond is created.
Atoms that are within a certain distance (the bond
proximate distance) from one another can be Adding Fragments
automatically bonded.
A model can be composed of several fragments.
Chem3D determines whether two atoms are
proximate based on their Cartesian coordinates and If you are using bond tools, begin building in a
the standard bond length measurement. corner of the window.

106 Building and Editing Models CambridgeSoft


Adding Fragments
If you are using the Text tool: To change the view focus to include only those
atoms and bonds you are working on:
1. Click in an empty area of the window.
1. Select the fragment or set of atoms or bonds.
A text box appears.
2. Click Set Focus to Selection on the View Focus
2. Type in the name of an element, atom type, or submenu of the View menu.
substructure.
Once you have set the view focus, the following
3. Press the Enter key. things happen:
The fragment appears. When building with the bond tools, Chem3D
will resize and reposition the view so that all of
For example, to add water molecules to a window
the atoms in the view focus are visible.
containing a model of formaldehyde:
As new atoms are added, they become part of
1. Click the Text tool. the view focus.
2. Click in the approximate location you want a When rotating, or resizing the view manually,
water molecule to appear. the rotation or resize will be centered around
the view focus.
A text box appears.
3. Type H2O. Setting Measurements
4. Press the Enter key. You can set the following measurements using the
The fragment appears. Measurements submenu of the Structure menu:

5. Double-click in a different location to add Bond lengths


another H2O molecule. Bond angles
Figure 4-13: H2O model Dihedral angles
Close contacts

NOTE: When you choose Measurement from the Structure


menu, the display of the Set Measurement option will vary,
depending on what you have selected. The grayed-out option
says Set Measurement; when you select a bond, it says Set
Bond Length, etc.
View Focus
When you use the Clean Up Structure command,
As models become large, keeping track of the the bond length and bond angle values are
section you are working on becomes more difficult. overridden by the standard measurements from the
With version 9.0.1, Chem3D adds the notion of Optimal column of the Measurement table. These
view focus, defined as the set of atoms that the optimal values are the standard measurements in
user is interested in working on. By default, the view the Bond Stretching and Angle Bending parameter
focus includes all of the atoms in the model. tables. For all other measurements, performing a

Chem & BioOffice 2006 /Chem3D Building and Editing Models 107
Setting Measurements
Clean Up Structure or MM2 computation alters Setting Non-Bonded
these values. To use values you set in these
computations, you must apply a constraint.
Distances (Atom Pairs)

Setting Bond Lengths To set the distance between two non-bonded atoms
Administrator

(an atom pair):


To set the length of a bond between two bonded
atoms: 1. Select two unbonded atoms.

2. From the Structure menu, point to Measure-


1. Select two adjacent atoms.
ment and choose Set Distance Measurement.
2. From the Structure menu, point to Measure-
ment and choose Set Bond Length Measurement. The Measurements table appears, displaying
the distance. The Actual value is highlighted.
The Measurements table appears, displaying
distance between the two atoms. The Actual 3. Edit the highlighted text.
value is highlighted.
4. Press the Enter key.
3. Edit the highlighted text.
4. Press the Enter key. Atom Movement When
Setting Bond Angles Setting Measurements

To set a bond angle: When you change the value of a measurement, the
last atom selected moves. Chem3D determines
1. Select three contiguous atoms for a bond angle. which other atoms in the same fragment also move
2. From the Structure menu, point to Measure- by repositioning the atoms that are attached to the
ment and choose Set Bond Angle Measurement. moving atom and excluding the atoms that are
attached to the other selected atoms.
The Measurements table appears, displaying
the angle value. The Actual value is highlighted. If all of the atoms in a measurement are within a
3. Edit the highlighted text. ring, the set of moving atoms is generated as
follows:
4. Press the Enter key.
Only one selected end atom that describes the
Setting Dihedral Angles measurement moves while other atoms
describing the measurement remain in the
To set a dihedral angle: same position.
1. Select four contiguous atoms. If you are setting a bond length or the distance
2. From the Structure menu, point to Measure- between two atoms, all atoms bonded to the
ment and choose Set Dihedral Measurement. non-moving selected atom do not move. This
The Measurements table appears, displaying set of non-moving atoms is extended through
the angle value. The Actual value is highlighted. all bonds. From among the remaining atoms,
any atoms which are bonded to the moving
3. Edit the highlighted text. atom move; this set of moving atoms is also
4. Press the Enter key. extended through all bonds.

108 Building and Editing Models CambridgeSoft


Setting Measurements
If the Automatically Rectify check box in the In the case of dihedral angles and non-bonded
Building control panel is selected, rectification distances, a constraint will have the effect of
atoms that are positioned relative to an atom keeping that measurement constant (or nearly so)
that moves may also be repositioned. while the remainder of the model is changed by the
computation. The constraint doesnt remove the
For example, consider the structure in Figure 4-14:
atoms from a computation.
Figure 4-14: Cyclopentylmethanol model
Setting Charges
Atoms are assigned a formal charge based on the
atom type parameter for that atom and its bonding.
You can display the charge by pointing to the atom.
To set the formal charge of an atom:
1. Click the Text tool.
2. Select the atom or atoms to change.
3. Type + or - followed by the number of the
formal charge.
4. Press the Enter key.
If you set the bond angle C(1)-C(2)-C(3) to 108 To set the formal charge of an atom in a molecular
degrees, C(3) becomes the end moving atom. C(1) fragment as you build you can add the charge after
and C(2) remain stationary. H(11) and H(12) move the element in the text as you build.
because they are not part of the ring but are bonded
To add the charge:
to the moving atom. If the Automatically Rectify
check box is selected, H(10) may move because it is 1. Type PhO- into a text box with no atoms
a rectification atom and is positioned relative to selected.
C(3). 2. Press the Enter key.

Setting Constraints The phenoxide ion molecule appears.


To remove the formal charge from an atom:
You can override the standard measurements which
Chem3D uses to position atoms by setting 1. Click the Text tool.
constraints. Constraints can be used to set an 2. Select the atom or atoms whose formal charge
optimal value for a particular bond length, bond you want to remove.
angle, dihedral angle, or non-bonded distance,
3. Type +0.
which is then applied instead of the standard
measurement when you use Clean Up Structure or 4. Press the Enter key.
perform a Docking, Overlay, or MM2 computation.
Setting Serial Numbers
To set constraints:
Atoms are assigned serial numbers when they are
Enter a new value for the constraint in the created. You can view the serial numbers in the
Optimal field of the Measurements table. following ways:

Chem & BioOffice 2006 /Chem3D Building and Editing Models 109
Setting Charges
Point to the atom to display the pop-up infor- A text box appears.
mation. 4. Type the serial number.
From the Model Display submenu of the View 5. Press the Enter key.
menu, choose Show Serial Numbers.
Administrator

If the serial numbers of any unselected atoms


In the Chem 3D Model Settings dialog box, conflict with the new serial numbers, then those
choose the Atom Labels tab, then check the unselected atoms are renumbered also.
Show Serial Numbers checkbox.
To reserialize another atom with the next sequential
Click the Serial Number toggle on the number:
Model Display Toolbar. Double-click the next atom you want to reseri-
alize.
Serial numbers are initially assigned based on the
order in which you add atoms to your model. To reserialize several atoms at once:

To change the serial number of an atom: 1. Click the Text tool.


2. Hold down Shift and select several atoms.
1. If you are using the Model Explorer, select the
atoms you want to re-number, and select Hide 3. Type the starting serial number.
Atom Serial Number from the Atom Serial 4. Press the Enter key.
Numbers submenu of the context menu.
Normally, the selected atoms are reserialized in the
Figure 4-15: Changing atom serial numbers with a order of their current serial numbers. However, the
context menu first four atoms selected are reserialized in the order
you selected them.

Changing Stereochem-
istry
You can alter the stereochemistry of your model by
inversion or reflection.

Inversion
The Invert command performs an inversion
symmetry operation about a selected chiral atom.
NOTE: The Model Explorer cannot update its
numbering to match the changes you are making on the To perform an inversion:
model when Serial Numbers are displayed. If you forget
1. Select the atom.
this step, you will see different numbers on the tree
control and the model. If this happens, simply hide the 2. From the Structure menu, choose Invert.
serial numbers momentarily and redisplay them. The Invert command only repositions side
chains extending from an atom.
2. Click the Text tool.
For example, if you choose Invert for the structure
3. Click the atom to reserialize. in Figure 4-16 when C(1) is selected:

110 Building and Editing Models CambridgeSoft


Changing Stereochemistry
Figure 4-16: Cyclohexylmethylamine model If the model contains any chiral centers, each of
these commands change the model into its
enantiomer. If this is done, all of the Pro-R
positioned atoms become Pro-S and all of the Pro-S
positioned atoms become Pro-R. All dihedral
angles used to position atoms are negated.

NOTE: Pro-R and Pro-S within Chem3D are not


The structure in Figure 4-17 is created. equivalent to the specifications R and S used in standard
chemistry terminology.
Figure 4-17: Inverted cyclohexylmethylamine model
For example, for the structure in Figure 4-18, when
any atom is selected:
From the Structure menu, point to Reflect
Model and choose Through X-Z Plane.
Figure 4-18: Reflecting through a plane

To invert several dihedral angles (such as all of the


dihedral angles in a ring) simultaneously:

1. Select the dihedral angles to invert.


2. From the Structure menu, choose Invert stere-
ochemistry.
Chem3D produces the enantiomer in Figure 4-19.
All of the dihedral angles that make up the ring
are negated. Atoms positioned axial to the ring Figure 4-19: Enantiomer produced by reflection
are repositioned equatorial. Atoms positioned
equatorial to the ring are repositioned axial.

Reflection
use the Reflect command to perform reflections on
your model through any of the specified planes.
When you choose the Reflect commands certain
Cartesian coordinates of each of the atoms are
negated. When you choose Reflect Through Y-Z Refining a Model
Plane, all of the X coordinates are negated. You can
choose Reflect Through X-Z Plane to negate all of the After building a 3D structure, you may need to
Y coordinates. Likewise, you can choose Reflect clean it up. For example, if your model was built
Through X-Y Plane to negate all of the Z coordinates. without automatic rectification, atom type
You can choose Invert through Origin to negate all of assignment, or standard measurements, you can
the Cartesian coordinates of the model. apply these as a refinement.

Chem & BioOffice 2006 /Chem3D Building and Editing Models 111
Refining a Model
Rectifying Atoms Cleaning Up a Model
To rectify the selected atoms in your model: Normally, Chem3D creates approximately correct
structures. However, it is possible to create
Administrator

From the Structure menu, choose Rectify. unrealistic structures, especially when you build
strained ring systems. To correct unrealistic bond
Hydrogen atoms are added and deleted so that lengths and bond angles use the Clean Up Structure
each selected atom is bonded to the correct command.
number of atoms as specified by the geometry
for its atom type. This command also assigns To clean up the selected atoms in a model:
atom types before rectification. From the Structure menu, choose Clean Up .
The atom types of the selected atoms are The selected atoms are repositioned to reduce
changed so that they are consistent with the errors in bond lengths and bond angles. Planar
bound-to orders and bound-to types of atoms are flattened and dihedral angles around
adjacent atoms. double bonds are rotated to 0 or 180 degrees.

112 Building and Editing Models CambridgeSoft


Refining a Model
Chapter 5: Manipulating Models
Overview Figure 5-1: The Model Explorer

Chem3D provides tools to manipulate the models


you create. You can show or hide atoms and select
groups to make them easier to manipulate.
Molecules can be rotated, aligned, and resized.

Selecting
Most operations require that the atoms and bonds
that are operated on be selected. Selected atoms and
bonds are highlighted in the model display. You can
change the default highlight color in the Model
Model Explorer tab
Settings dialog box.
Figure 1: The Model Settings dialog box
Colors and Fonts
tab

Set Highlight
Color

To select an atom using the Model Explorer:


1. Open the Model Explorer.
2. Select the atom in the Explorer.
The atom is selected in the model. Any
previously selected atoms or bonds are
deselected.
Selecting Single Atoms and To select an atom or bond in the display window:
Bonds 1. Click the Select tool .
You can select atoms and bonds in the model 2. Click the atom or bond.
window or by using the Model Explorer. If the Any previously selected atoms and bonds are
Model Explorer is not active, open it from the View deselected. When you click a bond, both atoms
menu. on the bond are selected.

Chem & BioOffice 2006 /Chem3D Manipulating Models 113


Selecting Multiple Atoms If Automatically Rectify is on when you deselect an
atom, adjacent rectification atoms and lone pairs are
and Bonds also deselected.
To select multiple individual atoms and bonds, do
Administrator

one of the following: NOTE: A rectification atom is an atom bonded to only one
other atom and whose atom type is the rectification type for
Shift+click atoms or bonds in the display that atom.
window to select them.
To deselect all atoms and bonds:
Ctrl+click atoms in the Model Explorer to
Click in an empty area of the Model window.
select them.
With the Model Explorer, you can use different
Shift+click atoms in the Model Explorer to selection highlight colors for different fragments or
select all atoms between (and including) the groups. To change the highlight color in the Model
two selected. Explorer:
Right-click at any level and choose Select Color.
NOTE: Selecting two adjacent atoms will also select
the bond between them. See Working With the Model Explorer on page
136 for information on other functions of the
Model Explorer.
To quickly select all atoms and bonds in a model:
Selecting Groups of Atoms
From the Edit menu, choose Select All.
and Bonds
NOTE: If the last action performed was typing in a text You can define groups of atoms (and fragments or
box, all of its text is selected instead of the atoms in the model. large models) and use the Model Explorer to select
the entire group. You can also select groups of
atoms without defining them as a group with the
Deselecting Atoms and selection rectangle.
Bonds Using the Selection Rectangle
When you deselect an atom, you deselect all To select several atoms and bonds using the
adjacent bonds. When you deselect a bond, you Selection Rectangle:
deselect the atoms on either end if they are not also Drag diagonally across the atoms you want to
connected to another selected bond. select.
Figure 5-2
To deselect a selected atom or bond, do one of the
following:

Shift+click the atoms or bonds in the display


window.

Ctrl+click the atom in the Model Explorer.

114 Manipulating Models CambridgeSoft


Any atoms that fall at least partially within the Once colors are assigned in the Substructures table,
Selection Rectangle are selected when you release you can use them to apply color by group:
the mouse button. A bond is selected only if both
atoms connected by the bond are also selected. 1. From the File menu, choose Model Settings.
2. Select the Model Display control panel.
To keep previously selected atoms selected:
3. Select the Group radio button in the Color by
Hold down the Shift key while you make section.
another selection.
Each atom in your model appears in the color
If you hold down the Shift key and all of the specified for its group.
atoms within the Selection Rectangle are
already selected, then these atoms are
NOTE: Color by Group is only displayed when Ribbon or
deselected.
Cartoon display mode is selected.
Defining Groups
You can define a portion of your model as a group. Selecting a Group or Fragment
This provides a way to easily select and to highlight There are several ways to select a group or
part of a model (such as the active site of a protein) fragment. The simplest is to use the Model
for visual effect. Explorer, and select the fragment.
To define a group: Figure 5-3: Using the Model Explorer to select a frag-
ment
1. Select the atoms and bonds you want in the
group. Using the select tool, select the first
atom then use Shift+click to select the other
atoms and bonds. selects the entire chain

2. While still pointing at one of the selected


atoms, right-click and choose New Group from
the context menu.
If the groups in your model are substructures
defined in the Substructures table
(substructures.xml), you can assign standard colors
to them.

To assign (or change) a color: You may also select a single atom or bond and use
the Select Fragment command on the Edit menu.
1. From the View menu, point to Parameter tables
and select Substructures. NOTE: If you want to select more than one fragment, you
2. Double click in a cell in the Color field. must use the Model Explorer.
The Color dialog box appears.
After you have selected a single atom or bond, each
3. Select a color and click OK.
successive double-click will select the next higher
4. Close and Save the Substructures table. level of hierarchy.

Chem & BioOffice 2006 /Chem3D Manipulating Models 115


Figure 5-4: Selection hierarchy

Option Result
Administrator

Select Atoms Selects all atoms lying within


within Distance of the specified distance from
Selection any part of the current selec-
tion.

Select Groups Selects all groups that contain


within Distance of one or more atoms lying
Selection within the specified distance
from any part of the current
selection.

Selecting Atoms or Groups Select Atoms Selects all atoms lying within
within Radius of the specified distance of the
by Distance Selection Centroid centroid of the current selec-
You can select atoms or groups based on the tion.
distance or radius from a selected atom or group of
objects. This feature is useful, among other things, Select Groups Selects all groups that contain
for highlighting the binding site of a protein. within Radius of one or more atoms lying
Selection Centroid within the specified distance
To select atoms or groups by distance:
of the centroid of the current
1. Use the Model Explorer to select an atom or selection.
fragment.
2. Right-click the selected object. From the
context menu point to Select and click the NOTE: 1. Atoms or groups already selected are not
appropriate option: included.
2. The current selection will be un-selected unless
multiple selection is used. Hold the shift key down
to specify multiple selection.

Showing and Hiding


Atoms
You may want to view your models with different
atoms visible or not visible. You can temporarily
hide atoms using the Model Explorer. To hide
atoms or groups:

116 Manipulating Models CambridgeSoft


Showing and Hiding Atoms
Right-click at any level, point to Visibility and Hydrogen Bonding and
click Hide... (Atom Group, etc.).
Polar Hydrogen Display
Hidden atoms or groups are displayed in
parentheses in the tree control. Chem3D can now detect and display hydrogen
bonds in a model. You can also selectively display
By default, all levels in the hierarchy are set to only the polar hydrogen atoms in a model. Chem3D
inherit the settings of the level above, but you can recognizes the following hydrogen bond donor and
reset the default to hide a group but show individual acceptor groups:
atoms in it. To show an atom belonging to a hidden
group: Hydrogen Bond Donors:
*-N-H
Right-click on the atom in the tree control,
*-O-H
point to Visibility and choose Show.
Hydrogen Bond Acceptors:
Showing Hs and Lps All Oxygen atoms
Nitrogen atoms in delocalized systems
To show all hydrogen atoms and lone pairs in the
model: Chem3D uses a liberal set of criteria to judge
whether the geometry of the donor/acceptor pair
From the Model Display submenu of the View will form a hydrogen bond.
menu, choose Show H's and Lp's.
To display hydrogen bonds:
A check mark appears beside the command,
indicating that it has been selected. 1. On the View menu, point to Model Display,
then Hydrogen Bonds.
When Show Hs and Lps is not selected, hydrogen
atoms and lone pairs are automatically hidden. Figure 5-5: Displaying hydrogen bonds

Showing All Atoms


If you are working with a large model, it may be
difficult to keep track of everything you have
hidden. To show all atoms or groups that are
hidden: 2. Select which bonds you want to view.

1. Select a level in the tree control above the TIP: You can also set the Model Settings dialog box
hidden atoms or groups, or Shift+click to to display hydrogen bonds.
select the entire model.
2. From the context menu point to Select and
Hydrogen bonds are represented as dashed lines
click Select All Children. between the donor hydrogen and the acceptor
atom. Bonds with less than ideal geometry are
3. Right-click again, point to Show... and choose displayed with a blue tint. The intensity of the color
Inherit Setting. increases as the bond becomes less ideal.

Chem & BioOffice 2006 /Chem3D Manipulating Models 117


Showing and Hiding Atoms
Figure 5-6: Hydrogen bonds in MM2 optimized water
Moving Atoms or Models
Use the Move Objects tool to move atoms and
other objects to different locations. If the atom,
Administrator

group of atoms, bond, or group of bonds that you


want to move are already selected, then all of the
selected atoms move. Using the Move Objects tool
changes the view relative to the model coordinates.
The following examples use the visualization axes
to demonstrate the difference between different
types of moving. To move an atom to a different
location on the X-Y plane:
.i.Displaying: hydrogens and lone pairs; 1. Click both the Model Axis and View Axis tools
to visualize the axes.
Chem3D 10 gives you more control over the display
of hydrogen atoms and lone pairs. There are NOTE: The axes will only appear if there is a model
separate controls for hydrogen atoms and lone in the window.
pairs, and you can choose to display only polar
hydrogens (those bonded to oxygen or nitrogen). 2. Drag with the single bond tool to create a
As with displaying hydrogen bonds, you control the model of ethane.
setting either from the View menu or the Model 3. Point to an atom using the Move Objects Tool.
Settings dialog box.
4. Drag the atom to a new location.
Figure 5-7: Setting hydrogen and lone-pair display
Figure 5-8: Moving an atom
1

Display/Hide
Hydrogen atoms

Display/Hide
Lone pairs

By default, Show Polar is selected when a


macromolecular PDB or mmCIF file is loaded.
These display modes are global options, but their
effect can be overridden by explicitly changing the
display mode of a particular atom or group in the
Model Explorer.

118 Manipulating Models CambridgeSoft


Moving Atoms or Models
Dragging moves atoms parallel to the X-Y Moving Models with the
plane, changing only their X- and
Y-coordinates.
Translate Tool
If Automatically Rectify is on, then the
Use the Translate tool to move a model in the
unselected rectification atoms that are adjacent
to selected atoms move with the selected view window. When you use the Translate tool, you
atoms. move both the focus view and the model
coordinates along with the model. Thus, the
To move a model: models position does not change relative to the
1. With the Move Objects tool, drag across the origin.
model select it.
Figure 5-10: Translating a model
2. Drag the model to the new location.
Figure 5-9: Moving a model
1

2
Rotating Models
Chem3D allows you to freely rotate the model
around axes. When you select the Trackball tool,
four pop-up rotation bars are displayed on the
periphery of the model window. You can use these
rotation bars to view your model from different
angles by rotating around different axes. You can
also open the Rotate dialog box where you can use
the rotate dial or type the number of degrees to
Note that the View axis has moved relative to the
rotate.
model coordinates.
To display the Rotation bars:

Select the Trackball tool from the Building


toolbar.

When you mouse over an edge of the model


window, the Rotation bars appear on the edges
of the Model window.

Chem & BioOffice 2006 /Chem3D Manipulating Models 119


Rotating Models
Figure 5-11: Rotating a model To rotate only one fragment:
Internal Rotation Bar Z-Axis Rotation Bar
1. Select an atom in the fragment you want to
rotate.
Administrator

2. Hold the Shift key while dragging a rotation


bar.
To rotate all fragments, drag a rotation bar.

Trackball Tool
Use the Trackball tool to freely rotate a model.
Starting anywhere in the model window, drag
the pointer in any direction
The Status bar displays the X and Y axis
Y-Axis Rotation Bar X-Axis Rotation Bar
rotation.
X- Y- or Z-Axis Rotations
Internal Rotations
To perform a rotation about the X-, Y-, or Z-axis:
Internal rotations alter a dihedral angle and create
1. Point to the appropriate Rotation bar. another conformation of your model. You can
If Show Mouse Rotation Zones is selected on the rotate an internal angle using the dihedral rotators
GUI tab of the Preferences dialog box, the on the Rotation Dial.
rotation bars will pop up. This is the default
setting. Using the Rotation Dial
NOTE: The rotation bars are active when the The Rotation Dial offers a quick method of rotating
Trackball tool is selected, even if they are hidden. a model or dihedral a chosen number of degrees
with reasonable accuracy. For more precision, you
2. Drag the pointer along the Rotation bar. can enter exact numbers into the degree display
The number of degrees of rotation appears in box. The Internal Rotation icons are only available
the Status bar. when atoms or bonds have been selected in the
model.
Rotating Fragments To perform internal rotations in a model, you must
If more than one model (fragment) is in the model select at least two atoms or one bond. You may then
window, you can rotate a single fragment or rotate either rotate the model around the bond axis, or
all fragments in the model window. rotate either end.

120 Manipulating Models CambridgeSoft


Rotating Models
Figure 5-12: The Rotation dial Figure 5-13: Rotating around a bond

To perform a rotation about the C-O bond where


the phenyl group moves:
degree display box
rotate around bond axis rotate fragment
1. Click the arrow next to the Trackball tool, and
drag the Rotation Dial onto the workspace.
2. Hold down the S key, and select the O atom.
3. Hold down the Shift and S keys, and select the
C1 atom.
NOTE: Using the Internal Rotation Bar (the one to the left
of the workspace) rotates the model around the selected bond 4. Click the left-hand dihedral rotator.
axis. Note that this is a change from earlier versions of 5. Drag the dial to rotate the phenyl group.
Chem3D, where the Internal Rotation Bar rotated the Figure 5-14: Selecting atoms for rotation around a
dihedral. bond

Internal rotation is typically specified by a bond.


The fragment at one end of the bond is stationary
while the fragment attached to the other end 1st selection 2nd selection
rotates. The order in which you select the atoms (Anchor)
determines which fragment rotates. (See the
following examples.)
For example, consider ethoxybenzene (phenetole):

faded fragment
is rotating

To perform a rotation about the C-O bond where


the ethyl group moves, do one of the following:
Click the right-hand dihedral rotator.
Reverse the order of selection: first select C1,
then O.

Chem & BioOffice 2006 /Chem3D Manipulating Models 121


Rotating Models
3. Drag the dial or enter a number in the text box.
TIP: To deselect the atoms, hold down the S key and
click anywhere in the model window. TIP: The keyboard shortcuts for dihedral rotation are
Shift+B and Shift+N.
Administrator

Rotating Around a Bond Figure 5-16: Rotating a dihedral angle


To rotate the model around a specific bond:

1. Select a bond.
2. Drag the pointer along the Internal Rotation
bar.

Rotating Around a Specific Axis


You can rotate your model around an axis you
specify by selecting any two atoms in your model.
You can add dummy atoms (see Creating
Uncoordinated Bonds on page 98) as fragments to
specify an axis around which to rotate. Figure 5-17: Using the Rotation dial

Figure 5-15: Rotating Around a Specific Axis

Dummy atom
Internal
Rotation

free rotation
bond
Axis of
Rotation
axis rotation
dihedral

To rotate the model around an axis: Changing Orientation


1. Select any two atoms. Chem3D allows you to change the orientation of
2. Drag the pointer along the Internal Rotation your model along a specific axis. However your
bar. model moves, the origin of the model (0, 0, 0) does
not change, and is always located in the center of
Rotating a Dihedral Angle the model window. To change the origin, see
Centering a Selection on page 124.
You can select a specific dihedral angle to rotate. To
rotate a dihedral:

1. Select four atoms that define the dihedral.


2. Select on of the dihedral rotators on the Rota-
tion Dial.

122 Manipulating Models CambridgeSoft


Changing Orientation
Aligning to an Axis Aligning to a Plane
To position your model parallel to either the You can align a model to a plane when you select
X-, Y-, or Z-axis: three or more atoms. When you select three atoms,
those atoms define a unique plane. If you select
1. Select two atoms only. more than three atoms, a plane is computed that
2. From the View menu, point to View Position, minimizes the average distance between the
then click Align View (choose an axis) With selected atoms and the plane.
Selection.
To position a plane in your model parallel to a plane
The model rotates so that the two atoms you
of the Cartesian Coordinate system:
select are parallel to the appropriate axis.
1. Select three or more atoms.
NOTE: This changes the view, not the coordinates of
the molecule. To change the model coordinates, use the 2. From the View menu, point to View Position,
Model Position submenu of the Structure menu. then click Align View (choose a plane) With
Selection.
For example, to see an end-on view of ethanol: The entire model rotates so that the computed
1. Click the Select tool. plane is parallel to the X-Y, Y-Z, or X-Z plane.
The center of the model remains in the center
2. Shift+click C(1) and C(2).
of the window.
Figure 5-18: Selecting atom for alignment
To move three atoms to a plane and two of the
atoms onto an axis:

1. Select the two atoms.


2. From the View menu, point to View Position,
then click Align View (choose an axis) With
Selection.
3. Shift+click the third atom.
4. From the View menu, point to View Position,
then click Align View (choose a plane) With
3. From the View menu, point to View Position, Selection.
then click Align View Z Axis With Selection.
For example, to move a cyclohexane chair so that
Figure 5-19: Ethane aligned on the Z-axis three alternating atoms are on the X-Y Plane:

1. Select two non-adjacent carbon atoms in the


ring, as shown in Figure 5-20 A.
2. From the View menu, point to View Position,
then click Align View X Axis With Selection.
The model moves to the position shown in
Figure 5-20 B.

Chem & BioOffice 2006 /Chem3D Manipulating Models 123


Changing Orientation
Figure 5-20: Aligning to the XY plane This command places the centroid of the selected
A B atoms at the coordinate origin. Chem3D calculates
the centroid of the selected atoms by averaging their
X, Y, and Z coordinates. If you do not select any
Administrator

atoms, the command operates on the entire model.

NOTE: This command affects all frames of your model, not


C just the active frame.

Using the Zoom Control


You can reduce or enlarge a model using the Zoom
tool.

3. Select the third carbon atom such that no two


NOTE: The Zoom tool lets you resize the
selected atoms in the ring are adjacent.
model by dragging.This changes the view, not the
4. From the View menu, point to View Position, coordinates of the molecule.
then click Align View X-Y Plane With Selection.
The model moves to the position shown in
Figure 5-20 C. Scaling a Model
Resizing Models You can scale a model to fit a window. If you have
created a movie of the model, you have a choice of
Chem3D provides the following ways to resize your scaling individual frames or the whole movie.
model:
To scale a model to the window size, do one of the
Resizing Windows
following:
Scaling a Model
From the View menu, point to View Position
Centering a Selection and click Fit To Window.

When resizing a model, or before doing From the View menu, point to View Position
computations, it is often useful to center the model. and choose Fit All Frames To Window to scale an
Chem3D allows you to select an atom (or atoms) to entire movie.
determine the center, or performs the calculation The Model To Window command operates only on
on the entire model. the active frame of a movie. To scale more than one
To center your model based on a particular frame, you must repeat the command for each
selection: frame you want to scale.

1. Select one or more atoms. (optional)


NOTE: The Fit command only affect the scale of the model.
2. Choose Center Model from the Model Position Atomic radii and interatomic distances do not change.
submenu of the Structure menu.

124 Manipulating Models CambridgeSoft


Resizing Models
Changing the Z-matrix Figure 5-21: Atoms in a Z-matrix

The relative position of each atom in your model is


determined by a set of internal coordinates known
as a Z-matrix. The internal coordinates for any
particular atom consist of measurements (bond
lengths, bond angles, and dihedral angles) between
it and other atoms. All but three of the atoms in
your structure (the first three atoms in the Z-matrix In the left example, the Second Positioned atom is
which describes your model) are positioned in a specified distance from the First Positioned atom.
terms of three previously positioned atoms. In addition, the placement of the Second
Positioned atom is specified by the angle between
To view the current Z-matrix of a model: the Origin atom, the First Positioned atom, and the
Second Positioned atom.
From the View menu choose Z-Matrix Table.
In the right example, the Second Positioned atom is
a specified distance from the Origin atom. In
The First Three Atoms in a addition, the placement of the Second Positioned
Z-matrix atom is specified by the angle between the First
Positioned atom, the Origin atom, and the Second
The first three atoms in a Z-matrix are defined as Positioned atom.
follows:
Atoms Positioned by Three
Origin atomThe first atom in a Z-matrix. Other Atoms
All other atoms in the model are positioned
(either directly or indirectly) in terms of this In the following set of illustrations, each atom D is
atom. positioned relative to three previously positioned
atoms C, B, and A. Three measurements are needed
First Positioned atomPositioned only in to position D: a distance, and two angles.
terms of the Origin atom. Its position is speci-
fied by a distance from the Origin atom. Atom C is the Distance-Defining atom; D is placed
Usually, the First Positioned atom is bonded to a specified distance from C. Atom B is the First
the Origin atom. Angle-Defining atom; D, C, and B describe an
angle.
Second Positioned atomPositioned in Atom A is the Second Angle-Defining atom. It is
terms of the Origin atom and the First Posi- used to position D in one of two ways:
tioned atom. There are two possible ways to
position the Second Positioned atom, as By a dihedral angle A-B-C-D
described in Figure 5-21. By a second angle A-C-D.

Chem & BioOffice 2006 /Chem3D Manipulating Models 125


Changing the Z-matrix
In Figure 5-22 A, atom D is positioned in terms of The most convenient way to visualize how the
a dihedral angle, thus the second angle is the Pro-R/Pro-S terms are used in Chem3D to
dihedral angle described by A-B-C-D. This dihedral position D is described in the following examples:
angle is the angle between the two planes defined by
Administrator

D-C-B and A-B-C. To position Atom D in Pro-S Orientation (Figure


5-24 A) and Pro-R Orientation (Figure 5-24 B):
In Figure 5-22 B, if you view down the C-B bond,
then the dihedral angle appears as the angle formed 1. Orient the Distance-Defining atom, C, the
by D-C-A. A clockwise rotation from atom D to First Angle-Defining atom, B, and the Second
atom A when C is in front of B indicates a positive Angle-Defining atom, A, such that the plane
which they define is parallel to the X-Y plane.
dihedral angle.
2. Orient the First Angle-Defining atom, B, to be
Figure 5-22: Positioning with a dihedral directly above the Distance-Defining atom, C,
A B
such that the bond joining B and C is parallel to
the Y-axis, and the Second Angle-Defining
atom, A, is somewhere to the left of C.

Figure 5-24: Pro-S and Pro-R orientation


A B

When D is positioned using two angles, there are


two possible positions in space about C for D to
occupy: a Pro-R position and a Pro-S position.

Figure 5-23: Positioning with two angles In this orientation, D is somewhere in front of the
plane defined by A, B and C if positioned Pro-R,
and somewhere behind the plane defined by A, B
and C if positioned Pro-S.

When you point to or click an atom, the


information box which appears can contain
information about how the atom is positioned.

Positioning Example
NOTE: The terms Pro-R and Pro-S used in Chem3D to
position atoms bear no relation to the Cahn-Ingold-Prelog If H(14) is positioned by C(5)-C(1), C(13) Pro-R,
R/S specification of the absolute stereochemical configuration then the position of H(14) is a specified distance
of a chiral atom. Pro-R and Pro-S refer only to the from C(5) as described by the H(14)-C(5) bond
positioning of D and do not imply any stereochemistry for C. length. Two bond angles, H(14)-C(5)-C(1), and
C may be chiral, or achiral. H(14)-C(5)-C(13), are also used to position the
atom.

126 Manipulating Models CambridgeSoft


Changing the Z-matrix
Because H(14) is positioned by two bond angles, For example, consider the structure in Figure 5-26.
there are two possible positions in space about C(5) Figure 5-26: Bicyclohexane model
for H(14) to occupy; the Pro-R designation
determines which of the two positions is used.
Figure 5-25: Positioning example

To position atom C(7) by two bond angles, select


atoms in the following order: C(5), C(1), C(6), C(7),
then choose Position by Bond Angles.

If an atom is positioned by a dihedral angle, the Positioning by Dihedral Angle


three atoms listed in the information about an atom
would all be connected by dashes, such as To position an atom relative to three previously
C(6)-C(3)-C(1), and there would be no Pro-R or positioned atoms using a bond distance, a bond
Pro-S designation. angle, and a dihedral angle:

The commands in the Set Z-Matrix submenu allow 1. With the Select tool, click the dihedral-angle
you to change the Z-matrix for your model using defining atom.
the concepts described previously. 2. Shift-click the first angle-defining atom.
Because current measurements are retained when 3. Shift-click the distance-defining atom.
you choose any of the commands in the Set Z- 4. Shift-click the atom to position.
Matrix submenu, no visible changes in the model You should now have four atoms selected, with
window occur. the atom to be positioned selected last.
5. From the Structure menu, point to Set
Positioning by Bond Angles Z-Matrix, then choose Position by Dihedral.
To position an atom relative to three previously For example, using the previous illustration, choose
positioned atoms using a bond distance and two atoms in the following order: C(7), C(6), C(1), C(10)
bond angles: to position C(10) by a dihedral angle in a ring. Then
choose Position by Dihedral.
1. With the Select tool, click the second
angle-defining atom. Setting Origin Atoms
2. Shift-click the first angle-defining atom.
To specify the origin atoms of the Z-matrix for a
3. Shift-click the distance-defining atom. model:
4. Shift-click the atom to position.
1. With the Select tool, click the first one, two, or
You should now have four atoms selected, with three atoms to start the Z-matrix.
the atom to be positioned selected last. 2. From the Structure menu, point to Set
5. From the Structure menu, point to Set Z-Matrix, then choose Set Origin Atom or Set
Z-Matrix, then choose Position by Bond Angles. Origin Atoms.

Chem & BioOffice 2006 /Chem3D Manipulating Models 127


Changing the Z-matrix
The selected atoms become the origin atoms
for the Z-matrix and all other atoms are
positioned relative to the new origin atoms.
Because current measurements are retained, no
Administrator

visible changes to the model occur.

128 Manipulating Models CambridgeSoft


Changing the Z-matrix
Chapter 6: Inspecting Models
Model Data Figure 6-1: Pop-up information

You can view information about an active model as


a pop-up or in measurement windows.

Pop-up Information
You can display information about atoms and
bonds by pointing to them so that pop-up
information appears. You specify what information
appears by using the Pop-up Info tab of the
Preferences dialog box.
You can display the following information about an
atom:
Cartesian coordinates
Atom type NOTE: Precise bond orders for delocalized pi systems
Internal coordinates (Z-matrix) are displayed if the MM2 Force Field has been
Measurements computed.
Bond Length The information about an atom or bond always
Bond Order begins with the name of that object, such as C(12)
Partial Charge for an atom or O(5)-P(3) for a bond.
Examples of pop-up information are shown in , To set what pop-up information appears:
Inspecting Models.
If you want to Then Select
display

The three numerical Cartesian Coordinates.


values indicating the
atoms position along
the X, Y, and Z axes

the atom type corre- Atom Type.


sponding to the first
column of a record in
the Atom Types table

Chem & BioOffice 2006 /Chem3D Inspecting Models 129


If you want to Then Select If you want to Then Select
display display
Administrator

a list of the atoms used Z-matrix. the bond orders calcu- Bond Order.
to position the atom lated by Minimize
NOTE: The Z-matrix Energy, Steric Energy, Bond orders are usually
definition includes or Molecular 1.000, 1.500, 2.000, or
whether the second Dynamics 3.000 depending on
angle used to position whether the bond is a
the selected atom is a single, delocalized,
dihedral angle or a double, or triple bond.
second bond angle. Computed bond orders
can be fractional.
If atoms other than the
one at which you are the partial charge Partial Charge.
pointing are selected, according to the
the currently selected See Displaying Molec-
calculation ular Surfaces on page
measurement formed by all 85 for information on
the selected atoms appears. how to select a calcula-
tion.
information relative to Measurements
other selected atoms, Non-Bonded Distances
such as the distance
between two atoms, To display non-bonded atoms measurements:
the angle formed by
three atoms, or the Select two non-bonded atoms and point to one
dihedral angle formed of them.
by four atoms.
The interatomic non-bonded distance appears in
the last line of the pop-up window.
the distance between Bond Length.
the atoms attached by a For example, in the cyclohexane model in Figure 6-
bond in angstroms 2, when you select two non-bonded atoms and
point to one of them, the interatomic non-bonded
distance appears in the last line of the pop-up
window.

130 Inspecting Models CambridgeSoft


Figure 6-2: viewing the interatomic non-bonded Figure 6-4: Measurements table
distance

bond
lengths
{
Measurement Table
Another way to view information about your model
bond
angles
{
is to activate the Measurement Table. This table can
display internal measurements between atoms in Editing Measurements
your model in various ways.
If you select a measurement in the Measurements
To display internal measurements:
table, the corresponding atoms are selected in the
1. From the View menu, click Measurement Table. model window. If you select atoms in your model,
A blank table appears in the Tables window. any corresponding measurements are selected.
2. From the Structure menu, point to Measure- To change the value of a measurement:
ments and select a measurement to display.
1. Select the text in the Actual column.
Figure 6-3: The Measurements submenu
2. Type a new measurement value in the selected
cell.
3. Press the Enter key
The model reflects the new measurement.
When atoms are deleted, any measurements that
The measurement values appear in the table. refer to them are removed from the Measurements
You can display several measurements sequentially table.
in the table. The following table shows the bond
lengths and angles for Ethene. Optimal Measurements
Optimal values are used instead of the
corresponding standard measurements when a
measurement is required in an operation such as
Clean Up Structure. Optimal measurements are
only used when the Measurements table is visible.
When the Measurements table is not visible, the
standard measurements are taken from the
parameter tables.

Chem & BioOffice 2006 /Chem3D Inspecting Models 131


Measurement Table
To specify optimal values for particular Example:
measurements, edit the value in the Optimal
To examine the Deviation from Plane for five
column.
atoms in a penicillin molecule:
Administrator

Chem3D also uses the optimal values with the 1. Build a penicillin model, as in the previous
Dock command. When you choose Dock from the example.
Structure menu, Chem3D reconciles the actual 2. Using the Select tool, click on the S (4) atom.
distance between atoms in two fragments to their 3. Shift+click the other atoms in the
optimal distances by rigidly moving one fragment five-membered penicillin ring.
relative to the other. The molecule should appear as follows:
Figure 6-6: Viewing Deviation from a Plane
Non-Bonded Distances in
Tables
To display non-bonded atom measurements:

1. Select the atoms.

2. From the Structure menu, point to Measure-


ments and choose Set Distance Measurement.

The measurement between the selected atoms


is added to the table.

Figure 6-5: Adding measurements to a table 4. From the Structure menu, choose Deviation
from Plane.
When the deviation from plane calculation is
complete, the value appears in the Output
window.
Figure 6-7: The Output window

The result indicates that the atoms in the five-


non-bonded distance
membered ring of penicillin are not totally coplanar;
there is a slight pucker to the ring.
Showing the Deviation from Plane
Removing Measurements from a Table
The Deviation from Plane command allows you to You can remove information from the
compute the RMS Deviation from the least squares Measurements table without affecting the model.
plane fitted to the selected atoms in the model. To remove measurements from a table:

132 Inspecting Models CambridgeSoft


Measurement Table
From the Structure menu, point to Measure- Figure 6-8: The Internal Coordinates table
ments and choose Clear.

Displaying the Coordinates


Tables
You can view the internal coordinates or the
Cartesian coordinates of your model by choosing
Cartesian Table or Z-Matrix Table from the View
menu.

Internal Coordinates
The Internal Coordinates table contains one entry
for each atom. The fields contain a description of
how each atom in the model is positioned relative to
the other atoms in the model.
The order of atoms in the Internal Coordinates
NOTE: The default condition is that all of the tables open
table is determined by the Z-matrix. The origin
in a tabbed window when you select any one.
atom is listed first, and the rest of the atoms are
listed in the order that they are positioned. For
more information see Scaling a Model on page When you select a record in the Internal
124. Coordinates table, the corresponding atom is
selected in the model. When you select atoms in the
To display the Internal Coordinates table: model, the corresponding records are selected in
the Internal Coordinates table.
1. From the View menu choose Z-Matrix Table.
The Internal Coordinates table appears. To edit measurements in the Z-matrix:

1. Type a new measurement in the selected cell.


2. Press the Enter key.

To change which atoms Chem3D uses to position


each atom use the commands in the Set Z-matrix
submenu in the Structure menu.

Cartesian Coordinates
The fields in the Cartesian Coordinates table
contain the atom name and the X-, Y- and Z-
coordinates for each atom. The order of atoms is
determined by their serial numbers. All of the atoms
in a fragment are listed in consecutive records.
Hydrogen, lone pair and dummy atoms are listed
after heavy atoms.

Chem & BioOffice 2006 /Chem3D Inspecting Models 133


Measurement Table
To display the Cartesian Coordinates table, do one Chem3D provides two overlay techniques.
of the following: Tutorial 6: Overlaying Models on page 63
describes the Fast Overlay method. This section
If the Tables window has been activated, click
uses the same examplesuperimposing a molecule
the XYZ tab at the bottom of the window.
Administrator

of Methamphetamine on a molecule of
If the Tables window has not been activated, Epinephrine (Adrenalin) to demonstrate their
choose Cartesian Table from the View menu. structural similaritiesto describe the
The Cartesian Coordinates table appears. Minimization Method.

The Cartesian Coordinates table acts like the other 1. From the File menu, choose New Model.
tables: you can select atoms or bonds either in the 2. Select the Text Building tool and click in the
table or in the model. Use the pin icon to collapse model window.
the window to save space. A text box appears.
Figure 6-9: Collapsed table tabs 3. Type Epinephrine and press the Enter key.
Collapsed table tabs A molecule of Epinephrine appears.
Mouse over a tab to display 4. Click in the model window, below the Epineph-
the table. The most recently used
table displays the full name.
rine molecule.
A text box appears.
5. Type Methamphetamine and press the Enter key.
A molecule of Methamphetamine appears
Comparing Models by beneath the Epinephrine molecule.
6. From the Model Display submenu of the View
Overlay menu, deselect Show Hs and Lps.
The Overlay submenu on the Structure menu is The hydrogen atoms and lone pairs in the
used to lay one fragment in a model window over a molecule are hidden.
second fragment. Each fragment remains rigid The two molecules should appear as shown in
during the overlay computation. the following illustration. You may need to
Common uses of Overlay include: move or rotate the models to display them as
shown.
Comparing structural similarities between
models with different composition. TIP: To move only one of the models, select an atom in
it before rotating.
Comparing conformations of the same model.

134 Inspecting Models CambridgeSoft


Comparing Models by Overlay
Figure 6-10: Overlaying models Your measurements table should look something
like this:
Figure 6-11: Adding optimal values for overlay to the
Measurements table

7. From the Model Display submenu of the View Now perform the overlay computation:
menu, select Show Atom Labels and Show Serial
Numbers. NOTE: To help see the two overlaid fragments, you
can color a fragment. For more information see
The atom labels and serial numbers appear for
Working With the Model Explorer on page 136
all the visible atoms.
To perform an overlay, you must first identify atom 1. From the Model Display submenu of the View
pairs by selecting an atom in each fragment, and menu, deselect Show Atom Labels and Show
then display the atom pairs in the Measurements Serial Numbers.
table.
2. From the Structure menu point to Overlay,
Atom Pair an atom in one fragment which has a and click Minimize.
distance specified to an atom in a second fragment. The Overlay dialog box appears.
1. Select C(9) in the Epinephrine molecule. Figure 6-12: The Overlay dialog box
2. Shift+click C(27) in the Methamphetamine
molecule.
3. From the Structure menu, point to Measure-
ments and choose Set Distance.
The Measurements table appears. The Actual
cell contains the current distance between the
two atoms listed in the Atom cell.
3. Type 0.100 for the Minimum RMS Error and
4. For an acceptable overlay, you must specify at 0.010 for the Minimum RMS Gradient.
least three atom pairs, although it can be done
The overlay computation will stop when either
with only two pairs. Repeat steps 1 to 3 to
the RMS Error becomes less than the
create at least three atom pairs.
Minimum RMS Error or the RMS Gradient
5. The optimal distances for overlaying two frag- becomes less than the Minimum RMS
ments are assumed to be zero for any atom pair Gradient value.
that appears in the Measurements table. For
4. Click Display Every Iteration.
each atom pair, type 0 into the Optimal column
and press the Enter key. 5. Click Start.

Chem & BioOffice 2006 /Chem3D Inspecting Models 135


Comparing Models by Overlay
How the fragments are moved at each iteration The default setting for all properties is Inherit
of the overlay computation is displayed. Setting. This means that parents determine the
properties of children, until you choose to change
To save the iterations as a movie, click the Record
a property. By changing some property of a lower
Each Iteration check box.
Administrator

level object, you can better visualize the part of the


To stop the overlay computation before it reaches model you want to study.
the preset minima, click Stop Calculation on Use the Model Explorer to:
the toolbar.
Define objects.
The Overlay operation stops. Recording is also
Add objects to groups.
stopped.
Rename objects.
The following illustration shows the distances
Delete objects, with or without their contents.
between atom pairs at the completion of the overlay
computation. The distances in the Actual cells are The display properties of objects you can alter
quite close to zero. include:
Changing the display mode.
Figure 6-13: Measurements table after overlay
Showing or hiding.
Changing the color.
At the atom level, you can display or hide:
Atom spheres
Atom dots
Element symbols
Your results may not exactly match those described. Serial numbers
The relative position of the two fragments or
molecules at the start of the computation can affect Model Explorer Objects
the final results.
The Model Explorer objects are:
Working With the Model Fragments
Explorer Chains
Groups
The Model Explorer displays a hierarchical tree
Atoms
representation of the model. It provides an easy way
to explore the structure of any model, even Bonds
complex macromolecules, and alter display Solvents
properties at any level. Backbone
The Model Explorer defines the model in terms of The Fragment object represents the highest level
objects. Every object has a set of properties, segment (parent) of a model. Fragments
including a property that defines whether or not it represent separate parts of the model, that is, if you
belongs to another object (is a child of a higher start at an atom in one fragment, you cannot trace
level parent object.) through a series of bonds that connect to an atom

136 Inspecting Models CambridgeSoft


Working With the Model Explorer
in another fragment. If you create a bond between virtual children of the Backbone object. This allows
two such atoms, Chem3D will collapse the you to select display properties for the backbone
hierarchical structure to create one fragment. that override the display properties of the chains
Fragment objects typically consist of chains and and groups above them in the hierarchy.
groups, but may also contain individual atoms and
bonds. To display the Model Explorer:

In Chem3D, chains and groups are functionally From the View menu choose Model Explorer.
identical. Chains are special groups found in PDB
files. If you rename a group as a chain, or vice versa, The Model Explorer window appears along the
the icon will change. This is also the reason that left side of the model.
only the work Group is used in the menus. All Figure 6-14: The Model Explorer
Group commands also apply to chains.

Group objects can consist of other groups, atoms


and bonds. Chem3D does not limit a group to
contiguous atoms and bonds, though this is the
logical definition.

Bond objects do not appear by default in the Model


Explorer. If you want to display bonds, select Show
Bonds in the GUI tab of the Chem3D Preferences
dialog box.

The Solvent object is a special group containing all


of the solvent molecules in the model. The
individual molecules appear as child groups
within the Solvent object. A Solvent object should
not be child of any other object.

NOTE: When importing PDB models, solvents will


sometimes show up in chains. While this is incorrect, To view or change a property in a model:
Chem3D preserves this structure in order to be able to save
the PDB file again. 1. Select the object (fragment, group, or atom)
you wish to change.
The Backbone object is a display feature that allows
you to show the carbon-nitrogen backbone TIP: To select multiple objects, use Shift+click if they
structure of a protein. It appears in the Model are contiguous or Ctrl+click if they are not.
Explorer as a separate object with no children. The
atoms and bonds that make up the backbone 2. Right-click, select the appropriate submenu,
belong to other chains and groups, but are also and choose a command.

Chem & BioOffice 2006 /Chem3D Inspecting Models 137


Working With the Model Explorer
Figure 6-15: Model Explorer context menus The group is created with the default name
selected.
3. Rename the group by typing a new name.
Administrator

Adding to Groups
You can add lower level objects to an existing
group, or combine groups to form new groups.
To add to a group:
1. Select the objects you want to combine, using
When you change an object property, the object either Shift+click (contiguous) or Ctrl+click
icon changes to green. When you hide an object, (non-contiguous).
the icon changes to red. Objects with default 2. Select Move Objects to Group from the context
properties have a blue icon. menu.
Figure 6-16: Icons in the Model Explorer 3. Rename the group, if necessary.

NOTE: The order of selection is important. The group


or chain you are adding to should be the last object
selected.

Pasting Substructures
hidden
changed You can cut-and-paste or copy-paste any
substructure into another structure, either within or
between model windows. In addition to the usual
methodsusing the Cut, Copy, and Paste
commands on either the Edit or Context-Sensitive
menus, or Ctrl+X, Ctrl+C, and Ctrl+Vyou can use
the Text tool to paste substructures.
Creating Groups To paste a substructure with the Text tool:
Some models, PDB proteins for example, have 1. Select a fragment, chain, or group.
group information incorporated in the file. For 2. Choose Replace with Text Tool from the context
other models you will need to define the groups. To menu.
do this in the Model Explorer:
The substructure appears in a Text tool in the
1. Holding down the Ctrl key, select the atoms in model window.
the group. 3. Click the Text tool on the atom that you want
2. Choose New Group from the context menu. to link to the substructure.

138 Inspecting Models CambridgeSoft


Working With the Model Explorer
Deleting Groups Coloring Groups
When deleting groups, you have two options: Another means of visualization is by assigning
different colors to groups. Changing a group color
If you want to Then Select in the Model Explorer overrides the standard color
settings in the Elements table and the Substructures
remove the grouping, Delete Group table.
but leave the model To change a group color:
intact
1. Select a group or groups.
delete the group from Delete Group and 2. Choose Select Color on the context menu.
the model Contents
The Color Dialog box appears.
3. Choose a color and click OK.
Using the Display Mode The Apply Group Color command is
One means of bringing out a particular part of a automatically selected.
model is by changing the display mode. The usual
To revert to the default color:
limitations apply (see Model Types on page 76).
The submenu will only display available modes. 1. Select a group or groups.
Figure 6-17 shows the effect of changing the 2. Right-click, point to Apply Group Color on the
HEM155 group of PDB-101M from Wireframe context menu and select Inherit Group Color.
(the default) to Space Filling.
The default group color is displayed.
Figure 6-17: Changing display types in the Model
Explorer Resetting Defaults
To remove changes, use the Reset All Children
command.

Animations
You can animate iterations from computations by
saving frames in a movie.You control the creation
and playback of movies from the Movie menu or
toolbar.

Creating and Playing


Movies
To display the Movie toolbar:
From the View menu, point to Toolbars and
choose Movies.
The Movie toolbar appears.

Chem & BioOffice 2006 /Chem3D Inspecting Models 139


Animations
To create a movie, select the Record Every Iteration Spin About Selected Axis
checkbox when you set up the calculation.
To spin the model around an axis specified by a
To stop recording click Stop Calculations on selection:
Administrator

the Calculation toolbar Movie, or let the calculation Choose Spin About... from the Movie menu.
terminate according to preset values.
The Spin About... command automatically
To view different frames of your movie: activates the Record command.

1. Click the arrow on the Position button of the To stop spinning:


Movie toolbar. On the Movie toolbar, click the Stop button.
The Movie Process tool appears. Spins are automatically recorded.
Figure 6-18:The Movie tool
To replay the spins:
Click Start.

Editing a Movie
You can change a movie by removing frames.

To remove a frame:

1. Position the movie to the frame you want to


delete.
TIP: You can tear the toolbar off by dragging the title
bar. 2. Click the Remove Frame button.

2. Drag the Slider knob to the frame you wish to Movie Control Panel
view.
You can control how a movie is created by changing
TIP: You can also use the Previous and Next buttons settings in the Movies control panel in the Model
to locate a frame in the movie. Settings dialog box. You can specify the number of
frames and at what increment they are captured.
To play back a movie you created:
To display the Movies control panel:
Click Start.
1. From the Movies menu, choose Properties.
To stop playback of a movie:
2. Take the appropriate actions:
Click Stop.

Spinning Models If you want to Then

You can spin models about a selected axis. The set the movie to loop Click the Loop or Back
number of frames created when you choose a Spin or repeat backwards and Forth radio button.
command is set using the Smoothness Slider in the and forwards
Movies control panel.

140 Inspecting Models CambridgeSoft


Animations
If you want to Then

specify the speed at Drag the Speed slider


which the movie is knob to the left to play
replayed your movie at a slower
speed (a smaller
number of degrees per
second). Drag the
Speed slider knob to the
right to play your movie
at a faster speed (a
larger number of
degrees per second).

specify the number of Drag the Smoothness


degrees of rotation that slider knob to the left to
is captured as a frame capture more frames (a
while recording. smaller number of
degrees of rotation
capture a frame). Drag
the Smoothness slider
knob to the right to
capture fewer frames (a
larger number of
degrees of rotation
capture a frame).

Chem & BioOffice 2006 /Chem3D Inspecting Models 141


Animations
Administrator

142 Inspecting Models CambridgeSoft


Animations
Chapter 7: Printing and Exporting
Models
Printing Models 2. Select the appropriate options:

You can print Chem3D models to PostScript and


If you want to Then select
non-PostScript printers. Before printing you can
specify options about the print job.
resize your model Scale To and type a scaling
Specifying Print Options according to a scaling value.
factor
To prepare your model for printing: Scaling factors are
measured in pixels per
1. From the File menu, choose Print Setup.
angstrom. A pixel is 1/72
The Print Setup dialog box appears. The of an inch, or approxi-
available options depend on the printer you mately 1/28 of a centi-
use. There are five options specific to meter. With a value of 28
Chem3D, which are described in the following pixels/ngstrom your
table. model is scaled so that a
Figure 7-1: The Print Setup dialog box distance of one ngstrom
in the model is 1 centi-
meter in the printed image.
If you specify a value of 72
pixels/angstrom, a
distance of one angstrom
in the model is scaled to 1
inch on the printed image.

Chem3D options scale your model so Scale To Full Page.


the printed image fills
the printed page

print with white back- Always Print with White


ground (default) Background

Chem & BioOffice 2006 /Chem3D Printing and Exporting Models 143
If you want to Then select
File Format Name Extension
produce publication High Resolution Printing
Administrator

quality output. (this can also be set with Alchemy Alchemy .alc; .mol
the OpenGL Preferences
settings.) Cartesian Coordi- Cart Coords 1 .cc1
nate
print a footer at the Include Footer.
bottom left of the Cart Coords 2 .cc2
printed page
containing the name CCDB Cambridge Crys- .ccd
of the model and the tallographic
date and time Database
changes were last
made
Chem3D .c3xml; .c3d

Printing Chem3D .c3t


To print the contents of the active window: template
From the File menu, choose Print.
ChemDraw ChemDraw .cdx; .cdxml
The Print dialog box appears. The contents of
the dialog box depend upon the type of printer
you are using. Connection Table Conn Table .ct; .con

The picture of the model is scaled according to the


GAMESS Input GAMESS Input .inp
settings in the Page Setup dialog box.
To print a table, right-click in the table and select Gaussian Check- .fchk; .fch
Print. point
Exporting Models Using
Gaussian Cube .cub
Different File Formats
The following table shows all of the chemistry file Gaussian Input Gaussian Input .gjc; .gjf
formats supported by Chem3D. For more
information about file formats, see Appendix E: Internal Coordi- Int Coords .int
File Formats. nates

MacroModel MacroModel .mcm; .dat;


.out

144 Printing and Exporting Models CambridgeSoft


Exporting Models Using Different File Formats
Publishing Formats
File Format Name Extension
The following file formats are used to import
Molecular Design MDL MolFile .mol and/or export models as pictures for desktop
Limited MolFile publishing and word processing software.

Image Format Features


MSI ChemNote MSI ChemNote .msm
Chem3D 10 gives you more options when saving
MOPAC input MOPAC .mop; .dat; graphic formats, and the options are easier to set
file .mpc; 2mt than ever.
Transparent OLE copy/paste
MOPAC graph .gpt
Save bitmap images up to 1200 DPI.
file
JPEG Quality (compression) can be adjusted
from 0 to 100%.
Protein Data Protein DB .pdb; .ent
Bank Movies can be saved in animated GIF, multi-
page TIFF, or AVI formats.
ROSDAL Rosdal .rdl The defaults are set in the new Pictures tab of the
Preferences dialog box.
Standard Molec- SMD File .smd The Save dialog box now displays the available
ular Data options, to make it easier to override defaults when
you save.
SYBYL MOL SYBYL .sml
Figure 8: Save as GIF dialog box

SYBYL MOL2 SYBYL2 .sm2; .ml2


Transparent background and
To save a model with a different format, name or animation support
location:
Set JPEG compression
1. From the File menu, choose Save As.
Set resolution
The Save File dialog box appears.
2. Specify the name of the file, the folder, and disk
where you want to save the file.
3. Select the file format in which you want to save
the model.
4. Click Save. Graphic file formatting uses CxImage, an open
When you save a file in another file format, only source toolset under the zlib license.1
information relevant to the file format is saved. For 1. CxImage: Copyright 2001 - 2004,
example, you will lose dot surfaces, color, and atom Davide Pizzolato
labels when saving a file as an MDL MolFile. http://www.xdp.it

Chem & BioOffice 2006 /Chem3D Printing and Exporting Models 145
Exporting Models Using Different File Formats
WMF and EMF TIF
Chem3D supports the Windows Metafile and
The Tagged Image File Format (TIFF) contains
Enhanced Metafile file formats. These are the only
binary data describing a bitmap image of the model.
graphic formats (as opposed to chemistry modeling
Administrator

formats) that can be used for import. They may also TIFF is a high resolution format commonly used
be used for export, EMF by using the Save As... for saving graphics for cross-platform importing
File menu command or the clipboard, and WMF by into desktop publishing applications. TIFF images
using the clipboard (only). See Exporting With the can be saved using a variety of resolution, color, and
Clipboard on page 154 for more information. compression options. As TIFF images can get large,
EMF files are exported with transparent choosing appropriate options is important.
backgrounds, when this is supported by the
operating system (Windows 2000 and When you save a file as TIF, an option button
Windows XP). The WMF and EMF file formats are appears in the Save As dialog box.
supported by applications such as Microsoft Word
for Windows. To specify the save options:

NOTE: Chem3D no longer embeds structural information 1. Click Options:


in models exported as EMF files. If you have EMF files
produced with previous versions of Chem3D, you can still The TIFF Options dialog box appears.
open them in Chem3D and work with the structure.
Figure 7-2: The TIFF Options dialog box
However, EMF files saved from Chem3D 8.0 contain
graphic information only and cannot be opened in Chem3D
10.

BMP
The Bitmap file format saves the bitmapped
representation of a Chem3D picture. The Bitmap 2. Choose a resolution. The size of the file
file format enables you to transfer increases as the square of the resolution.
Chem3D pictures to other applications, such as
Microsoft Word for Windows, that support 3. Choose a color option.
bitmaps.
If you want to Then choose
EPS
The PostScript file format saves models as force objects to black Monochrome.
encapsulated postscript file (EPS). EPS files are and white.
ASCII text files containing the scaleable PostScript
representation of a Chem3D picture. You can open store colors using RGB Indexed.
EPS files using other applications such as computer monitor
PageMaker. You can transfer EPS files among style of color
platforms, including Macintosh, Windows, and encoding.
UNIX.

146 Printing and Exporting Models CambridgeSoft


Exporting Models Using Different File Formats
the world wide web. Each of these formats uses a
If you want to Then choose compression algorithm to reduce the size of the file.
Applications that can import GIF, PNG, and JPG
use printing press CMYK Contiguous. files include Netscape Communicator and
style of color Stores colors non-sequen- Microsoft Internet Explorer.
encoding. tially. For example: The model window background color is used as the
CMYKCMYK. The Pack-
transparent color in the GIF format graphic.
Bits compression type
provides no compression
for this type of file. NOTE: The size of the image in Chem3D when you save
the file will be the size of the image as it appears in your web
page. If you turn on the Fit Model to Window building
NOTE: If objects in your document are black and white preference in Chem3D, you can resize the Chem3D window
they are saved as black and white regardless of which Color (in Chem3D) to resize the model to the desired size then
options you set. If you import drawings from other save.
applications and want them to print Black and White you
must set the Color option to Monochrome.
3DM
4. Choose a compression option: The QuickDraw 3D MetaFile (3DM) file format
contains 3-dimensional object data describing the
If you want to Then choose model. You can import 3DM files into many 3D
modeling applications. You can transfer 3DM files
between Macintosh and Windows platforms.
reduce file size by encoding PackBits.
repeating bytes of informa-
tion as output. For
AVI
example, for a line of color Use this file format to save a movie you have
information such as: created for the active model. You can import the
CCCCC- resulting movie file into any application that
MMMMMYYYYYKKKK supports the AVI file format.
K, the compression yields
a smaller file by repre- Formats for Chemistry
senting the information as
C5M5Y5K5.
Modeling Applications
The following file formats are used to export
fax transmissions of CCITT Group 3 or models to chemistry modeling application other
images CCITT Group 4. than Chem3D. Most of the formats also support
import.

GIF and PNG and JPG Alchemy


Use the Graphics Interchange Format (GIF), Use the ALC file format to interface with
Portable Network Graphics (PNG) file format, or TRIPOS applications such as Alchemy. This is
the JPEG format to publish a Chem3D model on supported only for input.

Chem & BioOffice 2006 /Chem3D Printing and Exporting Models 147
Exporting Models Using Different File Formats
Cartesian Coordinates
If you want the file to Then click
Use Cartesian Coordinates 1 (.CC1) or 2 (.CC2) to
import or export the X, Y, and Z Cartesian contain internal coordinates Save All Frames.
coordinates for your model. for each view of the model
Administrator

When you save a file as Cartesian Coordinates, an


option button appears in the Save As dialog box. Connection Table
To specify the save options: Chem3D uses the atom symbols and bond orders
of connection table files to guess the atom symbols
1. Click Options: and bond orders of the atom types. There are two
The Cartesian Coordinates Options dialog connection table file formats, CT and CON. The
box appears. CON format is supported only for import.
Figure 7-3: The Cartesian Coordinates Options dialog When you save a file as a Connection Table, an
box Options button appears in the Save As dialog box.
To specify the save options:
1. Click Options.
The Connection Table Options dialog box
appears.
Figure 7-4: The Connection Table Options dialog box

2. Select the appropriate options:

If you want the file to Then click

contain a connection table for By Serial Number.


each atom with serial numbers
2. Select the appropriate options:

contain a connection table for By Position.


each atom that describes adja- If you want to add Then click
cent atoms by their positions
in the file a blank line to the top of 1 Blank Line.
the file
not contain a connection table Missing.
two blank lines to the top 2 Blank Lines.
contain serial numbers Include Serial of the file
Numbers.

contain atom type numbers Include Atom Type three blank lines to the top 3 Blank Lines.
Text Numbers. of the file

148 Printing and Exporting Models CambridgeSoft


Exporting Models Using Different File Formats
Gaussian Input numbers are determined by the order of the atoms
in the file. The first atom has a serial number of 1,
Use the Gaussian Input (GJC, GJF) file format to the second is number 2, and so on. Internal
interface with models submitted for Gaussian Coordinates files may be both imported and
calculations. Either file format may be used to exported.
import a model. Only the Molecule Specification
section of the input file is saved. For atoms not You cannot use a Z-matrix to position an atom in
otherwise specified in Chem3D, the charge by terms of a later-positioned or higher serialized
default is written as 0, and the spin multiplicity is atom. If you choose the second or third options in
written as 1. You can edit Gaussian Input files using the Internal Coordinates Options dialog box, the
a text editor with the addition of keywords and nature of the serialization of your model determines
changing optimization flags for running the file whether a consistent Z-matrix can be constructed.
using the Run Gaussian Input file within Chem3D, If the serial numbers in the Z-matrix which is about
or using Gaussian directly. to be created are not consecutive, a message
appears. You are warned if the atoms in the model
Gaussian Checkpoint must be reserialized to create a consistent Z-matrix.
A Gaussian Checkpoint file (FCHK; FCH) stores When you click Options in the Save As dialog box,
the results of Gaussian Calculations. It contains the the following dialog box appears:
final geometry, electronic structure (including Figure 7-5: The Internal Coordinates Options dialog
energy levels) and other properties of the molecule. box
Checkpoint files are supported for import only.
Chem3D displays atomic orbitals and energy levels
stored in Checkpoint files. If Cubegen is installed,
molecular surfaces are calculated from the
Checkpoint file.

Gaussian Cube
Select the appropriate options:
A Gaussian Cube file (CUB) results from running
Cubegen on a Gaussian Checkpoint file. It contains
information related to grid data and model If you want to Then click
coordinates. Gaussian Cube files are supported for
import only. save your model using Use Current Z-matrix.
the Z-matrix described
Chem3D displays the surface the file describes. If
in the Internal Coordi-
more than one surface is stored in the file, only the
nates table of the model
first is displayed. You can display additional surfaces
using the Surfaces menu.

Internal Coordinates
Internal Coordinates (.INT) files are text files that
describe a single molecule by the internal
coordinates used to position each atom. The serial

Chem & BioOffice 2006 /Chem3D Printing and Exporting Models 149
Exporting Models Using Different File Formats
in the Journal of Chemical Information and
If you want to Then click Computer Science, Volume 32, Number 3, 1992,
pages
build a Z-matrix in Only Serial Numbers; 244255.
Administrator

which the current serial Bond and Dihedral


number ordering of the Angles. Use this format to interface with MDLs ISIS
atoms in the model is applications and other chemistry-related
Pro-R/Pro-S and applications. Both import and export are
preserved in the Z- Dihedral angles are
matrix supported.
used to position
atoms.
MSI ChemNote
build a Z-matrix in Only Serial Numbers; Use the MSI ChemNote (.MSM) file format to
which the current serial Dihedral Angles Only. interface with Molecular Simulations applications
number ordering of the such as ChemNote. The file format is defined in the
atoms in the model is The Pro-R and Pro-S ChemNote documentation. Both import and
preserved in the Z- stereochemical desig- export are supported.
matrix nations are not used
in constructing the MOPAC Files
Z-matrix from a
model. All atoms are MOPAC data may be stored in MOP, DAT, MPC,
positioned by dihe- or 2MT file formats. Chem3D can import any of
dral angles only. these file formats, and can export MOP files. You
can edit MOPAC files using a text editor, adding
MacroModel Files keywords and changing optimization flags, and run
the file using the Run MOPAC Input file command
The MacroModel1 (MCM; DAT; OUT) file formats within Chem3D.
are defined in the MacroModel Structure Files
When you click Options in the Save As dialog box,
version 2.0 documentation. Chem3D supports
the MOPAC Options dialog box appears:
import of all three file types, and can export MCM
Figure 7-6: The MOPAC options dialog box
Molecular Design Limited MolFile
(.MOL)
The MDL Molfile format saves files by MDL
applications such as ISIS/Draw, ISIS/Base,
MAACS and REACCS. The file format is defined in
the article, Description of Several Chemical
Structure File Formats Used by Computer
Programs Developed at Molecular Design Limited Click the Save All Frames check box to create a
1. MacroModel is produced within the MOPAC Data file in which the internal coordinates
Department of Chemistry at Columbia for each view of the model are included. The initial
University, New York, N.Y. frame of the model contains the first 3 lines of the

150 Printing and Exporting Models CambridgeSoft


Exporting Models Using Different File Formats
usual MOPAC output file (see the example file To edit a file to run using the Run MOPAC Input
below). Each subsequent frame contains only lines File command:
describing the Z-matrix for the atoms in that frame.
1. Open the MOPAC output file in a text editor.

NOTE: For data file specifications, see page 13 of the The output file below shows only the first four
online MOPAC manual. atom record lines. The first line and column of the
example output file shown below are for purposes
of description only and are not part of the output
file.

Chem & BioOffice 2006 /Chem3D Printing and Exporting Models 151
Exporting Models Using Different File Formats
Col. 1 Col. 2 C3 Col. 4 C5 Col. 6 Col. 7 Col. 8
Administrator

Line 1

Line 2: Cyclohexanol

Line 3:

Line 4: C 0 0 0 0 0 0 0 0 0

Line 5: C 1.54152 1 0 0 0 0 1 0 0

Line 6: C 1.53523 1 111.7747 1 0 0 2 1 0

L7..Ln C 1.53973 1 109.7114 1 -55.6959 1 1 2 3

Ln+1

2. In Line 1, type the keywords for the computa- Column 6 is the dihedral angle (for the
tions you want MOPAC to perform (blank in connectivity specified in Column 8).
the example above). Column 7 is the optimization flag for the
Line 2 is where enter the name that you want to dihedral angle specified in Column 6.
assign to the window for the resulting model. 5. To specify particular coordinates to optimize,
However, Chem3D ignores this line. change the optimization flags in Column 3,
3. Leave Line 3 blank. Column 5 and Column 7 for the respective
4. Line 4 through Ln (were n is the last atom
internal coordinate. The available flags in
record) include the internal coordinates, opti- MOPAC are:
mization flags, and connectivity information
for the model. 1 Optimize this internal coordinate
Column 1 is the atom specification.
0 Do not optimize this internal
Column 2 is the bond distance (for the
connectivity specified in Column 8).
-1 Reaction coordinate or grid index
Column 3 is the optimization flag for the
bond distance specified in Column 2.
T Monitor turning points in DRC
Column 4 is the bond angle (for the
connectivity specified in Column 8). 6. Add additional information in line Ln+1. For
Column 5 is the optimization flag for the example, symmetry information used in a
bond angle specified in Column 4. SADDLE computation.

152 Printing and Exporting Models CambridgeSoft


Exporting Models Using Different File Formats
7. Leave the last line in the data file blank to indi- Standard Molecular Data (SMD)
cate file termination.
Use the Standard Molecular Data (.SMD) file
8. Save the file in a text only format. format for interfacing with the STN Express
application for online chemical database searching.
MOPAC Graph Files Both import and export are supported.

A MOPAC Graph (GPT) file stores the results of SYBYL Files


MOPAC calculations that include the GRAPH Use the SYBYL (SML, SM2, ML2) file formats to
keyword. It contains the final geometry, electronic interface with Triposs SYBYL applications. The
structure, and other properties of the molecule. SML and SM2 formats can be used for both import
Chem3D supports the MOPAC Graph file format and export; the ML2 format is supported for
for import only. import only.

Protein Data Bank Files Job Description File Formats


You can use Job description files to save
Brookhaven Protein Data Bank files (PDB; ENT)
customized default settings for calculations. You
are used to store protein data and are typically large
can save customized calculations as a Job
in size. Chem3D can import both file types, and
Description file (.JDF) or Job Description
exports PDB. The PDB file format is taken from
Stationery (.JDT). Saving either format in a
the Protein Data Bank Atomic Coordinate and
Chem3D job folder adds it to the appropriate
Bibliographic Entry Format Description.
Chem3D menu.

ROSDAL Files (RDL) JDF Files


The ROSDAL Structure Language1 (RDL) file The JDF file format is a file format for saving job
format is defined in Appendix C: ROSDAL Syntax descriptions. When you open a JDF file, you can
of the MOLKICK Users Manual, and in this edit CSBR and save the settings.
manual in Appendix E, File Formats. on
JDT Files
page 242. The ROSDAL format is primarily used
for query searching in the Beilstein Online The JDT file format is a template format for saving
Database. Chem3D supports the ROSDAL file settings that can be applied to future calculations.
format for export only. You can edit the settings of a template file, however
1. ROSDAL is a product of Softron, Inc. you cannot save your changes.

Chem & BioOffice 2006 /Chem3D Printing and Exporting Models 153
Exporting Models Using Different File Formats
Exporting With the Clip- 3. In ChemDraw, select Paste from the Edit
menu.
board
NOTE: The model is imported as a bitmap or EMF
You can export a Chem3D model to other graphic and contains no structural information.
Administrator

applications as a picture or in chemical notation.


Two graphic formats are available: bitmap and To transfer a model as a 2D structure:
EMF, and three notation formats: ChemDraw 1. Select the model.
structure, SMILES, and InChI1. 2. From the Edit menu, point to Copy As, then
choose ChemDraw Structure.
NOTE: Chemical notation formats are mostly suitable for 3. Open ChemDraw.
exporting smaller models. You should be aware of the 4. From the Edit menu, choose Paste.
limitations of the format before using it.
The model is pasted into ChemDraw.

You can also export an Embedded Object that uses TIP: To have the ChemDraw model look like the
the Chem3D ActiveX Control to manipulate the Chem3D model, select or deselect the ChemDraw
object. Show Labels on Terminal Carbons and Hide
Implicit Hydrogens options on the Atom Labels tab
When exporting in a graphic format, the size of the of the Document Settings dialog box to match the
file that you copy to the clipboard from Chem3D is settings in Chem3D.
determined by the size of the Chem3D model
window. If you want the size of a copied molecule
to be smaller or larger, resize the model window Copying to Other Applica-
accordingly before you copy it. If the model tions
windows for several models are the same size, and
Fit Model to Window is on, then the models should To copy and paste a model into a word processing,
copy as the same size. desktop publishing, presentation or drawing
application, such as Microsoft Word or PowerPoint:
Copying to ChemDraw 1. Select the model.
2. From the Edit menu, point to Copy As, then
You can transfer information to ChemDraw as a
choose Bitmap or Enhanced Metafile.
picture or as a 2D model.
3. Paste the model into the target application
To transfer a model as a 3D picture: document.

1. Select the model.


TIP: If you are pasting into MS Word or PowerPoint,
select Paste Special and choose the type of graphic you
2. From the Edit menu, point to Copy As, then wish to import: bitmap, WMF, or EMF. The EMF
choose Bitmap or Enhanced Metafile. option will copy with a transparent background.
1. InChI is a trademark of the Interna-
tional Union of Pure and Applied Alternatively, you could use Save As Bitmap or
Chemistry. InChI Material in Chem- EMF to create a file to insert into or link to the
Draw is IUPAC 2005. target application document.

154 Printing and Exporting Models CambridgeSoft


Exporting With the Clipboard
To copy the model as a SMILES or InChI string, Figure 9: Chem3D model embedded in FrontPage
select the model and chose the SMILES or InChI
option from the Copy As submenu.

Embedding Models in Other


Applications
The improved Chem3D ActiveX control allows
you to embed animated models in PowerPoint
presentations, Word documents, or HTML-based
documents.
To embed a model:
1. Use the Ctrl+A key combination to select the
entire model, or drag a rectangle with the Select
tool.
NOTE: Modifying the embedded image in HTML is
2. Point to Copy As on the Edit menu, and click
Embedded Object.
beyond the scope of this document. If you are a programmer
developing 3D modeling HTML pages, see
3. Paste the object in the target document using ReadMeC3DP.htm in the Chem3D application folder.
Edit>Paste or Ctrl+V.

NOTE: Use the normal Paste command, not Paste When you embed a model in a PowerPoint
Special. presentation, you can modify the display properties.
To display the Properties dialog box, select
Properties from the context (right-click) menu.
Figure 10: Changing Chem3D display properties

Chem & BioOffice 2006 /Chem3D Printing and Exporting Models 155
Exporting With the Clipboard
Table 1lists the properties you can change in an Table 1: Embedded Chem3D object display
properties
embedded object.
Table 1: Embedded Chem3D object display Property Data
properties
Administrator

Property Data ShowRota- Shows/hides the Rotation toolbar.


tionBar
DataURL Normally left blank. You can
reference a file rather than using ShowToolbar Determines placement of the
cut-paste, but the slide presenta- Toolbar (left, right, top, bottom)
tion may not have access to that or hides the toolbar.
file later.
Top Defines the top of the object
EncodeData Cannot be changed. window., measured from the top
of the slide.
Fullscreen Cannot be changed.
Visible Shows/hides the object window.
Height Defines the height of the object
window. Width Defines the width of the object
window.
Left Defines the placement of the left
edge of the object window. Background Effects and Images
Chem3D 10 has nearly two dozen background
Modified Cannot be changed. effects for presentation images. You can also insert
an image into the background, to display your
Rotation Specifies the model rotation. companys logo or for visual effect. Figure 11shows
Enter data in the following format: the Sea and Sky background with an embedded
axis speed (angle) logo GIF file.
Angle can be X, Y, or Z or a
Figure 11: Background with logo
combination, for example: XY.
Speed may be 0-5, but the default
setting of 1 generally gives best
results. Specifying an angle means
that the model will rock rather
than spin. For example, x 1 45 will
rock the model on the X axis at
speed 1 through an angle of 45.

ShowContext- Shows/hides right-click menus in


Menu the object window.

156 Printing and Exporting Models CambridgeSoft


Exporting With the Clipboard
Chapter 8: MM2 and MM3 Computa-
tions
MM2 Overview 1. Build the model for which you want to
minimize the energy.
The Chem3D MM2 menu provides computations
using the MM2 force field. 2. To impose constraints on model measure-
ments, set Optimal column measurements in
The MM2 procedures described assume that you the Measurements table.
understand how the potential energy surface relates
to conformations of your model. If you are not 3. From the Calculations menu, point to MM2,
familiar with these concepts, see Computation and choose Minimize Energy.
Concepts
The Minimize Energy dialog box appears.
As discussed in Appendix G: Computation
Figure 8-1: The Minimize Energy dialog box
Concepts, the energy minimization routine
performs a local minimization only. Therefore, the
results of minimization may vary depending on the
starting conformation in a model.

Minimize Energy
To minimize the energy of the molecule based on
MM2 Force Field:
Minimum RMS Gradient
NOTE: You cannot minimize models containing phosphate
groups drawn with double bonds. For information on how to
create a model with phosphate groups you can minimize, see
the Chem3D Drawing FAQ at:
http://www.cambridgesoft.com/services/faqs.cfm

Chem & BioOffice 2006 /Chem3D MM2 and MM3 Computations 157
Minimize Energy
4. Set the convergence criteria using the following
options:.

If you want to Then


Administrator

specify the convergence Enter a value for Minimum RMS Gradient.


criteria for the gradient of
the potential energy surface If the slope of the potential energy surface becomes too small, then the mini-
mization has probably reached a local minimum on the potential energy
surface and the minimization terminates.

The default value of 0.100 is a reasonable compromise between accuracy and


speed.
Reducing the value means that the calculation continues longer as it tries to
get even closer to a minimum.
Increasing the value shortens the calculation, but leaves you farther from a
minimum. Increase the value if you want a better optimization of a
conformation that you know is not a minimum, but you want to isolate for
computing comparative data.

watch the minimization Select Display Every Iteration.


process live at each itera-
tion in the calculation NOTE: Displaying or recording each iteration adds significantly to the time
required to minimize the structure.

store each iteration as a Select Record Every Iteration.


frame in a movie for replay
later

view the value of each Select Copy Measurements to Output.


measurement in the Output
window

restrict movement of a Select Move Only Selected Atoms.


selected part of a model
during the minimization Constraint is not imposed on any term in the calculation and the values of
any results are not affected.

158 MM2 and MM3 Computations CambridgeSoft


Minimize Energy
The minimization and recording stops.
NOTE: If you are planning to make changes to any of the
MM2 constants, such as cutoff values or other parameters Queuing Minimizations
used in the MM2 force field, please make a backup copy of
the parameter tables before making any changes. This will You can start to minimize several models without
assure that you can get back the values that are shipped with waiting for each model to finish minimizing. If a
Chem3D, in case you need them computation is in progress when you begin
minimizing a second model, the minimization of
the second model is delayed until the first
NOTE: Chem3D guesses parameters if you try to minimization stops.
minimize a structure containing atom types not supported by
If you are using other applications, you can run
MM2. Examples include inorganic complexes where known
parameters are limited. You can view all parameters used in minimization with Chem3D in the background.
the analysis using the Show Used Parameters command. See You can perform any action in Chem3D that does
Showing Used Parameters on page 169. not change the position of an atom or add or delete
any part of the model. For example, you can move
windows around during minimization, change
Running a Minimization settings, or scale your model.

To begin the minimization of a model, click Run. Example: Minimizing Ethane


Ethane is a particularly straightforward example of
TIP: In all of the following minimization examples,
you can use the MM2 icon on the Calculation toolbar minimization, because it has only one
instead of the Calculations menu. minimum-energy (staggered) and one
maximum-energy (eclipsed) conformation.
The Output window appears when the To minimize energy in ethane:
minimization begins if it was not already
opened. The data is updated for every iteration 1. From the File menu, choose New.
of the computation, showing the iteration An empty model window appears.
number, the steric energy value at that iteration,
2. Draw a model of Ethane.
and the RMS gradient. If you have not selected
the Copy Measurements to Output option, only 3. Choose Show Serial Numbers on the Model
the last iteration is displayed. Display submenu of the View menu.

After the RMS gradient is reduced below the You might also want to set the Model Display
requested value, the minimization ends, and the Mode to Ball and Stick or Cylindrical Bonds.
final steric energy components and total appear 4. On the Calculations menu, point to MM2 and
in the Output window. choose Minimize Energy.
Intermediate status messages may appear in the 5. Click Run on the Minimize Energy dialog
Output window. A message appears if the box.
minimization terminates abnormally, usually The calculation is performed. Messages appear
due to a poor starting conformation. in the Output Window.
To interrupt a minimization that is in progress: To view all the messages:
Click Stop in the Computing dialog box. Scroll in the Output Window.

Chem & BioOffice 2006 /Chem3D MM2 and MM3 Computations 159
Minimize Energy
You can also tear off the window and Figure 8-2: Dihedral measurement for Ethane
enlarge it to make it easier to view.
Figure 8-2: Output for Ethane minimization
Administrator

The 60 degree dihedral represents the lowest


energy conformation for the ethane model.

Select the Trackball tool:

1. Reorient the model by dragging the X- and Y-


axis rotation bars until you have an end-on
view.
Figure 8-3: Ethane model, end-on view
The Total Steric Energy for the conformation is
0.8181 kcal/mol. The 1,4 VDW term of 0.6764
dominates the steric energy. This term is due to the
H-H repulsion contribution.

NOTE: The values of the energy terms shown are


approximate and can vary slightly based on the type of
processor used to calculate them. To force a minimization to converge on the
transition conformation, set the barrier to rotation:
To view the value of one of the dihedral angles that 1. In the Measurements table, type 0 in the
contributes to the 1,4 VDW contribution: Optimal column for the selected dihedral angle
and press the Enter key.
1. Select the atoms making up the dihedral angle
2. On the MM2 submenu of the Calculations
as shown in Figure 8-1 by Shift+clicking H(7),
menu, choose Minimize.
C(2), C(1), and H(4) in that order.
The Minimize Energy dialog box appears.
Figure 8-1: Selecting dihedral atoms
3. Click Run.
The model conforms to the structure in Figure
8-4.
Figure 8-4: Minimized Ethane, end-on view

2. From the Structure menu, point to Measure-


ment, and select Set Dihedral Measurement.

The following measurement appears.

160 MM2 and MM3 Computations CambridgeSoft


Minimize Energy
Entering a value in the Optimal column imposes a Delete the value from the Optimal column for
constraint on the minimization routine. You are the dihedral angle and click the MM2 icon on
increasing the force constant for the torsional term the Calculation toolbar.
in the steric energy calculation so that you can
optimize to the transition state. After the minimization is complete, you are still at 0
degrees. This is an important consideration for
When the minimization is complete, the reported working with the MM2 minimizer. It uses first
energy values shown in Figure 8-5. The energy for derivatives of energy to determine the next logical
this eclipsed conformation is higher relative to the move to lower the energy. However, for saddle
staggered form. The majority of the energy points (transition states), the region is fairly flat and
contribution is from the torsional energy and the the minimizer is satisfied that a minimum is
1,4 VDW interactions. reached. If you suspect your starting point is not a
minimum, try setting the dihedral angle off by
about 2 degrees and minimize again.
NOTE: The values of the energy terms shown here are
approximate and can vary slightly based on the type of Example: Comparing Two Stable
processor used to calculate them. Conformations of Cyclohexane

Figure 8-5: Output for eclipsed Ethane model In the following example you compare the
cyclohexane twist-boat conformation and the chair
global minimum.

To build a model of cyclohexane:

1. From the File menu, choose New.

An empty model window appears.


2. Select the Text Building tool.

3. Click in the model window.

A text box appears.


4. Type CH2(CH2)5 and press the Enter key.

The dihedral angle in the Actual column becomes 0, CAUTION


corresponding to the imposed constraint. While there are other, perhaps easier, methods of creating
a cyclohexane model, you should use the method described
The difference in energy between the global
to follow this example.
minimum (Total, previous calculation) and the
transition state (Total, this calculation) is 2.73
kcal/mole, which is in agreement with literature Before minimizing, it is wise to use the Clean Up
values. Structure command to refine the model. This
generally improves the ability of the Minimize
To further illustrate points about minimization: Energy command to reach a minimum point.

Chem & BioOffice 2006 /Chem3D MM2 and MM3 Computations 161
Minimize Energy
1. From the Edit menu, choose Select All. Figure 8-7: Energy values for twisted boat conforma-
tion
2. From the Structure menu, choose Clean Up.

NOTE: The Clean Up command is very similar to the


Administrator

minimize energy command in that it is a preset, short


minimization of the structure.

To perform the minimization:


From the MM2 submenu of the Calculations
menu, choose Minimize Energy, and click Run.
When the minimization is complete, reorient The major contributions are from the 1,4 VDW and
the model so it appears as in Figure 8-6. Torsional aspects of the model.
Figure 8-6: Minimized cyclohexane model
For cyclohexane, there are six equivalent local
minima (twisted-boat), two equivalent global
minima (chair), and many transition states (one of
which is the boat conformation).

Locating the Global Minimum


Finding the global minimum is extremely
The conformation you converged to is not the
challenging for all but the most simple molecules. It
well-known chair conformation, which is the global
requires a starting conformation which is already in
minimum. Instead, the model has converged on a
the valley of the global minimum, not in a local
local minimum, the twisted-boat conformation.
minimum valley. The case of cyclohexane is
This is the closest low-energy conformation to your
straightforward because you already know that the
starting conformation.
global minimum is either of the two possible chair
Had you built this structure using substructures conformations. To obtain the new starting
that are already energy minimized, or the conformation, change the dihedrals of the twisted
ChemDraw panel, you would be close to the chair conformation so that they represent the potential
conformation. The minimizer does not surmount energy valley of the chair conformation.
the saddle point to locate the global minimum, and
The most precise way to alter a dihedral angle is to
the closest minimum is sought.
change its Actual value in the Measurements table
The energy values in the Output window should be when dihedral angles are displayed. An easier way to
approximately as follows: alter an angle, especially when dealing with a ring, is
to move the atoms by dragging then cleaning up the
resulting conformation.
To change a dihedral angle:
1. Drag C1 below the plane of the ring.
The cursor appears as a box with a hand.
2. Drag C4 above the plane of the ring.

162 MM2 and MM3 Computations CambridgeSoft


Minimize Energy
Figure 8-8: Changing a dihedral angle 4. When the minimization is complete, reorient
1a 2a the model using the Rotation bars to see the
final chair conformation.

NOTE: The values of the energy terms shown here are


2b approximate and can vary slightly based on the type of
1b
processor used to calculate them.

Figure 8-10: Chair conformation of cyclohexane with


energy values

During dragging, the bond lengths and angles were


deformed. To return them to the optimal values
before minimizing, select the model by dragging a
box around it with the Select tool, and run Clean
Up.
Figure 8-9: Clean Up command on the Structure menu
This conformation is about 5.5 kcal/mole more
stable than the twisted-boat conformation.

For molecules more complicated than cyclohexane,


where you dont already know what the global
minimum is, some other method is necessary for
locating likely starting geometries for minimization.
One way of accessing this conformational space of
a molecule with large energy barriers is to perform
molecular dynamics simulations. This, in effect,
heats the molecule, thereby increasing the kinetic
energy enough to cross the energetically disfavored
Now run the minimization: transition states.
3. Click the MM2 tool on the Computation
toolbar. Molecular Dynamics
Molecular Dynamics uses Newtonian mechanics to
simulate motion of atoms, adding or subtracting
kinetic energy as the models temperature increases
or decreases.

Molecular Dynamics allows you to access the


conformational space available to a model by
storing iterations of the molecular dynamics run
and later examining each frame.

Chem & BioOffice 2006 /Chem3D MM2 and MM3 Computations 163
Molecular Dynamics
Performing a Molecular 5. Enter the appropriate values.

Dynamics Computation 6. Click Run.

To perform a molecular dynamics simulation: Dynamics Settings


Administrator

1. Build the model (or fragments) that you want


Use the Dynamics tab to enter parameter values for
to include in the computation.
the parameters that define the molecular dynamics
NOTE: The model display type you use affects the calculations:
speed of the molecular dynamics computation. Model
Step Intervaldetermines the time between
display will decrease the speed in the following order:
Wire Frame< Sticks < Ball and Sticks< Cylindrical molecular dynamics steps. The step interval
Bonds < Ribbons< Space Fill and VDW dot surfaces must be less than ~5% of the vibration period
< Molecular Surfaces. for the highest frequency normal mode, (10 fs
for a 3336 cm-1 HX stretching vibration).
2. Minimize the energy of the model (or frag- Normally a step interval of 1 or 2 fs yields
ments), using MM2 or MOPAC. reasonable results. Larger step intervals may
cause the integration method to break down,
3. To track a particular measurement during the
because higher order moments of the position
simulation, choose one of the following:
are neglected in the Beeman algorithm.
Select the appropriate atoms, and choose Set
Bond Angle or Set Bond Length on the Frame Intervaldetermines the interval at
Measurement submenu of the Structure which frames and statistics are collected. A
menu. frame interval of 10 or 20 fs gives a fairly
4. Choose Molecular Dynamics on the MM2 smooth sequence of frames, and a frame
submenu of the Calculations menu. interval of 100 fs or more can be used to obtain
samples of conformational space over a longer
The Molecular Dynamics dialog box appears
computation.
with the default values.
Figure 8-11: The Molecular Dynamics dialog box. Terminate Aftercauses the molecular
dynamics run to stop after the specified
number of steps. The total time of the run is
the Step Interval times the number of steps.
Heating/Cooling Ratedictates whether
temperature adjustments are made. If the
Heating/Cooling Rate check box is checked,
the Heating/Cooling Rate slider determines
the rate at which energy is added to or removed
from the model when it is far from the target
temperature.
A heating/cooling rate of approximately 1.0
kcal/atom/picosecond results in small
corrections which minimally disturb the
trajectory. A much higher rate quickly heats up

164 MM2 and MM3 Computations CambridgeSoft


Molecular Dynamics
the model, but an equilibration or stabilization Select the appropriate options:
period is required to yield statistically
meaningful results. If you want to Then Click
To compute an isoenthalpic trajectory
(constant total energy), deselect Heating/ record each iteration Record Every Iteration.
Cooling Rate.
as a frame in a movie
Target Temperaturethe final temperature for later replay
to which the calculation will run. Energy is
added to or removed from the model when the track a particular Copy Measurements to
computed temperature varies more than 3% measurement Output.
from the target temperature.
The computed temperature used for this
restrict movement of Move Only Selected
purpose is an exponentially weighted average
a selected part of a Atoms.
temperature with a memory half-life of about
model during the
20 steps.
minimization
Job Type Settings
save a file containing Click Save Step Data In
Use the Job Type tab to set options for the the Time (in picosec- and browse to choose a
computation. onds), Total Energy, location for storing this
Figure 8-12: The Job Type tab Potential Energy, and file.
Temperature data for
each step. The word heating or
cooling appears for
each step in which
heating or cooling was
performed. A summary
of this data appears in the
Message window each
time a new frame is
created.

To begin the computation:

Click Run.
The computation begins. Messages for each
iteration and any measurements you are
tracking appear in the Output window.
If you have chosen to Record each iteration,
the Movie menu commands (and Movie
toolbar icons) will be active at the end of the
computation.

Chem & BioOffice 2006 /Chem3D MM2 and MM3 Computations 165
Molecular Dynamics
The simulation ends when the number of steps To replay the movie:
specified is taken.
Click Start on the Movie menu.
To stop the computation prematurely:
The frames computed during the molecular
Administrator

Click Stop in the Computation dialog box.


dynamics calculation are played as a movie.
Example: Computing the Molecular To review the results:
Dynamics Trajectory for a Short
Segment of Polytetrafluoroethylene 1. View the Output window to examine the
(PTFE) measurement data included in the molecular
dynamics step data.
To build the model:
2. Drag the Movie slider knob to the left until the
1. From the File menu, choose New. first step appears.
2. Select the Text Building tool.
Figure 8-13: C(2) - C(33) distance before calculation
3. Click in the model window.
A text box appears.
4. Type F(C2F4)6F and press the Enter key.
A polymer segment consisting of six repeat
units of tetrafluoroethylene appears in the
model window. Selected

To perform the computation: The C(2)-C(33) distance for the molecule


before the molecular dynamics calculation
1. Select C(2), the leftmost terminal carbon, then
began is approximately 9.4.
Shift+click C(33), the rightmost terminal
carbon. 3. Scroll down to the bottom of the Output
2. Choose Set Distance from the Measurement window and examine the C(2)-C(33) distance
submenu of the Structure menu. for the molecule at 0.190 picoseconds (which
corresponds to frame 20 in the Movie slider of
A measurement for the overall length of the the model window).
molecule appears in the Measurements table.
Figure 8-14: C(2) - C(33) distance after calculation
3. Choose Molecular Dynamics from the MM2
submenu of the Calculations menu.
4. Click the Job Type tab and click the checkbox
for Copy Measurements to Output. If you want
to save the calculation as a movie, select Record
Every Iteration checkbox.
5. Click Run.
The C(2)-C(33) distance is approximately
When the calculation begins, the Output Window 13.7, 42% greater than the initial C(2)-C(33)
appears. distance.

166 MM2 and MM3 Computations CambridgeSoft


Molecular Dynamics
Compute Properties Figure 8-15: The Compute Properties dialog box

Compute Properties represents a single point


energy computation that reports the total steric
energy for the current conformation of a model
(the active frame, if more than one exists).

NOTE: The Steric Energy is computed at the end of an


MM2 Energy minimization.

A comparison of the steric energy of various


conformations of a molecule gives you information
on the relative stability of those conformations.

NOTE: In cases where parameters are not available 6. Click Run.


because the atom types in your model are not among the
MM2 atom types supported, Chem3D will attempt an The Output window appears. When the steric
educated guess. You can view the guessed parameters by using energy calculation is complete, the individual
the Show Used Parameters command after the analysis is steric energy terms and the total steric energy
completed. appear.
Use the Output window scroll bar to view all of the
output. The units are kcal/mole for all terms. At the
Compare the steric energies of cis- and trans-2-
beginning of the computation the first message
butene.
indicates that the parameters are of Quality=4
meaning that they are experimentally
To build trans-2-butene and compute properties:
determined/verified parameters.
1. From the File menu, choose New.
NOTE: The values of the energy terms shown here are
2. Select the Text Building tool. approximate and can vary slightly based on the type of
3. Click in the model window. processor used to calculate them.

A text box appears. The following values are displayed:


4. Type trans-2-butene and press the Enter key. The Stretch term represents the energy associ-
A molecule of trans-2-butene appears in the ated with distorting bonds from their optimal
model window. length.

5. From the MM2 submenu of the Calculations


The second steric energy term is the Bend
menu, choose Compute Properties. term. This term represents the energy associ-
ated with deforming bond angles from their
The Compute Properties dialog box appears. optimal values.

Chem & BioOffice 2006 /Chem3D MM2 and MM3 Computations 167
Compute Properties
The Stretch-Bend term represents the energy The steric energy terms for cis-2-butene
required to stretch the two bonds involved in a appears in the Output window.
bond angle when that bond angle is severely
Below is a comparison of the steric energy
compressed.
components for cis-2-butene and trans-2-butene.
Administrator

The Torsion term represents the energy associ-


ated with deforming torsional angles in the
molecule from their ideal values. NOTE: The values of the energy terms shown here are
approximate and can vary slightly based on the type of
The Non-1,4 van der Waals term represents the
processor used to calculate them.
energy for the through-space interaction
between pairs of atoms that are separated by
more than three atoms.
For example, in trans-2-butene, the Non-1,4 van der Energy Term trans-2- cis-2-
Waals energy term includes the energy for the butene butene
interaction of a hydrogen atom bonded to C(1) with
a hydrogen atom bonded to C(4). Stretch: 0.0627 0.0839
The 1,4 van der Waals term represents the energy
for the through-space interaction of atoms Bend: 0.2638 1.3235
separated by two atoms.
For example, in trans-2-butene, the 1,4 van der Stretch-Bend: 0.0163 0.0435
Waals energy term includes the energy for the
interaction of a hydrogen atom bonded to C(1) with Torsion: -1.4369 -1.5366
a hydrogen atom bonded to C(2).
The dipole/dipole steric energy represents the Non-1,4 van der Waals: -0.0193 0.3794
energy associated with the interaction of bond
dipoles. 1,4 van der Waals: 1.1742 1.1621
For example, in trans-2-butene, the Dipole/Dipole
term includes the energy for the interaction of the Dipole/Dipole: 0.0767 0.1032
two C Alkane/C Alkene bond dipoles.
To build a cis-2-butene and compute properties: Total: 0.137 1.5512

1. From the Edit menu, choose Clear to delete


The significant differences between the steric
the model. energy terms for cis and trans-2-butene are in the
2. Double-click in the model window. Bend and Non-1,4 van der Waals steric energy
A text box appears. terms. The Bend term is much higher in cis-2-
butene because the C(1)-C(2)-C(3) and the C(2)-
3. Type cis-2-butene and press the Enter key.
C(3)-C(4) bond angles had to be deformed from
A molecule of cis-2-butene appears in the their optimal value of 122.0 to 127.4 to relieve
model window. some of the steric crowding from the interaction of
4. From the MM2 submenu of the Calculations hydrogens on C(1) and C(4). The interaction of
menu, choose Compute Properties. hydrogens on C(1) and C(4) of trans-2-butene is

168 MM2 and MM3 Computations CambridgeSoft


Compute Properties
much less intense, thus the C(1)-C(2)-C(3) and the Repeating an MM2 Compu-
C(2)-C(3)-C(4) bond angles have values of 123.9,
much closer to the optimal value of 122.0. The
tation
Bend and Non-1,4 van der Waals terms for trans-2- After you perform an MM2 computation, you can
butene are smaller, therefore trans-2-butene has a repeat the job as follows:
lower steric energy than cis-2-butene.
1. Choose Repeat MM2 Job from the MM2
Showing Used Parame- submenu of the Calculations menu,
ters The appropriate dialog box appears.
2. Change parameters if desired and click Run.
You can display all parameters used in an MM2
The computation proceeds.
calculation in the Output window. The list includes
a quality assessment of each parameter. Highest Using JDF Files
quality empirically-derived parameters are rated as 4
while a lowest quality rating of 1 indicates that a The job type and settings are saved in a JDF file if
parameter is a best guess value. you click the Save As button on the dialog box
before running a computation. You can then run
To show the used Parameters:
these computations in a later work session.
From the MM2 submenu of the Calculations
To run a previously created MM2 job:
menu, choose Show Used Parameters.
The parameters appear in the Output window. 1. Choose Run MM2 Job from the MM2 submenu
of the Calculations menu.
2. Choose the file and click Open.
The dialog box for the appropriate
computation appears.
3. Change parameters if desired and click Run.

Chem & BioOffice 2006 /Chem3D MM2 and MM3 Computations 169
Showing Used Parameters
Administrator

170 MM2 and MM3 Computations CambridgeSoft


Showing Used Parameters
Chapter 9: MOPAC Computations
Overview Optimizing Geometry
Optimizing to a Transition State
MOPAC is a molecular computation application
Computing Properties
developed by Dr. James Stewart and supported by
Fujitsu Corporation that features a number of Examples
widely-used, semi-empirical methods. It is available Example: Locating the Eclipsed Transition
in two versions, Professional and Ultra. State of Ethane
MOPAC Pro allows you to compute properties Example 1: The Dipole Moment of
and perform simple (and some advanced) energy Formaldehyde
minimizations, optimize to transition states, and Example 2: Comparing Cation Stabilities in
compute properties. The CS MOPAC Pro a Homologous Series of Molecules
implementation supports MOPAC sparkles, has an
Example 3: Analyzing Charge Distribution
improved user interface, and provides faster
in a Series Of Mono-substituted Phenoxy
calculations. It is included in some versions of
Ions
Chem3D, or may be purchased as an optional
addin. See Example 4: Calculating the Dipole
http://www.cambridgesoft.com/products/family.cfm? Moment of meta-Nitrotoluene
FID=3 for details. Example 5: Comparing the Stability of
MOPAC Ultra is the full MOPAC implementation, Glycine Zwitterion in Water and Gas
and is only available as an optional addin. The CS Phase
MOPAC Ultra implementation provides support Example 6: Hyperfine Coupling Constants
for previously unavailable features such as for the Ethyl Radical
MOZYME and PM5 methods. Example 8: RHF Spin Density for the
For both versions you need a separate installer to Ethyl Radical
install the MOPAC application, and Chem3D must Using MOPAC Properties
be installed first. Either version of MOPAC will Using MOPAC files
work with either version of Chem3D.
The procedures assume you have a basic
CS MOPAC provides a graphical user interface that understanding of the computational concepts and
allows you to perform MOPAC computations terminology of semi-empirical methods, and the
directly on the model in the Chem3D model concepts involved in geometry optimization
window. As a computation progresses, the model (minimization) and single-point computations.
changes appearance to reflect the computed result.
For help with MOPAC, see the online MOPAC
In this section: manual at:
http://www.cachesoftware.com/mopac/Mopac2002
Minimizing Energy manual/

Chem & BioOffice 2006 /Chem3D MOPAC Computations 171


Minimizing Energy Option Function
Minimizing energy is generally the first molecular
computation performed on a model. Optimizer Selects a geometry mini-
Administrator

From the Calculations menu, point to mizer. See Optimizing


MOPAC Interface and choose Minimize Energy. Geometry on page 173 for
more information.
The MOPAC Interface dialog box appears,
with Minimize as the default Job Type.
Solvent Selects a solvent. For more
Figure 9-16: The MOPAC Interface dialog box
information on solvent
effects, see the online
MOPAC manual.

Move Which Allows you to minimize


part of a model by selecting
it.

Minimum RMS Specifies the convergence


criteria for the gradient of
the potential energy surface.
(See also Gradient Norm
on page 177.)

Use MOZYME Ultra For very large


models, alters the way the
SCF is generated, cutting
You may use the defaults, or set your own memory requirements and
parameters. running much faster.

Option Function Display Every Itera- Displays the minimization


tion process live at each itera-
tion in the calculation.
Job Type Sets defaults for different
types of computations. NOTE: Adds significantly
to the time required to
minimize the structure.
Method Selects a method.

Show Output in Sends the output to a text


Wave Function Selects close or open shell.
Notepad file.
See Specifying the Elec-
tronic Configuration on
page 296 for more details.

172 MOPAC Computations CambridgeSoft


Minimizing Energy
you wish to calculate Hyperfine Coupling
Option Function Constants, you must select the UHF wave
function.
Send Back Output Displays the value of each
NOTE: UHF computations take at least twice as
measurement in the Output
window. long as RHF. This may be the deciding consideration of
method when large molecules are being studied.
NOTE: Adds significantly
to the time required to
minimize the structure.
Optimizing Geometry
Chem3D uses the Eigenvector Following (EF)
Notes routine as the default geometry optimization
routine for minimization calculations. EF is
RMSThe default value of 0.100 is a reasonable generally superior to the other minimizers, and is
compromise between accuracy and speed. the default used by MOPAC 2002. (Earlier versions
Reducing the value means that the calculation of MOPAC used BFGS as the default.) The other
continues longer as it tries to get even closer to a alternatives are described below.
minimum. Increasing the value shortens the
calculation, but leaves you farther from a minimum. TS
Increase the value if you want a better optimization The TS optimizer is used to optimize a transition
of a conformation that you know is not a minimum, state. It is inserted automatically when you select
but you want to isolate it for computing Optimize to Transition State from the MOPAC
comparative data. Interface submenu.

BFGS
NOTE: If you want to use a value <0.01, you must specify
LET in the keywords section (General Tab). For large models (over about 500-1,000 atoms) the
suggested optimizer is the Broyden-Fletcher-
Goldfarb-Shanno procedure. By specifying BFGS,
Wave FunctionSelecting a wave function from this procedure will be used instead of EF.
the drop down menu involves deciding whether to
use RHF or UHF computations. LBFGS
RHF is the default Hartree-Fock method used For very large systems, the LBFGS optimizer is
for closed shell systems. To use RHF select the often the only method that can be used. It is based
Close Shell (Restricted) wave function. on the BFGS optimizer, but calculates the inverse
Hessian as needed rather than storing it. Because it
UHF is an alternative form of the HF method uses little memory, it is preferred for optimizing
used for open shell systems. To use UHF select very large systems. It is, however, not as efficient as
the Open Shell (Unrestricted) wave function. If the other optimizers.

Chem & BioOffice 2006 /Chem3D MOPAC Computations 173


Minimizing Energy
Adding Keywords To optimize a transition state:
1. Choose Optimize to Transition State from the
Click the General tab to specify additional MOPAC MOPAC Interface submenu of the
keywords. This will tailor a calculation to more Calculations menu.
Administrator

exacting requirements. For example, you might use The MOPAC Interface dialog box appears.
additional keywords to control convergence criteria,
Figure 9-18: Optimizing to a transition state
to optimize to an excited state instead of the ground
state, or to calculate additional properties.

NOTE: Other properties that you might specify through the


keywords section of the dialog box may affect the outcome. For
more information see Using Keywords on page 294.

Figure 9-17: The General tab

2. On the Job and Theory tab select a Method and


Wave Function.

NOTE: Unless you are an experienced MOPAC


user, use the Transition State defaults.

3. On the Properties tab, select the properties you


wish to calculate from the final optimized
conformation.
4. On the General tab, type any additional
Optimize to Transition State keywords that you want to use to modify the
optimization.
To optimize your model to a transition state, use a 5. Click Run.
conformation that is as close to the transition state The information about the model and the
as possible. Do not use a local or global minimum, keywords are sent to MOPAC. If you have
because the algorithm cannot effectively move the selected Send Back Output, the Output window
geometry from that starting point. appears.

174 MOPAC Computations CambridgeSoft


Minimizing Energy
The Output window displays intermediate
messages about the status of the minimization. A Keyword Description
message appears if the minimization terminates
abnormally, usually due to a poor starting LET Overrides safety checks to
conformation. make the job run faster (or
further).
The following contains keywords automatically sent
to MOPAC and some additional keywords you can RECALC=5 Use this keyword if the optimi-
use to affect convergence. zation has trouble converging
to a transition state.
Keyword Description For descriptions of error messages reported by
MOPAC see Chapter 11, pages 325331, in the
EF Automatically sent to MOPAC MOPAC manual.
to specify the use of the Eigen-
vector Following minimizer. To interrupt a minimization that is in progress:

Click Stop in the Movie Controller.


GEO-OK Automatically sent to MOPAC
to override checking of the Example: Locating the Eclipsed Transi-
Z-matrix.
tion State of Ethane
MMOK Automatically sent to MOPAC Build a model of ethane:
to specify Molecular Mechanics
correction for amide bonds. 1. From the File menu, choose New Model
Use the additional keyword 2. Double-click in the model window.
NOMM to turn this keyword
off. A text box appears.
3. Type CH3CH3 and press the Enter key.
RMAX=n.nn The maximum for the ratio of
A model of ethane appears.
calculated/predicted energy
change. The default is 4.0. 4. Select the Rotation tool.

5. Click the arrow next to the Rotation tool, and


RMIN=n.nn The minimum for the ratio of drag down the Rotation dial.
calculated/predicted energy
Figure 9-19: The Rotation dial
change. The default value is
0.000.
click here to open the
Rotation dial
PRECISE Runs the SCF calculations
using a higher precision so that
values do not fluctuate from
dihedral rotators
run to run.

Chem & BioOffice 2006 /Chem3D MOPAC Computations 175


Minimizing Energy
6. Hold down the S key and select the bond 10.From the MOPAC Interface submenu of the
between the C(1) and C(2) atoms. Calculations menu, choose Optimize to Transi-
tion State.
NOTE: Holding down the S key temporarily
11.Click the Copy Measurements to Messages box
Administrator

activates the Select tool.


on the Job Type tab.
7. Select one of the dihedral rotators, then enter
12.Click Run.
57 in the text box and press the Enter key.
A nearly eclipsed conformation of ethane is The ethane model minimizes so that the
displayed. dihedral is 0 degrees, corresponding to the
eclipsed conformation of ethane, a known
TIP: To view this better, rotate the model on the Y transition state between the staggered minima
axis until the carbon atoms are aligned. conformations.

To see the Newman projection of the eclipsed


Use Mopac to create the precise eclipsed transition
ethane model:
state:
8. Holding down the S and shift keys, click on any 1. Select both carbon atoms.
two nearly eclipsed hydrogen atoms, such as
H(4) and H(7), to identify the dihedral to track. 2. From View Position submenu of the View
menu, click Align View Z-Axis With Selection.
You should have a nearly coplanar four-atom
chain, such as H(4)-C(1)-C(2)-H(7), selected. NOTE: If you perform an Energy Minimization
9. From the Structure menu, point to Measure- from the same starting dihedral, your model would
ments, and choose Dihedral Angle. optimize to the staggered conformation of ethane where
the dihedral is 60 degrees, instead of optimizing to the
The Measurements table appears and displays
transition state.
an actual value for the selected dihedral angle
of about 3 degrees (this will vary slightly
between experiments). Computing Properties
Figure 9-20: Eclipsed transition state with measure-
ments To perform a single point calculation on the current
conformation of a model:

1. From the MOPAC Interface submenu of the


dihedral = 2.9224 Calculations menu, choose Compute
dihedral = 3.1551 Properties.

The Compute Properties dialog box appears.


2. On the Theory tab, choose a potential energy
function to use for performing the calculation.
3. On the Properties tab, select the properties to
calculate.

176 MOPAC Computations CambridgeSoft


Computing Properties
Figure 9-21: The Properties tab The heat of formation is composed of the
following terms:


=
f
e+
l
en+

c
u +
ic
s
o
lal
tom

Where:
Eelec is calculated from the SCF calculation.

Enucl is the core-core repulsion based on the


nuclei in the molecule.
Eisol and Eatoms are parameters supplied by the
4. On the Properties tab, set the charges.
potential function for the elements within your
5. On the General tab, type any additional molecule.
keywords, if necessary.
6. Click Run. NOTE: You can use the keyword ENPART and open the
*.out file at the end of a run to view the energy components
making up the heat of formation and SCF calculations. See
MOPAC Properties the MOPAC online manual reference page 137, for more
information.
The following section describes the properties that
you can calculate for a given conformation of your
model, either as a single point energy computation Gradient Norm
using the Compute Properties command, or after a
minimization using either the Minimize Energy or This is the value of the scalar of the vector of
Optimize to Transition State commands. derivatives with respect to the geometric variables
flagged for optimization. This property (called
Heat of Formation, Hf GNORM in the MOPAC manual) is automatically
selected for a minimization, which calculates the
This energy value represents the heat of formation GNORM and compares it to the selected minimum
for a models current conformation. It is useful for gradient. When the selected minimum is reached,
comparing the stability of conformations of the the minimization terminates.
same model.
Selecting this property for a Compute Properties
operation (where a minimization is not being
NOTE: The heat of formation values include the zero point performed) will give you an idea of how close to
energies. To obtain the zero point energy for a conformation optimum geometry the model is for the particular
run a force operation using the keyword FORCE. The zero- calculation.
point energy is found at the bottom of the *.out file.

NOTE: The GNORM property is not the same as the


The heat of formation in MOPAC is the gas-phase MOPAC keyword GNORM. For more information see the
heat of formation at 298K of one mole of a MOPAC manual, pages 31 and 180.
compound from its elements in their standard state.

Chem & BioOffice 2006 /Chem3D MOPAC Computations 177


Computing Properties
Dipole Moment Mulliken Charges
This property provides a set of charges on an atom
The dipole moment is the first derivative of the
basis derived by reworking the density matrix from
energy with respect to an applied electric field. It the SCF calculation. Unlike the Wang-Ford charges
Administrator

measures the asymmetry in the molecular charge utilized in the previous example, Mulliken charges
distribution and is reported as a vector in three give a quick survey of charge distribution in a
dimensions. molecule.

The dipole value will differ when you choose NOTE: For more information, see the MOPAC online
Mulliken Charges, Wang-Ford Charges or manual, page 41 and 121.
Electrostatic Potential, as a different density matrix
is used in each computation. The following table contains the keywords
automatically sent to MOPAC.

NOTE: For more information see the MOPAC manual, Keyword Description
page 119.
MULLIK Automatically sent to MOPAC to
The following table contains the keywords generate the Mulliken Population
automatically sent to MOPAC. Analysis.

Keyword Description GEO-OK Automatically sent to MOPAC to


override checking of the Z-matrix.
GEO-OK Automatically sent to MOPAC to
override checking of the Z-matrix. MMOK Automatically sent to MOPAC to
specify Molecular Mechanics
MMOK
correction for amide bonds. Use
Automatically sent to MOPAC to
the additional keyword NOMM to
specify Molecular Mechanics
turn this keyword off.
correction for amide bonds. Use the
additional keyword NOMM to turn
this keyword off. Charges From an Electrostatic Potential
The charges derived from an electrostatic potential
computation give useful information about
Charges
chemical reactivity.
The property, Charges, determines the atomic The electrostatic potential is computed by creating
charges using a variety of techniques discussed in an electrostatic potential grid. Chem3D reports the
the following sections. In this example the charges point charges derived from such a grid.
are the electrostatic potential derived charges from In general, these atomic point charges give a better
Wang-Ford, because Wang-Ford charges give useful indication of likely sites of attack when compared to
information about chemical stability (reactivity). atomic charges derived from the Coulson density

178 MOPAC Computations CambridgeSoft


Computing Properties
matrix (Charges) or Mulliken population analysis Electrostatic Potential
(Mulliken Charges). The uses for electrostatic
potential derived charges are generally the same as Use the electrostatic potential property when the
for atomic charges. For examples, see Charges on element coverage of the AM1 potential function
page 178. does not apply to the molecule of interest. For more
information see the MOPAC online manual, page
There are two properties available for calculating 223.
atomic point charges: Wang-Ford Charges and
Electrostatic Potential. The following table contains the keywords
automatically sent to MOPAC and those you can
use to affect this property.
Wang-Ford Charges
This computation of point charges can be used with
the AM1 potential function only. Keyword Description

NOTE: For elements not covered by the AM1 potential ESP Automatically sent to MOPAC to
function, use the Electrostatic Potential property to get specify the Electrostatic Potential
similar information on elements outside this properties range. routine.

Below are the keywords automatically sent to POTWRT Add this keyword if you want to
MOPAC. print out the ESP map values.

GEO-OK Automatically sent to MOPAC to


Keyword Description override checking of the Z-matrix.

PMEP Automatically sent to MOPAC to MMOK Automatically sent to MOPAC to


specify the generation of Point specify Molecular Mechanics
Charges from PMEP. correction for amide bonds. Use
the additional keyword NOMM to
QPMEP Automatically sent to MOPAC to turn this keyword off.
specify the Wang/Ford electro-
static Potential routine. Molecular Surfaces
Molecular surfaces calculate the data necessary to
GEO-OK Automatically sent to MOPAC to
render the Total Charge Density, Molecular
override checking of the Z-matrix.
Electrostatic Potential, Spin Density, and Molecular
Orbitals surfaces.
MMOK Automatically sent to MOPAC to
specify Molecular Mechanics Polarizability
correction for amide bonds. Use
the additional keyword NOMM to The polarizability (and hyperpolarizability)
turn this keyword off. property provides information about the
distribution of electrons based on presence of an

Chem & BioOffice 2006 /Chem3D MOPAC Computations 179


Computing Properties
applied electric field. In general, molecules with Hyperfine interaction of the unpaired electron with
more delocalized electrons have higher values for the central proton and other equivalent protons
this property. cause complex splitting patterns in ESR spectra.
ESR spectroscopy measures the absorption of
Polarizability data is often used in other equations
Administrator

microwave radiation by an unpaired electron when


for evaluation of optical properties of molecules.
it is placed under a strong magnetic field.
For more information see the MOPAC online
manual, page 214. Hyperfine Coupling Constants (HFCs) are related
The polarizability and hyperpolarizability values to the line spacing within the hyperfine pattern of
reported are the first order (alpha) tensors (xx, yy, an ESR spectra and the distance between peaks.
zz, xz, yz, xy), second order (beta) tensors and third
Species that contain unpaired electrons are as
order (gamma) tensors.
follows:

NOTE: Polarizabilities cannot be calculated using the Free radicals


MINDO/3 potential function.
Odd electron molecules

Transition metal complexes


COSMO Solvation in Water
The COSMO method is useful for determining the Rare-earth ions
stability of various species in a solvent. The default Triplet-state molecules
solvent is water. For more information, see the
MOPAC online manual. For more information see the MOPAC online
manual, page 34.
To run the COSMO method, make the following
selections in the MOPAC Interface: The following table contains the keywords
On the Job & Theory tab, select COSMO in automatically sent to MOPAC and those you can
the Solvent field. use to affect this property.
On the Properties tab, check the COSMO Area
and/or COSMO Volume properties. You must Keyword Description
check each property you want to see in the
results. UHF Automatically sent to MOPAC if
you choose Open Shell (Unre-
NOTE: You can also use the Miertus-Scirocco-Tomasi stricted) wave functions to specify
solvation model, which is available using the H2O keyword. the use of the Unrestricted
This method is recommended only for water as the solvent. A Hartree-Fock methods.
discussion of this method can be found in the MOPAC
online documentation. Hyperfine Automatically sent to MOPAC to
specify the hyperfine computation.
Hyperfine Coupling Constants
GEO-OK Automatically sent to MOPAC to
Hyperfine Coupling Constants are useful for override checking of the Z-matrix.
simulating Electron Spin Resonance (ESR) spectra.

180 MOPAC Computations CambridgeSoft


Computing Properties
Keyword Description Keyword Description

MMOK Automatically sent to MOPAC to GEO-OK Automatically sent to MOPAC to


specify Molecular Mechanics override checking of the Z-matrix.
correction for amide bonds. Use
the additional keyword NOMM to MMOK Automatically sent to MOPAC to
turn this keyword off. specify Molecular Mechanics
correction for amide bonds. Use
Spin Density the additional keyword NOMM to
turn this keyword off.
Spin density arises in molecules where there is an
unpaired electron. Spin density data provides SPIN You can add this keyword to print
relative amounts of alpha spin electrons for a the spin density matrix in the *.out
particular state. file.

Spin density is a useful property for accessing sites


RHF Spin Density
of reactivity and for simulating ESR spectra.
RHF Spin Density uses the 1/2 electron correction
Two methods of calculating spin density of and a single configuration interaction calculation to
molecules with unpaired electrons are available: isolate the alpha spin density in a molecule. This
RHF Spin Density and UHF Spin Density. method is particularly useful when the UHF Spin
Density computation becomes too resource
UHF Spin Density intensive for large molecules. For more information
see the MOPAC online manual, page 28.
The UHF Spin Density removes the closed shell
restriction. In doing so, separate wave functions for The following table contains the keywords
alpha and beta spin electrons are computed. For automatically sent to MOPAC and those you can
more information see the MOPAC online manual, use to affect this property.
page 152.
Keyword Description
The following table contains the keywords
automatically sent to MOPAC and those you can ESR Automatically sent to MOPAC to
use to affect this property. specify RHF spin density calcula-
tion.
Keyword Description
GEO-OK Automatically sent to MOPAC to
UHF Automatically sent to MOPAC if override checking of the Z-matrix.
you choose Open Shell (Unre-
stricted) wave functions to specify
the use of the Unrestricted
Hartree-Fock methods.

Chem & BioOffice 2006 /Chem3D MOPAC Computations 181


Computing Properties
The results shown in the Messages window indicate
Keyword Description the electron distribution is skewed in the direction
of the oxygen atom.
MMOK Automatically sent to MOPAC to X Y Z Total
Administrator

specify Molecular Mechanics


correction for amide bonds. Use Dipole -2.317 0.000 -0.000 2.317
the additional keyword NOMM to (vector
turn this keyword off. Debye)

If you rotate your model, the X,Y, and Z


Example 1: The Dipole Moment of
components of the dipole differ. However, the total
Formaldehyde dipole does not. In this example, the model is
oriented so that the significant component of the
To calculate the dipole moment of formaldehyde: dipole lies along the X-axis.
1. From the File menu, choose New Model.
Example 2: Comparing Cation Stabili-
2. Click the Text Building tool. ties in a Homologous Series of Mole-
cules
3. Click in the model window.
To build the model:
A text box appears.
1. From the File menu, choose New Model.
4. Type H2CO and press the Enter key.
2. Click the Text Building tool.
A model of formaldehyde appears.
3. Click in the model window.
Figure 9-22: Formaldehyde model
A text box appears.
4. For tri-chloro, type CCl3 and press the Enter
key.
5. Repeat step 1 through step 4 for the other
cations: type CHCl2 for di-chloro; type CH2Cl
for mono-chloro and CH3 for methyl cation.

NOTE: The cations in this example are even electron


closed shell systems and are assumed to have Singlet
ground state. No modifications through additional
5. From the MOPAC Interface submenu of the keywords are necessary. The default RHF computation
Calculations menu, choose Minimize Energy. is used.

6. On the Theory tab, choose AM1. 6. For each model, click the central carbon, type
+ and press the Enter key.
7. On the Properties tab, select Dipole.
The model changes to a cation and insures that
8. Click Run. the charge is sent to MOPAC.

182 MOPAC Computations CambridgeSoft


Computing Properties
To perform the computation: 5. Click Run.

1. From the MOPAC Interface submenu of the The results for the model appear in the
Calculations menu, choose Minimize Energy. Message window when the computation is
complete.
2. On the Theory tab, choose AM1.
3. On the Properties tab, select Charges in the The molecules are now planar, reflecting sp2
Properties list. hybridization of the central carbon.

4. Select Wang-Ford from the Charges list. The following table shows the results:

tri-chloro cation di-chloro cation mono-chloro cation methyl cation


C(1) 0.03660 C(1) 0.11255 C(1) 0.32463 C(1) 0.72465
Cl(2) 0.31828 Cl(2) 0.33189 Cl(2) 0.35852 H(2) 0.08722
Cl(3) 0.32260 Cl(3) 0.33171 H(3) 0.15844 H(3) 0.09406
Cl(4) 0.32253 H(4) 0.22384 H(4) 0.15841 H(4) 0.09406

From these simple computations, you can reason Figure 9-23: Phenoxide ion model
that the charge of the cation is not localized to the
central carbon, but is rather distributed to different
extents by the other atoms attached to the charged
carbon. The general trend for this group of cations
is that the more chlorine atoms attached to the
charged carbon, the more stable the cation (the
decreasing order of stability is tri-chloro >di-chloro
> mono-chloro > methyl).

Example 3: Analyzing Charge Distribu-


tion in a Series Of Mono-substituted NOTE: All the monosubstituted phenols under
Phenoxy Ions examination are even electron closed shell systems and are
assumed to have Singlet ground state. No modifications by
1. From the File menu, choose New Model. additional keywords are necessary. The default RHF
computation is used.
2. Click the Text Building tool.
5. From the MOPAC Interface submenu of the
3. Click in the model window.
Calculations menu, choose Minimize Energy.
A text box appears. 6. On the Theory tab, choose PM3. This automat-
ically selects Mulliken from the Charges list.
4. Type PhO- and press the Enter key.
7. On the Property tab, select Charges.
A phenoxide ion model appears. 8. Click Run.

Chem & BioOffice 2006 /Chem3D MOPAC Computations 183


Computing Properties
To build para-nitrophenoxide ion:
Phenoxide p-Nitro m- Nitro o-Nitro
1. Click the Text Building tool.
H9 0.12069 H9 0.17553 N9 1.31296 H9 0.16911
2. Click H10, type NO2, then press the Enter key.
Administrator

H10 0.15700 N10 1.38043 H10 0.19979 H10 0.17281


Para nitrophenoxide ion is formed.
H11 0.12067 H11 0.17561 H11 0.14096 H11 0.13932
Perform minimization as in the last step.
H12 0.16946 H12 0.18715 H12 0.17948 H12 0.18090
For the last two monosubstituted nitro
phenols, first, select the nitro group using the O13 -0.70347 O13 -0.65265 O13 -0.71656

Select Tool and press the Delete key. Add the


O14 -0.70345 O14 -0.64406 O14 -0.65424
nitro group at the meta (H9) or ortho (H8) posi-
tion and repeat the analysis.
Example 4: Calculating the Dipole
The data from this series of analyses are shown Moment of meta-Nitrotoluene
below. The substitution of a nitro group at para,
meta and ortho positions shows a decrease in Create a model of m-nitrotoluene:
negative charge at the phenoxy oxygen in the order
1. From the File menu, choose New Model.
meta>para>ortho, where ortho substitution shows
the greatest reduction of negative charge on the 2. Click the Text Building tool.
phenoxy oxygen. You can reason from this data that 3. Click in the model window.
the phenoxy ion is stabilized by nitro substitution at
A text box appears.
the ortho position.
4. Type PhCH3 and press the Enter key.
Phenoxide p-Nitro m- Nitro o-Nitro A model of toluene appears. Reorient the
model using the Trackball tool until it is
C1 0.39572 C1 0.41546 C1 0.38077 C1 0.45789 oriented like the model shown in step 8.
C2 -0.46113 C2 -0.44929 C2 -0.36594 C2 -0.75764 5. From the Edit menu, choose Select All.

6. Select Show Serial Numbers from the Model


C3 -0.09388 C3 -0.00519 C3 -0.33658 C3 0.00316
Display submenu of the View menu.
C4 -0.44560 C4 -0.71261 C4 -0.35950 C4 -0.41505
NOTE: Show Serial Numbers is a toggle. When it is
C5 -0.09385 C5 -0.00521 C5 -0.10939 C5 -0.09544 selected, the number 1 displays in a frame.

C6 -0.46109 C6 -0.44926 C6 -0.41451 C6 -0.38967 7. With the Text Building tool, click H(11), then
type NO2 in the text box that appears.
O7 -0.57746 O7 -0.49291 O7 -0.54186 O7 -0.48265
8. Press the Enter key.
H8 0.16946 H8 0.18718 H8 0.21051 N8 1.38805
A model of m-nitrotoluene appears.

184 MOPAC Computations CambridgeSoft


Computing Properties
Figure 9-24: m-nitrotoluene model The following table contains the keywords
automatically sent to MOPAC and those you can
use to affect this property.

Keyword Description

POLAR Automatically sent to MOPAC


(E=(n1, n2, n3)) to specify the polarizablity
routine. n is the starting voltage
Use MOPAC to find the dipole moment: in eV. The default value is
E = 1.0.
1. From the MOPAC Interface submenu of the
Calculations menu, choose Minimize Energy.
You can reenter the keyword
2. On the Theory tab, choose AM1.
and another value for n to
3. On the Property tab, select Polarizabilities. change the starting voltage.
4. Click Run.
The following table is a subset of the results GEO-OK Automatically sent to MOPAC
showing the effect of an applied electric field on the to override checking of the
first order polarizability for m-nitrotoluene. Z-matrix.

MMOK Automatically sent to MOPAC


Applied to specify Molecular Mechanics
field (eV) alpha xx alpha yy alpha zz correction for amide bonds. Use
the additional keyword NOMM
0.000000 108.23400 97.70127 18.82380 to turn this keyword off.

0.250000 108.40480 97.82726 18.83561 Example 5: Comparing the Stability of


Glycine Zwitterion in Water and Gas
0.500000 108.91847 98.20891 18.86943 Phase
To compare stabilities:

1. From the File menu, choose New Model.

2. Click the Text Building tool.

3. Click in the model window.

A text box appears.


4. Type HGlyOH and press the Enter key.

A model of glycine appears.

Chem & BioOffice 2006 /Chem3D MOPAC Computations 185


Computing Properties
Figure 9-25: Glycine model 4. Perform a minimization with and without the
COSMO solvation property selected as
performed for the glycine model.
The following table summarizes the results of the
Administrator

four analyses.

Form of H Solvent
glycine (kcal/mole) Accessible
5. From the MOPAC Interface submenu of the Surface 2
Calculations menu, choose Minimize Energy.
neutral (H2O) -108.32861 52.36067
6. On the Theory tab, choose PM3.
zwitterion (H2O) -126.93974 52.37133
7. On the Property tab, Ctrl+click Heat of Forma-
tion and COSMO Solvation. neutral (gas) -92.75386
8. Click Run.
zwitterion (gas) -57.83940
The results appear in the Messages window.
9. From the MOPAC Interface submenu of the
From this data you can reason that the glycine
Calculations menu, choose Minimize Energy. zwitterion is the more favored conformation in
water and the neutral form is more favored in gas
10. On the Property tab, deselect COSMO phase.
Solvation.
11. Click Run. Example 6: Hyperfine Coupling
Constants for the Ethyl Radical
The results appear in the Messages window.
To build the model:
To create the zwitterionic form:
1. From the File menu, choose New Model.
1. Click the Text Building tool.
2. Click the Text Building tool.
2. Click the nitrogen, type +, then press the
3. Click in the model window.
Enter key.
A text box appears.
3. Click the oxygen atom, type -, then press the
Enter key. 4. Type EtH and press the Enter key.

The glycine zwitterion is formed. 5. Click the Select tool.


6. Select H(8).
Figure 9-26: Glycine zwitterion
7. Press the Backspace key.
If you have automatic rectification on, a message
appears asking to turn it off to perform this
operation.
8. Click Turn Off Automatic Rectification.
The Ethyl Radical is displayed.

186 MOPAC Computations CambridgeSoft


Computing Properties
Figure 9-27: Ethyl radical model
Hyperfine Coupling Constants

H7 0.05479

Example 7: UHF Spin Density for the


Ethyl Radical
To calculate the UHF spin density:
1. Create the ethyl radical as described in Spin
Density on page 181.
2. From the MOPAC Interface submenu of the
Calculations menu, choose Minimize Energy.
To perform the HFC computation: 3. On the Theory tab, select PM3.
4. On the Properties tab, select Open Shell (Unre-
1. From the MOPAC Interface submenu of the
stricted) and Spin Density.
Calculations menu, choose Minimize Energy.
The Message window displays a list of atomic
2. On the Theory tab, choose the PM3 potential
orbital spin densities.
function and the Open Shell (Unrestricted) wave
function. The atomic orbitals are not labeled for each
value, however, the general rule is shown in the
3. On the Properties tab, choose Hyperfine
table below (MOPAC only uses s, px, py and pz
Coupling Constants. orbitals).
4. Click Run.

The unpaired electron in the ethyl radical is Atomic Orbital Spin Density A.O.
delocalized. Otherwise, there would be no coupling
0.07127 C1 s
constants.
0.06739 C1 px
Hyperfine Coupling Constants
0.08375 C1 py

C1 0.02376 0.94768 C1 pz

C2 -0.00504 -0.01511 C2 S

-0.06345 C2 px
H3 -0.02632
-0.01844 C2 py
H4 -0.02605
-0.03463 C2 pz
H5 0.00350
-0.07896 H3 s

H6 0.05672 0.07815 H4 s

Chem & BioOffice 2006 /Chem3D MOPAC Computations 187


Computing Properties
Atomic Orbital Spin Density A.O. Total Spin Density

0.01046 H5 s 0.04395 H6
Administrator

0.05488 H6 s 0.04216 H7

0.05329 H7 s You can reason from this result that the unpaired
electron in the ethyl radical is more localized on C1.
You can reason from the result shown below that Generally, this is a good indication of the reactive
the unpaired electron in the ethyl radical is more site.
localized at pz orbital on C1. Generally, this is a
good indication of the reactive site MOPAC Files
Example 8: RHF Spin Density for the CS MOPAC can use standard MOPAC text files for
Ethyl Radical input, and creates standard MOPAC output files.
These are especially useful when running repeat
To calculate the RHF spin density: computations.
1. Create the ethyl radical as described in Spin Using the *.out file
Density on page 181.
2. From the MOPAC Interface submenu of the In addition to the Messages window, MOPAC
Calculations menu, choose Minimize Energy. creates two text files that contain information about
the computations.
3. On the Theory tab, choose PM3 and Closed
Shell (Restricted). Each computation performed using MOPAC
4. On the Properties tab, choose Spin Density.
creates a *.out file containing all information
concerning the computation. A summary *.arax file
The Message window displays the total spin is also created, (where x increments from a to z after
densities for each atom (spin densities for all each run). The *.out file is overwritten for each run,
orbitals are totaled for each atom). but a new summary *.arax, file is created after each
computation (*.araa, *.arab, and so on.)
NOTE: You can look in the *.out file for a breakdown of
the spin densities for each atomic orbital. The OUT and AAX files are saved by default to the
\Mopac Interface subfolder in your My Documents
folder. You may specify a different location from
Total Spin Density the General tab of the MOPAC Interface dialog
box.The following information is found in the
0.90744 C1 summary file for each run:
0.00644 C2 Electronic Energy (Eelectronic)

0.00000 H3 Core-Core Repulsion Energy (Enuclear)


Symmetry
0.00000 H4
Ionization Potential
0.00001 H5
HOMO/LUMO energies

188 MOPAC Computations CambridgeSoft


MOPAC Files
The *.out file contains the following information by 2. Select the appropriate settings and click Create.
default.
Running Input Files
Starting atomic coordinates
Starting Z-matrix Chem3D allows you to run previously created
MOPAC input files.
Molecular orbital energies (eigenvalues)
To run an input file:
Ending atomic coordinates
The workings of many of the calculations can also 1. From the MOPAC Interface submenu of the
be printed in the *.out file by specifying the Calculations menu, click Run Input File.
appropriate keywords before running the The Run MOPAC Input File dialog box
calculation. For example, specifying MECI as an appears.
additional keyword will show the derivation of Figure 9-29: The Run MOPAC Input File dialog box
microstates used in an RHF 1/2 electron
approximation calculation. For more information
see Using Keywords on page 294.

NOTE: Close the *.out file while performing MOPAC


computations or the MOPAC application stops functioning.

2. Type the full path of the MOPAC file or


Creating an Input File Browse to the file location.
A MOPAC input file (.MOP) is associated with a 3. Select the appropriate options. For more infor-
model and its dialog box settings. mation about the options see Specifying the
Electronic Configuration on page 296.
To create a MOPAC input file:
4. Click Run.
1. From the MOPAC Interface submenu of the A new model window appears displaying the
Calculations menu, choose Create Input File. initial model. The MOPAC job runs and the
Figure 9-28: Creating an input file results appear.

Chem & BioOffice 2006 /Chem3D MOPAC Computations 189


MOPAC Files
All properties requested for the job appear in 2. Select the JDF file to run.
the *.out file. Only iteration messages appear The dialog box corresponding to the type of
for these jobs. job saved within the file appears.
3. Click Run.
Administrator

NOTE: If you are opening a MOPAC file where a model


has an open valence, such as a radical, you can avoid having
the coordinates readjusted by Chem3D by turning off Repeating MOPAC Jobs
Automatically Rectify in the Building control panel.
After you perform a MOPAC calculation, you can
repeat the job as follows:
NOTE: MOPAC input files that containing multiple
4. From the MOPAC Interface submenu of the
instances of the Z-matrix under examination will not be
Calculations menu, choose Repeat [name of
correctly displayed in Chem3D. This type of MOPAC input
computation].
files includes calculations that use the SADDLE keyword,
or model reaction coordinate geometries. The appropriate dialog box appears.
5. Change parameters if desired and click Run.
Running MOPAC Jobs The computation proceeds.
Chem3D enables you to select a previously created
Creating Structures From
MOPAC job description file (JDF). The JDF file
can be thought of as a set of Settings that apply to a ARC Files
particular dialog box. For more information about
When you perform a MOPAC calculation, the
JDF files see JDF Files on page 153.
results are stored in an ARC file in the \Mopac
To create a JDF file: Interface subfolder in your My Documents folder.

1. From the MOPAC Interface submenu of the You can create a structure from the ARC file as
Calculations menu, choose a calculation. follows:
2. After all settings for the calculation are speci-
1. Open the ARC file in a text editor.
fied, click Save As.
2. Delete the text above the keywords section of
To run a MOPAC job from a JDF file: the file as shown in the following illustration.
1. From the MOPAC Interface submenu of the 3. Save the file with a MOP extension.
Calculations menu, click Run MOPAC Job.
4. Open the MOP file.
The Open dialog box appears.

190 MOPAC Computations CambridgeSoft


MOPAC Files
Delete text through
this line

Keywords
section

Chem & BioOffice 2006 /Chem3D MOPAC Computations 191


MOPAC Files
Administrator

192 MOPAC Computations CambridgeSoft


MOPAC Files
Chapter 10: Gaussian
Overview Predicting Spectra
Gaussian 2003 is a powerful, command-line driven, To run predictions, select the spectrum from the
computational chemistry application including Gaussian Interface submenu of the Calculations
both ab initio and semi empirical methods. It is not menu.
included with Chem3D, but can be purchased
Figure 10-30: Running a Spectrum
directly from CambridgeSoft. You can use the
Online menu command Browse ChemStore.com to
link directly to the website.

Chem3D 10 provides an all-new interface for


Gaussian 2003. The model in the Chem3D window
transparently provides the data for creating
Gaussian jobs or running Gaussian computations.
The new interface supports all Gaussian 2003
calculations, offering the following features not
previously available in Chem3D:

13
C and 1H NMR spectra predictions Predict spectra

IR and Raman spectra predictions


Multi-step Jobs
Partial Optimizations
Support for DFT Methods
Advanced Mode
For information on how to use Gaussian, see the NOTE: Depending on your computers speed and memory,
documentation supplied with the Gaussian Gaussian calculations can be slow. You should only run
application. spectrum predictions on models of small molecules.

New Gaussian Interface


TIP: Run a minimization before predicting spectra. MM2
The new Gaussian interface is more stable and is faster than Gaussian minimization, and is usually
offers more Gaussian features, including prediction adequate. Gaussian may fail to produce a spectrum if the
of NMR, UV, IR, and Raman spectra. It makes use model is not at a minimum energy state.
of COEA, CambridgeSofts new extension
architecture. Some of the new features supported To view the predicted spectra, select the Spectrum
are described in the following sections. Viewer on the View menu.

Chem & BioOffice 2006 /Chem3D Gaussian 193


New Gaussian Interface
Figure 10-31: Selecting the Spectrum Viewer
Administrator

For each prediction that you run on a given


compound, a new tab will open in the Spectrum
Viewer.

Figure 10-32: Predicted spectra for chlorobenzene

Multi-step Jobs
You can link jobs and run them with a single
command. There is no technical limit to the
number of jobs that can be linked. To run multiple
jobs:

194 Gaussian CambridgeSoft


New Gaussian Interface
1. Select your first job (usually Minimization) Figure 12: Setting up a partial optimization
from the Gaussian Interface submenu of the
Calculations menu.
Figure 11: Gaussian Interface

Internal
coordinates

Input Template
The General tab of the Gaussian Interface dialog
2. Click the + button, and use the Job Type
box contains the input template.
drop-down menu to add a new job to the
queue. Figure 13: Input template
3. If you want to remove a job from the queue,
select the Link tab and click the - button.
4. Run the job queue. If you wish to terminate the
runs at any time, use the stop button on the
Calculations toolbar.

Partial Optimizations
To perform a partial optimization:
1. Select a portion of the model. You may
optimize either the selected or unselected
portion, whichever is more convenient.
2. Select optimization from the Gaussian Inter-
face submenu. In the Gaussian Interface
dialog box, click the Internal Coordinates radio
button.
3. In the Move Which text window, indicate
whether the selected or unselected atoms are to You can set output parameters with the checkboxes
be optimized. and edit keywords in the run file.

Chem & BioOffice 2006 /Chem3D Gaussian 195


New Gaussian Interface
Advanced Mode Figure 15: DFT methods

If you are an expert user, you can go directly to a


text entry window similar to the input template. Just
click Use Advanced Mode on the Gaussian
Administrator

Interface submenu.
Figure 14: Advanced Mode

When you have chosen a method, the complete


DFT method information is displayed, and a
button appears next to the Method text box to allow
you to edit your input.

Figure 16: DFT display

Note the Gaussian 2003 Keywords link under the


text window. If you need help, clicking the link
opens your web browser to the keywords page of
the Gaussian website.

Support for DFT Methods


Selecting DFT for Method opens a dialog box
where you can choose which DFT method you
wish to use. Minimizing Energy
Minimizing energy is generally the first molecular
computation performed on a model. You may
minimize all or part of a model. If you are
minimizing part of a model, you should make your
selection of what to include or exclude before
continuing. See Other Options on page 198.

1. From the Calculations menu, point to


Gaussian Interface and choose Minimize
(Energy/Geometry).

The Gaussian Interface dialog box appears,


with Minimize as the default Job Type.

196 Gaussian CambridgeSoft


Minimizing Energy
Figure 10-1Gaussian menu
Option Function

Polarization Specifies a polarization


function for heavy atoms (P,
S, or heavier).

H If you selected a Polariza-


tion function, you should
also choose an H function.

Diffuse Adds a diffuse function to


the basis set. If you use a
diffuse function, you should
also specify Tight Conver-
gence on the Advanced tab.
See the Gaussian manual
for details.

The Advanced tab displays parameters that are


adjusted less often. Only those parameters that
2. You may use the defaults on the Jobs tab, or set
apply to the job type you have selected are active.
your own parameters. For minimizations, they are:

Option Function Option Function

Job Type Sets defaults for different Solvation Model Selects a solvation model.
types of computations. See the SCRF keyword in
the Gaussian manual for
Method Selects a method. information on methods.

Basis Set Specifies the basis set. Most Solvent If you select a solvation
methods require a basis set model, you may select a
be specified. See the Gaus- solvent. The default solvent
sian Help file for excep- for all models is water.
tions.

Wave Function Selects closed or open shell.


See Specifying the Elec-
tronic Configuration on
page 296 for more details.

Chem & BioOffice 2006 /Chem3D Gaussian 197


Minimizing Energy
Selecting the Internal Coordinate radio button allows
Option Function you to minimize only part of the model by choosing
either Selected Atoms or Unselected Atoms.
Force Constants Options are:
3. On the General Tab, set the parameters that
Administrator

No calculation control the output:

Initial force constants


Option Function
(CalcFC)

Calculate at each point Display Every Itera- Displays the minimization


(CalcAll) tion process live at each itera-
tion in the calculation.
Population Analysis Options are: NOTE: Adds significantly
None
to the time required to
minimize the structure.
Fullsame as Regular,
but for all orbitals Show Output in Sends the output to a text
Notepad file.
Minimumoutputs
the total atomic
Send Back Output Displays the value of each
charges and orbital
measurement in the Output
energies
window.
Regular outputs five
NOTE: Adds significantly
highest occupied and
to the time required to
five lowest virtual
minimize the structure.
orbitals, with density
matrices and full
Mulliken population Optimize to Transition State
analysis
To optimize your model to a transition state, use a
Other Options conformation that is as close to the transition state
as possible. Do not use a local or global minimum,
By default, Gaussian uses modest convergence because the algorithm cannot effectively move the
geometry from that starting point.
criteria to speed up calculations. The Use Tight
Convergence checkbox adds the keyword tight to To optimize a transition state:
the input template to specify full convergence. You
may also add a charge by first deselecting the default 1. From the Calculations menu, point to
Use Formal Charge checkbox, or change the Spin Gaussian Interface, and choose Optimize to
Transition State.
Multiplicity. Spins can be positive integers. Charges
may be plus or minus. The Gaussian Interface dialog box appears.

198 Gaussian CambridgeSoft


Minimizing Energy
Figure 10-2: Optimizing to a transition state Figure 10-3: The Properties tab

2. Select the properties to estimate.

3. Click the Run button.

Job Description File


2. You may use the defaults, or set your own Formats
parameters.
Job description files are like Preferences files; they
NOTE: Unless you are an experienced Gaussian store the settings of the dialog box. You may save
user, use the Transition State defaults. the file as either a JDF or a JDT type. You modify
and save JDF files more easily than JDT files.
3. On the Properties tab, select the properties you
wish to calculate from the final optimized
conformation. JDT Format
4. On the General tab, type any additional The JDT format is a template format intended to
keywords that you want to use to modify the serve as a foundation from which other job types
optimization. may be derived. The Minimize Energy and
5. Click Run. Compute Properties job types supplied with
Chem3D are examples of these. To discourage
Computing Properties modification of these files, the Save button is
deactivated in the dialog box of a template file.
To specify the parameters for computations to
predict properties of a model: JDF Format
1. From the Calculations menu, point to The JDF format is a file format for saving job
Gaussian and choose Compute Properties. descriptions. Clicking Save within the dialog box
The Gaussian Interface dialog box appears, saves modifications without the appearance of a
with the Properties tab selected. warning or confirmation dialog box.

Chem & BioOffice 2006 /Chem3D Gaussian 199


Computing Properties
Saving either format within the Gaussian Job folder 4. Click Run.
adds it to the Gaussian submenu for convenient
access. The Gaussian job runs. At a certain point, a
new tab opens and the model appears in the
Job description files are like Preferences files; they Model Window.
Administrator

store the settings of the dialog box. You may save


the file as either a JDF or a JDT type. You modify Running a Gaussian Job
and save JDF files more easily than JDT files.
Chem3D enables you to select a previously created
Running a Gaussian Input Gaussian job description file (JDF). The JDF file
File can be thought of as a set of Settings that apply to a
particular dialog box.
If you have a previously created GJF Gaussian
input file, you can run the file from within Chem3D. You can create a JDF file from the dialog box of any
of the Gaussian calculations (Minimize Energy,
To run a Gaussian input file:
Optimize to Transition State) by clicking Save As
1. From the Calculations menu, point to after all Settings for the calculation have been set.
Gaussian Interface and choose Run Input File. For more information about JDF files see Job
The Run Gaussian Input File dialog box Description File Formats on page 153.
appears.
To run a Gaussian job:
Figure 10-4: The Run Gaussian Input file dialog box
1. From the Gaussian submenu, choose Run
Gaussian Job.

The Open dialog box appears.


2. Select the file to run.

The dialog box corresponding to the type of


2. Type the full path of the Gaussian file or job (Minimize Energy, Compute Properties,
Browse to location. and so on.) saved within the file appears.
3. Select the appropriate options. 3. Click Run.

If you want to Then click Chem3D enables you to select a previously created
Gaussian job description file (JDF). The JDF file
can be thought of as a set of Settings that apply to a
Automatically Parse Results
particular dialog box.

save the output to a Show Output in Notepad You can create a JDF file from the dialog box of any
file. of the Gaussian calculations (Minimize Energy,
Optimize to Transition State) by clicking Save As
display the results in Send Back Output after all Settings for the calculation have been set.
the Output window For more information about JDF files see Job
Description File Formats on page 153.

200 Gaussian CambridgeSoft


Job Description File Formats
To run a Gaussian job: Repeating a Gaussian Job
1. From the Gaussian submenu, choose Run After you perform a Gaussian calculation, you can
Gaussian Job. repeat the job as follows:
The Open dialog box appears. 1. From the Gaussian submenu, choose Repeat
2. Select the file to run. [name of computation].
The appropriate dialog box appears.
The dialog box corresponding to the type of
job (Minimize Energy, Compute Properties, 2. Change parameters if desired and click Run.
and so on.) saved within the file appears. The computation proceeds.
3. Click Run.

Chem & BioOffice 2006 /Chem3D Gaussian 201


Job Description File Formats
Administrator

202 Gaussian CambridgeSoft


Job Description File Formats
Chapter 11 : GAMESS Computa-
tions
GAMESS Overview Optimize to Transition State
Compute Properties
The General Atomic and Molecular Electronic
Run Frequency
Structure System (GAMESS) is a general ab initio
quantum chemistry package maintained by the Predict IR/Raman Spectra
Gordon research group at Iowa State University. It Predict NMR Spectra
computes wavefunctions using RHF, ROHF, UHF, When you choose one of these options, The
GVB, and MCSCF. CI and MP2 energy corrections GAMESS Interface dialog box appears, with the
are available for some of these. recommended default parameters for that
GAMESS is a command-line application, which computation chosen. You may change parameters
requires a user to type text-based commands and on any of the tabbed pages of the dialog box before
data. Chem3D serves as a front-end graphical user running the computation. Thus, the options are a
interface (GUI), allowing you create and run convenience in that they insert defaults. If you
GAMESS jobs from within Chem3D. know what parameter settings you want to use, you
can run any computation using any of the options
New in version 10, the GAMESS application is as a starting point. If you are familiar with the
installed automatically with Chem3D. You must, GAMESS keywords, you can choose Use Advanced
however, accept a license agreement and register Mode and get a GUI version of the command line
the software before you can use it. This is done interface.
automatically by Chem3D the first time you use the
GAMESS computation option. You can download Minimize Energy
the GAMESS documentation from the following
web site: To perform a GAMESS Minimize Energy
http://www.msg.ameslab.gov/GAMESS/ computation on a model:
GAMESS.html
1. From the Calculations menu, point to
The computation options on the GAMESS GAMESS and choose Minimize Energy.
interface menu are:
The Minimize Energy dialog box appears
Minimize Energy with the Job & Theory tab displayed.

Chem & BioOffice 2006 /Chem3D GAMESS Computations 203


Minimize Energy
Figure 11-5: GAMESS minimizing energy 5. Set the Polarization functions.

If you select a function for Heavy Atom, also


select an H option.
Administrator

6. Select a Spin Multiplicity value between 1 and


10.

The General Tab


Use the General tab to set options for display and
recording results of calculations.

To set the job type options:

1. In the Minimize Energy dialog box, click the


Job Type tab.
2. Use the tabs to customize your computation.
2. Select the appropriate options:
See the following sections for details.
3. Click Run.
If you want to Then click

The Job & Theory Tab


watch the minimiza- Display Every Iteration
Use the Job & Theory tab to specify the combination tion process live at
of basis set and particular electronic structure each iteration in the NOTE: Displaying or
calculation recording each iteration
theory. By default, this tab is optimized for setting
adds significantly to the
up ab initio computations.
time required to
For more detailed information, see the $BASIS minimize the structure.
section of the GAMESS documentation.
record each iteration Record Every Iteration
To specify the calculation settings: as a frame in a movie
for later replay
1. From the Method list, choose a method.
2. From the Wave Function list, choose a function. view the value of Copy Measurements to
3. From the Basis Set list, choose the basis set. each measurement in Output
the Measurement
NOTE: To use a Method or Basis Set that is not on table
the list, type it in the Additional Keywords section on
the General tab. For more information, see Specifying calculate using the Use Tight Convergence
the General Settings on page 205. equivalent to the Criteria
Gamess keyword
4. From the Diffuse list, select the diffuse function Opt=Tight
to add to the basis set.

204 GAMESS Computations CambridgeSoft


Minimize Energy
Specifying Properties to To set the General settings:
Compute 1. In the Minimize Energy dialog box, click
General.
Use the Properties tab to specify which properties Figure 11-7: The General tab
are computed. The default Population Analysis type
is Mulliken.

To specify properties:

1. In the Minimize Energy dialog box, click


Properties.

Figure 11-6: The Properties tab

2. On the General tab, set the following options:


Select the Solvation model.
Type the dielectric constant for the solvent.
The box does not appear for gas-phase
computations.
In the Results In box, type or browse to the
path to the directory where results are
stored.
2. On the Properties tab, set the following options: If desired, add GAMESS keywords to the
Additional Keywords dialog box.
Select the properties to calculate
Saving Customized Job
Select the Population Analysis type
Descriptions
Specifying the General After you customize a job description, you can save
Settings it as a Job Description file to use for future
calculations.
Use the General tab to customize the calculation to For more information, see Job Description File
the model. Formats on page 153.

Chem & BioOffice 2006 /Chem3D GAMESS Computations 205


Saving Customized Job Descriptions
To save a GAMESS job: To run the job file:

1. On the General tab, type the name of the file in 1. From the Calculations menu, point to
the Menu Item Name text box. GAMESS and choose Run a Job.
The Open dialog box appears.
Administrator

The name you choose will appear in the


GAMESS menu. 2. Type the full path of the GAMESS file or
Browse to location.
2. Click Save As.
3. Click Open.
The Save dialog box appears. The appropriate dialog box appears.
3. Open the folder 4. Change settings on the tabs if desired.
\Chem3D\C3D Extensions\GAMESS Job.
5. Click Run
NOTE: You must save the file in the GAMESS Job 6. Repeating a GAMESS Job
folder for it to appear in the menu. After a GAMESS computation has been
performed, you can repeat it using the GAMESS
4. Select the .jdf or .jdt file type. menu.
5. Click Save. To repeat a GAMESS job:
Your custom job description appears in the 7. From the Calculations menu, point to
GAMESS menu. GAMESS and choose Repeat [name of computa-
tion].
Running a GAMESS Job The appropriate dialog box appears.
If you have a previously created an INP GAMESS 8. Change parameters if desired and click Run.
job file, you can run the file in Chem3D. The computation is run.

206 GAMESS Computations CambridgeSoft


Running a GAMESS Job
Chapter 12: Jaguar
Overview 1. From the Calculations menu, point to Jaguar
Interface and choose Minimize
SCHRDINGER Jaguar is a high-performance (Energy/Geometry).
ab initio package for both gas and solution phase The Jaguar Interface dialog box appears, with
simulations, with particular strength in treating Minimize as the default Job Type.
metal containing systems. It is a practical quantum Figure 12-8: Jaguar minimization dialog box
mechanical tool for solving real-world problems.
The new Chem3D interface is the only Windows
platform GUI for Jaguar. The model in the
Chem3D window transparently provides the data
for creating Jaguar input files or running Jaguar
computations. The new interface offers the
following features:
Minimizing Energy/Geometry
Optimize to Transition State
Predict IR and Raman Spectra
Computing Properties
Advanced Mode
Jaguar must be purchased as a separate addin.
Academic customers may purchase Jaguar from
Cambridgesoft, see http://www.chem3d.com for
details. Commercial customers should go to
2. You may use the defaults on the Jobs tab, or set
http://www.schrodinger.com for information. For
your own parameters.
information on how to use Jaguar, see the
documentation supplied with the Jaguar
application. Option Function

Minimizing Energy Job Type Sets defaults for different


types of computations.
Minimizing energy is generally the first molecular
computation performed on a model. You may Method Selects a method.
minimize all or part of a model. If you are
minimizing part of a model, you should make your
selection of what to include or exclude before
continuing.

Chem & BioOffice 2006 /Chem3D Jaguar 207


Minimizing Energy
Option Function Option Function

Basis Set Specifies the basis set. Most Max Iterations Maximum iterations, if
Administrator

methods require a basis set minimum is not reached


be specified. See the Jaguar sooner. Default is 100.
Help file for exceptions.
Pressure Default is 1 atm.
Wave Function Selects closed or open shell.
See Specifying the Elec- Temperature Default is 0C (298.15K).
tronic Configuration on
page 296 for more details.
Spin Multiplicity A positive integer. Default
is 1.
Polarization Specifies a polarization
function for heavy atoms (P,
Net Charge You may set a positive or
S, or heavier).
negative charge by dese-
lecting the Use Formal
Diffuse Adds a diffuse function to Charge checkbox and
the basis set. If you use a entering a value.
diffuse function, you should
also specify Tight Conver-
gence on the Advanced tab. Optimize to Transition
See the Jaguar manual for State
details.
To optimize your model to a transition state, use a
Move Which Used for partial minimiza- conformation that is as close to the transition state
tion. You may optimize the as possible. Do not use a local or global minimum,
selected or unselected because the algorithm cannot effectively move the
portion of the model, geometry from that starting point.
whichever is more conve-
nient To optimize a transition state:

Coord. System Select Cartesian or Internal 1. From the Calculations menu, point to Jaguar
Coordinate radio button. Interface, and choose Optimize to Transition
State.

The Jaguar Interface dialog box appears.

208 Jaguar CambridgeSoft


Optimize to Transition State
Figure 12-9: Jaguar optimize to transition state dialog 1. Run a minimization. If you have not run the
box Jaguar minimization routine on the model, the
MM2 tool on the Calculation toolbar is faster
and usually adequate.
2. Point to Jaguar Interface on the Calculations
menu, and select Predict IR Spectrum.
3. Click the Run button.
The predicted spectrum appears in the
Spectrum Viewer.

Computing Properties
To specify the parameters for computations to
predict properties of a model:
1. From the Calculations menu, point to Jaguar
and choose Compute Properties.
The Jaguar Interface dialog box appears, with
the Properties tab selected.
Figure 12-10: Computing Jaguar properties

2. You may use the defaults, or set your own


parameters.

NOTE: Unless you are an experienced Jaguar user,


use the Transition State defaults.

3. On the Properties tab, select the properties you


wish to calculate from the final optimized
conformation.

4. On the General tab, type any additional


keywords that you want to use to modify the
optimization.

5. Click Run.

Predicting Spectra
2. Select the properties to estimate.
To predict an IR spectrum: 3. Click the Run button.

Chem & BioOffice 2006 /Chem3D Jaguar 209


Predicting Spectra
Advanced Mode Figure 12-11: Advanced Mode

If you are an expert user, you can go directly to a


text entry window similar to the input template. Just
Administrator

click Use Advanced Mode on the Jaguar Interface


submenu.

Note the Online Jaguar Keywords link under the


text window. If you need help, clicking the link
opens your web browser to the keywords page of
the Schrdinger website.

210 Jaguar CambridgeSoft


Advanced Mode
Appendix A: Substructures
Overview Angles and measurements
In addition to the attachment points, the
You can define substructures and add them to a
substructures table. When you define a measurements between the selected atoms and
substructure, the attachment points (where nearby unselected atoms are saved with the
unselected atoms are bonded to selected atoms) are substructure to position the substructure relative to
stored with the substructure. other atoms when the substructure is used to
convert labels into atoms and bonds.
If a substructure contains more than one For example, Chem3D stores with the substructure
attachment point (such as Ala), the atom with the a dihedral angle formed by two atoms in the
lowest serial number normally becomes the first substructure and two unselected atoms. If more
attachment point. The atom with the second lowest than one dihedral angle can be composed from
serial number becomes the second attachment selected (substructure) and unselected
point, and so on. However, there are situations (non-substructure) atoms, the dihedral angle that is
where this general rule is not valid. saved with the substructure consists of the atoms
with the lowest serial numbers.
Attachment point rules Consider the following model to define a
substructure for alanine:
The following rules cover all possible situations for
Figure A-12: Alanine substructure
multiple attachment points in substructures; Rule 3
is the normal situation described above:

1. If an atom has an open valence and is not


attached to an atom that is unselected, it goes
after any atom that is attached to an unselected
atom.
2. If an atom is attached only to rectification
atoms, it goes after any atom that is attached to
non-rectification atoms.
3. If two atoms are the same according to the
Since polypeptides are specified beginning with the
above criteria, the atom with the lowest serial N-terminal amino acid, N(4) should have a lower
number goes first. serial number than the Carboxyl C(6). To ensure
that a chain of alanine substructures is formed
4. If two atoms are the same according to the correctly, C(1) should have a lower serial number
above criteria, then the one which is attached to than O(3) so that the C-C-N-C dihedral angle is
the atom with the lowest serial number goes used to position adjacent substructures within a
first. label.

Chem & BioOffice 2006 /Chem3D Substructures 211


Defining Substructures Select atoms 3-5 (the two oxygens and the carbon
between them) and using the instructions above,
To define a substructure: create a new record in the Substructures Table.
If you want to append an ester onto the end of the
Administrator

1. Build a model of the substructure. You can use


chain as a carboxylic acid, you can simply
Chem3D tools, or build it in the ChemDraw double-click a hydrogen to replace it with the ester
panel. (as long as the name of the substructure is in the
2. Select the atoms to define. text box). Replacing H(8) (of the original structure)
would produce the following structure:
3. From the Edit menu, choose Copy.
Figure A-14: Extended ethoxypropanol model
To save the substructure definition:

1. Open Substructures.xml. From the

2. View menu, point to Parameter Tables and


choose Substructures.
3. Right-click in the Substructures table and
choose Append Row.
A new row is added to the table. Notice that the carbon atom in the ester has
4. Select the cell in the Model column. replaced the hydrogen. This is because, when the
ester was defined, the carbon atom had a lower
5. Right-click in the cell and choose Paste from serial number (3) than the oxygen atom that formed
the context menu. the other attachment point in the substructure (5).
The structure is pasted into the table cell. Note
that it will be not be visible until you move to NOTE: When defining substructures with multiple
another cell. attachment points, it is critical to note the serial numbers of
6. Select the cell in the Name column.
the atoms in the substructure so that you can correctly orient
the substructure when it is inserted in the model. See the rules
7. Type a name for the substructure. for multiple attachment points discussed at the beginning of
8. Close and save the Substructures table. this section.

For example, consider an ester substructure,


R1COOR2. You can build this substructure as part
of the following model:
Figure A-13: Ethoxypropanol model

212 Substructures CambridgeSoft


Defining Substructures
Appendix B: Keyboard Modifiers
The following tables list the keyboard modifiers that allow you to manipulate your view of the model without
changing tools.

Rotation

Key Drag Shift+Drag

ALT Trackball rotate view Trackball rotate model selection

Shift+B Rotate 1/2 of fragment around bond


Shift+N which fragment rotates depends on the order in
which the atoms were selected.

V Rotate view about selected bond Rotate model selection about axis

X Rotate view about view X axis Rotate model about view X axis

Y Rotate view about view Y axis Rotate model about view Y axis

Z Rotate view about view Z axis Rotate model about view Z axis

In addition to the keyboard shortcuts, you can rotate a model by dragging with the mouse while holding down
both the middle mouse button or scroll wheel and the left mouse button. Tip: The order is important; press the middle
button first.

Zoom and Translate

Key Drag Shift+Drag

CTRL Translate view Translate model selection

A Zoom to center

Chem & BioOffice 2006 /Chem3D Keyboard Modifiers 213


Key Drag Shift+Drag

Q Zoom to rotation center


Administrator

W Zoom to selection center

If you have a wheel mouse, you may also use the scroll wheel to zoom. Dragging with the middle button or
scroll wheel translates the view.

Selection
Standard Selection

Key Click Shift+Click Drag Shift+Drag

S Select atom/bond Multiple select atom/bond Box select atoms Multiple box select
/bonds atoms /bonds

Notes: Double-clicking a selected fragment selects the


next higher fragment; that is, each double-click
Clicking a bond selects the bond and the two moves you up one in the hierarchy until you
atoms connected to it. have selected the entire model.
Double-clicking an atom or bond selects the
fragment that atom or bond belongs to. Radial Selection
Radial selection is selection of an object or group of objects based on the distance or radius from a selected
object or group of objects. This feature is particularly useful for highlighting the binding site of a protein. Radial
selection is accessed through the Select submenu of the context menu in the Model Explorer or 3D display.

214 Keyboard Modifiers CambridgeSoft


Selection
In all cases, multiple selection is specified by holding the shift key down while making the selections.

Submenu option Effect

Select Atoms within Distance of Selects all atoms (except for those already selected) lying within the speci-
Selection fied distance from any part of the current selection. The current selection
will be un-selected unless multiple selection is used.

Select Groups within Distance Selects all groups (except for those already selected) that contain one or
of Selection more atoms lying within the specified distance from any part of the current
selection. The current selection will be un-selected unless multiple selec-
tion is used.

Select Atoms within Radius of Selects all atoms (except for those already selected) lying within the speci-
Selection Centroid fied distance of the centroid of the current selection. The current selection
will be un-selected unless multiple selection is used.

Select Groups within Radius of Selects all groups (except for those already selected) that contain one or
Selection Centroid more atoms lying within the specified distance of the centroid of the
current selection. The current selection will be un-selected unless multiple
selection is used.

Chem & BioOffice 2006 /Chem3D Keyboard Modifiers 215


Selection
Administrator

216 Keyboard Modifiers CambridgeSoft


Selection
Appendix C: Atom Types
Overview The number of double, triple and delocalized
bonds.
Chem3D assigns atom types when you build with
Automatically Correct Atom Types turned on. You NOTE: For comparing bond orders, an atom type that
can also create your own atom types. contains one double bond may be assigned to an atom that
contains two delocalized bonds. For example, all six carbons
Assigning Atom Types in benzene are C Alkene.
When you replace atoms, Chem3D attempts to
assign the best atom type to each atom by If the maximum ring size field of an atom type is
comparing the information about the atom (such as specified, then the atom must be in a ring of that
its symbol and the number of bonds to the atom) to size or smaller to be assigned the corresponding
each atom type record in the Atom Type table. atom type.
When you have selected the Automatically Correct If an atom is bound to fewer ligands than are
Atom Types check box in the Building control specified by an atom type geometry but the
panel, atom types are corrected when you delete rectification type is specified, then the atom can be
atoms or bonds, or when you add atoms or bonds. assigned to that atom type. Chem3D fills the open
In addition, if this check box is selected, then the valences with rectification atoms.
atom types of pre-existing atoms may change when
you replace other atoms with other atoms of a For example, consider the atom types for the
different type. following structure:

If the wrong atom type is assigned to an atom, you Figure C-15: Ethanoic acid model
can specify the correct atom type by selecting the
Text Building Tool, clicking the atom, typing the
name of the atom type into the text box, and
pressing the Enter key.

Atom Type Characteristics


The characteristics of an atom must match the
following atom type characteristics for Chem3D to
assign the atom type to the atom.
The symbol.
O(3) matches the criteria specified for the atom
The bound-to type (if specified for the atom type O Carbonyl. Specifically, it is labeled O, it is
type). bound to a C Carbonyl by a double bond and it is
The bound-to order (if the bound-to type is attached to exactly one double bond and no triple
specified). bonds.

Chem & BioOffice 2006 /Chem3D Atom Types 217


If an atom can be assigned to more than one atom the priority list above) is given precedence over the
type, atom types are assigned to atoms in the other two possibilities, the O Carboxyl atom type is
following order: assigned to the oxygen atom.

1. Atom types whose bound-to types are Defining Atom Types


Administrator

specified and are not the same as their


rectification types. If you need to define atom types, whether to add to
the atom types table for building or to add to a file
2. Atom types whose bound-to types are speci- format interpreter for importing, here is the general
fied and are the same as their rectification procedure:
types.
To add or edit an atom type to the Atom Types
3. Atom types whose bound-to types are not table:
specified.
1. From the View menu, point to Parameter
For example, in the model depicted above, O(4) Tables and choose Atom Types.
could be one of several atom types. First, it could be
an O Ether atom for which the bound-to type is The Atom Types table opens in a window.
unspecified (priority number 3, above). 2. To edit an atom type, click in the cell that you
Alternatively, it could be an O Alcohol for which want to change and type new information.
the bound-to type is the same as the rectification 3. Enter the appropriate data in each field of the
type, H Alcohol (priority number 2, above). A third table. Be sure that the name for the parameter
possibility is O Carboxyl, for which the bound-to is not duplicated elsewhere in the table.
type is C Carbonyl and the rectification type is H 4. Close and Save the table.
Carboxyl (priority number 1). Because the
characteristic of a specified bound-to type which is You now can use the newly defined atom type.
not the same as the rectification type (number 1 in

218 Atom Types CambridgeSoft


Appendix D: 2D to 3D Conversion
Overview indicate the opposite: the atom at the wide end of a
wedged hashed bond is behind the atom at the
This section discusses how Chem3D performs the other end of the bond.
conversion from two to three dimensions when
opening a ChemDraw or ISIS/Draw document, Example 1
when pasting a ChemDraw or ISIS/Draw structure
Figure D-17: Trans phenyl rings
from the Clipboard, or when opening a ChemDraw
connection table file. While Chem3D can read in
and assimilate any ChemDraw structure, you can
assist Chem3D in the two- to three-dimensional
conversion of your models by following the
suggestions in this Appendix.

Chem3D uses the atom labels and bonds drawn in In Example 1, the two phenyl rings are trans about
ChemDraw to form the structure of your model. the cyclopentane ring. The phenyl ring on the left is
For every bond drawn in ChemDraw, a attached by a wedged hashed bond; the phenyl ring
corresponding bond is created in Chem3D. Every on the right is attached by a wedged bond.
atom label is converted into at least one atom.
You can also use dashed, hashed, and bold bonds.
Dative bonds are converted to single bonds with a However, you should be aware of potential
positive formal charge added to one atom (the atom ambiguity where these non-directional bonds are
at the tail of the dative bond) and a negative formal used. A dashed, hashed, or bold bond must be
charge added to the other (the head of the dative between one atom that has at least three
bond). attachments and one atom that has no more than
two attachments, including the dashed, hashed, or
Figure D-16: Dative bond
+ - bold bond.
S O
Example 2
Stereochemical Relation-
Figure D-18: Nitrogen behind the ring
ships
Chem3D uses the stereo bonds and H-Dot and
H-Dash atom labels in a ChemDraw structure to
define the stereochemical relationships in the NH2
corresponding model. Wedged bonds in
ChemDraw indicate a bond where the atom at the In Example 2, the nitrogen atom is placed behind
wide end of the bond is in front of the atom at the the ring system and the two methyl groups are
narrow end of the bond. Wedged hashed bonds placed in front of the ring system. Each of these

Chem & BioOffice 2006 /Chem3D 2D to 3D Conversion 219


three atoms is bonded to only one other atom, so Example 4 shows cis-decalin on the left and
they are presumed to be at the wide ends of the trans-decalin on the right as they would be drawn in
stereo bonds. ChemDraw to be read in by Chem3D. Of course,
you can specify a cis fusion with two H-Dots
Administrator

Example 3 instead of two H-Dashes.


Figure D-19: Ambiguous bond As a general rule, the more stereo bonds you
include in your model, the greater is the probability
that Chem3D will make correct choices for chirality
and dihedral angles.
When converting two-dimensional structures,
H Chem3D uses standard bond lengths and angles as
specified in the current set of parameters. If
Chem3D tries to translate strained ring systems, the
In Example 3, however, the hashed bond is ring closures will not be of the correct length or
ambiguous because both atoms on the hashed bond angle.
are attached to more than two bonds. In this case
the hashed bond is treated like a solid bond. Wavy Labels
bonds are always treated like solid bonds.
Chem3D uses the atom labels in a two-dimensional
H-Dots and H-Dashes are also used to indicate structure to determine the atom types of the atoms.
stereochemistry. H-Dots become hydrogen atoms Unlabeled atoms are assumed to be carbon. Labels
attached to carbon atoms by a wedged bond. are converted into atoms and bonds using the same
H-Dashes become hydrogen atoms attached by a method as that used to convert the text in a text box
wedged hashed bond. into atoms and bonds. Therefore, labels can contain
several atoms or even substructures.
Example 4
Figure D-20: Cis and trans models

H H H H

cis-decalin trans-decalin

220 2D to 3D Conversion CambridgeSoft


Appendix E: File Formats
Editing File Format Atom The remaining fields (Symbol, Charge, Maximum
Ring Size, Rectification type, Geometry, Number of
Types Double Bonds, Number of Triple Bonds, Number
of Delocalized Bonds, Bound to Order and Bound
Some file formats contain information describing to Type) contain information corresponding to the
the atom types that the file format understands. information in an Atom Types table.
Typically, these atom types are ordered by some set
of numbers, similar to the atom type numbers used File Format Examples
in the Atom Types table. If the file format needs to
support additional types of atoms, you can supply The following sections provide examples of the
those types by editing the file format atom types. files created when you save Chem3D files using the
provided file formats.
Chem3D 10 uses XML tables for storing file
formats. You can edit these tables in any text editor Alchemy File
or in Chem3D by selecting the table you want to
edit from the Parameter Tables list on the View The following is a sample Alchemy file1 (Alchemy)
menu. created using Chem3D for a model of
cyclohexanol. The numbers in the first column are
TIP: The XML files are in the path line numbers that are added for reference only.
...\Chem3D\C3D Items\ 1 19 19
ATOMS BONDS
2 1 C3 -1.1236 -0.177 0.059
Name
3 2 C3 -0.26 -0.856 -1.0224
Each atom type is described by a name. This name 4 3 C3 1.01 -0.0491 -1.3267
is a number found in files of the format described 5 4 C3 1.838 0.1626 -0.0526
by the file format. All names must be unique. The
6 5 C3 0.9934 0.8543 1.0252
records in the table window are sorted by name.
7 6 C3 -0.2815 0.0527 1.3275
8 7 O3 -2.1621 -1.0585 0.3907
NOTE: While names are similar to atom type numbers,
they do not have to correspond to the atom type numbers of 9 8H -1.4448 0.8185 -0.3338
atom types. In some cases, however, they do correspond. 10 9H -0.8497 -0.979 -1.9623
11 10 H 0.0275 -1.8784 -0.6806
12 11 H 1.6239 -0.5794 -2.0941
Description 13 12 H 0.729 0.9408 -1.7589
The second field contains a description of the atom 14 13 H 2.197 -0.8229 0.3289
type, such as C Alkane. This description is included 1. Alchemy III is a registered trademark
for your reference only. of Tripos Associates, Inc.

Chem & BioOffice 2006 /Chem3D File Formats 221


File Format Examples
15 14 H 2.7422 0.7763 -0.282 the X coordinate, the fourth field is the
16 15 H 1.5961 0.9769 1.9574 Y coordinate and the fifth field is the
Z coordinate.
17 16 H 0.7156 1.8784 0.679
Administrator

18 17 H -0.8718 0.6068 2.0941 NOTE: Atom types in the Alchemy file format are
19 18 H -0.004 -0.9319 1.7721 user-definable. See Editing File Format Atom Types
20 19 H -2.7422 -0.593 0.9688 on page 221 for instructions on modifying or creating an
21 1 1 2 SINGLE atom type.
22 2 1 6 SINGLE
3. Lines 2140 each contain 4 fields describing
23 3 1 7 SINGLE
information about each of the bonds in the
24 4 1 8 SINGLE molecule. The first field is the bond number
25 5 2 3 SINGLE (ranging from 1 to the number of bonds), the
26 6 2 9 SINGLE second field is the serial number of the atom
27 7 2 10 SINGLE where the bond begins, the third field is the
serial number of the atom where the bond
28 8 3 4 SINGLE
ends, and the fourth field is the bond type. The
29 9 3 11 SINGLE possible bond types are: SINGLE, DOUBLE,
30 10 3 12 SINGLE TRIPLE, AMIDE, or AROMATIC. Note that
31 11 4 5 SINGLE all the bond order names are padded on the
32 12 4 13 SINGLE right with spaces to eight characters.
33 13 4 14 SINGLE
34 14 5 6 SINGLE FORTRAN Formats
35 15 5 15 SINGLE The FORTRAN format for each record of the
36 16 5 16 SINGLE Alchemy file is as follows:
37 17 6 17 SINGLE
38 18 6 18 SINGLE Line Description FORTRAN
40 19 7 19 SINGLE Number Format
Each line represents a data record containing one or
more fields of information about the molecule. 1 number of atoms, I5, 1X,
number of bonds ATOMS,1X,I5,
Each field is delimited by spaces or a tab. The fields
1X, BONDS
used by Chem3D are described below:

1. Line 1 contains two fields. The first field is the 220 atom serial I6,A4,3(F9.4)
total number of atoms in the molecule and the number, type, and
second field is the total number of bonds. coordinates

2. Lines 220 each contain 5 fields of information


2140 bond id, from I6,I5,I6,2X,A8
about each of the atom in the molecule. The atom, to atom,
first field is the serial number of the atom. The bond type
second field is the atom type, the third field is

222 File Formats CambridgeSoft


File Format Examples
Cartesian Coordinate Files The Cartesian Coordinate File Format
The Cartesian coordinate file format (Cart Coords, The format for Cartesian coordinate files is as
Cart Coords 2) interprets text files that specify follows:
models in terms of the X, Y, and Z coordinates of
the atoms. This file format can also interpret 1. The first line of data contains the number of
fractional cell coordinates in orthogonal or non- atoms in the model.
orthogonal coordinate systems.
Optionally, you can follow the number of
Atom Types in Cartesian Coordinate atoms in the file with crystal cell parameters for
the crystal structure: a, b, c, , , and .
Files
Following the cell parameters, you can also
Two file formats are supplied with Chem3D that include an exponent. If you include an
interpret Cartesian coordinate files. The difference exponent, then all of the fractional cell
between the two file formats are the codes used to coordinates will be divided by 10 raised to the
convert atom type numbers in the file into atom power of the exponent.
types used by Chem3D.
2. The first line of a Cartesian coordinate file is
In Cartesian coordinates 1, atom types are followed by one line of data for each atom in
numbered according to the numbering used by N.L. the model. Each line describing an atom begins
Allinger in MM2. These numbers are also generally with the symbol for the atom. This symbol
followed by the program PC Model. must correspond to a symbol in the Elements
table. The symbol can include a charge, such as
In Cartesian coordinates 2, the atom type number
N+. The symbol is followed by the serial
for all atom types is computed by multiplying the
number.
atomic number of the element by 10 and adding the
number of valences as specified by the geometry of 3. The serial number is followed by the three
the atom type. These numbers are also generally coordinates of the atom. If you have specified
followed by the program MacroModel. crystal cell parameters in the first line of the
For example, the atom type number for C Alkane (a file, then these numbers are the fractional cell
tetrahedral carbon atom) is 64. coordinates. Otherwise, the three numbers are
X, Y, and Z Cartesian coordinates.
To examine the atom types described by a file
format, see Editing File Format Atom Types on 4. Following the coordinates is the atom type
page 221. number of the atom type for this atom. This
number must correspond to the code of an
atom type record specified in the file format
atom type table. For more information, see
Editing File Format Atom Types on page
221.
5. Following the atom type number is the connec-
tion table for the atom. You can specify up to
ten other atoms. The connection table for a
Cartesian coordinate file can be listed in one of
two ways: by serial number or by position.

Chem & BioOffice 2006 /Chem3D File Formats 223


File Format Examples
Connection tables by serial number use the 6. To create multiple views of the same set of
serial number of each atom to determine the atoms, you can flow the descriptions of the
number that appears in the connection table of atoms with an equal number of lines corre-
other atoms. All serial numbers must, sponding to the same atoms with different
Administrator

therefore, be unique. coordinates. Chem3D generates independent


Connection tables by position use the relative views using the additional sets of coordinates.
positions of the atoms in the file to determine Samples of Cartesian coordinate files with
the number for each atom that will appear in connection tables by position and serial number for
the connection table of other atoms. The first a model of cyclohexanol are shown below. To
atom is number 1, the second is 2, etc. clearly illustrate the difference between the two
formats, the serial number of the oxygen has been
set to 101.

19
C 1 0.706696 1.066193 0.50882 1 2 4 7 8
C 2 -0.834732 1.075577 0.508789 1 1 3 9 10
C 3 -1.409012 0.275513 -0.668915 1 2 6 11 12
C 4 1.217285 -0.38632 0.508865 1 1 5 13 14
C 5 0.639328 -1.19154 -0.664444 1 4 6 15 16
C 6 -0.89444 -1.1698 -0.646652 1 3 5 17 18
O 101 1.192993 1.809631 1.59346 6 1 19
H 9 1.052597 1.559525 -0.432266 5 1
H 10 -1.211624 2.125046 0.457016 5 2
H 11 -1.208969 0.640518 1.465607 5 2
H 12 -2.524918 0.2816 -0.625809 5 3
H 13 -1.11557 0.762314 -1.629425 5 3
H 14 0.937027 -0.8781 1.470062 5 4
H 15 2.329758 -0.41023 0.437714 5 4
H 16 1.003448 -2.24631 -0.618286 5 5
H 17 1.005798 -0.76137 -1.627 5 5
H 18 -1.295059 -1.73161 -1.524567 5 6
H 19 -1.265137 -1.68524 0.271255 5 6
H 102 2.127594 1.865631 1.48999 21 7

224 File Formats CambridgeSoft


File Format Examples
Following is an example of a Cartesian Coordinate An example of a Cartesian Coordinate File with
file with Connection table by Position for Connection Table by Serial Number for
Cyclohexanol. Cyclohexanol follows.

Element X, Y and Z Positions of Other Atoms


Symbol Coordinates to which C(1) is Bonded

C 1 0.706691.0
6 6619
0.5
3 08820 1 2 4 7 8

Serial Atom Type


Number Text Number

19
C 1 0.706696 1.066193 0.50882 1 2 4 9 10
C 2 -0.834732 1.075577 0.508789 1 1 3 10 11
C 3 -1.409012 0.275513 -0.668915 1 2 6 12 13
C 4 1.217285 -0.38632 0.508865 1 1 5 14 15
C 5 0.639328 -1.19154 -0.664444 1 4 6 16 17
C 6 -0.89444 -1.1698 -0.646652 1 3 5 18 19
O 101 1.192993 1.809631 1.59346 6 1 102
H 9 1.052597 1.559525 -0.432266 5 1
H 10 -1.211624 2.125046 0.457016 5 3
H 11 -1.208969 0.640518 1.465607 5 3
H 12 -2.524918 0.2816 -0.625809 5 4
H 13 -1.11557 0.762314 -1.629425 5 4
H 14 0.937027 -0.8781 1.470062 5 5
H 15 2.329758 -0.41023 0.437714 5 5
H 16 1.003448 -2.24631 -0.618286 5 6
H 17 1.005798 -0.76137 -1.627 5 6
H 18 -1.295059 -1.73161 -1.524567 5 7
H 19 -1.265137 -1.68524 0.271255 5 7
H 102 2.127594 1.865631 1.48999 21 10
1

Chem & BioOffice 2006 /Chem3D File Formats 225


File Format Examples
Components of a Cartesian coordinate File with
Connection Table by Serial Number for C(1) of 2 to End Atom coordi- A3, 1X, I4, 3(1X,
Cyclohexanol is shown below. nates F11.6), 1X, I4,
10(1X, I4)
Administrator

Element X, Y and Z Serial Numbers of Other Atoms Cartesian coordinate File (Fractional Crystal Cell
Symbol Coordinates to which C(1) is Bonded
Parameters):
C 1 0.706691.0
6 66193
0.508820 1 2 4 9 101
Line Description FORTRAN
Serial Atom Type Number Format
Number Text Number

1 Number of I3, 6(1X, F), I


Atoms, Crystal
Components of a Cartesian coordinate File with Cell Parameters
Crystal coordinate Parameters for C(1) is shown
below.
2 to End Atom coordi- A3, 1X, I4, 3(1X,
Number nates F11.6), 1X, I4,
a b c Exponent
of Atoms
10(1X,I4)
43 10.23 12.568.12 90.0 120.0
90.0 4

C 1 1578 -2341 5643 1 20 21 22


Cambridge Crystal Data
Fractional Cell
Coordinates
Bank Files
The specific format of Cambridge Crystal Data
FORTRAN Formats Bank files (CCDB) used by Chem3D is the FDAT
The FORTRAN format for the records in a format, described on pages 2642 of the data file
Cartesian coordinate file with a connection table by specifications of the Cambridge Structural
serial number or position and a Cartesian Database, Version 1 File Specifications from the
coordinate file with fractional crystal cell Cambridge Crystallographic Data Centre. For
parameters are listed in the following tables: further details about the FDAT format, please refer
Cartesian coordinate File (Connection Table by to the above publication or contact the Cambridge
Serial Number or Position): Crystallographic Data Centre.

As described in the specifications of the Cambridge


Line Description FORTRAN
Crystal Data Bank format, bonds are automatically
Number Format
added between pairs of atoms whose distance is less
than that of the sum of the covalent radii of the two
1 Number of I3
Atoms atoms. The bond orders are guessed based on the
ratio of the actual distance to the sum of the

226 File Formats CambridgeSoft


File Format Examples
covalent radii. The bond orders, bond angles, and 3. Beginning with line 3, the atom type number is
the atom symbols are used to determine the atom followed by the serial number of the atom to
types of the atoms in the model. which the new atom is bonded and the distance
to that atom. In an Internal coordinates file, the
origin atom is always the first distance-defining
atom in the file. All distances are measured in
Bond Type Actual Distance / Sum
Angstroms.
of Covalent Radii
4. Beginning with line 4, the distance is followed
by the serial number of the first angle-defining
Triple 0.81
atom and the angle between the newly defined
atom, the distance-defining atom, and the first
Double 0.87 angle-defining atom. All angles are measured in
degrees.
Delocalized 0.93 5. Beginning with line 5, the serial number of a
second angle-defining atom and a second
Single 1.00 defining angle follows the first angle. Finally, a
number is given that indicates the type of the
second angle. If the second angle type is zero,
Internal Coordinates File the second angle is a dihedral angle: New Atom
Distance-defining Atom First Angle-
Internal coordinates files (INT Coords) are text defining Atom Second Angle-defining Atom.
files that describe a single molecule by the internal Otherwise the third angle is a bond angle: New
coordinates used to position each atom. The serial Atom Distance-defining Atom Second
numbers are determined by the order of the atoms Angle-defining Atom. If the second angle type
in the file. The first atom has a serial number of 1, is 1, then the new atom is defined using a
the second is number 2, etc. Pro-R/Pro-S relationship to the three defining
atoms; if the second angle type is -1, the rela-
The format for Internal coordinates files is as tionship is Pro-S.
follows:
NOTE: You cannot position an atom in terms of a
1. Line 1 is a comment line ignored by Chem3D. later-positioned atom.
Each subsequent line begins with the atom
type number of an atom type. The following is a sample of an Internal coordinates
output file for cyclohexanol which was created
2. Line 2 contains the atom type number of the from within Chem3D:
Origin atom.
1
1 1 1.54146
1 2 1.53525 1 111.7729
1 1 1.53967 2 109.7132 3 -55.6959 0
1 4 1.53592 1 111.703 2 55.3112 0
1 3 1.53415 2 110.7535 1 57.0318 0

Chem & BioOffice 2006 /Chem3D File Formats 227


File Format Examples
6 1 1.40195 2 107.6989 3 -172.6532 0
5 1 1.11742 2 109.39 4 109.39 -1
5 2 1.11629 1 109.41 3 109.41 1
Administrator

5 2 1.11568 1 109.41 3 109.41 -1


5 3 1.11664 2 109.41 6 109.41 -1
5 3 1.11606 2 109.41 6 109.41 1
5 4 1.11542 1 109.41 5 109.41 1
5 4 1.11493 1 109.41 5 109.41 -1
5 5 1.11664 4 109.41 6 109.41 1
5 5 1.11617 4 109.41 6 109.41 -1
5 6 1.11664 3 109.41 5 109.41 1
5 6 1.11606 3 109.41 5 109.41 -1
21 7 0.942 1 106.8998 2 59.999 0

5 6

Bonds the bond) the bond is removed from the model.


This is useful if you want to describe multiple
Bonds are indicated in Internal coordinates files in fragments in an internal coordinates file.
two ways.

First, a bond is automatically created between each Atom Type


Text Numbers

atom (except the Origin atom) and its distance- Bond


Lengths
defining atom. Origin Atom 1 First
Angles

Second, if there are any rings in the model, ring- Second Atom 1 1 1.54146 Second
Angles
closing bonds are listed at the end of the file. If
there are ring-closing bonds in the model, a blank Third Atom 1 2 1.53525 1 111.7729

line is included after the last atom definition. For Fourth Atom 1 1 1.53967 2 109.7132 3 -55.6959 0
each ring-closure, the serial numbers of the two
atoms which comprise the ring-closing bond are Distance-defining
Atoms
First Angle-
defining Atoms
Second Angle-
defining Atoms
Indicates
Dihedral
listed on one line. The serial number of the first
atom is 1, the second is 2, etc. In the prior Internal Components of an Internal coordinates File for
coordinates output example of cyclohexanol, the C(1) through C(4) of Cyclohexanol
numbers 5 and 6 are on a line at the end of the file,
and therefore the ring closure is between the fifth In this illustration, the origin atom is C(1). C(2) is
atom and the sixth atom. connected to C(1), the origin and distance defining
atom, by a bond of length 1.54146 . C(3) is
If a bond listed at the end of an Internal coordinates connected to C(2) with a bond of length 1.53525 ,
format file already exists (because one of the atoms and at a bond angle of 111.7729 degrees with C(1),
on the bond is used to position the other atom on defined by C(3)-C(2)-C(1). C(4) is attached to C(1)

228 File Formats CambridgeSoft


File Format Examples
with a bond of length 1.53967 , and at a bond Ignored by
angle of 109.7132 degrees with C(2), defined by Comment
Chem3D
C(4)-C(1)-C(2). C(4) also forms a dihedral angle of
-55.6959 degrees with C(3), defined by C(4)-C(1)- Origin Atom I4
C(2)-C(3).
Second Atom I4, 1X, I3,
This portion of the Internal coordinates file for 1X, F9.5
C(1) through C(4) of Cyclohexanol can be
Third Atom I4, 2(1X, I3,
represented by the following structural diagram: 1X, F9.5)

Fourth Atom to I4, 3(1X, I3,


1.540 4 Last Atom 1X, F9.5), I4

1
Blank Line
109.713
1.541
-55.698 Dihedral Angle
Ring Closure 2(1X, I4)
111.771
2 Atoms

1.535 3 MacroModel
MacroModel is produced within the Department of
Chemistry at Columbia University, New York, N.Y.
FORTRAN Formats The MacroModel file format is defined in the
MacroModel Structure Files version 2.0
The FORTRAN formats for the records in an documentation. The following is a sample
Internal coordinates file are as follows: MacroModel file created using Chem3D. The
following file describes a model of cyclohexanol.
Line Number Description FORTRAN
Format

19 cyclohexanol
3 2 1 6 1 7 1 18 1 0 0 0 0 -1.396561 0.350174 1.055603 0
3 1 1 3 1 8 1 9 1 0 0 0 0 -0.455032 -0.740891 1.587143 0
3 2 1 4 1 10 1 11 1 0 0 0 0 0.514313 -1.222107 0.49733 0
3 3 1 5 1 12 1 13 1 0 0 0 0 1.302856 -0.04895 -0.103714 0
3 4 1 6 1 14 1 15 1 0 0 0 0 0.372467 1.056656 -0.627853 0
3 1 1 5 1 16 1 17 1 0 0 0 0 -0.606857 1.525177 0.4599 0
41 1 1 0 0 0 0 0 0 0 0 0 0 -2.068466 -0.083405 0.277008 0
41 2 1 0 0 0 0 0 0 0 0 0 0 -1.053284 -1.603394 1.96843 0

Chem & BioOffice 2006 /Chem3D File Formats 229


File Format Examples
41 2 1 0 0 0 0 0 0 0 0 0 0 0.127151 -0.3405 2.451294 0
41 3 1 0 0 0 0 0 0 0 0 0 0 1.222366 -1.972153 0.925369 0
41 3 1 0 0 0 0 0 0 0 0 0 0 -0.058121 -1.742569 -0.306931 0
Administrator

41 4 1 0 0 0 0 0 0 0 0 0 0 1.972885 0.38063 0.679077 0


41 4 1 0 0 0 0 0 0 0 0 0 0 1.960663 -0.413223 -0.928909 0
41 5 1 0 0 0 0 0 0 0 0 0 0 0.981857 1.921463 -0.992111 0
41 6 1 0 0 0 0 0 0 0 0 0 0 -1.309372 2.283279 0.037933 0
41 6 1 0 0 0 0 0 0 0 0 0 0 -0.033539 2.031708 1.272888 0
41 1 1 0 0 0 0 0 0 0 0 0 0 -2.052933 0.717285 1.881104 0
42 15 1 0 0 0 0 0 0 0 0 0 0 0.275696 0.374954 -2.411163 0

Each line represents a data record containing one or Atom colors are ignored by Chem3D. This
more fields of information about the model. Each field will contain a zero if the file was created
field is delimited by space(s) or a tab. using Chem3D.
The fields in the MacroModel format file used by
Chem3D are: NOTE: Atom types are user-definable. See Editing File
Format Atom Types on page 221 for instructions on
1. Line 1 contains 2 fields: the first field is the
number of atoms and the second field is the modifying or creating an atom type.
name of the molecule. The molecule name is
the file name when the file is created using For example, the following illustrates the atom and
Chem3D. bond components for C6 and bond 3 of
2. Lines 2-19 each contain 17 fields describing cyclohexanol:
information about one atom and its attached
bond. The first field contains the atom type.
The second through thirteenth fields represent Each pair of numbers represents an
atom to which this atom is bondedAtom Color
6 pairs of numbers describing the bonds that
this atom makes to other atoms. The first 3115116
117
10000-0.606
185
.52
750
1.45
77 90
900
number of each pair is the serial number of the
other atom, and the second number is the bond Atom TypS
eerial Nu
Bmober
nd Type
X Y Z
Coordinates
type. The fourteenth field is the X coordinate,
the fifteenth field is the Y coordinate, the
sixteenth field is the Z coordinate and finally, FORTRAN Formats
and the seventeenth field is the color of the
atom. The FORTRAN format for each record of the
MacroModel format is as follows:

Line Description FORTRAN


Number Format

230 File Formats CambridgeSoft


File Format Examples
of Chemical Information and Computer Science,
1 number of 1X,I5,2X,A Volume 32, Number 3, 1992, pages 244255. The
atoms and mole-
following is a sample MDL MolFile file created
cule name (file
using Chem3D Pro. This file describes a model of
name
cyclohexanol (the line numbers are added for
reference only):
MDL MolFile
The MDL MolFile1 format is defined in the article 1. MDL MACCS-II is a product of MDL
Description of Several Chemical Structure File Information Systems, Inc. (previously called
Formats Used by Computer Programs Developed Molecular Design, Limited).
at Molecular Design Limited found in the Journal
1 cyclohexanol
2
3
4 19 19 0 0 0
5 -1.3488 0.1946 1.0316 C 0 0 0 0 0
6 -0.4072 -0.8965 1.5632 C 0 0 0 0 0
7 0.5621 -1.3777 0.4733 C 0 0 0 0 0
8 1.3507 -0.2045 -0.1277 C 0 0 0 0 0
9 0.4203 0.9011 -0.6518 C 0 0 0 0 0
10 -0.559 1.3696 0.4359 C 0 0 0 0 0
11 -0.3007 0.4266 -1.7567 O 0 0 0 0 0
12 -2.0207 -0.239 0.253 H 0 0 0 0 0
13 -2.0051 0.5617 1.8571 H 0 0 0 0 0
14 -1.0054 -1.7589 1.9444 H 0 0 0 0 0
15 0.1749 -0.4961 2.4273 H 0 0 0 0 0
16 1.27 -2.1277 0.9014 H 0 0 0 0 0
17 -0.0103 -1.8981 -0.3309 H 0 0 0 0 0
18 2.0207 0.225 0.6551 H 0 0 0 0 0
19 2.0084 -0.5688 -0.9529 H 0 0 0 0 0
20 1.0296 7659 -1.0161 H 0 0 0 0 0
21 -1.2615 2.1277 0.0139 H 0 0 0 0 0
22 0.0143 1.8761 1.2488 H 0 0 0 0 0
23 0.3286 0.2227 -2.4273 H 0 0 0 0 0
24 1 2 1 0 0 0
25 1 6 1 0 0 0

Chem & BioOffice 2006 /Chem3D File Formats 231


File Format Examples
26 1 8 1 6 0 0
27 1 9 1 1 0 0
28 2 3 1 6 0 0
Administrator

29 2 10 1 0 0 0
30 2 11 1 1 0 0
31 3 4 1 0 0 0
32 3 12 1 0 0 0
33 3 13 1 6 0 0
34 4 5 1 0 0 0
35 4 14 1 1 0 0
36 4 15 1 6 0 0
37 5 6 1 1 0 0
38 5 7 1 6 0 0
39 5 16 1 0 0 0
40 6 17 1 0 0 0
41 6 18 1 1 0 0
42 7 19 1 6 0 0

Each line represents either a blank line, or a data number of bonds, the third field is the number
record containing one or more fields of of atom lists, the fourth field is an unused field
information about the structure. Each field is and the fifth field is the stereochemistry.
delimited by a space(s) or a tab.
NOTE: Chem3D Pro ignores the following fields: number
The fields in the MDL MolFile format used by of atom lists, the unused field and stereochemistry. These
Chem3D Pro are discussed below: fields will always contain a zero if the file was created using
Chem3D Pro.
1. Line 1 starts the header block, which contains
5. Lines 523 (the Atom block) each contain 9
the name of the molecule. The molecule name
fields which describes an atom in the molecule:
is the file name when the file was created using
The first field is the X coordinate, the second
Chem3D Pro.
field is the Y coordinate, the third field is the Z
2. Line 2 continues the Header block, and is a coordinate, the fourth field is the atomic
blank line. symbol, the fifth field is the mass difference,
the sixth field is the charge, the seventh field is
3. Line 3 continues the Header block, and is
another blank line.

4. Line 4 (the Counts line) contains 5 fields which


describes the molecule: The first field is the
number of atoms, the second field is the

232 File Formats CambridgeSoft


File Format Examples
the stereo parity designator, the eighth field is FORTRAN Formats
the number of hydrogens and the ninth field is
The FORTRAN format for each record of the
the center.
MDL MolFile format is as follows:
NOTE: Chem3D Pro ignores the following fields: mass
difference, charge, stereo parity designator, number of Line Description FORTRAN
hydrogens, and center. These fields contain zeros if the file was Number Format
created using Chem3D Pro.
1 Molecule name A
6. Lines 2442 (the Bond block) each contain 6 (file name)
fields which describe a bond in the molecule:
the first field is the from-atom id, the second 2 Blank line
field is the to-atom id, the third field is the
bond type, the fourth field is the bond stereo
designator, the fifth field is an unused field and 3 Blank line
the sixth field is the topology code.
4 Number of atoms 5I3
NOTE: Chem3D Pro ignores the unused field and Number of bonds
topology code. These fields will contain zeros if the file was
created using Chem3D Pro. 523 Atom coordi- 3F10.4,1X,A2,5I3
nates, atomic
Limitations symbol

The MDL MolFile format does not support


2442 Bond id, from 6(1X,I2)
non-integral charges in the same way as Chem3D
atom, to atom,
Pro. For example, in a typical MDL MolFile format
and bond type
file, the two oxygens in a nitro functional group
(NO2) contain different charges: -1 and 0. In
Chem3D models, the oxygen atoms each contain a MSI MolFile
charge of -0.500.
The MSI MolFile is defined in Chapter 4,
Chem-Note File Format in the Centrum:
Chem-Note Application documentation, pages
4-1 to 4-5. The following is a sample MSI MolFile
file created using Chem3D Pro for cyclohexanol
(the line numbers are added for purposes of
discussion only):
1 ! Polygen 133
2 Polygen Corporation: ChemNote molecule file (2D)
3 * File format version number
4 90.0928

Chem & BioOffice 2006 /Chem3D File Formats 233


File Format Examples
5 * File update version number
6 92.0114
7 * molecule name
Administrator

8 cyclohexanol-MSI
9 empirical formula
10 Undefined Empirical Formula
11 * need 3D conversion?
12 0
13 * 3D displacement vector
14 0.000 0.000 0.000
15 * 3D rotation matrix
16 1.000 0.000 0.000 0.000 1.000 0.000 0.000 0.000 1.000
17 * 3D scale factor
18 0
19 * 2D scale factor
20 1
21 * 2D attributes
22 100000000000000
23 * 3D attributes
24 00000000000
25 * Global display attributes
26 1 0 1 12 256
27 * Atom List
28 * Atom# Lbl Type x y x y z bits chrg ichrg frag istp lp chrl ring frad name seg grp FLAGS
29 1 C 10 0 0 -1 0.46 0.2 0 0 0 0 0 0 0 0 0 C 1 0 -1 0 0 0 0 0 0 [C]
30 2 C 10 0 0 1.2 -1.1 0.2 0 0 0 0 0 0 0 0 0 C 2 0 -1 0 0 0 0 0 0 [C]
30 2 C 10 0 0 1.2 -1.1 0.2 0 0 0 0 0 0 0 0 0 C 2 0 -1 0 0 0 0 0 0 [C]
31 3 C 10 0 0 0.1 -1.6 0.7 0 0 0 0 0 0 0 0 0 C 3 0 -1 0 0 0 0 0 0 [C]
32 4 C 10 0 0 1.3 -1.1 0 0 0 0000000C40-1000000[C]
33 5 C 10 0 0 1.2 0.48 0 0 0 0 0 0 0 0 0 0 C 5 0 -1 0 0 0 0 0 0 [C]
34 6 C 10 0 0 0 1.01 -1 0 0 0 0 0 0 0 0 0 C 6 0 -1 0 0 0 0 0 0 [C]
35 7 O 45 0 0 0 2.42 -1 0 0 0 0 0 0 0 0 0 O 7 0 -1 0 0 0 0 0 0 [O]
36 8 H 8 0 0 0.6 2.72 -1 0 0 0 0 0 0 0 0 0 H 7 0 -1 0 0 0 0 0 0 [H]
37 9 H 1 0 0 2.1 0.86 -1 0 0 0 0 0 0 0 0 0 H 8 0 -1 0 0 0 0 0 0 [H]
38 10 H 1 0 0 1.4 0.86 0.8 0 0 0 0 0 0 0 0 0 H 9 0 -1 0 0 0 0 0 0 [H]
39 11 H 1 0 0 1.1 -1.4 -1 0 0 0 0 0 0 0 0 0 H 10 0 -1 0 0 00 00[H]

234 File Formats CambridgeSoft


File Format Examples
40 12 H 1 0 0 2.2 -1.4 0.2 0 0 0 0 0 0 0 0 0 H 11 0 -1 0 0 0000 [H]
41 13 H 1 0 0 0 0.72 -2 0 0 0 0 0 0 0 0 0 H 12 0 -1 0 0000 0 [H]
42 14 H 1 0 0 0.1 -2.7 0.7 0 0 0 0 0 0 0 0 0 H 13 0 -1 0 0 0000 [H]
43 15 H 1 0 0 0.3 -1.3 1.7 0 0 0 0 0 0 0 0 0 H 14 0 -1 0 0 0 00 [H]
44 16 H 1 0 0 -1 -1.5 -1 0 0 0 0 0 0 0 0 0 H 15 0 -1 0 0 0000 [H]
45 17 H 1 0 0 -2 -1.5 0.9 0 0 0 0 0 0 0 0 0 H 16 0 -1 0 0 0000 [H]
46 18 H 1 0 0 -1 0.85 1.2 0 0 0 0 0 0 0 0 0 H 17 0 -1 0 0 0000 [H]
47 19 H 1 0 0 -2 0.83 0 0 0 0 0 0 0 0 0 0 H 18 0 -1 0 0 0000 [H]
48 * Bond List
49 * Bond# bond_type atom1 atom2 cis/trans length locked ring Sh_type Sh_nr Qorder Qtopol Qs
50 11120 0.000 0 0 0 0 [S] 0 0
51 21160 0.000 0 0 0 0 [S] 0 0
52 3 1 1 18 0 0.000 0 0 0 0 [S] 0 0
53 4 1 1 19 0 0.000 0 0 0 0 [S] 0 0
54 51230 0.000 0 0 0 0 [S] 0 0
55 6 1 2 16 0 0.000 0 0 0 0 [S] 0 0
56 7 1 2 17 0 0.000 0 0 0 0 [S] 0 0
57 81340 0.000 0 0 0 0 [S] 0 0
58 9 1 3 14 0 0.000 0 0 0 0 [S] 0 0
59 10 1 3 15 0 0.000 0 0 0 0 [S] 0 0
60 11 1 4 5 0 0.000 0 0 0 0 [S] 0 0
61 12 1 4 11 0 0.000 0 0 0 0 [S] 0 0
62 13 1 4 12 0 0.000 0 0 0 0 [S] 0 0
63 14 1 5 6 0 0.000 0 0 0 0 [S] 0 0
64 15 1 5 9 0 0.000 0 0 0 0 [S] 0 0
65 16 1 5 10 0 0.000 0 0 0 0 [S] 0 0
66 17 1 6 7 0 0.000 0 0 0 0 [S] 0 0
67 18 1 6 13 0 0.000 0 0 0 0 [S] 0 0
68 19 1 7 8 0 0.000 0 0 0 0 [S] 0 0
69 * Bond Angles
70 * bond1 bond2 angle locked
71 * Dihedral Angles
72 * at1-cons at1 at2 at2-cons angle locked
73 * Planarity data
74 * User data area
75 * End of File

Chem & BioOffice 2006 /Chem3D File Formats 235


File Format Examples
The MSI MolFile1 format is broken up into several 13. Line 26 contains 5 fields describing the global
sections. Section headers are preceded by a *. display attributes: Line thickness (1), font style
Blank lines also contain a *. Each line is either a (0), type face (1), type size (12), font (256).
blank line, a header line or a data record containing These values are specific to the platform that is
Administrator

one or more fields of information about the generating the file.


structure. Individual fields are delimited by space(s) 14. .Line 27 contains the header for the Atom Lists
or a tab. The fields in the MSI MolFile format file section.
used by Chem3D Pro are discussed below.
15. Line 28 contains a listing of all the possible
The field value for Carbon 6 from the example file fields for the atom list section. When the file is
is included in parentheses for reference: created using Chem3D Pro the following fields
1. Line 1 is a standard header line for MSI
are used: Atom#,Lbl, Type, and x,y,z.
MolFile format files. 16. Lines 2947 each contains 28 fields describing
2. Line 2 normally indicates the application which information about each of the atoms in the
created the file. structure: the first field is the atom number (6),
the second field is the atom label (C), the third
3. Line 3 is the header for the File format version
field is the atom type (10), the fourth field and
number section.
fifth fields contain 2D coordinates, and contain
4. Line 4 indicates the file format version number. zeros when the file is created using Chem3D
The format for this field is YY.MMDD. Pro, the sixth field is the X coordinate (-0.113)
5. Line 5 is the header for the File update version and the fifth field is the Y coordinate (1.005),
number section. the sixth field is the Z coordinate (-0.675), the
seventh through fifteenth fields are ignored
6. Line 6 indicates the file update version number.
and contain zeros when the file is created by
The format for this field is YY.MMDD.
Chem3D Pro, the sixteenth field is, again, the
7. Line 7 is the header for the molecule name atom label (C), the eighteenth field is, again, the
section. atom number (6), the nineteenth field is the
8. Line 8 contains the field molecule name. This segment field, the twentieth field is the
field contains either the file name, or Unde- coordination field, the twenty first field is
fined Name. ignored, the twenty-second field is called the
saturation field: if the atom is attached to any
9. Line 9 is the header for the empirical formula.
single, double or delocalized bonds this field is
10. Line 10 contains the empirical formula field. 1 (not saturated) otherwise this field is 0. The
This field contains either the empirical formula twenty-third through the twenty-sixth fields are
or Undefined Empirical Formula. ignored and contain zeros when the file is
11. Lines 1124 each contains information created using Chem3D Pro, the twenty-seventh
concerning conversions from 3D to 2D. field is, again, the atom label (C).
12. Line 25 is the header for the Global display
NOTE: Atom types in the Molecular Simulations
attributes section.
1. Molecular Simulations MOLFILE MolFile format are user-definable. For more
(ChemNote) is a product of Molecular information, see Editing File Format Atom Types
Simulations, Inc. on page 221.

236 File Formats CambridgeSoft


File Format Examples
17. Line 48 contains the header for the Bond List FORTRAN Formats
section.
18. Line 49 contains a listing of all the possible The FORTRAN format for each record of the
fields for the bond list section. When the file is Molecular Simulations MolFile format is as follows:
created by Chem3D Pro the following fields
are used: Bond#, Bond_type, atom 1, atom 2 Line Description FORTRAN
and cis/trans and Qorder. Number Format
19. Lines 5068 each contain 4 fields describing
information about each of the bonds in the 29-47 atom list, field I,1X,A,3(1X,I),3F9.
structure: the first field is the internal bond value 3,1X,I,F4.1,7(1X,I),
number (6), the second field is the bond type 1X,A,I,8(1X,I),
(1), the third and fourth fields are the atom [,A, ]
serial numbers for the atoms involved in the
bond [atom 1 (2), atom 2 (16)], the fifth field is 50-68 bond list, field I,4(1X,I),F9.3,4(2X
the cis/trans designator (this is 0 if it does not values ,I),1X, [,A1, ]
apply), the sixth through tenth fields are ,2(1X,I)
ignored, and contain zeros if the file is created
using Chem3D Pro, the eleventh field contains
the bond order ([S] meaning single), the twelfth
and thirteenth fields are ignored and contain
MOPAC
zeros if the file is created using Chem3D Pro.
The specific format of the MOPAC files used by
20. Lines 6973 are each a section header for 3D Chem3D is the MOPAC Data-File format. This
conversion use. This section only contains the format is described on pages 1-5 through 1-7 of the
header name only (as shown) when the file is Description of MOPAC section and page 3-5 of
created using Chem3D Pro. the Geometry Specification section in the
21. Line 74 is a header for the section User data MOPAC Manual (fifth edition). For further details
area. This section contains the header name about the MOPAC Data-File format, please refer to
only (as shown) when the file is created using the above publication.
Chem3D Pro.
22. Line 75 is a header that indicates the End of The following is a sample MOPAC output file from
File. Chem3D for cyclohexanol:
Line 1:
Line 2: Cyclohexanol
Line 3:
Line 4a: C 0 0 0 0 0 0 0 0 0
Line 4b: C 1.54152 1 0 0 0 0 1 0 0
Line 4c: C 1.53523 1 111.7747 1 0 0 2 1 0
Line 4d: C 1.53973 1 109.7114 1 -55.6959 1 1 2 3
Line 4e: C 1.53597 1 111.7012 1 55.3112 1 4 1 2

Chem & BioOffice 2006 /Chem3D File Formats 237


File Format Examples
Line 4f: C 1.53424 1 110.7535 1 57.03175 1 3 2 1
Line 4g: O 1.40196 1 107.6989 1 -172.662 1 1 2 3
Line 4h: H 1.11739 1 107.8685 1 62.06751 1 1 2 3
Administrator

Line 4I: H 1.11633 1 110.0751 1 -177.17 1 2 1 4


Line 4j: H 1.11566 1 109.4526 1 65.43868 1 2 1 4
Line 4k: H 1.11665 1 109.9597 1 178.6209 1 3 2 1
Line 4l: H 1.1161 1 109.5453 1 -63.9507 1 3 2 1
Line 4m: H 1.11542 1 109.4316 1 -66.0209 1 4 1 2
Line 4n: H 1.11499 1 110.549 1 176.0838 1 4 1 2
Line 4o: H 1.11671 1 109.93 1 -178.296 1 5 4 1
Line 4p: H 1.11615 1 109.4596 1 64.43501 1 5 4 1
Line 4q: H 1.11664 1 110.0104 1 -178.325 1 6 3 2
Line 4r: H 1.11604 1 109.6082 1 64.09581 1 6 3 2
Line 4s: H 0.94199 1 106.898 1 -173.033 1 7 1 2

The following illustrates the components of the a bond angle of 109.711411 degrees from C(2). C(4)
MOPAC Output File from Chem3D for C(1) also forms a dihedral angle of
Through C(4) of Cyclohexanol -55.695877 degrees with C(3).
The action integers listed next to each measurement
Element Bond Action Bond Action Dihedral Action Connectivity
Symbol Lengths Integers Angles Integers Angles Integers Atoms are instructions to MOPAC which are as follows:

1st Atom C 0.000000 0 0.000000 0 0.000000 0 0 0 0 1Optimize this internal coordinate


2nd Atom C 1.541519 1 0.000000 0 0.000000 0 1 0 0
0Do not optimize this internal coordinate
3rd Atom C 1.535233 1 111.774673 1 0.000000 0 2 1 0
-1Reaction coordinate or grid index
4th Atom C 1.539734 1 109.711411 1 -55.695877 1 1 2 3
When you create a MOPAC file from within
Chem3D, an action integer of 1 is automatically
assigned to each non-zero bond length, bond angle,
The internal coordinates section of the MOPAC and dihedral angle for each atom record in the file.
Data-File format contains one line of text for each
atom in the model. Each line contains bond lengths, FORTRAN Formats
bond angles, dihedral angles, action integers, and
The description of the MOPAC Data-File format
connectivity atoms.
for each line is as follows:
As shown in the illustration above, C(1) is the origin
atom. C(2) is connected to C(1) with a bond of
length 1.541519 . C(3) is connected to C(2) with a Line Description Read by Written
bond of length 1.535233 , and is at a bond angle Number Chem3D by
of 111.774673 degrees from C(1). C(4) is connected Chem3D
to C(1) with a bond of length 1.539734 , and is at

238 File Formats CambridgeSoft


File Format Examples
The ATOM record contains atomic coordinate
1 Keywords for No No records for standard groups, and the HETATM
Calculation record contains atomic coordinate records for
Instructions non-standard groups. The CONECT record
contains the atomic connectivity records.
2 Molecule Title No Yes
NOTE: The COMPND record is created by Chem3D to
3 Comment No No include the title of a Chem3D model only when you are saving
a file using the Protein Data Bank file format. This record
4a-s Internal coor- Yes Yes is not used when opening a file.
dinates for
molecule The following is an example of a Protein Data Bank
Output File from Chem3D for L-Alanine.
5 Blank line, Yes Yes
terminates
geometry defi- COMPND Alanine.pdb
nition HETATM 1 N 0 -0.962 1
HETATM 2 C 0 -0.049 0
The FORTRAN format for each line containing HETATM 3 C 0.6 0.834 -1
internal coordinate data in the MOPAC Data-File is
HETATM 4 C -2 0.834 1
FORMAT(1X, 2A, 3(F12.6, I3), 1X, 3I4).
HETATM 5 O 0.3 1.737 -1
HETATM 6 O 1.8 0.459 0
Protein Data Bank Files HETATM 7 H 0.9 -1.398 1
The Protein Data Bank file format (Protein DB) is HETATM 13 H -1 -1.737 1
taken from pages 3, 1415, and 1718 of the HETATM 8 H -1 -0.642 -1
Protein Data Bank Atomic coordinate and HETATM 9 H -2 1.564 0
Bibliographic Entry Format Description dated HETATM 10 H -1 1.41 1
January, 1985.
HETATM 11 H -2 0.211 1
A Protein Data Bank file can contain as many as 32 HETATM 12 H 2.4 1.06 -1
different record types. Only the COMPND, CONECT 1 2 7 13
ATOM, HETATM, and CONECT records are
CONECT 2 1 3 4 8
used by Chem3D; all other records in a Protein
Data Bank file are ignored. The COMPND record CONECT 3 2 5 6
contains the name of the molecule and identifying CONECT 4 2 9 10 11
information. CONECT 5 3
CONECT 6 3 12
CONECT 7 1
CONECT 13 1
CONECT 8 2

Chem & BioOffice 2006 /Chem3D File Formats 239


File Format Examples
CONECT 9 4
7-10 UNUSED No
CONECT 10 4
CONECT 11 4
11-70 Name of Molecule Yes
Administrator

CONECT 12 6
END The full description of the ATOM and HETATM
The ATOM or HETATM record contains the record formats in Protein Data Bank files is as
record name, followed by the serial number of the follows:
atom being described, the element symbol for that
atom, then the X, Y, and Z Cartesian coordinates
for that atom. Column Column Used by
Number Description Chem3D
A CONECT record is used to describe the atomic
connectivity. The CONECT records contain the
1-6 Record Name Yes
record name, followed by the serial number of the
(HETATM or
atom whose connectivity is being described, then
ATOM)
the serial numbers of the first atom, second atom,
third atom and fourth atom to which the described
atom is connected. 7-11 Atom Serial Number Yes

Record Chem3D 12 UNUSED No


Name File Title

COMPND Alanine.pdb 1316 Atom Name Yes


(Element Symbol)
Record Serial Element X Y Z
Name Number Symbol Coord. Coord. Coord.

17 Alternate Location No
HETATM 1 N 0.038 -0.962 0.943
Indicator
Record Serial 1st Atom 2nd Atom 3rd Atom 4th Atom
Name Number Serial Serial Serial Serial
Number Number Number Number
1820 Residue Name Optional
CONECT 2 1 3 4 8
21 UNUSED No
FORTRAN Formats
22 Chain Identifier No
The full description of the COMPND record
format in Protein Data Bank files is as follows:
2326 Residue Sequence No
Number
Column Column Used by
Number Description Chem3D
27 Code for insertions of No
residues
1-6 Record Name Yes
(COMPND)

240 File Formats CambridgeSoft


File Format Examples
2830 UNUSED No 2226 Serial Number of Third Yes
Bonded Atom
3138 X Orthogonal Yes
coordinates 2731 Serial Number of Yes
Fourth Bonded Atom
3946 Y Orthogonal coor- Yes
dinates 3236 Hydrogen Bonds, No
Atoms in cols. 711 are
4754 Z Orthogonal coor- Yes Donors
dinates
3741 Hydrogen Bonds No
5560 Occupancy No
4246 Salt Bridge, Atoms in No
6166 Temperature Factor No cols. 711 have Nega-
tive Charge
67 UNUSED No
4751 Hydrogen Bonds, No
Atoms in cols 711 are
6870 Footnote Number No
Acceptors
The full description of the CONECT record
format in Protein Data Bank files is as follows: 5256 Hydrogen Bonds No

5761 Salt Bridge, Atoms in No


Column Column Used by cols. 711 have Positive
Number Description Chem3D Charge

16 Record Name Yes The FORTRAN formats for the records used in
(CONECT) the Protein Data Bank file format are as follows:

711 Atom Serial Number Yes


Line Description FORTRAN Format

1216 Serial Number of First Yes


Bonded Atom COMPND COMPND, 4X, 60A1

1721 Serial Number of Yes ATOM ATOM, 2X, I5,1X,A4,


Second Bonded Atom 1X, A3,10X, 3F8.3,16X

HETATM HETATM,
I5,1X,A4,14X,3F8.3,16X

Chem & BioOffice 2006 /Chem3D File Formats 241


File Format Examples
1-2-3-4-5-6,1-6,2-7H,3-8H,4-9H,5-10H,6-11H,1-
CONECT CONECT, 5I5, 30X 12O-13H,1-14H,2-15H, 3-16H,4-17H,5-18H,6-
19H.@
ROSDAL
Administrator

SMD
The Rosdal Structure Language1 file format is The Standard Molecular Data 2SMD file) file
defined in Appendix C: Rosdal Syntax, pages format is defined in the SMD File Format version
91108, of the MOLKICK Users Manual. The 4.3 documentation, dated 04-Feb-1987. The
Rosdal format is primarily used for query searching following is a sample SMD file produced using
in the Beilstein Online Database. Rosdal format Chem3D Pro for cyclohexanol (the line numbers
files are for export only. The following is a sample are added for purposes of discussion only).
Rosdal format file created using Chem3D Pro for
cyclohexanol: 2. SMD format - H. Bebak AV-IM-AM
1. Rosdal is a product of Softron, Inc. Bayer AG.

Line 1 >STRT Cyclohexane


Line 2 DTCR Chem3D 00000 05-MAY-92 12:32:26
Line 3 >CT Cyclohexan 00039
Line 4 19 19 (A2,5I2) (6I3)
Line 5 C 0 0 0
Line 6 C 0 0 0
Line 7 C 0 0 0
Line 8 C 0 0 0
Line 9 C 0 0 0
Line 10 C 0 0 0
Line 11 H 0 0 0
Line 12 H 0 0 0
Line 13 H 0 0 0
Line 14 H 0 0 0
Line 15 H 0 0 0
Line 16 O 0 0 0
Line 17 H 0 0 0
Line 18 H 0 0 0
Line 19 H 0 0 0
Line 20 H 0 0 0
Line 21 H 0 0 0
Line 22 H 0 0 0

242 File Formats CambridgeSoft


File Format Examples
Line 23 H 0 0 0
Line 24 1 2 1
Line 25 1 6 1
Line 26 1 12 1
Line 27 1 14 1
Line 28 2 3 1
Line 29 2 7 1
Line 30 2 15 1
Line 31 3 4 1
Line 32 3 8 1
Line 33 3 16 1
Line 34 4 5 1
Line 35 4 9 1
Line 36 4 17 1
Line 37 5 6 1
Line 38 5 10 1
Line 39 5 18 1
Line 40 6 11 1
Line 41 6 19 1
Line 42 12 13 1
Line 43 >CO ANGSTROEM 0020
Line 44 4 (3I10)
Line 45 -6903 13566 -4583
Line 46 -14061 808 125
Line 47 -4424 -8880 7132
Line 48 7577 -12182 -1855
Line 49 14874 594 -6240
Line 50 5270 10234 -13349
Line 51 -18551 -4300 -8725
Line 52 -9815 -18274 9852
Line 53 4047 -17718 -10879
Line 54 19321 5600 2685
Line 55 10636 19608 -16168
Line 56 -2794 21139 6600
Line 57 2876 15736 11820
Line 58 -14029 20018 -10310

Chem & BioOffice 2006 /Chem3D File Formats 243


File Format Examples
Line 59 -22477 3450 6965
Line 60 -806 -4365 16672
Line 61 14642 -18918 3566
Administrator

Line 62 23341 -2014 -13035


Line 63 1740 5536 -22837

Each line is either a blank line, a block header line number of hydrogens attached to the atom, the
or a data record containing multiple fields of third field is the stereo information about the
information about the structure. The SMD file is atom and the fourth field is the formal charge
broken down into several blocks of information. of the atom.
The header for each block starts with a > sign.
Individual fields are delimited by space(s) or a tab. NOTE: If the file is created using Chem3D Pro, the
number of hydrogens, the stereo information and the
The fields in the SMD format file used by Chem3D formal charge fields are not used, and will always
Pro are discussed below: contain zeros.
1. Line 1 starts the block named STRT. This 6. Lines 2442 of the CT Block each contains 3
block contains the molecule name. The fields describing a bond between the two
molecule name is the file name when the file atoms. The first field is the serial number of the
was created using Chem3D Pro. atom from which the bond starts, the second
2. Line 2 starts the block named DTCR. The field is the serial number of atom where the
information in this line includes the name of bond ends, and the third field is the bond
the application that created the file and the date order.
and time when the file was generated. 7. Line 43 starts the block named CO, The infor-
3. Line 3 starts the block named CT which mation in this block includes the Cartesian
contains the connection table of the coordinates of all the atoms from the CT block
compound(s). Also on this line is a 10 character and indicates the type of coordinates used,
description of the connection table. This will Angstroms in this example. Also in this line is
be the same as the file name when the file is the number of lines in the block, 20 in this
generated using Chem3D Pro. Finally, the example.
number of records contained within the CT 8. Line 44 contains two fields. The first field
block is indicated, 39 in the above example. contains the exponent used to convert the
4. Line 4 of the CT Block contains four fields. coordinates in the lines following to the coor-
The first field is the number of atoms, the dinate type specified in line 43. The second
second field is the number of bonds, the third field is the FORTRAN format of the atom
field is the FORTRAN format for the number coordinates.
of atoms, and the fourth field is the 9. Lines 4565 each contains three fields
FORTRAN format for the number of bonds. describing the Cartesian coordinates of an
5. Lines 523 of the CT Block each contain 4 atom indicated in the CT block. The first field
fields describing an atom. The first field is the is the X coordinate, the second field is the Y
element symbol (first letter uppercase, second coordinate and the third field is the Z coordi-
lowercase). The second field is the total nate.

244 File Formats CambridgeSoft


File Format Examples
SYBYL MOL File The following is an example of a file in SYBYL
format produced from within Chem3D. This file
The SYBYL MOL File format (SYBYL) is defined describes a model of cyclohexanol.
in Chapter 9, SYBYL File Formats, pages 91
through 95, of the 1989 SYBYL Programming
Manual.
19 MOL Cyclohexanol0
1 1 1.068 0.3581 -0.7007C
2 1 -0.207 1.2238 -0.7007C
3 1 -1.473 0.3737 -0.5185C
4 1 1.1286 -0.477 0.5913C
5 1 -0.139 -1.324 0.7800C
6 1 -1.396 -0.445 0.7768C
7 8 2.1708 1.2238 -0.7007O
8 13 1.0068 -0.343 -1.5689H
9 13 -0.284 1.7936 -1.6577H
10 13 -0.147 1.9741 0.1228H
11 13 -2.375 1.032 -0.4983H
12 13 -1.589 -0.314 -1.3895H
13 13 1.2546 0.202 1.4669H
14 13 2.0091 -1.161 0.5742H
15 13 -0.077 -1.893 1.7389H
16 13 -0.21 -2.076 -0.0419H
17 13 -2.308 -1.081 0.8816H
18 13 -1.372 0.2442 1.6545H
19 13 2.9386 0.6891 -0.8100H
19 MOL
1 1 2 1
2 1 4 1
3 1 7 1
4 1 8 1
5 2 3 1
6 2 9 1
7 2 10 1
8 3 6 1
9 3 11 1

Chem & BioOffice 2006 /Chem3D File Formats 245


File Format Examples
10 3 12 1
11 4 5 1
12 4 13 1
Administrator

13 4 14 1
14 5 6 1
15 5 15 1
16 5 16 1
17 6 17 1
18 6 18 1
19 7 19 1
0 MOL

The following illustration shows the components of The format for SYBYL MOL files is as follows:
the SYBYL Output File from Chem3D for C(6)
and Bond 3 of Cyclohexanol. 1. The first record in the SYBYL MOL File
contains the number of atoms in the model, the
word MOL, the name of the molecule, and
the center of the molecule.
Number Molecule
of Atoms Name Center
2. The atom records (lines 220 in the cyclohex-
19 MOL Cyclohexanol 0
anol example) contain the Atom ID in column
6 1 -1.3959 -0.4449 0.7768C 1, followed by the Atom Type in column 2, and
the X, Y and Z Cartesian coordinates of that
Atom
ID
Atom
Type
X
Coord
Y
Coord
Z
Coord
atom in columns 35.
Number
of Bonds
3. The first record after the last atom records
19 MOL contains the number of bonds in the molecule,
3 1 7 1 followed by the word MOL.
Bond From-Atom To-Atom Bond 4. The bond records (lines 2240 in the cyclohex-
Number Type

Number
anol example) contain the Bond Number in
of Features column 1, followed by the Atom ID of the
atom where the bond starts (the From-
0 MOL
Atom) in column 2 and the Atom ID of the
atom where the bond stops (the To-Atom) in
column 3. The last column in the bond records
is the bond type. Finally the last line in the file
is the Number of Features record, which
contains the number of feature records in the
molecule. Chem3D does not use this informa-
tion.

246 File Formats CambridgeSoft


File Format Examples
FORTRAN Formats
Number of Features I4,1X,'MOL'
The FORTRAN format for each record of the record
SYBYL MOL File format is as follows:
SYBYL MOL2 File
Line Description FORTRAN Format
The SYBYL MOL21 file format (SYBYL2) is
Number of Atoms/File I4,1X,'MOL',20A2,11 defined in Chapter 3, File Formats, pages 3033
Name X,I4 3050, of the 1991 SYBYL Programming Manual. The
following is a sample SYBYL MOL2 file created
using Chem3D Pro. This file describes a model of
Atom records 2I4,3F9.4,2A2
cyclohexanol (the line numbers are added for
reference only):
Number of Bonds record I4,1X,'MOL'

Bond records 3I4,9X,I4

1. SYBYL is a product of TRIPOS Associ-


ates, Inc., a subsidiary of Evans &
Sutherland.
Line 1 # Name: CYCLOHEXANOL
Line 2
Line 3 @<TRIPOS>MOLECULE
Line 4 CYCLOHEXANOL
Line 5 19 19 0 0 0
Line 6 SMALL
Line 7 NO_CHARGES
Line 8
Line 9
Line 10 @<TRIPOS>ATOM
Line 11 1 C -1.349 0.195 1.032 C.3
Line 12 2 C -0.407 -0.896 1.563 C.3
Line 13 3 C 0.562 -1.378 0.473 C.3
Line 14 4 C 1.351 -0.205 -0.128 C.3
Line 15 5 C 0.42 0.9 -0.652 C.3
Line 16 6 C -0.559 1.37 0.436 C.3
Line 17 7 H -2.021 -0.239 0.253 H
Line 18 8 H -1.005 -1.759 1.944 H
Line 19 9 H 0.175 -0.496 2.427 H

Chem & BioOffice 2006 /Chem3D File Formats 247


File Format Examples
Line 20 10 H 1.27 -2.128 0.9 H
Line 21 11 H -0.01 -1.898 -0.331 H
Line 22 12 H 2.021 0.225 0.655 H
Administrator

Line 23 13 H 2.008 -0.569 -0.953 H


Line 24 14 H 1.03 1.766 -1.016 H
Line 25 15 O -0.3 0.427 -1.757 O.sp
Line 26 16 H -1.262 2.128 0.014 H
Line 27 17 H 0.014 1.876 1.249 H
Line 28 18 H -2.005 0.562 1.857 H
Line 29 19 H 0.329 0.223 -2.427 H.sp
Line 30 @<TRIPOS>BOND
Line 31 1 31 2 1
Line 32 2 1 6 1
Line 33 3 1 7 1
Line 34 4 1 18 1
Line 35 5 2 3 1
Line 36 6 2 8 1
Line 37 7 2 9 1
Line 38 8 3 4 1
Line 39 9 3 10 1
Line 40 10 3 11 1
Line 41 11 4 5 1
Line 42 12 4 12 1
Line 43 13 4 13 1
Line 44 14 5 6 1
Line 45 15 5 14 1
Line 46 16 5 15 1
Line 47 17 6 16 1
Line 48 18 6 17 1
Line 49 19 15 19 1

Each line is either a blank line, a section header or a information. Record type indicators (RTI) break
data record containing multiple fields of the information about the molecule into sections.
information about the compound. The SYBYL RTIs are always preceded by an @ sign.
MOL2 file is broken down into several sections of Individual fields are delimited by space(s) or a tab.

248 File Formats CambridgeSoft


File Format Examples
The fields in the SYBYL MOL2 format file used by 7. Line 7 describes the charge type associated
Chem3D Pro are as follows: with the molecule. This field contains
NO_CHARGES if the file is created using
1. Line 1 is a comment field. The pound sign Chem3D Pro.
preceding the text indicates a comment line.
Name: is a field designating the name of 8. Line 8, blank in the above example, might
molecule. The molecule name is the file name contain internal SYBYL status bits associated
when the file is created using Chem3D Pro. with the molecule.

2. Line 2 is a blank line. 9. Line 9, blank in the above example, might


contain comments associated with the mole-
3. Line 3, @<TRIPOS>MOLECULE, is a cule.
Record Type Indicator (RTI) which begins a
section containing information about the NOTE: Four asterisks appear in line 8 when there
molecule(s) contained in the file. are no status bits associated with the molecule but there
is a comment in Line 9.
NOTE: There are many additional RTIs in the
SYBYL MOL2 format. Chem3D Pro uses only 10. Line 10, @<TRIPOS>ATOM, is a Record
@<TRIPOS>MOLECULE, Type Indicator (RTI) which begins a section
@<TRIPOS>ATOM and containing information about each of the
@<TRIPOS>BOND. atoms associated with the molecule.

11. Lines 1129 each contain 6 fields describing


4. Line 4 contains the name of the molecule. The
name on line 4 is the same as the name on line information about an atom: the first field is the
1. atom id, the second field is the atom name, the
third field is the X coordinate, the fourth field
5. Line 5 contains 5 fields describing information is the Y coordinate, the fifth field is the Z
about the molecule: The first field is the coordinate and the sixth field is the atom type.
number of atoms, the second field is the
number of bonds, the third field is the number NOTE: Atom types are user-definable See Editing
of substructures, the fourth field is the number File Format Atom Types on page 221 for instructions
of features and the fifth field is the number of on modifying or creating an atom type.
sets.
12. Line 30, @<TRIPOS>BOND, is a Record
NOTE: Chem3D Pro ignores the following fields: number Type Indicator (RTI) which begins a section
of substructures, number of features and number of sets. containing information about the bonds
These fields will contain zeros if the file was created using associated with the molecule.
Chem3D Pro.
13. .Lines 3149 each contain 4 fields describing
information about a bond: the first field is the
6. Line 6 describes the molecule type. This field bond id, the second field is the from-atom id,
contains SMALL if the file is created using the third field is the to-atom id, and the fourth
Chem3D Pro. field is the bond type.

Chem & BioOffice 2006 /Chem3D File Formats 249


File Format Examples
FORTRAN Formats 5 Number of 4(1X,I2)
The FORTRAN format for each record of the atoms/number of
SYBYL MOL2 File format is as follows: bonds
Administrator

1129 Atom type, name, I4,6X,A2,3X,


coordinates and id 3F9.3,2X,A5
Line Description FORTRAN
Number Format
3149 Bond id, from-atom, 3I4,3X,A2
1 Molecule name (file # ,5X, to-atom, bond type
name) Name:
,1X,A

250 File Formats CambridgeSoft


File Format Examples
Appendix F: Parameter Tables
Parameter Table Over- Parameter Use
view Table

Chem3D uses the parameter tables, containing 4-Membered Ring Bond angles for bonds in
information about elements, bond types, atom Angles.xml 4-membered rings. In force
types, and other parameters, for building and for field analysis, angle bending
analyzing your model. portion of the force field for
bonds in 4-membered rings.
The parameter tables must be located in the C3D
Items directory in the same directory as the
4-Membered Ring Computes the portion of the
Chem3D application.
Torsionals.xml force field for the torsional
angles in your model for
Parameter Table Use atoms in 4-membered rings.

Chem3D uses several parameter tables to calculate Angle Bending Standard bond angles. In
bond lengths and bond angles in your model. To Parameters.xml force field analysis, angle
apply this information, select Apply Standard bending portion of the force
measurements in the Building Control panel. field for bonds.

Calculating the MM2 force field of a model requires


Atom Types.xml Contains atom types available
special parameters for the atoms and bonds in your
for building models.
model. The MM2 force field is calculated during
Energy Minimization, Molecular Dynamics, and
Steric Energy computations. Bond Stretching Standard bond lengths. In
Parameters.xml force field analysis, bond
The use of the parameter tables are described in the stretching and electrostatic
following table: portions of force field for
bonds.
Parameter Use
Table Conjugated Bond lengths for bonds
Pisystem involved in Pi systems. Pi
Atoms.xml system portion of the force
3-Membered Ring Bond angles for bonds in
field for pi atoms.
Angles.xml 3-membered rings. In force
field analysis, angle bending
portion of the force field for
bonds in 3-membered rings.

Chem & BioOffice 2006 /Chem3D Parameter Tables 251


Parameter Use Parameter Use
Table Table
Administrator

Conjugated Pi system portion of the force Torsional Parame- Computes the portion of the
Pisystem field for pi bonds. ters.xml force field for the torsional
Bonds.xml angles in your model.

Electronegativity Adjusts optimal bond length VDW Interac- Adjusts specific VDW inter-
Adjustments.xml between two atoms when one tions.xml actions, such as hydrogen
atom is attached to an atom bonding.
that is electronegative.
Parameter Table Fields
Elements.xml Contains elements available
for building models. Most of the tables contain the following types of
fields:
MM2 Atom Type van der Waals parameters for Atom Type Numbers
Parameters.xml computing force field for
Quality
each atom.
Reference
MM2 Constants used for
Constants.xml computing MM2 force field. Atom Type Numbers
The first column in a parameter table references an
Out-of-Plane Parameters to assure atoms in atom type using an Atom Type number. An Atom
Bending Parame- trigonal planar geometry Type number is assigned to an atom type in the
ters.xml remain planar. In force field Atom Types table. For example, in Chem3D, a
analysis, parameters to assure dihedral type field, 1114, in the Torsional
atoms in trigonal planar Parameters table indicates a torsional angle between
geometry remain planar. carbon atoms of type alkane (Atom Type number 1)
and carbon atoms of type alkyne (Atom Type
References.xml Contains information about number 4). In the 3-membered ring table, the angle
where parameter information type field, 22-22-22, indicates an angle between
is derived. three cyclopropyl carbons (Atom Type number 22)
in a cyclopropane ring.
Substructures.xml Contains predrawn substruc-
tures available for speeding Quality
up model building. The quality of a parameter indicates the relative
accuracy of the data.

Quality Accuracy Level

252 Parameter Tables CambridgeSoft


Parameter Table Fields
To view the parameters used in an MM2 analysis:
1 Parameter guessed by Chem3D.
From the Calculations menu, point to MM2,
and choose Show Used Parameters.
2 Parameter theorized but not
confirmed. Estimated parameters have a Quality value of
1.
3 Parameter derived from experi- Creating Parameters
mental data.
The MM2 force field parameters are based on a
4 Parameter well confirmed. limited number of MM2 atom types. These atom
types cover the common atom types found in
organic compounds. As discussed in the previous
Reference section, parameters may be missing from structures
The reference for a measurement corresponds to a containing other than an MM2 atom type.
reference number in the References table.
References indicate where the parameter data was NOTE: Adding or changing parameter tables is not
derived. recommended unless you are sure of the information your are
adding. For example, new parameter information that is
Estimating Parameters documented in journals.

In certain circumstances Chem3D may estimate


parameters. NOTE: A method for guessing at missing MM2
Parameters can be found in Development of an Internal
For example, during an MM2 analysis, a non-MM2 Searching Algorithm for Parameterization of the
atom type is encountered in your model. Although MM2/MM3 Force Fields, Journal of Computational
the atom type is defined in the Atom Types table, Chemistry, Vol 12, No. 7, 844849 (1991).
the necessary MM2 parameter will not be defined
for that atom type. For example, torsional
parameters are missing. This commonly occurs for To add a new parameter to a parameter table:
inorganic complexes, which MM2 does not cover 1. From the View menu, point to Parameter
adequately. More parameters exist for organic Tables and choose the parameter table to open.
compounds.
The parameter table appears.
In this case, Chem3D makes an educated guess 2. Right click on a row header and choose Append
wherever possible. A message indicating an error in Row from the context menu.
your model may appear before you start the
A blank row is inserted.
analysis. If you choose to ignore this, you can
determine the parameters guessed after the analysis 3. Type the information for the new parameter.
is complete. 4. Close and Save the file.

Chem & BioOffice 2006 /Chem3D Parameter Tables 253


Estimating Parameters
The new parameter is added to the file. Color
The colors of elements are used when the Color by
NOTE: Do not include duplicate parameters. If duplicate Element check box is selected in the control panel.
parameters exist in a parameter table it is indeterminate
Administrator

which parameter will be used when called for in a calculation. To change the color of an element:
Double-click the current color.

NOTE: If you do want to make changes to any of the The Color Picker dialog box appears in which
parameters used in Chem3D, we strongly recommend that you can specify a new color for the element.
you make a back up copy of the original parameter table and
remove it from the C3DTABLE directory. Atom Types
The Atom Types table Atom Types.xml) contains
the atom types for use in building your models.
The Elements
Normally you use only the first column of the Atom
The Elements table (Elements.xml) contains the Types table while building models. To use an atom
elements for use in building your models. type in a model, type its name in the Replacement
text box (or paste it, after copying the name cell to
To use an element in a model, type its symbol in the the Clipboard) and press the Enter key when an
Replacement text box (or paste it, after copying the atom is selected, or when you double-click an atom.
cell in the Symbol field to the Clipboard) and If no atom is selected, a fragment is added.
press the Enter key when an atom is selected, or
Twelve fields comprise an atom type record: name,
double-click an atom. If no atom is selected, a
symbol, van der Waals radius, text number, charge,
fragment is added.
the maximum ring size, rectification type, geometry,
number of double bonds, number of triple bonds,
Four fields comprise a record in the Elements table:
number of delocalized bonds, bound-to order and
the symbol, the covalent radius, the color, and the
bound-to type.
atomic number.
Name
Symbol
The records in the Atom Types table are ordered
Normally you use only the first column of the alphabetically by atom type name. Atom type names
Elements table while building models. If you are must be unique.
not currently editing a text cell, you can quickly
move from one element to another by typing the Symbol
first letter or letters of the element symbol. This field contains the element symbol associated
with the atom type. The symbol links the Atom
Covalent Radius Type table and the Elements table. The element
symbol is used in atom labels and when you save
The covalent radius is used to approximate bond files in file formats that do not support atom types,
lengths between atoms. such as MDL MolFile.

254 Parameter Tables CambridgeSoft


The Elements
van der Waals Radius When the information about an atom is displayed,
the atom symbol is always followed by the charge.
The van der Waals (VDW) radius is used to specify Charges can be fractional. For example, the charge
the size of atom balls and dot surfaces when of a carbon atom in a cyclopentadienyl ring should
displaying the Ball & Stick, Cylindrical Bonds or be 0.200.
Space Filling models.
Maximum Ring Size
The Close Contacts command in the Measurements
The maximum ring size field indicates whether the
submenu of the Structure menu determines close
corresponding atom type should be restricted to
contacts by comparing the distance between pairs
atoms found in rings of a certain size. If this cell is
of non-bonded atoms to the sum of their van der
zero or empty, then this atom type is not restricted.
Waals radii.
For example, the maximum ring size of
The van der Waals radii specified in the Atom Types C Cyclopropane is 3.
table do not affect the results of an MM2
computation. The radii used in MM2 computations Rectification Type
are specified in the MM2 Atom Types table. The rectification type specifies the type of atom
used to fill open valences. Rectification atoms are
NOTE: The space filling model display is set in the Model added or deleted as you build your model if you
Display tab of the Model Settings dialog box. The have selected the Automatically Rectify checkbox
appearance of VDW dot surfaces is specified for the entire from the Model Build tab of the Model Settings
model in the Atom Display tab of the Model Settings dialog dialog box.
box, or for individual atoms using the Right-click Atom Possible rectification types are:
Dots submenu in the Model Explorer.
D
H
Text Number (Atom Type) H Alcohol
H Amide
Text numbers are used to determine which
measurements apply to a given group of atoms in H Amine
other parameter tables. H Ammonium
H Carboxyl
For example, C Alkane has an atom type number
H Enol
of 1and O Alcohol has an atom type number of 6.
To determine the standard bond length of a bond H Guanidine
between a C Alkane atom and an O Alcohol atom, H Thiol
you should look at the 1-6 record in the Bond
Stretching table. NOTE: When you specify a rectification type, the bound-to
type of the rectification type should not conflict with the atom
Charge type. If there is no rectification type for an atom, it is never
rectified.
The charge of an atom type is used when assigning For example, if the rectification type of O Carboxyl is H
atom types to atoms in a model. Carboxyl, the bound-to type of H Carboxyl should be either

Chem & BioOffice 2006 /Chem3D Parameter Tables 255


Atom Types
O Carboxyl or empty. Otherwise, when assigning atom types, Bound-to Order
hydrogen atoms bound to O Carboxyl atoms are not assigned
H Carboxyl. Specifies the order of the bond acceptable between
this atom type and the atom type specified in the
Administrator

bound-to type.
Geometry
For example, for C Carbonyl, only double bonds
The geometry for an atom type describes both the can be formed to bound-to type O Carboxylate. If
number of bonds that extend from this type of there is no bound-to type specified, this field is not
atom and the angles formed by those bonds. used.
Possible geometries are: Possible bond orders are:
0 Ligand Single
1 Ligand Double
5 Ligands Triple

Bent Delocalized

Linear NOTE: The bound-to order should be consistent with the


Octahedral number of double, triple, and delocalized bonds for this atom
Square planar type. If the bound-to type of an atom type is not specified, its
bound-to order is ignored.
Tetrahedral
Trigonal bipyramidal
Bound-to Type
Trigonal planar
Specifies the atom type that this atom must be
Trigonal pyramidal
bound to. If there is no restriction, this field is
empty. Used conjunction with the Bound-to Order
NOTE: Standard bond angle parameters are used only
field.
when the central atom has a tetrahedral, trigonal or bent
geometry. Non-blank Bound-to-Type values:
C Alkene
Number of Double Bonds, C Carbocation
Triple Bonds, and Delocal- C Carbonyl
ized Bonds C Carboxylate
C Cyclopentadienyl
The number of double bonds, number of triple
bonds, and number of delocalized bonds are C Cyclopropene
integers ranging from zero to the number of ligands C Epoxy
as specified by the geometry. Chem3D uses this C Isonitrile
information both to assign atom types based on the
bond orders and to assign bond orders based on C Metal CO
atom types. C Thiocarbonyl

256 Parameter Tables CambridgeSoft


Atom Types
H Alcohol References
H Thiol
The References table (References.xml) contains
N Ammonium information concerning the source for other
N Azide Center parameters. Use of the References table does not
affect the other tables in any way.
N Azide End
Two fields are used for each reference record: the
N Isonitrile
reference number and the reference description.
N Nitro
O Carbonyl Reference Number
O Carboxylate The reference number is an index by which the
references are organized. Each measurement also
O Epoxy
contains a reference field that should contain a
O Metal CO reference number, indicating the source for that
measurement.
O Nitro
O Oxo Reference Description
O Phosphate
The reference description contains whatever text
P Phosphate you need to describe the reference. Journal
references or bibliographic data are common
S Thiocarbonyl
examples of how you can describe your references.

Substructures Bond Stretching Parame-


The Substructure table (Substructures.xml) ters
contains substructures to use in your model.
The Bond Stretching Parameters table (Bond
To use a substructure simply type its name in the Stretching Parameters.xml) contains information
Replacement text box (or paste it, after copying the about standard bond lengths between atoms of
name cell to the Clipboard) and press the Enter key various atom types. In addition to standard bond
when an atom(s) is selected, or double-click an lengths are information used in MM2 calculations
atom. You can also copy the substructures picture in Chem3D.
to the Clipboard and paste it into a model window.
The substructure is attached to selected atom(s) in The Bond Stretching table contains parameters
the model window. If no atom is selected, a needed to compute the bond stretching and
fragment is added. You can also define your own electrostatic portions of the force field for the
substructures and add them to the table. The table bonds in your model.
below shows the substructure table window with
the substructure records open (triangles facing The Bond Stretching Parameters record consists of
down). Clicking a triangle closes the record. The six fields: Bond Type, KS, Length, Bond Dpl,
picture of the substructure is minimized. Quality, and Reference.

Chem & BioOffice 2006 /Chem3D Parameter Tables 257


Substructures
Bond Type gen is more electronegative than an alkane carbon.

The Bond Type field contains the atom type Finally, the 1-19 bond type has a bond dipole
numbers of the two bonded atoms. of - 0.600 since a silane silicon is less
electronegative than an alkane carbon.
Administrator

For example, Bond Type 1-2 is a bond between an


alkane carbon and an alkene carbon. NOTE: The 1-5 bond type has a dipole of zero, despite the
fact that the carbon and hydrogen atoms on this bond have
KS unequal electronegativity. This approximation drastically
reduces the number of dipoles to be computed and has been
The KS, or bond stretching force constant field,
found to produce acceptable results.
contains a proportionality constant which directly
impacts the strength of a bond between two atoms.
The larger the value of KS for a particular bond Record Order
between two atoms, the more difficult it is to
compress or to stretch that bond. The order of the records in the Bond Stretching
table window is as follows:
Length
1. Records are sorted by the first atom type
The third field, Length, contains the bond length number in the Bond Type field. For example,
for a particular bond type. The larger the number in the record for bond type 1-3 is before the
the Length field, the longer is that type of bond. record for bond type 2-3.
2. For records where the first atom type number
Bond Dipole is the same, the records are sorted by the
The Bond Dpl field contains the bond dipole for a second atom type number in the Bond Type
particular bond type. The numbers in this cell give field. For example, bond type 1-1 is before the
an indication of the polarity of the particular bond. record for bond type 1-2.
A value of zero indicates that there is no difference
in the electronegativity of the atoms in a particular Angle Bending
bond. A positive bond dipole indicates that the
(4-Membered Ring Angle Bending, 3-Membered
atom type represented by the first atom type
Ring Angle Bending)
number in the Bond Type field is less
electronegative than the atom type represented by The Angle Bending table (Angle Bending
the second atom type number. Finally, a negative Parameters.xml) contains information about bond
bond dipole means that the atom type represented angles between atoms of various atom type. In
by the first atom type number in the Bond Type addition to standard bond angles are information
field is more electronegative than the atom type used in MM2 Calculations in Chem3D. Angle
represented by the second atom type number. bending parameters are used when the central atom
has four or fewer attachments and the bond angle is
For example, the 1-1 bond type has a bond dipole not in a three or four membered ring. In three and
of zero since both alkane carbons in the bond are of four membered rings, the parameters in the
the same electronegativity. The 1-6 bond type has a 3-Membered Ring Angles.xml and 4-Membered
bond dipole of 0.440 since an ether or alcohol oxy- Ring Angles.xml are used.

258 Parameter Tables CambridgeSoft


Angle Bending
The Angle Bending table contains the parameters of KB for a particular bond angle described by
used to determine the bond angles in your model. three atoms, the more difficult it is to compress or
In Chem3D Pro, additional information is used to stretch that bond angle.
compute the angle bending portions of the MM2
force field for the bond angles in your model. XR2
The 4-membered Ring Angles table contains the XR2, the third field, contains the optimal value
parameters that are needed to determine the bond of a bond angle where the central atom of that bond
angles in your model that are part of 4-membered angle is not bonded to any hydrogen atoms. In the
rings. In Chem3D, additional information is used to XR2 notation, X represents the central atom of a
compute the angle bending portions of the MM2 bond angle and R represents any non-hydrogen
force field for any bond angles in your model which atom bonded to X.
occur in 4-membered rings.
The 3-membered Ring Angles table contains the For example, the optimal value of the 1-1-3 angle
parameters that are needed to determine the bond type for 2,2-dichloropropionic acid is the XR2
angles in your model that are part of 3-membered bond angle of 107.8, since the central carbon (C-2)
rings. In Chem3D, additional information is used to has no attached hydrogen atoms.
compute the angle bending portions of the MM2
force field for any bond angles in your model which The optimal value of the 1-8-1 angle type for
occur in 3-membered rings. N,N,N-triethylamine is the XR2 bond angle of
107.7, because the central nitrogen has no attached
Each of the records in the Angle Bending table, the hydrogen atoms. Notice that the central nitrogen
4-Membered Ring Angles table and the 3- has a trigonal pyramidal geometry, thus one of the
Membered Ring Angles table consists of seven attached non-hydrogen atoms is a lone pair, the
fields: Angle Type, KB, XR2, XRH, XH2, other non-hydrogen atom is a carbon.
Quality, and Reference.
XRH
Angle Type
The XRH field contains the optimal value of a
The first field, Angle Type, contains the atom type
bond angle where the central atom of that bond
numbers of the three atoms which describe the
angle is also bonded to one hydrogen atom and one
bond angle.
non-hydrogen atom. In the XRH notation, X
For example, angle type 1-2-1 is a bond angle and R are the same as XR2, and H represents a
formed by an alkane carbon bonded to an alkene hydrogen atom bonded to X.
carbon which is bonded to another alkane carbon.
Notice that the alkene carbon is the central atom of For example, the optimal value of the 1-1-3 angle
the bond angle. type for 2-chloropropionic acid is the XRH bond
angle of 109.9, since the central carbon (C-2) has
KB one attached hydrogen atom. The optimal value of
the 1-8-1 angle type for N,N-diethylamine is the
The KB, or the angle bending constant, contains a XRH value of 107.7, because the central N has
measure of the amount of energy required to one attached hydrogen atom. In this case the
deform a particular bond angle. The larger the value XR2 and XRH values for the 1-8-1 angle type

Chem & BioOffice 2006 /Chem3D Parameter Tables 259


Angle Bending
are identical. As in the N,N,N-triethylamine your model. In Chem3D, additional information is
example above, the only attached non-hydrogen used to compute the pi system portions of the
atom is a lone pair. MM2 force field for the pi atoms in your model.

The records in the Pi Atoms table are comprised of


Administrator

XH2
six fields: Atom Type, Electron, Ionization,
XH2 is the optimal value of a bond angle where Repulsion, Quality, and Reference.
the central atom of that bond angle is also bonded
to two hydrogen atoms. Atom Type
For example, the optimal value of the 1-1-3 angle The Atom type number field contains the atom
type for propionic acid is the XH2 bond angle of type number to which the rest of the Conjugated
110.0, since the central carbon (C-2) has two Pisystem Atoms record applies.
attached hydrogen atoms.
Electron
Record Order
The Electron field contains the number of
When sorted by angle type, the order of the records electrons that a particular pi atom contributes to the
in the Angle Bending table, the 4-Membered Ring pi system.
Angles table and the 3-Membered Ring Angles
table is as follows: For example, an alkene carbon, atom type number
2, contributes 1 electron to the pi system whereas a
1. Records are sorted by the second atom type pyrrole nitrogen, atom type number 40, contributes
number in the Angle Type field. For example, 2 electrons to the pi system.
the record for bond angle type 1-2-1 is before
the record for bond angle type 1-3-1.
Ionization
2. For multiple records where the second atom
type number is the same, the records are sorted The Ionization field contains the amount of energy
by the first atom type number in the Angle required to remove a pi electron from an isolated pi
Type field. For example, the record for bond atom. The units of the ionization energy by electron
angle type 1-3-2 is listed before the record for volts (eV). The magnitude of the ionization energy
bond angle type 2-3-2. is larger the more electronegative the atom.
3. For multiple records where the first two atom For example, an alkene carbon has an ionization
type numbers are the same, the records are energy of -11.160 eV, and the more electronegative
sorted by the third atom type number in the pyrrole nitrogen has an ionization energy of -13.145
Angle Type field. For example, the record for eV.
bond angle type 1-1-1 is listed before the
record for bond angle type 1-1-2. Repulsion
Pi Atoms The Repulsion field contains a measure of:

The Pi Atoms table (Conjugated Pisystem The energy required to keep two electrons,
Atoms.xml) contains the parameters which are used each on separate pi atoms, from moving apart
to correct bond lengths and angles for pi atoms in and

260 Parameter Tables CambridgeSoft


Pi Atoms
The energy required to keep two electrons, The higher the value of Kx for the bond between
occupying the same orbital on the same pi two pi atoms, the more difficult it is to compress or
atom, from moving apart. stretch that bond.
The units of the repulsion energy are electron
volts (eV). The repulsion energy is more dLength
positive the more electronegative the atom.
The dLength field contains a constant used to
For example, an alkene carbon has an repulsion increase the bond length of any conjugated double
energy of 11.134 eV, and the more electronegative bond. The bond length lx for a bond with a
pyrrole nitrogen has an repulsion energy of 17.210 calculated pi bond order x is:
eV.
lx = l2 + (1 - x) * dLength
Pi Bonds
where l2 is the bond length of a non-conjugated
The Pi Bonds table (Conjugated PI System double bond, taken from the Bond Stretching
Bonds.xml) contains parameters used to correct table. The higher the value of lx for the bond
bond lengths and bond angles for bonds that are between two pi atoms, the longer that bond is.
part of a pi system. In Chem3D, additional
information is used to compute the pi system Record Order
portions of the MM2 force field for the pi bonds in
a model. When sorted for Bond Type, the order of the
records in the Conjugated Pisystem Bonds table is
There are five fields in records in the Pi Bonds
as follows:
table: Bond Type, dForce, dLength, Quality, and
Reference. 1. Records are sorted by the first atom type
number in the Bond Type field. For example,
Bond Type the record for bond type 2-2 is listed before the
The Bond Type field is described by the atom type record for bond type 3-4.
numbers of the two bonded atoms. 2. For records where the first atom type number
For example, bond type 2-2 is a bond between two is the same, the records are sorted by the
alkene carbons. second atom type number in the Bond Type
field. For example, the record for bond type 2-
dForce 2 is listed before the record for bond type 2-3.

The dForce field contains a constant used to Electronegativity Adjust-


decrease the bond stretching force constant of a
particular conjugated double bond. The force ments
constant Kx for a bond with a calculated pi bond
order x is: The parameters contained in the Electronegativity
Adjustments table (Electronegativity
Kx = K2 - (1 - x) * dForce Adjustments.xml) are used to adjust the optimal
where K2 is the force constant for a non- bond length between two atoms when one of the
conjugated double bond, taken from the Bond atoms is attached to a third atom which is
Stretching table. electronegative.

Chem & BioOffice 2006 /Chem3D Parameter Tables 261


Pi Bonds
For example, the carbon-carbon single bond length Certain molecules contain long bonds which are
in ethane is different than that in ethanol. The MM2 not described well by Hooke's Law. For this reason
parameter set has only a single parameter for the MM2 force field contains a cubic stretch term.
carbon-carbon single bond lengths (1.523). The The cubic stretch term allows for an asymmetric
Administrator

use of electronegativity correction parameters shape of the potential well, thereby allowing these
allows the C-C bond in ethanol to be corrected. The long bonds to be handled. However, the cubic
electronegativity parameter used in the stretch term is not sufficient to handle abnormally
Electronegativity Corrections table is the 1-1-6 long bonds. Thus the MM2 force field contains a
angle type, where atom type 1 is a C Alkane and quartic stretch term to correct for problems caused
atom type 6 is an O Alcohol. The value of this by these abnormally long bonds.
parameter is -0.009. Thus the C-C bond length in
ethanol is 0.009 shorter than the standard C-C Type 2 (-CHR-) Bending Force
bond length.
Parameters for C-C-C Angles
MM2 Constants -CHR- Bending K for 1-1-1 angles -CHR- Bending
The MM2 Constants table (MM2 Constants.xml) K for 1-1-1 angles in 4-membered rings -CHR-
contains parameters which Chem3D uses to Bending K for 22-22-22 angles in 3-membered
compute the MM2 force field. rings

These constants are distinct from the force


Cubic and Quartic Stretch constants specified in the Angle Bending table. The
Constants bending force constant (K) for the 1-1-1 angle (1 is
the atom type number for the C Alkane atom type)
Integrating the Hooke's Law equation provides the listed in the MM2 Angle Bending parameters table
Hooke's Law potential function which describes is for an alkane carbon with two non-hydrogen
the potential energy of the ball and spring model. groups attached. Angle bending parameters for
The shape of this potential function is the classical carbons with one or two attached hydrogens differ
potential well. from those for carbons with no attached hydrogens.
Because carbons with one or two attached
dV hydrogens frequently occur, separate force
------- = F = dx
dx constants are used for these bond angles.

The Hooke's Law potential function is quadratic, The -CHR- Bending K for 1-1-1 angles allows more
thus the potential well created is symmetrical. The accurate force constants to be specified for the
real shape of the potential well is asymmetric and is Type 1 (-CH2-) and Type 2 (-CHR-) interactions. In
defined by a complicated function called the Morse addition, the -CHR- Bending K for 1-1-1 angles in
Function, but the Hooke's Law potential function 4-membered rings and the -CHR- Bending K for
works well for most molecules. 22-22-22 angles (22 is the atom type number for the
C Cyclopropane atom type) in 3-membered rings
x x 1--- kx 2 differ from the aforementioned -CHR- Bending K
V( x)=
0 dV = k0 xdx = 2 for 1-1-1 angles and thus require separate constants
to be accurately specified.

262 Parameter Tables CambridgeSoft


MM2 Constants
Stretch-Bend Parameters The charge-dipole interaction uses the geometric
mean of the charge and dipole dielectric constants.
X-B,C,N,O-Y Stretch-Bend interaction force
constant X-B,C,N,O-H Stretch-Bend interaction For example, when you increase the Dielectric
force constant X-Al,S-Y Stretch-Bend force constant for dipoles, a decrease in the
constant X-Al,S-H Stretch-Bend force constant X- Dipole/Dipole energy occurs. This has the effect of
Si,P-Y Stretch-Bend force constant X-Si,P-H reducing the contribution of dipole-dipole
Stretch-Bend force constant X-Ga,Ge,As,Se-Y
interactions to the total steric energy of a molecule.
Stretch-Bend force constant

The stretch-bend parameters are force constants Electrostatic and van der
for the stretch-bend interaction terms in the prior
list of elements. X and Y represent any non-
Waals Cutoff Parameters
hydrogen atom.
Cutoff distance for charge/charge interactions
When an angle is compressed, the MM2 force field Cutoff distance for charge/dipole interactions
uses the stretch-bend force constants to lengthen Cutoff distance for dipole/dipole interactions
the bonds from the central atom in the angle to the Cutoff distance for van der Waals interactions
other two atoms in the angle.
These parameters define the minimum distance at
For example, the normal C-C-C bond angle in
which the fifth-order polynomial switching
cyclobutane is 88.0, as compared to a C-C-C bond
function is used for the computation of the listed
angle of 110.8 in cyclohexane. The stretch-bend
interactions.
force constants are used to lengthen the C-C bonds
in cyclobutane to 1.550, from a C-C bond length
of 1.536 in cyclohexane. MM2 Atom Types
Sextic Bending Constant The MM2 Atom Types table (MM2 Atom
Types.xml) contains the van der Waals parameters
Sextic bending constant (* 10**8) used to compute the force field for each atom in
your model.
Chem3D uses the sextic bending constant to
increase the energy of angles with large
Each MM2 Atom Type record contains eight fields:
deformations from their ideal value.
Atom type number, R*, Eps, Reduct, Atomic
Dielectric Constants Weight, Lone Pairs, Quality, and Reference.

Dielectric constant for charges Dielectric constant Atom type number


for dipoles
The dielectric constants perform as inverse The Atom Type number field is the atom type to
proportionality constants in the electrostatic energy which the rest of the MM2 Atom Type Parameter
terms. The constants for the charge and dipole record applies. The records in the MM2 Atom Type
terms are supplied separately so that either can be table window are sorted in ascending order of
partially or completely suppressed. Atom Type Atom type number.

Chem & BioOffice 2006 /Chem3D Parameter Tables 263


MM2 Atom Types
R* However, it is a reasonable compromise to assume
that the electron cloud about hydrogen is still
The R* field is the van der Waals radius of the spherical, but that it is no longer centered on the
particular atom. The larger the van der Waals radius hydrogen nucleus. The Reduct constant is
Administrator

of an atom is, the larger that atom. multiplied by the normal bond length to give a new
bond length which represents the center of the
repositioned electron cloud.
NOTE: Chem3D uses the van der Waals radius, R*, in
the MM2 Atom Types table for computation. It is not the The value of the Reduct field for all non-hydrogen
same as the van der Waals radius in the Atom Types table, atoms is zero.
which is used for displaying the model.
Atomic Weight
Eps The fifth field, Atomic Weight, is the atomic weight
of atoms represented by this atom type number.
The Eps or Epsilon field is a constant which is
proportional to the depth of the potential well. As NOTE: The atomic weight is for the isotopically pure
the value of epsilon increases, the depth of the element, i.e. the atomic weight for atom type number 1 is
potential well increases, as does the strength of the 12.000, the atomic weight of 12C.
repulsive and attractive interactions between this
atom and other atoms.
Lone Pairs
NOTE: For specific VDW interactions, the R* and Eps The Lone Pairs field contains the number of lone
values from the VDW Interactions table are used instead of pairs around a particular atom type. Notice that an
values in the MM2 Atom Types table. See VDW amine nitrogen, atom type number 8, has one lone
Interactions later in the chapter for more information. pair and an ether oxygen, atom type number 6, has
two lone pairs. Lone pairs are treated explicitly for
atoms such as these, which have distinctly
Reduct non-spherical electron distributions. For atom types
such as O Carbonyl, which have more nearly
Reduct, the fourth field, is a constant used to orient spherical electron distributions, no explicit lone
the center of the electron cloud on a hydrogen atom pairs are necessary.
toward the nucleus of the carbon atom to which it
is bonded by approximately 10% of the distance
NOTE: Lone pairs are added automatically to atoms
between the two atoms.
which require them at the beginning of an MM2
Any atom in a van der Waals potential function computation.
must possess a spherical electron cloud centered
about its nucleus. For most larger atoms this is a Torsional Parameters
reasonable assumption, but for smaller atoms such
as hydrogen it is not a good assumption. Molecular The Torsional Parameters table (Torsional
mechanics calculations based on spherical electron Parameters.xml) contains parameters used to
clouds centered about hydrogen nuclei do not give compute the portions of the MM2 force field for
accurate results. the torsional angles in your model. The 4-

264 Parameter Tables CambridgeSoft


Torsional Parameters
Membered Ring Torsional Parameters V2
(4-membered Ring Torsionals.xml) contains
torsional parameters for atoms in 4-membered The V2, or 180 Periodicity Torsional constant,
rings. field contains the second of three principal
torsional constants used to compute the total
Each of the records in the Torsional Parameters torsional energy in a molecule. V2 derives its name
table and the 4-Membered Ring Torsional from the fact that a torsional constant of 180
Parameters table consists of six fields: Dihedral periodicity can have only two torsional energy
Type, V1, V2, V3, Quality, and Reference. minima and two torsional energy maxima within a
360 period.
Dihedral Type
A positive value of V2 indicates there are minima at
The Dihedral Type field contains the atom type
0 and +180, and there are maxima at -90 and
numbers of the four atom types which describe the
+90 in a 360 period. A negative value of V2
dihedral angle.
causes the position of the maxima and minima to be
For example, angle type 1-2-2-1 is a dihedral angle switched, as in the case of V1 above. The
formed by an alkane carbon bonded to an alkene significance of V2 is explained in the following
carbon which is first bonded to a second alkene example.
carbon which is bonded to another alkane carbon.
A good example of the significance of the V1 and
In other words, angle type 1-2-2-1 is the dihedral
V2 torsional constants exists in the 1-2-2-1
angle between the two methyl groups of 2-butene.
torsional parameter of 2-butene. The values of V1
The two alkene carbons are the central atoms of the and V2 in the Torsional Parameters table are -0.100
dihedral angle. and 10.000 respectively.

V1 Because a positive value of V2 indicates that there


are minima at 0 and +180, these minima signify
The V1, or 360 Periodicity Torsional constant, cis-2-butene and trans-2-butene respectively.
field contains the first of three principal torsional Notice that V2 for torsional parameters involving
constants used to compute the total torsional torsions about carbon-carbon double bonds all
energy in a molecule. V1 derives its name from the have values ranging from approximately V2=8.000
fact that a torsional constant of 360 periodicity can to V2=16.250. In addition, V2 torsional parameters
have only one torsional energy minimum and one involving torsions about carbon-carbon single
torsional energy maximum within a 360 period. bonds all have values ranging from approximately
The period starts at -180 and ends at 180. V2=-2.000 to V2=0.950.

A positive value of V1 means that a maximum The values of V2 for torsions about carbon-carbon
occurs at 0 and a minimum occurs at 180 in a double bonds are higher than those values for
360 period. A negative value of V1 means that a torsions about carbon-carbon single bonds. A
minimum occurs at 0 and a maximum occurs at consequence of this difference in V2 values is that
180 in a 360 period. The significance of V1 is the energy barrier for rotations about double bonds
explained in the example following the V2 is much higher than the barrier for rotations about
discussion. single bonds.

Chem & BioOffice 2006 /Chem3D Parameter Tables 265


Torsional Parameters
The V1 torsional constant creates a torsional energy 60, +60 and +180 and there are maxima at -
difference between the conformations represented 120, 0, and +120 in a 360 period. A negative
by the two torsional energy minima of the V2 value of V3 causes the position of the maxima and
constant. As discussed previously, a negative value minima to be reversed, as in the case of V1 and V2
Administrator

of V1 means that a torsional energy minimum above. The significance of V3 is explained in the
occurs at 0 and a torsional energy maximum following example.
occurs at 180. The value of V1=-0.100 means that
cis-2-butene is a torsional energy minimum that is The 1-1-1-1 torsional parameter of n-butane is an
0.100 kcal/mole lower in energy than the torsional example of the V3 torsional constant. The values of
energy maximum represented by trans-2-butene. V1, V2 and V3 in the Torsional Parameters table are
0.200, 0.270 and 0.093 respectively. Because a
The counterintuitive fact that the V1 field is positive value of V3 indicates that there are minima
negative can be understood by remembering that at -60, +60 and +180 and there are maxima at -
only the total energy can be compared to 120, 0, and +120, the minima at 60 signify the
experimental results. In fact, the total energy of
two conformations of n-butane in which the methyl
trans-2-butene is computed to be 1.423 kcal/mole
groups are gauche to one another. The +180
lower than the total energy of cis-2-butene. This
minimum represents the conformation in which the
corresponds closely with experimental results. The
methyl groups are anti to one another. The
negative V1 term has been introduced to
maximum at 0 represents the conformation in
compensate for an overestimation of the energy
which the methyl groups are eclipsed. The maxima
difference based solely on van der Waals repulsion
at 120 conform n-butane in which a methyl
between the methyl groups and hydrogens on
group and a hydrogen are eclipsed.
opposite ends of the double bond. This example
illustrates an important lesson: The V1 and V2 torsional constants in this example
affect the torsional energy in a similar way to the V1
There is not necessarily any correspondence
between the value of a particular parameter used in torsional constant for torsions about a carbon-
MM2 calculations and value of a particular physical carbon double bond (see previous example).
property of a molecule.
NOTE: The results of MM2 calculations on hydrocarbons
V3 do not correspond well with the experimental data on
hydrocarbons when only the V3 torsional constant is used
The V3, or 120 Periodicity Torsional constant, (when V1 and V2 are set to zero). However, including
field contains the third of three principal torsional small values for the V1 and V2 torsional constants in the
constants used to compute the total torsional MM2 calculations for hydrocarbons dramatically improve
energy in a molecule. V3 derives its name from the the correspondence of the MM2 results with experimental
fact that a torsional constant of 120 periodicity can results. This use of V1 and V2 provides little
have three torsional energy minima and three correspondence to any particular physical property of
torsional energy maxima within a 360 period. A hydrocarbons.
positive value of V3 indicates there are minima at -

266 Parameter Tables CambridgeSoft


Torsional Parameters
Record Order There are four fields in records in the Out-of-Plane
Bending Parameters table: Bond Type, Force
When sorted by Dihedral Angle, the order of the Constant, Quality and Reference.
records in the Torsional Parameters table and the
4-Membered Ring Torsional Parameters table is as Bond Type
follows: The first field is the Bond Type which is described
by the atom type numbers of the two bonded
1. Records are sorted by the second atom type atoms.
number in the Dihedral Type field. For
example, the record for dihedral type 1-1-1-1 is For example, Bond Type 2-3 is a bond between an
listed before the record for dihedral alkene carbon and a carbonyl carbon.
type 1-2-1-1.
Force Constant
2. For records where the second atom type
number is the same, the records are sorted by The Force Constant field, or the out-of-plane
the third atom type number in the Dihedral bending constant, field contains a measure of the
Type field. For example, the record for dihedral amount of energy required to cause a trigonal
type 1-1-1-1 is listed before the record for planar atom to bend out-of-plane, i.e., to become
dihedral type 1-1-2-1. non-planar. The larger the value of Force Constant
for a particular atom, the more difficult it is to
3. For multiple records where the second and coerce that atom to be non-planar.
third atom type numbers are the same, the
records are sorted by the first atom type
Record Order
number in the Dihedral Type field. For
example, the record for dihedral type 5-1-3-1 is When sorted by Bond Type, the order of the
listed before the record for dihedral type 6-1-3- records in the Out-of-Plane Bending Parameters
1. table is as follows:
4. For multiple records where the first, second 1. Records are sorted by the first atom type
and third atom type numbers are the same, the number in the Bond Type field. For example,
records are sorted by the fourth atom type the record for bond type 2-1 is before the
number in the Dihedral Type field. For record for bond type 3-1.
example, the record for dihedral type 5-1-3-1 is
listed before the record for dihedral 2. For records where the first atom type number
type 5-1-3-2. is the same, the records are sorted by the
second atom type number in the Bond Type
field. For example, the record for bond type 2-
Out-of-Plane Bending 1 is before the record for bond type 2-2.

The Out-of-Plane Bending table (Out-of-Plane NOTE: Out-of-plane bending parameters are not
Bending Parameters.xml) contains parameters symmetrical. For example, the force constant for a 2-3 bond
which are used to ensure that atoms with trigonal refers to the plane about the type 2 atom. The force constant
planar geometry remain planar in MM2 for a 3-2 bond refers to the plane about the type 3 atom.
calculations.

Chem & BioOffice 2006 /Chem3D Parameter Tables 267


Out-of-Plane Bending
VDW Interactions Eps parameter is substituted for the geometric
mean of the Eps parameters for a pair of atoms if
The parameters contained in the VDW parameters their atom types appear in the VDW Interactions
table (VDW Interaction.xml) are used to adjust table.
Administrator

specific VDW interactions in a molecule, such as


hydrogen bonding, to provide better Record Order
correspondence with experimental data in
calculating the MM2 force field. When sorted by Atom Type, the order of the
records in VDW Interactions table window is as
For example, consider the VDW interaction
follows:
between an Alkane carbon (Atom Type 1) and a
hydrogen (Atom Type 5). Normally, the VDW Records are sorted by the first atom type number in
energy is based on the sum of the VDW radii for the Atom Type field. For example, the record for
these atoms, found for each atom in the Atom Atom Type 1-36 is before the record for atom type
Types table (1.900 for Atom type number 1 + 2-21.
1.400 for Atom type number 2 = 3.400).
However, better correspondence between the For records where the first atom type number is the
computed VDW energy and experimental data is same, the records are sorted by the second atom
found by substituting this sum with the value found type number in the Atom Type field. For example,
in the VDW Interactions table for this specific atom the record for atom type 2-21 is before the record
type pair (Atom Types 1-5 = 3.340). Similarly, an for atom type 2-23.

268 Parameter Tables CambridgeSoft


VDW Interactions
Appendix G: Computation Concepts
Computational Molecular mechanicsapplies the laws of
classical physics to the atoms in a molecule
Chemistry Overview without explicit consideration of electrons.
Quantum mechanicsrelies on the
Computational chemistry allows the exploration of Schrdinger equation to describe a molecule
molecules by using a computer when an actual with explicit treatment of electronic structure.
laboratory investigation may be inappropriate,
Quantum mechanical methods can be
impractical, or impossible.
subdivided into two classes: ab initio and
Aspects of computational chemistry include: semiempirical.
Figure G-21: Computational Chemistry Methods
Molecular modeling.
Computational Chemistry Methods
Computational methods.
Computer-Aided Molecular Design (CAMD).
Molecular Quantum
Chemical databases. Mechanical Methods Mechanical Methods

Organic synthesis design.

Molecular modeling can be thought of as the


Semiempirical Ab Initio
rendering of a 2D or 3D model of a molecules Methods Methods
structure and properties. Computational methods,
on the other hand, calculate the structure and Chem3D provides the following methods:
property data necessary to render the model.
Within a modeling program such as Chem3D, Method
computational methods are referred to as
computation engines, while geometry engines and
graphics engines render the model. molecular MM2 Chem3D, Tinker
mechanics Tinker
Chem3D supports a number of powerful MM3,
computational chemistry methods and extensive MM3-
visualization options. protein Gaussian

AMBER,UFF,
Computational Methods Dreiding
Overview
Computational chemistry encompasses a variety of
mathematical methods which fall into two broad
categories:

Chem & BioOffice 2006 /Chem3D Computation Concepts 269


Computational Methods Overview
Single point energy calculationThe
Method energy of a given geometry of the atoms in a
model which is the value of the PES at that
semi- extended Chem3D, point.
Administrator

empirical Hckel MOPAC, Gaussian Geometry optimizationA systematic


MOPAC, Gaussian modification of the atomic coordinates of a
other semi-
model resulting in a geometry where the forces
empirical
on each atom in the structure is zero. A
methods
3-dimensional arrangement of atoms in the
(AM1,
model representing a local energy minimum (a
MINDO/3,
stable molecular geometry to be found without
PM3, etc.)
crossing a conformational energy barrier).
Property calculationPredicts certain phys-
Ab initio RHF, UHF, Gaussian,
ical and chemical properties, such as charge,
MP2, etc. GAMESS
dipole moment, and heat of formation.
Molecular mechanical methods: MM2 Computational methods can perform more
(directly). MM3 and MM3-protein through the specialized functions, such as conformational
Chem3D Tinker interface. searches and molecular dynamics simulations.

Semiempirical Extended Hckel, MINDO/3, Choosing the Best Method


MNDO, MNDO-d, AM1 and PM3 methods
Not all types of calculations are possible for all
through Chem3D and CS MOPAC or Gaus-
methods and no one method is best for all
sian. purposes. For any given application, each method
Ab initio methods through the Chem3D Gaus- poses advantages and disadvantages. The choice of
sian or GAMESS interface. method depend on a number of factors, including:
The nature and size of the molecule
Uses of Computational The type of information sought
Methods The availability of applicable experimentally
determined parameters (as required by some
Computational methods calculate the potential methods)
energy surfaces (PES) of molecules. The potential Computer resources
energy surface is the embodiment of the forces of The three most important of the these criteria are:
interaction among atoms in a molecule. From the Model sizeThe size of a model can be a
PES, structural and chemical information about a limiting factor for a particular method. The
molecule can be derived. The methods differ in the limiting number of atoms in a molecule
way the surface is calculated and in the molecular increases by approximately one order of
properties derived from the energy surface. magnitude between method classes from ab
initio to molecular mechanics. Ab initio is limited
The methods perform the following basic types of to tens of atoms, semiempirical to hundreds,
calculations: and molecular mechanics to thousands.

270 Computation Concepts CambridgeSoft


Computational Methods Overview
Parameter AvailabilitySome methods Single point energy calculations for comparing
depend on experimentally determined parame- conformations of the same molecule.
ters to perform computations. If the model Searching conformational space by varying one
contains atoms for which the parameters of a or two dihedral angles.
particular method have not been derived, that
Studying molecular motion using Molecular
method may produce invalid predictions.
Dynamics.
Molecular mechanics, for example, relies on
parameters to define a force-field. A force-field Quantum Mechanical Methods Applica-
is only applicable to the limited class of mole-
tions Summary
cules for which it is parametrized.
Useful information determined by quantum
Computer resourcesRequirements
mechanical methods includes:
increase relative to the size of the model for
each of the methods. Molecular orbital energies and coefficients.
Ab initio: The time required for performing Heat of Formation for evaluating conforma-
computations increases on the order of N4, tional energies.
where N is the number of atoms in the model. Partial atomic charges calculated from the
Semiempirical: The time required for molecular orbital coefficients.
computation increases as N3 or N2, where N is Electrostatic potential.
the number of atoms in the model. Dipole moment.
MM2: The time required for performing Transition-state geometries and energies.
computations increases as N2, where N is the
Bond dissociation energies.
number of atoms.
Semiempirical methods available in Chem3D with
In general, molecular mechanical methods are
CS MOPAC or Gaussian apply to:
computationally less expensive than quantum
mechanical methods. The suitability of each Systems containing up to 120 heavy atoms and 300
general method for particular applications can total atoms.
be summarized as follows.
Organic, organometallics, and small oligomers
Molecular Mechanics Methods Applica- (peptide, nucleotide, saccharide).
tions Summary Gas phase or implicit solvent environment.
Molecular mechanics in Chem3D apply to: Ground, transition, and excited states.
Systems containing thousands of atoms. Ab initio methods available in Chem3D with
Organic, oligonucleotides, peptides, and Gaussian or Jaguar apply to:
saccharides. Systems containing up to 150 atoms.
Gas phase only (for MM2). Organic, organometallics, and molecular frag-
Useful techniques available using MM2 methods ments (catalytic components of an enzyme).
include: Gas or implicit solvent environment.
Energy Minimization for locating stable Study ground, transition, and excited states
conformations. (certain methods).

Chem & BioOffice 2006 /Chem3D Computation Concepts 271


Computational Methods Overview
Table 1: Comparison of Methods

Method Type Advantages Disadvantages Best For


Administrator

Molecular Mechanics Least intensive compu- Particular force field appli- Large systems
(Gaussian) tationallyfast and cable only for a limited (thousands of atoms)
useful with limited class of molecules
Uses classical physics computer resources Systems or processes with
Does not calculate elec- no breaking or forming of
Relies on force-field with Can be used for mole- tronic properties bonds
embedded empirical cules as large as
parameters enzymes Requires experimental
data (or data from ab initio)
for parameters

Semiempirical Less demanding Requires experimental Medium-sized systems


(MOPAC, Gaussian) computationally than data (or data from ab initio) (hundreds of atoms)
ab initio methods for parameters
Uses quantum physics Systems involving elec-
Capable of calculating Less rigorous than ab tronic transitions
Uses experimentally transition states and initio methods
derived empirical param- excited states
eters

Uses approximation
extensively

ab initio (Gaussian, Useful for a broad Computationally intensive Small systems


GAMESS) range of systems (tens of atoms)

Uses quantum physics Does not depend on Systems involving elec-


experimental data tronic transitions
Mathematically
rigorousno empirical Capable of calculating Molecules or systems
parameters transition states and without available experi-
excited states mental data
(new chemistry)

Systems requiring rigorous


accuracy

272 Computation Concepts CambridgeSoft


Computational Methods Overview
Potential Energy Surfaces The main areas of interest on a potential energy
surface are the extrema as indicated by the arrows,
A potential energy surface (PES) can describe:
are as follows:
A molecule or ensemble of molecules having
Global minimumThe most stable confor-
constant atom composition (ethane, for
mation appears at the extremum where the
example) or a system where a chemical reaction
energy is lowest. A molecule has only one
occurs.
global minimum.
Relative energies for conformations (eclipsed
Local minimaAdditional low energy
and staggered forms of ethane).
extrema. Minima are regions of the PES where
Potential energy surfaces can differentiate between: a change in geometry in any direction yields a
Molecules having slightly different atomic higher energy geometry.
composition (ethane and chloroethane). Saddle pointA stationary point between
Molecules with identical atomic composition two low energy extrema. A saddle point is
but different bonding patterns, such as propy- defined as a point on the potential energy
lene and cyclopropane surface for which the slope (first derivative) of
the surface is zero.
Excited states and ground states of the same
molecule. NOTE: At the energy minimum, the energy is not zero; the
first derivative (gradient) of the energy with respect to
Potential Energy Surfaces (PES) geometry is zero.
The true representation of a models potential
energy surface is a multi-dimensional surface whose All the minima on a potential energy surface of a
dimensionality increases with the number of atom molecule represent stable stationery points where
coordinates. Since each atom has three independent the forces on each atom sums to zero. The global
variables (x, y, z coordinates), visualizing a surface minimum represents the most stable conformation;
for a many-atom model is impossible. However, the local minima, less stable conformations; and the
you can generalize this problem by examining any 2 saddle points represent transition conformations
independent variables, such as the x and y between minima.
coordinates of an atom, as shown below.
Single Point Energy Calculations
Figure G-22: Potential energy surfaces
Single point energy calculations can be used to
calculate properties of specific geometry of a
model. The values of these properties depend on
where the model lies on the potential surface as
follows:
A single point energy calculation at a global
minimum provides information about the
Saddle Point
Potential Energy model in its most stable conformation.
Local Minimum A single point calculation at a local minimum
Global Minimum
provides information about the model in one
of many stable conformations.

Chem & BioOffice 2006 /Chem3D Computation Concepts 273


Computational Methods Overview
A single point calculation at a saddle point 3. The first or second derivative of the energy
provides information about the transition state (depending on the method) with respect to the
of the model. atomic coordinates determines how large and
in what direction the next increment of geom-
A single point energy calculation at any other
Administrator

etry change should be.


point on the potential energy surface provides
information about that particular geometry, 4. The change is made.
not a stable conformation or transition state. 5. Following the incremental change, the energy
and energy derivatives are again determined
Single point energy calculations can be performed and the process continues until convergence is
before or after optimizing geometry. achieved, at which point the minimization
process terminates.
NOTE: Do not compare values from different methods. The following illustration shows some concepts of
Different methods rely on different assumptions about a given minimization. For simplicity, this plot shows a
molecule, and the energies differ by an arbitrary offset. single independent variable plotted in two
dimensions.

Geometry Optimization
Geometry optimization is used to locate a stable
conformation of a model, and should be done
before performing additional computations or
analyses of a model.

Locating global and local energy minima is typically


done by energy minimization. Locating a saddle
point is optimizing to a transition state.

The ability of a geometry optimization to converge


to a minimum depends on the starting geometry, The starting geometry of the model determines
the potential energy function used, and the settings which minimum is reached. For example, starting at
for a minimum acceptable gradient between steps (b), minimization results in geometry (a), which is
(convergence criteria). the global minimum. Starting at (d) leads to
geometry (f), which is a local minimum.The
Geometry optimizations are iterative and begin at proximity to a minimum, but not a particular
some starting geometry as follows: minimum, can be controlled by specifying a
minimum gradient that should be reached.
1. The single point energy calculation is Geometry (f), rather than geometry (e), can be
performed on the starting geometry. reached by decreasing the value of the gradient
where the calculation ends.
2. The coordinates for some subset of atoms are
changed and another single point energy calcu- In theory, if a convergence criterion (energy
lation is performed to determine the energy of gradient) is too lax, a first-derivative minimization
that new conformation. can result in a geometry that is near a saddle point.

274 Computation Concepts CambridgeSoft


Computational Methods Overview
This occurs because the value of the energy Electron spin density
gradient near a saddle point, as near a minimum, is Hyperfine coupling constants
very small. For example, at point (c), the derivative
Atomic charges
of the energy is 0, and as far as the minimizer is
concerned, point (c) is a minimum. First derivative Polarizability
minimizers cannot, as a rule, cross saddle points to Others, such as IR vibrational frequencies
reach another minimum.
Molecular Mechanics
NOTE: If the saddle point is the extremum of interest, it is Theory in Brief
best to use a procedure that specifically locates a transition
state, such as the CS MOPAC Pro Optimize To Transition Molecular mechanics computes the energy of a
State command. molecule in terms of a set of classical potential
energy functions. The potential energy functions
You can take the following steps to ensure that a and the parameters used for their evaluation are
minimization has not resulted in a saddle point. known as a force-field.

The geometry can be altered slightly and Molecular mechanical methods are based on the
another minimization performed. The new following principles:
starting geometry might result in either (a), or Nuclei and electrons are lumped together and
(f) in a case where the original one led to (c). treated as unified particles (atoms).
The Dihedral Driver can be employed to Atoms are typically treated as spheres.
search the conformational space of the model.
Bonds are typically treated as springs.
For more information, see Tutorial 5:
Mapping Conformations with the Dihedral Non-bonded interactions between atoms are
Driver on page 62. described using potential functions derived
from classical mechanics.
A molecular dynamics simulation can be run,
which will allow small potential energy barriers Individual potential functions are used to
to be crossed. After completing the molecular describe the different interactions: bond
dynamics simulation, individual geometries can stretching, angle bending, torsion (bond
then be minimized and analyzed. For more twisting), and through-space (non-bonded)
information see Appendix H: MM2 interactions.
You can calculate the following properties with the Potential energy functions rely on empirically
computational methods available through Chem3D derived parameters (force constants, equilib-
using the PES: rium values) that describe the interactions
between sets of atoms.
Steric energy
The sum of the interactions determines the
Heat of formation conformation of the molecule.
Dipole moment Molecular mechanical energies have no meaning
Charge density as absolute quantities. They can only be used to
compare relative steric energy (strain) between
COSMO solvation in water two or more conformations of the same mole-
Electrostatic potential cule.

Chem & BioOffice 2006 /Chem3D Computation Concepts 275


Molecular Mechanics Theory in Brief
The Force-Field The following illustration shows the major
interactions.
Since molecular mechanics treats bonds as springs,
Figure G-23Potential Energy Interactions
the mathematics of spring deformation (Hookes
Administrator

Law) is used to describe the ability of bonds to


stretch, bend, and twist. Non-bonded atoms
(greater than two bonds apart) interact through van
der Waals attraction, steric repulsion, and
electrostatic attraction and repulsion. These
properties are easiest to describe mathematically
when atoms are considered as spheres of
characteristic radii.
The total potential energy, E, of a molecule can be
described by the following summation of
interactions: Different kinds of force-fields have been
developed. Some include additional energy terms
E= Stretching Energy + Bending Energy + that describe other kinds of deformations, such as
Torsion Energy + Non-bonded Interaction the coupling between bending and stretching in
Energy adjacent bonds, in order to improve the accuracy of
the mechanical model.
The first three terms are the so-called bonded
interactions. In general, these bonded interactions The reliability of a molecular mechanical force-field
can be viewed as a strain energy imposed by a depends on the parameters and the potential energy
model moving from some ideal zero strain functions used to describe the total energy of a
conformation. The last term, which represents the model. Parameters must be optimized for a
non-bonded interactions, includes the two particular set of potential energy functions, and
interactions shown below. thus are not transferable to other force fields.
The total potential energy can be described by the
MM2
following relationships between atoms. The
numbers refer to the atom positions in Figure G-23. Chem3D uses a modified version of Allingers
MM2 force field. For additional MM2 references
1. Bond Stretching: (1-2) bond stretching
see Appendix H: MM2
between directly bonded atoms
2. Angle Bending: (1-3) angle bending between
The principal additions to Allingers MM2 force
two atoms that are adjacent to a third atom. field are:

3. Torsion Energy: (1-4) torsional angle rotation A charge-dipole interaction term


between atoms that form a dihedral angle. A quartic stretching term
4. Repulsion for atoms that are too close and Cutoffs for electrostatic and van der Waals
attraction at long range from dispersion forces terms with 5th order polynomial switching
(van der Waals interaction). function
5. Interactions from charges, dipoles, quadru- Automatic pi system calculations when neces-
poles (electrostatic interactions). sary

276 Computation Concepts CambridgeSoft


Molecular Mechanics Theory in Brief
Torsional and non-bonded constraints. This simple parabolic model fails when bonds are
stretched toward the point of dissociation. The
Chem3D stores the parameters for the potential
Morse function would be the best correction for
energy function in tables. These tables may be
this problem. However, the Morse Function leads
viewed and edited from the Parameter Tables option
to a large increase in computation time. As an
of the View menu.
alternative, cubic stretch and quartic stretch
Each parameter is classified by a Quality number. constants are added to provide a result approaching
This number indicates the reliability of the data. a Morse-function correction.
The quality ranges from 4, where the data is derived
completely from experimental data (or ab initio The cubic stretch term allows for an asymmetric
data), to 1, where the data is guessed by Chem3D. shape of the potential well, allowing these long
bonds to be handled. However, the cubic stretch
The parameter table, MM2 Constants, contains term is not sufficient to handle abnormally long
adjustable parameters that correct for failings of the bonds. A quartic stretch term is used to correct
potential functions in outlying situations. problems caused by these very long bonds. With the
addition of the cubic and quartic stretch term, the
equation for bond stretching becomes:
NOTE: Editing of MM2 parameters should only be done
with the greatest of caution by expert users. Within a force-
field equation, parameters operate interdependently; changing E
S=
t7
r1
e
.
tK
c[
9
h
(
r
4
o
2
)+
r
C(
r
r
)
S
o
B
3
+Q
on

(r
r
)
o
s
ds
4
]
S
one normally requires that others be changed to compensate
for its effects.
Both the cubic and quartic stretch constants are
Bond Stretching Energy defined in the MM2 Constants table.

To precisely reproduce the energies obtained with


.
2
E =
Stre 7
1
tch 9K
4(
rr
o) s Allingers force field: set the cubic and quartic
Bonds
stretching constant to 0 in the MM2 Constants
tables.
The bond stretching energy equation is based on
Hooke's law. The Ks parameter controls the
stiffness of the springs stretching (bond stretching Angle Bending Energy
force constant), while ro defines its equilibrium
length (the standard measurement used in building E=
Be0.
021
nd 9
K(
1

4
b o
2
)18
models). Unique Ks and ro parameters are assigned Angles

to each pair of bonded atoms based on their atom The bending energy equation is also based on
types (C-C, C-H, O-C). The parameters are stored Hookes law. The Kb parameter controls the
in the Bond Stretching parameter table. The
stiffness of the springs bending (angular force
constant, 71.94, is a conversion factor to obtain the
constant), while 0 defines the equilibrium angle.
final units as kcal/mole.
This equation estimates the energy associated with
The result of this equation is the energy deformation about the equilibrium bond angle. The
contribution associated with the deformation of the constant, 0.02191418, is a conversion factor to
bond from its equilibrium bond length. obtain the final units as kcal/mole.

Chem & BioOffice 2006 /Chem3D Computation Concepts 277


Molecular Mechanics Theory in Brief
Unique parameters for angle bending are assigned There are three additional angle bending force
to each bonded triplet of atoms based on their atom constants available in the MM2 Constants table.
types (C-C-C, C-O-C, C-C-H). For each triplet of These are the -CHR-Bending constants,
atoms, the equilibrium angle differs depending on specifically for carbons with one or two attached
Administrator

what other atoms the central atom is bonded to. For hydrogens.
each angle there are three possibilities: XR2, XRH
or XH2. For example, the XH2 parameter would be The -CHR- Bending Kb for 1-1-1 angles1 allows
used for a C-C-C angle in propane, because the more accurate force constants to be specified for
other atoms the central atom is bonded to are both Type 1 (-CHR-) and Type 2 (-CHR-) interactions.
hydrogens. For isobutane, the XRH parameter
The -CHR-Bending Kb for 1-1-1 angles in
would be used, and for 2,2-dimethylpropane, the
XR2 parameter would be used. 4-membered rings and the -CHR- Bending Kb for
22-22-22 angles in 3-membered rings require
The effect of the Kb and 0 parameters is to separate constants for accurate specification.
broaden or steepen the slope of the parabola. The
larger the value of Kb, the more energy is required Torsion Energy
to deform an angle from its equilibrium value.
Shallow potentials are achieved with Kb values less =
Tw
ist [
n
1+
co

s]
)
(n
2
V
Torsions
than 1.0.
This term accounts for the tendency for dihedral
A sextic term is added to increase the energy of angles (torsionals) to have an energy minimum
angles with large deformations from their ideal occurring at specific intervals of 360/n. In
value. The sextic bending constant, SF, is defined in Chem3D, n can equal 1, 2, or 3.
the MM2 Constants table. With the addition of the
sextic term, the equation for angle bending
T=
w
V
(
1
1
is
2
+
tc)
+
o
V
(
2

2
+
1
sc2
V
)
+
o(
3
1
2
+
sc
3)
o s
becomes: Torsion s
The Vn/2 parameter is the torsional force constant. It determines the amplitude of the curve. The n signifies its periodicity. n shifts the entire curve about the rotation angle axis. The parameters are determined through curve-fitting techniques. Unique parameters for
torsional rotation are assigned to each bonded quartet of atoms based on their atom types (C-C-C-C, C-O-C-N, H-C-C-H).

E
B=
0
e.
0
nd
21
K[
(
9)
o+1
(
S
4
F)
o]18
A
b
ngles

2 6 Chem3D provides three torsional parameters
tables:
Torsional parameters
NOTE: The default value of the sextic force constant 4-Membered ring torsions
is 0.00000007. To precisely reproduce the energies 3-Membered ring torsions.
obtained with Allingers force field, set the sextic
bending constant to 0 in the MM2 Constants tables. Non-Bonded Energy
The non-bonded energy represents the pairwise
There are three parameter tables for the angle
sum of the energies of all possible interacting
bending parameters:
non-bonded atoms within a predetermined
cut-off distance.
Angle Bending parameters 1. The numbers in the angle definitions
3-Membered Ring Angle Bending parameters refer to the Text column in the Atom
Types Table. 1 refers to C-alkane, and
4-Membered Ring Angle Bending parameters 22 refers to C-cyclopropane.

278 Computation Concepts CambridgeSoft


Molecular Mechanics Theory in Brief
The non-bonded energy accounts for repulsive For certain interactions, values in the VDW
forces experienced between atoms at close interactions parameter table are used instead of
distances, and for the attractive forces felt at longer those in the MM2 atom types table. These
distances. It also accounts for their rapid falloff as situations include interactions where one of the
the interacting atoms move farther apart by a few atoms is very electronegative relative to the other,
Angstroms. such as in the case of a water molecule.

van der Waals Energy Cutoff Parameters for van der Waals
Repulsive forces dominate when the distance Interactions
between interacting atoms becomes less than the The use of cutoff distances for van der Waals terms
sum of their contact radii. In Chem3D repulsion is greatly improves the computational speed for large
modeled by an equation which combines an molecules by eliminating long range, relatively
exponential repulsion with an attractive dispersion insignificant, interactions from the computation.
interaction (1/R6):
Chem3D uses a fifth-order polynomial switching
function so that the resulting force field maintains
Evan der W=
aals (290000
e12.5/R
-2.2R-6
5 ) second-order continuity. The cutoff is implemented
i j gradually, beginning at 90% of the specified cutoff
where distance. This distance is set in the MM2 Constants
rij table.
R= * *
Ri +R j
The van der Waals interactions fall off as 1/r6, and
The parameters include: can be cut off at much shorter distances, for
example 10. This cut off speeds the computations
Ri* and Rj*the van der Waals radii for the significantly, even for relatively small molecules.
atoms
Epsilon ()determines the depth of the NOTE: To precisely reproduce the energies obtained with
attractive potential energy well and how easy it Allingers force field: set the van der Waals cutoff constants
is to push atoms together to large values in the MM2 Constants table.
rijwhich is the actual distance between the
atoms Electrostatic Energy
At short distances the above equation favors
repulsive over dispersive interactions. To q
iq

j
E =
Electrostatic
compensate for this at short distances (R=3.311) i j D r
ij
this term is replaced with:
The electrostatic energy is a function of the charge
on the non-bonded atoms, q, their interatomic
E =
van d3
er.
3
1W

7
6
a6
aR
ls -2
distance, rij, and a molecular dielectric expression,
i j
D, that accounts for the attenuation of electrostatic
The R* and Epsilon parameters are stored in the interaction by the environment (solvent or the
MM2 Atom Types table. molecule itself).

Chem & BioOffice 2006 /Chem3D Computation Concepts 279


Molecular Mechanics Theory in Brief
In Chem3D, the electrostatic energy is modeled Bond dipole parameters, , for each atom pair are
using atomic charges for charged molecules and stored in the bond stretching parameter table. The
bond dipoles for neutral molecules. charge, q, is stored in the atom types table. The
molecular dielectric expression is set to a constant
There are three possible interactions accounted for
Administrator

by Chem3D: value between 1.0 and 5.0 in the MM2 Atom types
table.
charge/charge
dipole/dipole NOTE: Chem3D does not use a distance-dependent
dipole/charge. dielectric.

Each type of interaction uses a different form of the


electrostatic equation as shown below: Cutoff Parameters for Electrostatic Inter-
actions
charge/charge contribution
The use of cutoff distances for electrostatic terms,
iq
q as for van der Waals terms, greatly improves the

j
E=
332
.0538 2 computational speed for large molecules by
i j Dr
qij
eliminating long-range interactions from the
where the value 332.05382 converts the result to computation.
units of kcal/mole.
As in the van der Waals calculations, Chem3D uses
dipole/dipole contribution a fifth-order polynomial switching function to
maintain second-order continuity in the force-field.

The switching function is invoked as minimum
=
E
14
.338(
c8
o
3c
so
ics
o)
j s
ij
values for charge/charge, charge/dipole, or
i jD
r

ij
dipole/dipole interactions are reached. These
where the value 14.388 converts the result from cutoff values are located in the MM2 Constants
ergs/mole to kcal/mole, is the angle between the parameter table.
two dipoles i and j, i and j are the angles the
dipoles form with the vector, rij, connecting the two Since the charge-charge interaction energy between
at their midpoints, and D is the (effective) two point charges separated by a distance r is
proportional to 1/r, the charge-charge cutoff must
dielectric constant.
be rather large, typically 30 to 40, depending on
the size of the molecule. The charge-dipole, dipole-
dipole/charge contribution
dipole interactions fall off as 1/r2, 1/r3 and can be
q cutoff at much shorter distances, for example 25
=
E6
91
. 202
i j
(
coj)
s and 18 respectively. To precisely reproduce the
i j ij D
r Dq
energies obtained with Allingers force field: set the
where the value 69.120 converts the result to units cutoff constants to large values (99, for example) in
of kcal/mole. the MM2 Constants table.

280 Computation Concepts CambridgeSoft


Molecular Mechanics Theory in Brief
OOP Bending computation yields bond orders which are used to scale the
bond stretching force constants, standard bond lengths and
Atoms that are arranged in a trigonal planar twofold torsional barriers.
fashion, as in sp2 hybridization, require an
additional term to account for out-of-plane (OOP)
The following is a step-wise overview of the
bending. MM2 uses the following equation to
process:
describe OOP bending:
1. A Fock matrix is generated based on the


favorability of electron sharing between pairs
( )
2 6

= K
[
b
o +
S(
F
o)] of atoms in a pi system.
O
oP
uft
lane

2. The pi molecular orbitals are computed from


The form of the equation is the same as for angle the Fock matrix.
bending, however, the value used is angle of
3. The pi molecular orbitals are used to compute
deviation from coplanarity for an atom pair and
a new Fock matrix, then this new Fock matrix
is set to zero. The illustration below shows the is used to compute better pi molecular orbitals.
determined for atom pairs DB.
Step 2 and 3 are repeated until the computation
Figure G-24: Determination of of the Fock matrix and the pi molecular orbitals
D converge. This method is called the self-
consistent field technique or a pi-SCF
x
C calculation.
A

y 4. A pi bond order is computed from the pi
B molecular orbitals.
The special force constants for each atom pair are 5. The pi bond order is used to modify the bond
located in the Out of Plane bending parameters length(BLres) and force constant (Ksres) for
table. The sextic correction is used as previously each bond in the pi system.
described for Angle Bending. The sextic constant, 6. The modified values of Ksres and BLres are
SF, is located in the MM2 Constants table. used in the molecular mechanics portion of the
MM2 computation to further refine the mole-
Pi Bonds and Atoms with Pi Bonds cule.
For models containing pi systems, MM2 performs a
Pariser-Parr-Pople pi orbital SCF computation for Stretch-Bend Cross Terms
each system. A pi system is defined as a sequence of Stretch-bend cross terms are used when a coupling
three or more atoms of types which appear in the occurs between bond stretching and angle bending.
Conjugate Pi system Atoms table. Because of this For example, when an angle is compressed, the
computation, MM2 may calculate bond orders MM2 force field uses the stretch-bend force
other than 1, 1.5, 2, and so on. constants to lengthen the bonds from the central
atom in the angle to the other two atoms in the
NOTE: The method used is that of D.H. Lo and M.A. angle.
Whitehead, Can. J. Chem., 46, 2027(1968), with
1
heterocycle parameter according to G.D. Zeiss and M.A. =
K(
r
sbr
o)
(
)
o
Whitehead, J. Chem. Soc. (A), 1727 (1971). The SCF Stre
/B 2
tc
enhd

Chem & BioOffice 2006 /Chem3D Computation Concepts 281


Molecular Mechanics Theory in Brief
The force constant (Ksb) differs for different atom Molecular Dynamics Simula-
combinations. tion
The seven different atom combinations where Molecular dynamics simulates molecular motion.
Administrator

force constants are available for describing the This simulation is useful because motion is inherent
situation follow: to all chemical processes: vibrations, like bond
X-B, C, N, O-Y stretching and angle bending, give rise to IR spectra;
chemical reactions, hormone-receptor binding, and
B-B, C, N, O-H other complex processes are associated with many
kinds of intramolecular and intermolecular
X-Al, S-Y motions.
X-Al, S-H
The MM2 method of molecular dynamics
X-Si, P-Y simulation uses Newtons equations of motion to
simulate the movement of atoms.
X-Si, P-H
Conformational transitions and local vibrations are
X-Ga, Ge, As, Se-Y, P-Y the usual subjects of molecular dynamics studies.
where X and Y are any non-hydrogen atom. Molecular dynamics alters the values of the
intramolecular degrees of freedom in a stepwise
fashion. The steps in a molecular dynamics
User-Imposed Constraints simulation represent the changes in atom position
Additional terms are included in the force field over time, for a given amount of kinetic energy.
when constraints are applied to torsional angles and The Molecular Dynamics (MM2) command in the
non-bonded distances by the Optimal field in the Calculations menu can be used to compute a
Measurements table. These terms use a harmonic molecular dynamics trajectory for a molecule or
potential function, where the force constant has fragment in Chem3D. A common use of molecular
been set to a large value (4 for torsional constraints dynamics is to explore the conformational space
and 106 for non-bonded distances) in order to accessible to a molecule, and to prepare sequences
enforce the constraint. of frames representing a molecule in motion. For
more information on Molecular Dynamics see
For torsional constraints the additional term and Chapter 8, MM2 and MM3 Computations on
force constant is described by: page 157.

Molecular Dynamics Formulas


=
4
(
o)
2

Torsions
The molecular dynamics computation consists of a
For non-bonded distance constraints the additional series of steps that occur at a fixed interval, typically
term and force constant is: about 2.0 fs (femtoseconds, 1.0 x 10-15 seconds). The
Beeman algorithm for integrating the equations of
motion, with improved coefficients (B. R. Brooks)
=
16
0
(rr
o)2
is used to compute new positions and velocities of
Distance
each atom at each step.

282 Computation Concepts CambridgeSoft


Molecular Mechanics Theory in Brief
Each atom (i) is moved according to the following Further approximations are made to the RHF
formula: method when an open shell system is presented.
This approximation has been termed the 1/2
xi = xi + vit + (5ai ai old) (t)2/8
electron approximation by Dewar. In this method,
Similarly, each atom is moved for y and z, where xi, unpaired electrons are treated as two 1/2 electrons
yi, and zi are the Cartesian coordinates of the atom, of equal charge and opposite spin. This allows the
vi is the velocity, ai is the acceleration, aiold is the computation to be performed as a closed shell. A
acceleration in the previous step, and t is the time CI calculation is automatically invoked to correct
between the current step and the previous step. The errors in energy values inherent to the 1/2 electron
potential energy and derivatives of potential energy approximation. For more information see
(gi) are then computed with respect to the new Configuration Interaction on page 283.
Cartesian coordinates. With the addition of the 1/2 electron
New accelerations and velocities are computed at approximation, RHF methods can be run on any
each step according to the following formulas (mi is starting configuration.
the mass of the atom):
UHF
aiveryold = aiold
The UHF method treats alpha (spin up) and beta
aiold = ai (spin down) electrons separately, allowing them to
occupy different molecular orbitals and thus have
ai = gi / mi different orbital energies. For many open and
vi = vi + (3ai + 6aiold aiveryold) t / 8 closed shell systems, this treatment of electrons
results in better estimates of the energy in systems
where energy levels are closely spaced, and where
Methods Available in CS bond breaking is occurring.
MOPAC
UHF can be run on both open and closed shell
CS MOPAC methods include both open shell and systems. The major caveat to this method is the
closed shell Hartree-Fock approximations. time involved. Since alpha and beta electrons are
Configuration interaction may be estimated by treated separately, twice as many integrals need to
either iterative self-consistent field (SCF) or multi- be solved. As your models get large, the time for the
electron (MECI) methods. For semi-empirical computation may make it a less satisfactory
methods, you may choose between five method.
Hamiltonian approximations.
Configuration Interaction
RHF
The effects of electron-electron repulsion are
The default Hartree-Fock method assumes that the underestimated by SCF-RHF methods, which
molecule is a closed shell and imposes spin results in the overestimation of energies.
restrictions. The spin restrictions allow the Fock
matrix to be simplified. Since alpha (spin up) and SCF-RHF calculations use a single determinant that
beta (spin down) electrons are always paired, the includes only the electron configuration that
basic RHF method is restricted to even electron describes the occupied orbitals for most molecules
closed shell systems. in their ground state. Further, each electron is

Chem & BioOffice 2006 /Chem3D Computation Concepts 283


Molecular Mechanics Theory in Brief
assumed to exist in the average field created by all The approximations in semiempirical MOPAC
other electrons in the system, which tends to methods play a role in the following areas of the
overestimate the repulsion between electrons. Fock operator:
Repulsive interactions can be minimized by
The basis set used in constructing the 1-elec-
Administrator

allowing the electrons to exist in more places (i.e.


tron atom orbitals is a minimum basis set of
more orbitals, specifically termed virtual orbitals).
only the s and p Slater Type Orbitals (STOs)
The multi-electron configuration interaction
for valence electrons.
(MECI) method in MOPAC addresses this problem
by allowing multiple sets of electron assignments The core electrons are not explicitly treated.
(i.e., configurations) to be used in constructing the Instead they are added to the nucleus. The
molecular wave functions. Molecular wave nuclear charge is termed Neffective.
functions representing different configurations are For example, Carbon as a nuclear charge of +6-
combined in a manner analogous to the LCAO 2 core electrons for a effective nuclear charge
approach. of +4.
For a particular molecule, configuration interaction Many of the 2-electron Coulomb and
uses these occupied orbitals as a reference electron Exchange integrals are parameterized based on
configuration then promotes the electrons to element.
unoccupied (virtual) orbitals. These new states,
Slater determinants or microstates in MOPAC, are Choosing a Hamiltonian
then linearly combined with the ground state Overall, these potential energy functions may be
configuration. The linear combination of viewed as a chronological progression of
microstates yields an improved electronic improvements from the oldest method, MINDO/3
configuration and hence a better representation of to the newest method, PM3. However, although the
the molecule. improvements in each method were designed to
make global improvements, they have been found
Approximate Hamilto- to be limited in certain situations.
nians in MOPAC The two major questions to consider when
choosing a potential function are:
There are five approximation methods available in
MOPAC: Is the method parameterized for the elements
in the model?
MINDO/3
Does the approximation have limitations
MNDO which render it inappropriate for the model
being studied?
AM1
For more detailed information see the MOPAC
PM3 online manual.
Ultra MNDO-d MINDO/3 Applicability and Limitations
The potential energy functions modify the HF MINDO/3 (Modified Intermediate Neglect of
equations by approximating and parameterizing Diatomic Overlap revision 3) is the oldest method.
aspects of the Fock matrix. Using diatomic pairs, it is an INDO (Intermediate

284 Computation Concepts CambridgeSoft


Approximate Hamiltonians in MOPAC
Neglect of Diatomic Orbitals) method, where the Sterically crowded molecules are too unstable,
degree of approximation is more severe than the for example, neopentane.
NDDO methods MNDO, PM3 and AM1. This Four-membered rings are too stable, for
method is generally regarded to be of historical example, cubane.
interest only, although some sulfur compounds are
still more accurately analyzed using this method. Hydrogen bonds are virtually non-existent, for
example, water dimer. Overly repulsive
The following table shows the diatomic pairs that nonbonding interactions between hydrogens
are parameterized in MINDO/3. An x indicates and other atoms are predicted. In particular,
parameter availability for the pair indicated by the simple H-bonds are generally not predicted to
row and column. Parameters of dubious quality are exist using MNDO.
indicated by (x).
Hypervalent compounds are too unstable, for
example, sulfuric acid.
Activation barriers are generally too high.
Non-classical structures are predicted to be
unstable relative to the classical structure, for
example, ethyl radical.
Oxygenated substituents on aromatic rings are
out-of-plane, for example, nitrobenzene.

The peroxide bond is systematically too short


by about 0.17 .

The C-O-C angle in ethers is too large.

AM1 Applicability and Limitations


AM1 may be applied to the shaded elements in the
table below:
MNDO Applicability and Limitations
MNDO may be applied to the shaded elements in
the table below:

Important factors relevant to AM1 are:


AM1 is similar to MNDO; however, there are
changes in the core-core repulsion terms and
The following limitations apply to MNDO: reparameterization.

Chem & BioOffice 2006 /Chem3D Computation Concepts 285


Approximate Hamiltonians in MOPAC
AM1 is a distinct improvement over MNDO, PM3 Applicability and Limitations
in that the overall accuracy is considerably
PM3 (Parameterized Model revision 3) may be
improved. Specific improvements are:
applied to the shaded elements in the following
The strength of the hydrogen bond in the table:
Administrator

water dimer is 5.5 kcal/mol, in accordance


with experiment.
Activation barriers for reaction are markedly
better than those of MNDO.
Hypervalent phosphorus compounds are
considerably improved relative to MNDO.
In general, errors in Hf obtained using
AM1 are about 40% less than those given by
MNDO. The following apply to PM3:
AM1 phosphorus has a spurious and very
PM3 is a reparameterization of AM1.
sharp potential barrier at 3.0. The effect of
this is to distort otherwise symmetric PM3 is a distinct improvement over AM1.
geometries and to introduce spurious Hypervalent compounds are predicted with
activation barriers. A good example is given considerably improved accuracy.
by P4O6, in which the nominally equivalent Overall errors in Hf are reduced by about
P-P bonds are predicted by AM1 to differ by
40% relative to AM1.
0.4. This is by far the most severe
limitation of AM1. Little information exists regarding the limita-
tions of PM3. This should be corrected natu-
Alkyl groups have a systematic error due to rally as results of PM3 calculations are
the heat of formation of the CH2 fragment reported.
being too negative by about 2 kcal/mol.
The barrier to rotation in formamide is practi-
Nitro compounds, although considerably cally non-existent. In part, this can be
improved, are still systematically too positive corrected by the use of the MMOK option.
in energy. The MMOK option is used by default in CS
The peroxide bond is still systematically too MOPAC. For more information about MMOK
short by about 0.17. see the online MOPAC Manual.

286 Computation Concepts CambridgeSoft


Approximate Hamiltonians in MOPAC
the table below. Results obtained from MNDO-d
Ultra MNDO-d Applicability and Limi-
are generally superior to those obtained from
tations MNDO. The MNDO method should be used
MNDO-d (Modified Neglect of Differential where it is necessary to compare or repeat
Overlap with d-Orbitals) may be applied to the calculations previously performed using MNDO.
shaded elements in the table below:
The following types of calculations, as indicated by
MOPAC keywords, are incompatible with
MNDO-d:

COSMO (Conductor-like Screening Model)


solvation

POLAR (polarizability calculation)

GREENF (Greens Function)


MNDO-d is a reformulation of MNDO with an
extended basis set to include d-orbitals. This TOM (Miertus-Scirocco-Tomasi self-consis-
method may be applied to the elements shaded in tent reaction field model for solvation)

Chem & BioOffice 2006 /Chem3D Computation Concepts 287


Approximate Hamiltonians in MOPAC
Administrator

288 Computation Concepts CambridgeSoft


Approximate Hamiltonians in MOPAC
Appendix H: MM2
Overview Algorithm for Parameterization of the MM2/MM3
Force Fields, Journal of Computational Chemistry,
This appendix contains miscellaneous information Vol 12, No. 7, 844-849 (1991).
about the MM2 parameters and force field.
Other Parameters
MM2 Parameters The rest of the parameters consist of atom types
and elements in the periodic table which were not
The original MM2 parameters include the elements included in the original MM2 force field, such as
commonly used in organic compounds: carbon, metals. The rectification type of all the non-MM2
hydrogen, nitrogen, oxygen, sulfur and halogens. atom types in the Chem3D Parameter tables is
The atom type numbers for these atom types range Hydrogen (H). The atom type numbers for these
from 1 to 50. atom types range from 111 to 851. The atom type
number for each of the non-MM2 atom types in the
The MM2 parameters were derived from three MM2 Atom Type Parameters table is based on the
sources: atomic number of the element and the number of
ligands in the geometry for that atom type. To
1. Most of the parameters were provided by determine an atom type number, the atomic
Dr. N. L. Allinger. number is multiplied by ten, and the number of
ligands is added.
2. Several additional parameters were provided by
Dr. Jay Ponder, author of the TINKER For example, Co Octahedral has an atomic number
program. of 27 and six ligands. Therefore the atom type
number is 276.
3. Some commonly used parameters that were
not provided by Dr. Allinger or Dr. Ponder are In a case where different atom types of the same
provided by CambridgeSoft Corporation. element have the same number of ligands (Iridium
However, most of these parameters are esti- Tetrahedral, Atom Type # 774 and Iridium Square
mates which are extrapolated from other Planar, Atom Type # 779), the number nine is used
parameters. for the second geometry.

The best source of information on the MM2 Viewing Parameters


parameter set is Molecular Mechanics, Burkert, Ulrich
and Allinger, Norman L., ACS Monograph 177, To view the parameters used by Chem3D to
American Chemical Society, Washington, DC, 1982. perform MM2 computations:
From the View menu, point to Parameter
A method for developing reasonable guesses for
Tables, and choose a table.
parameters for non-MM2 atom types can be found
in Development of an Internal Searching The table you chose opens in a window.

Chem & BioOffice 2006 /Chem3DI MM2 289


Viewing Parameters
Editing Parameters For a review of MM2 and applications of molecular
mechanics methods in general, see Molecular
You can edit the parameters that come with Mechanics, by U. Burkert and N. L. Allinger, ACS,
Chem3D. Parameters that you add or change can be Washington, D.C., USA, 1982. Computational
Administrator

guesses or approximations that you make, or values Chemistry, by T. Clark, Wiley, N.Y., USA, 1985, also
obtained from current literature. contains an excellent description of molecular
mechanics.
In addition, there are several adjustable parameters
available in the MM2 Constants table. For a description of the TINKER system and the
detailed rationale for Ponders additions to the
MM2 force field, visit the TINKER home page at
NOTE: Before performing any editing we strongly http://dasher.wustl.edu/tinker.
recommend that you create back-up copies of all the
parameter files located in the C3DTable directory. For a description and review of molecular
dynamics, see Dynamics of Proteins and Nucleic Acids, J.
Andrew McCammon and Stephen Harvey,
To add a new parameter to the Torsional Cambridge University Press, Cambridge, UK, 1987.
parameters table: Despite its focus on biopolymers, this book
contains a cogent description of molecular
1. From the View menu, point to Parameter
dynamics and related methods, as well as
Tables and choose Torsional Parameters.
information applicable to other molecules.
The Torsional Parameters table opens in a
window. Chem3D Changes to
2. Enter the appropriate data in each field of the Allingers Force Field
parameter table. Be sure that the name for the
parameter is not duplicated elsewhere in the The Chem3D implementation of the Allinger Force
table. Field differs in these areas:
3. Close and Save the table. 1. A charge-dipole interaction term
2. A quartic stretching term
The MM2 Force Field in 3. Cutoffs for electrostatic and van der Waals
Chem3D terms with a fifth-order polynomial switching
function
Chem3D includes a new implementation of 4. Automatic pi system calculation when neces-
Norman L. Allingers MM2 force field based in sary
large measure on work done by Jay W. Ponder of
Washington University. This appendix does not Charge-Dipole Interaction
attempt to completely describe the MM2 force
field, but discusses the way in which the MM2 force
Term
field is implemented and used in Chem3D and the Allingers potential function includes one of two
differences between this implementation, Allingers possible electrostatic terms: one based on bond
MM2 program (QCPE 395), and Ponders dipoles, or one based on partial atomic charges. The
TINKER system (M.J. Dudek and J.W. Ponder, J. addition of a charge-dipole interaction term allows
Comput. Chem., 16, 791-816 (1995)). for a combined approach, where partial charges are

290 MM2 CambridgeSoft


The MM2 Force Field in Chem3D
represented as bond dipoles, and charged groups, Because the charge-charge interaction energy
such as ammonium or phosphate, are treated as between two point charges separated by a distance
point charges. r is proportional to 1/r, the charge-charge cutoff
must be rather large, typically 30 or 40. The
Quartic Stretching Term charge-dipole, dipole-dipole, and van der Waals
energies, which fall off as 1/r2, 1/r3, and 1/r6,
With the addition of a quartic bond stretching term, respectively, can be cut off at much shorter
troublesome negative bond stretching energies distances, for example, 25, 18, and 10,
which appear when long bonds are treated by respectively. Fortunately, since the van der Waals
Allingers force field are eliminated. interactions are by far the most numerous, this
cutoff speeds the computation significantly, even
The quartic bond stretching term is required for relatively small molecules.
primarily for molecular dynamics; it has little or no
effect on low energy conformations.
Pi Orbital SCF Computation
To precisely reproduce energies obtained with
Allingers force field: Chem3D determines whether the model contains
any pi systems, and performs a Pariser-Parr-Pople
Set the quartic stretching constant in the MM2 pi orbital SCF computation for each system. A pi
Constants table window to zero. system is defined as a sequence of three or more
The quartic term is eliminated. atoms of types which appear in the Pi Atoms table
window (PIATOMS.xml).
Electrostatic and van der The method used is that of D.H. Lo and M.A.
Waals Cutoff Terms Whitehead, Can. J. Chem., 46, 2027 (1968), with
heterocycle parameters according to G.D. Zeiss and
The cutoffs for electrostatic and van der Waals M.A. Whitehead, J. Chem. Soc. (A), 1727 (1971). The
terms greatly improve the computation speed for SCF computation yields bond orders which are
large molecules by eliminating long range used to scale the bond stretching force constants,
interactions from the computation. standard bond lengths, and twofold torsional
To precisely reproduce energies obtained with barriers.
Allingers force field:
A step-wise overview of the process used to do pi
Set the cutoff distances to large values (greater system calculations is as follows:
than the diameter of the model).
5. A matrix called the Fock matrix is initialized to
Every interaction is then computed. represent the favorability of sharing electrons
The cutoff is implemented gradually, beginning at between pairs of atoms in a pi system.
50% of the specified cutoff distance for charge and 6. The pi molecular orbitals are computed from
charge-dipole interactions, 75% for dipole-dipole the Fock matrix.
interactions, and 90% for van der Waals
interactions. Chem3D uses a fifth-order polynomial 7. The pi molecular orbitals are used to compute
switching function so that the resulting force field is a new Fock matrix, then this new Fock matrix
second-order continuous. is used to compute better pi molecular orbitals.

Chem & BioOffice 2006 /Chem3DI MM2 291


Chem3D Changes to Allingers Force Field
8. step 6 and Step 7 are repeated until the compu- 11.The values of KSres and BLres are used in the
tation of Fock matrix and the pi molecular molecular mechanics portion of the MM2
orbitals converge. This method is called the computation to further refine the molecule.
self-consistent field technique or a pi-SCF
To examine the computed bond orders after an
Administrator

calculation. MM2 computation:


9. A pi bond order is computed from the pi 1. In the Pop-up Information control panel,
molecular orbitals. select Bond Order.
10.The pi bond order is used to modify the bond 2. Position the pointer over a bond.
length (BLres) and force constant (KSres) for The information box contains the newly computed
each sigma bond in the pi system. bond orders for any bonds that are in a pi system.

292 MM2 CambridgeSoft


Chem3D Changes to Allingers Force Field
Appendix I: MOPAC
Overview Potential Functions
The appendix contains miscellaneous information Parameters
about MOPAC.
MOPAC provides five potential energy functions:
You can find additional information about MOPAC MINDO/3, MNDO, PM3, AM1, and MNDO-d.
by visiting the MOPAC home page at: All are SCF (Self Consistent Field) methods. Each
http://www.cachesoftware.com/mopac/index.shtml
function represents an approximation in the
mathematics for solving the Electronic Schrdinger
MOPAC background equation for a molecule.
Potential energy functions
Historically, these approximations were made to
Adding parameters to MOPAC allow ab initio calculations to be within the reach of
MOPAC Keywords used in CS MOPAC available computer technology. Currently, ab initio
methods for small molecules are within the reach of
Electronic configuration (includes using
desktop computers. Larger molecules, however, are
MOPAC sparkles)
still more efficiently modeled on the desktop using
semi-empirical or molecular mechanics
methodologies.
MOPAC Background
To understand the place that the potential energy
MOPAC was created by Dr. James Stewart at the functions in MOPAC take in the semi-empirical
University of Texas in the 1980s. It implements arena, here is a brief chronology of the
semi-empirical methodologies for analyzing approximations that comprise the semi-empirical
molecular models. (MOPAC stands for Molecular methods. The first approximation was termed
Orbital PACkage.) Due to its complexity and CNDO for Complete Neglect of Differential
command line user interface, its use was limited Overlap. The next approximation was termed
until the mid 1990s. INDO for Intermediate Neglect of Differential
Since version 3.5 (1996), Chem3D has provided an Overlap, Next followed MINDO/3, which stands
for Modified Intermediate Neglect of Differential
easy-to-use GUI interface for MOPAC that makes
it accessible to the novice molecular modeller, as Overlap. Next was MNDO, which is short for
well as providing greater usability for the veteran Modified Neglect of Differential Overlap which
modeller. We are currently supporting MOPAC corrected MINDO/3 for various organic
2002. molecules made up from elements in rows 1 and 2
of the periodic table. AM1 improved upon MNDO
MOPAC 2002 is copyrighted by Fujitsu, Ltd.CS markedly. Finally the most recent, PM3 is a
MOPAC is the licensed version that runs under reparameterization of AM1. The approximations in
Chem3D. PM3 are the same as AM1.

Chem & BioOffice 2006 /Chem3D MOPAC 293


Potential Functions Parameters
This sequence of potential energy functions Automatic Keywords
represents a series of improvements to support the
initial assumption that complete neglect of diatomic The following contains keywords automatically sent
orbitals would yield useful data when molecules to MOPAC and some additional keywords you can
use to affect convergence.
Administrator

proved too resource intensive for ab initio methods.

Adding Parameters to Keyword Description


MOPAC
EF Automatically sent to MOPAC to
Parameters are in constant development for use specify the use of the Eigenvector
with PM3 and AM1 potential functions. If you find Following (EF) minimizer.
that the standard set of parameters that comes with
CS MOPAC does not cover an element that you BFGS Prevents the automatic insertion
need, for example Cu, you can search the literature of EF and restores the BFGS mini-
for the necessary parameter and add it at run time mizer.
when performing a MOPAC job. This flexibility
greatly enhances the usefulness of MOPAC.
GEO-OK Automatically sent to MOPAC to
You can add parameters at run time using the override checking of the Z-matrix.
keyword EXTERNAL=name, where name is the
name of the file (and its full path) containing the MMOK Automatically sent to MOPAC to
additional parameters. specify Molecular Mechanics
correction for amide bonds. Use
A description of the required format for this file can
the additional keyword NOMM to
be found in Figure 3.4, page 43 of the MOPAC
turn this keyword off.
2002 V.1.3 manual included on the CD-ROM.

Using Keywords RMAX=n.nn The calculated/predicted energy


change must be less than n.nn.
Selecting parameters for a MOPAC approximation The default is 4.0.
automatically inserts keywords in a window on the
General tab of the MOPAC Interface. You can edit RMIN=n.nn The calculated/predicted energy
these keywords or use additional keywords to change must be more than n.n.
perform other calculations or save information to The default value is 0.000.
the *.out file.
PRECISE Runs the SCF calculations using a
CAUTION
higher precision so that values do
Use the automatic keywords unless you are an advanced not fluctuate from run to run.
MOPAC user. Changing the keywords may give
unreliable results. LET Overrides safety checks to make
the job run faster.
For a complete list of keywords see the MOPAC
online manual.

294 MOPAC CambridgeSoft


Adding Parameters to MOPAC
Keyword Description Keyword Data

RECALC=5 Use this keyword if the optimiza- BONDS Bond Order Matrix*
tion has trouble converging to a
transition state. The following table contains the keywords that
invoke additional computations. Terms marked
For descriptions of error messages reported by with an asterisk (*) appear in the *.out file.
MOPAC see Chapter 11, pages 325331, in the
MOPAC manual. Keyword Description

Additional Keywords CIS UV absorption energies*

Keywords that output the details of a particular NOTE: Performs C.I. using only
computation are shown in the following table. the first excited Singlet states and
Terms marked with an asterisk (*) appear in the does not include the ground state.
*.out file. Use MECI to print out energy
information in the *.out file.

Keyword Data
FORCE Vibrational Analysis*
ENPART All Energy Components* NOTE: Useful for determining
zero point energies and normal
FORCE Zero Point Energy vibrational modes. Use DFORCE
to print out vibration information
in *.out file.
FORCE Vibrational Frequencies*

MECI
NOMM No MM correction
Microstates used in MECI calcula-
tion* NOTE: By default, MOPAC
performs a molecular mechanics
none HOMO/LUMO Energies* (MM) correction for CONH
bonds.
none Ionization Potential*
PI Resolve density matrix*
*
none Symmetry
NOTE: Resolve density matrix
into sigma and pi bonds.
LOCALIZE Print localized orbitals

VECTORS Print final eigenvectors


(molecular orbital coefficients)

Chem & BioOffice 2006 /Chem3D MOPAC 295


Using Keywords
To specify the charge in MOPAC:
Keyword Description
1. From the Calculations menu, point to
MOPAC Interface and choose a computation.
PRECISE Increase SCF criteria
Administrator

The MOPAC Interface dialog box appears.


NOTE: Increases criteria by 100
2. On the General tab, in the Keywords box, type
times. This is useful for increasing
the keyword CHARGE=n, where n is a positive
the precision of energies reported.
or negative integer (-2, -1, +1, +2).

T = n [M,H,D] Increase the total CPU time Different combinations of spin-up (alpha electrons)
allowed for the job. and spin-down (beta electrons) lead to various
electronic energies. These combinations are
NOTE: The default is 1h (1 hour) specified as the Spin Multiplicity of the molecule.
or 3600 seconds. The following table shows the relation between
total spin S, spin multiplicity, and the number of
unpaired electrons.
Specifying the Electronic
Configuration
Spin Keyword (# unpaired
MOPAC must have the net charge of the molecule electrons)
in order to determine whether the molecule is open
or closed shell. If a molecule has a net charge, be 0 SINGLET 0 unpaired
sure you have either specified a charged atom type
or added the charge.
1/2 DOUBLET 1 unpaired
CS MOPAC 2002 supports sparkles pure ionic
charges that can be used as counter-ions or to form 1 TRIPLET 2 unpaired
dipoles that mimic solvation effects.
1 1/2 QUARTET 3 unpaired
You can assign a charge using the Text Building tool
or by specifying it in MOPAC:
2 QUINTET 4 unpaired
To add the charge to the model:
2 1/2 SEXTET 5 unpaired
1. Click the Text Building tool.
To determine the appropriate spin multiplicity,
2. Click an atom in your model. consider whether:
3. Type a charge symbol. The molecule has an even or an odd number of
electrons.
For example, click a carbon and type + in a
text box to make it a carbocation.The charge is The molecule is in its ground state or an excited
automatically sent to MOPAC when you do a state.
calculation. To use RHF or UHF methods.

296 MOPAC CambridgeSoft


Specifying the Electronic Configuration
The following table shows some common
UHF (Open Shell)
permutations of these three factors:
Electronic State Spin State
RHF (Closed Shell)
Ground SINGLET
Electronic Spin Keywords to
State State Usea DOUBLET

OPEN(n1,n2)
TRIPLET

ROOT=n

C.I.=n
QUARTET
QUINTET

Ground SINGLET SEXTET

DOUBLET 1,2 Even-Electron Systems


TRIPLET 2,2
If a molecule has an even number of electrons, the
QUARTET 3,3 ground state and excited state configurations can be
QUINTET 4,4 Singlet, Triplet, or Quintet (not likely). Normally
the ground state is Singlet, but for some molecules,
SEXTET 5,5 symmetry considerations indicate a Triplet is the
1st Excited SINGLET 2 most stable ground state.
DOUBLET 2 2
Ground State, RHF
TRIPLET 2 3
The Ground State, RHF configuration is as follows:
QUARTET 2 4
Singlet ground statethe most common
QUINTET 2 5 configuration for a neutral, even electron stable
SEXTET 2 6 organic compound. No additional keywords
are necessary.
2nd Excited SINGLET 3
Triplet ground stateUse the following
DOUBLET 3 3 keyword combination: TRIPLET OPEN(2,2)
TRIPLET 3 3 Quintet ground stateUse the following
QUARTET 3 4 keyword combination: QUINTET OPEN(4,4)
QUINTET 3 5
NOTE: The OPEN keyword is normally necessary only
SEXTET 3 6 when the molecule has a high degree of symmetry, such as
a.
Do not use OPEN(n1,n2) for ground- molecular oxygen. The OPEN keyword increases the active
state systems except for high symmetry space available to the SCF calculation by including virtual
systems with open shells orbitals. This is necessary for attaining the higher multiplicity
configurations for even shell system. The OPEN keyword
also invokes the RHF computation using the 1/2 electron
approximation method and a C.I. calculation to correct the

Chem & BioOffice 2006 /Chem3D MOPAC 297


Specifying the Electronic Configuration
final RHF energies. To see the states used in a C.I. Second excited Singlet: OPEN(2,2) ROOT=3
calculation, type MECI as an additional keyword. The SINGLET
information is printed at the bottom of the *.out file.
Second excited triplet: OPEN(2,2) ROOT=3
TRIPLET C.I.=n, where n=3 is the simplest case.
Administrator

Ground State, UHF


Second excited quintet: OPEN(4,4) ROOT=3
For UHF computations, all unpaired electrons are QUINTET C.I.=n, where n=5 is the simplest case.
forced to be spin up (alpha).
Excited State, UHF
Singlet ground statethe most common
configuration for a neutral, even electron, Only the ground state of a given multiplicity can be
stable organic compound. No additional calculated using UHF.
keywords are necessary.
UHF will likely converge to the RHF solution Odd-Electron Systems
for Singlet ground states.
Often, anions, cations, or radicals are odd-electron
Triplet or Quintet ground state: Use the
systems. Normally, the ground states and excited
keyword TRIPLET or QUINTET. state configuration can be doublet, quartet or
sextet.
NOTE: When a higher multiplicity is used, the UHF
solution yields different energies due to separate treatment of
Ground State, RHF
alpha electrons.
Doublet ground state: This is the most common
configuration. No additional keywords are
Excited State, RHF necessary.
First Excited State: The first excited state is actually
Quartet: Use the following keyword combination:
the second lowest state (the root=2) for a given spin
QUARTET OPEN(3,3)
system (Singlet, Triplet, Quintet).
Sextet ground state: Use the following keyword
To request the first excited state, use the following
combination: SEXTET OPEN(5,5)
sets of keywords:
First excited Singlet: ROOT=2 OPEN(2,2) SINGLET Ground State, UHF
(or specify the single keyword EXCITED)
For UHF computations all unpaired electrons are
First excited triplet: ROOT=2 OPEN (2,2) forced to be spin up (alpha).
TRIPLET C.I.=n, where n=3 is the simplest case.
Doublet ground state: This is the most common
First excited quintet: ROOT=2 OPEN (4,4) configuration for a odd electron molecule. No
QUINTET C.I.=n, where n=5 is the simplest case. additional keywords are necessary.
Second Excited State: The second excited state is UHF will yield energies different from those
actually the third lowest state (the root=3) for a obtained by the RHF method.
given system (Singlet, Triplet, Quintet). To request
the second excited state use the following set of Quartet and Sextet ground state: Use the keyword
keywords: QUARTET or SEXTET.

298 MOPAC CambridgeSoft


Specifying the Electronic Configuration
Excited State, RHF Sparkles
First Excited State: The first excited state is actually Sparkles are used to represent pure ionic charges.
the second lowest state (the root=2) for a given spin They are roughly equivalent to the following
system (Doublet, Quartet, Sextet). To request the chemical entities:
first excited state use the following sets of
keywords. Chemical Equivalent to...
First excited doublet: ROOT=2 DOUBLET C.I.=n, symbol
where n=2 is the simplest case.
+ tetramethyl ammonium, potassium
First excited quartet: ROOT=2 QUARTET C.I.=n,
or cesium cation + electron
where n=4 is the simplest case.
First excited sextet: ROOT=2 SEXTET C.I.=n, where ++ barium di-cation + 2 electrons
n=5 is the simplest case.
Second Excited State: The second excited state is _ borohydride halogen, or nitrate
actually the third lowest state (the root=3) for a anion minus electron
given system (Singlet, Triplet, Quintet). To request
the second excited state use the following set of = sulfate, oxalate di-anion minus 2
keywords: electrons
Second excited doublet: ROOT=3 DOUBLET C.I.=n,
where n=3 is the simplest case. Sparkles are represented in Chem3D by adding a
charged dummy atom to the model.
Second excited quartet: ROOT=3 QUARTET C.I.=n,
where n=4 is the simplest case.
TIP: Dummy atoms are created with the uncoordinated
Second excited sextet: ROOT=3 SEXTET C.I.=n, bond tool. You must add the charge after creating the dummy.
where n=5 is the simplest case.
The output file shows the chemical symbol as XX.
NOTE: If you get an error indicating the active space is not
spanned, use C.I.> n for the simplest case to increase the
number of orbitals available in the active space. To see the
states used in a C.I. calculation, type MECI as an
additional keyword. The information is printed at the bottom
of the *.out file.

Excited State, UHF


Only the ground state of a given multiplicity can be
calculated using UHF.

Chem & BioOffice 2006 /Chem3D MOPAC 299


Specifying the Electronic Configuration
Administrator

300 MOPAC CambridgeSoft


Specifying the Electronic Configuration
Section II ChemFinder: Introduction
About ChemFinder Whats New in Chem-
ChemFinder is a database management system for
Finder 10?
anyone who works with chemical information. It ChemFinder 10 includes the following new
provides a place to store chemical structures, features:
physical properties, notes, tables of data, and charts GUI Improvements
based on that data. It takes the place of that box of Tabbed Windows
index cards youve been using to jot notes about
Find and Replace
interesting molecules and reactions, but does it
much better! With ChemFinder, you can search Struct=Name from the Context Menu
through data efficiently and quickly, and you can Subform Generator
organize the data instantly. BioViz improvements
Statistical Analysis
ChemFinder is integrated with the following
Details Window
CambridgeSoft products:
Filter Slider Adjustment
ChemDraw Histogram Improvements

Chem3D Better Selecting And Mouse-overs


More plotting flexibility
ChemDraw/Excel
Removal of Empty Points
Chem & BioOffice 2006

Chem & BioOffice 2006 /ChemFinder Introduction 301


About ChemFinder
Administrator

302 Introduction CambridgeSoft


Whats New in ChemFinder 10?
Chapter 13: ChemFinder Basics
Overview GUI Improvements in ChemFinder 10, a brief
description of opening a database, using a database,
ChemFinder is a database management system that and finally a discussion of the ChemFinder database
allows storage, retrieval, and searching of molecular model.
structures, text, and numerical data.
The general steps for using ChemFinder are as
You create structures in ChemDraw or with the follows:
built-in ChemDraw ActiveX control to store in
Create a form.
your ChemFinder database, and add related
numerical or textual data and comments. You can Create or open a database and link it to the
use the Chem3D ActiveX control to view the form.
structures. Add or manipulate data.
Use ChemFinder as a reference, together with one Perform a search.
of the CD-ROM databases provided. Use it as your
corporate database system, available to anyone on These steps are described in the Tutorials, and in
your network. Use it as a registration system or the detailed reference material in the manual.
front-end search engine for your big mainframe
database. Use it as a custom viewer for your Oracle The ChemFinder GUI
data, with or without chemical structures. Use it to
The ChemFinder GUI consists of menus, toolbars
keep track of what you find in your routine
and the form window. The central part of the form
literature scans. Use it to make a database to keep
window contains the work space where you create
the figures that go in your thesis or your next paper.
and view structures and data. The toolbars contain
This chapter describes The ChemFinder GUI, icons that change the way the pointer behaves or
including each of The ChemFinder Toolbars, and that perform actions corresponding to menu
The Status Bar. Following that is a description of commands.

Chem & BioOffice 2006 /ChemFinder ChemFinder Basics 303


The ChemFinder GUI
The components of the ChemFinder GUI are
shown below.
.

Main toolbar Title bar Record toolbar Search toolbar


Administrator

Menu
bar

Main form
S
Form
toolbar
O
Structure
window Framed
(shows BioViz data box
moused point)

Structure
box
(shows current
record) BioViz
Explorer window
window
(Database
panel visible)

Favorites tab
Database tab
Queries tab Details &
Filters tab Filter windows
New record
Details tab
indicator
Status Total
bar db size
Details for moused-over point Read-only Query Current Current
(in Structure window) indicator indicator record list size

The components of the ChemFinder GUI are


described below. Screen Description
Element
Screen Description
Element Current list size Displays the number of records
through which you are
browsing. Might be less than the
BioViz window Displays plotted data from
total database size if you have
ChemFinder databases.
recently performed a search.

304 ChemFinder Basics CambridgeSoft


The ChemFinder GUI
Screen Description Screen Description
Element Element

Current record Displays the position within the Menu bar Contains all the commands
current hit list of the record you specific to the ChemFinder
are viewing. application for manipulating
forms, tables, databases, and
Details window Displays details of selected (or their contents.
moused-over) point when a plot
window is displayed. New record Displays ADD if you are in the
indicator process of adding a new record
Explorer Has three tabs to display: that had not yet been
window committed to the database.
1. The database field hierarchy.
Query indicator Displays QRY if you are in the
2. The query list that will be
process of entering a search
saved with the form.
query.
3. A Favorites list of file
paths. Read-only indi- Displays READ if the data-
cator base is read-only and cannot be
Form toolbar Contains icons representing the modified.
form-creation tools available in
ChemFinder. Click a tool icon Record toolbar Contains icons for commands
to select it. The selected tool in the Record menu. Click an
determines what action is icon to perform the command.
carried out when you drag in a
form window. Search toolbar Contains icons for commands
in the Search menu. Click an
Framed data Displays data in a Data Box icon to perform the command.
box surrounded by a labeled frame.
Status bar Displays information about the
Main form Displays data contained in one current state of the ChemFinder
record of the database. application.

Main toolbar Contains icons representing Structure box Displays the chemical structure
general-purpose menu of the current record.
commands such as copying,
saving, and printing. Click an
icon to perform the command.

Chem & BioOffice 2006 /ChemFinder ChemFinder Basics 305


The ChemFinder GUI
Main Toolbar
Screen Description
Element The Main Toolbar contains the standard tools you
find in most modern applications: New, Open, and
Save; Cut, Copy, and Paste; Undo and Redo; Print
Administrator

Structure Displays structure of selected


and Help.
window (or moused-over) point when a
plot window is displayed.
New Save Layout
Form Form Paste Redo Print Help Mode
Table header Displays the name of a field.
Double-clicking on a table
header sorts on that field.

Title bar Contains the name of the appli-


Open Cut Copy Undo Switch to Database
cation or document as a Form Table Wizard
window title. Also, the title bar
can be dragged to move a In addition, it has three ChemFinder tools:
window. Layout Modeswitches between Layout
(Edit) Mode and View Mode. When the Layout
Total database Displays the total number of Mode button is depressed, the Form
size records in the current table. Toolbar is visible and an alignment grid
appear on the form.
The ChemFinder Toolbars Switch to Tableswitches between Form
View and Table View.
ChemFinder uses several toolbars to create and
manipulate the ChemFinder form and the database Database Wizardactivates the Database
records it displays. Toolbars are normally docked at Wizard to connect a database to a form.
the top and left side of the GUI, but they can be
Form Toolbar
torn off and placed anywhere on the screen for
your convenience. Which toolbars are visible is set The Form Toolbar contains the tools you need to
in the Toolbars submenu of the View menu. You create objects on a form. Use it to create a new
can also use the Toolbars submenu to customize the form, or to add an object to an existing form.
toolbars. A description of toolbar customization is
beyond the scope of this manual. (See Microsoft Selection
help for information on customizing toolbars.) tool Frame Text Button Subform

To select which toolbars are visible, choose Toolbars


from the View menu, and check or uncheck the
appropriate boxes.

Data box Framed box Picture Boolean Grid

The tools are described in detail in Chapter 15,


Creating and Editing Forms on page 335.

306 ChemFinder Basics CambridgeSoft


The ChemFinder GUI
Search Toolbar (not available) when you are not working in a data
or text field. Some options will be grayed out if the
The Search Toolbar contains the tools you need to
field type does not permit them.
query the database and work with the hitlists that
the query produces. Font Bold Italic Underline Color Alignment

Enter Retrieve Previous Restore Find


Query All Query List List

Point Size Subscript Superscript Bullets

The Status Bar


While you move among records, counters in the
Find Find Current Save List Restore Over
lower right corner of the ChemFinder window
Molecule Previous Current
List List change to indicate the current record, the current
list size, and the total size of the database. The lower
Record Toolbar left corner of the window displays help for menu
items and other information.
The Record Toolbar contains the tools you need to
browse a database or hitlist. It also has tools for When you first open a form, the current list size
adding, deleting, and changing records. equals the total database size. The total database
size changes only when you add or delete records.
First Go to Last Undo Omit If you search to find a subset of the entries in the
Record Record Record Changes Record database, then the current list size changes to
indicate the number of hits in the search.
To the left of these counters are three other
indicators that show the general status of the
database. The first displays the word READ when
Previous Next Add a Commit Delete you are using a read-only database, such as one that
Record Record Record Changes Record is on a CD-ROM, a read only form file, or if you
have selected Open as read only on the Open
Text Toolbar File dialog box.
The Text Toolbar contains standard text formatting
tools that you can use when entering or editing
information in data and text fields. It is grayed out The second indicator displays the word ADD
when you are entering a new record.

The third displays QRY when you are entering a


query.

To hide or show the Status Bar:

Chem & BioOffice 2006 /ChemFinder ChemFinder Basics 307


The ChemFinder GUI
From the View menu, deselect or choose Status A dialog box appears where you can enter text
Bar. and set the search parameters.

Figure 9: Find and replace


GUI Improvements in
Administrator

ChemFinder 10
Create tabbed windows to save space. Drag a
dockable window over an existing docked window
until you see the outline of a tab at the bottom.

Figure 8: Creating tabbed windows

1. Drag

Struct=Name from the


Context Menu
The structure Copy As command has two new
options. In addition to SMILES, you may now copy
as Name or InChI1. The Name command
2. Tab outline appears invokes the CS Struct=Name utility.
Struct=Name generates systematic chemical
names with proper CIP stereochemistry
3. Final result descriptors.

The InChI command invokes the CambridgeSoft


implementation of the IUPAC InChI algorithm.
The InChI algorithm takes a chemical structure
and converts it into an alphanumeric string. A key
aspect of the InChI algorithm is that the
Find and Replace generated string is independent of the way that a
structure is drawn, producing a consistent
You can find-and-replace strings in both text and alphanumeric representation of different structural
memo fields, either across all records in the current representations of the same structural formula
recordset, or in the current record. In either case, (canonicalization).
find-and-replace is limited to the selected field.
Both commands place the data on the Clipboard,
To find text: allowing it to be copied into other applications.
1. InChI is a trademark of the Interna-
tional Union of Pure and Applied
1. Right-click in a text or memo field.
Chemistry. InChI Material in Chem-
2. Select Find or Replace. Draw is IUPAC 2005.

308 ChemFinder Basics CambridgeSoft


GUI Improvements in ChemFinder 10
To copy a structure as a name or InChI string: create it automatically. For more information,
see Connecting a Database to a Form on
1. Click in the Structure window to select it. page 317.
2. Right-click, and choose Name or InChI from The Database WizardGuides you through
the Copy As submenu. the process of setting up a form with a database
connection.
Figure 10: Copy As Name
Existing tabAllows you to open an existing
form in your file system.
Recent tabAllows you to open a form on
the recently-used file list.
You can choose whether or not the ChemFinder
dialog box is displayed when ChemFinder opens by
doing the following:
1. From the File menu, choose Preferences.
2. In the Preferences dialog box, click the
General tab.
3. Select or deselect Show Startup Dialog.
If you choose to hide the ChemFinder dialog
3. Paste the data into the other application using box, ChemFinder will open a new blank form
Ctrl+V or the Paste command on the Edit by default when you open the application.
menu.
To open the ChemFinder dialog box when the
preference is set to hide:
Opening ChemFinder
From the File menu, choose New.
To open the ChemFinder application:
Using ChemFinder with
Click Start, point to Programs (in Windows XP
All Programs), point to Chem & BioOffice 2006, Databases
and select ChemFinder.
ChemFinder comes with the Microsoft Jet database
ChemFinder opens and the ChemFinder engine. ChemFinder maintains a table of chemical
dialog box appears. informationstructure, formula, and molecular
weightand relies Jet to create a database system
The ChemFinder dialog box enables you to for managing the rest of the data. If you have MS
perform the following tasks. Access installed on your computer, you can use it to
work with the relational part of the database (.mdb
Blank FormOpen a blank form to create file).
your own form.
With ChemFinder 10 Ultra, you can use the
Database ConnectionAllows you to open ChemFinder/Oracle Cartridge to manage all
a blank form and connect it to a database. You chemical and relational data directly in Oracle,
can create the form manually or choose to without using DAO or ODBC.

Chem & BioOffice 2006 /ChemFinder ChemFinder Basics 309


Opening ChemFinder
The Database Model A record is a set of related data items, one per field,
representing a single entry in the database.
A database is a collection of information. In
ChemFinder the information is organized into
increasing levels of complexity. At the simplest level
Administrator

is the data item itself, for example the, molecular


weight of furan.

A collection of records is a table. A table is defined


by a set of fields, generally set up once and rarely
modified, and a set of records which grows as
entries are added.
The data item is stored within a field, in this
example MolWeight. A field contains
information of a specific type. For example, a field
can contain numeric, text, or structure information.

In spreadsheet terminology:

A data item is found in a cell.

A field corresponds to a column.

A record corresponds to a row.

A table corresponds to a worksheet.

A database is a storehouse for tablespossibly one,


possibly more than one. A database containing only
one table is known as a simple (or flat or flat-file)
database.

310 ChemFinder Basics CambridgeSoft


Using ChemFinder with Databases
Databases containing multiple tables are called information stored in the database. No data is
relational. Relational databases are discussed stored in a form. The form acts like a window,
further in Chapter 16, Relational Data and letting you select which fields and tables you want
Subforms on page 361. to view.
A form displays data from a single table, but may ChemFinder lets you create more than one form to
contain subforms that display data from other access the same database. For example, you may
tables. If the tables have a field in common, then want to create one sample form for working with
any record retrieved in the form calls up the related structural data and a more complicated one to
records in the subform. include literature or lab data. By switching between
forms, you can look at just those fields you want to
Understanding Forms and see. For more information, see Chapter 16,
Databases Relational Data and Subforms on page 361.

There is an important distinction between forms


and databases. Databases are where data is actually
stored. A form is used only to display the

Chem & BioOffice 2006 /ChemFinder ChemFinder Basics 311


Using ChemFinder with Databases
Administrator

312 ChemFinder Basics CambridgeSoft


Using ChemFinder with Databases
Chapter 14: ChemFinder Tutorials
Overview The Cs_Demo database contains about 300
structures covering a range of structural types. The
The general steps for using ChemFinder are: database contains two tables, both of which are
visible using the form Cs_Demo.cfw. This is the
1. Create a form. form used in the following tutorials. Demo.cfw is a
2. Create or open a database and link it to the simpler form which displays only the main table of
form. the same database.
3. Add or manipulate data.
CAUTION
4. Perform a search.
We recommend you make a working copy of the database
The tutorials introduce you to ChemFinder basic
before experimenting with it. If you make changes to the
functions. Tutorial 1: Creating Forms walks you
data or structures in the database, the examples in the
through the basics of form creation. Tutorial 2:
Opening a Database works with an existing tutorials may no longer give the documented results.
database, showing you how to link it to your form.
Tutorial 3: Creating Your Own Database teaches The following procedure creates a working copy of
you how to create your own simple database and the Cs_Demo.cfw database.
link it to your form.
1. Open Windows Explorer.
Tutorial 4: Searching a Database illustrates the
2. Create a folder for the database copies.
basics of searching databases and Tutorial 5:
Reaction Queries expands on this to include 3. Select all Cs_Demo.* files.
reaction databases. Tutorial 6: Using BioViz 4. Right-click, and choose Copy.
introduces the new Chemfinder plotting feature.
5. Select the folder you created for the database
Finally, Tutorial 7: Working with Subforms,
copies.
illustrates ChemFinder relational database
capabilities. 6. Right-click and choose Paste.

You may want to use the Quick Reference card You can now experiment with adding, modifying,
while you perform the tutorials. and deleting data in the copies with no effect on the
Cs_Demo database.
Perform the tutorials in the sequence they are
presented because each tutorial develops on and Tutorial 1: Creating
refers to the previous ones.
Forms
Sample Databases
Forms allow you to display your data in a
The Samples directory located in the \Chem & customized format, to browse and search through
BioOffice\samples folder contains several small your database, and to interact with other
databases, forms, and sample scripts. applications, such as ChemDraw and Chem3D.

Chem & BioOffice 2006 /ChemFinder ChemFinder Tutorials 313


Tutorial 1: Creating Forms
In this tutorial, you learn to create, edit, and save the 3. Click the Data Box tool .
following form: 4. In the form window, drag diagonally to create a
box.
Administrator

You create forms using the Form toolbar shown


below: 5. Draw two more boxes in the same way. You
edit them in later steps
NOTE: The Form toolbar docks on the left side of the
ChemFinder window by default, but can be docked anywhere
or torn off, as shown below.
.

Selection tool Frame Text Button Subform

A Frame, a Framed Box, and a Text Box are


Data box Framed box Picture Checkbox Grid
different types of boxes and require a label.
For detailed information about each tool, see
To draw a Framed Box:
Creating Forms Manually on page 340.
1. Click the Framed Box tool and drag
Creating Data Boxes diagonally to create a framed box.
Data and structures from a database are displayed in A box labeled Data is created.
boxes. You create boxes using the tools in the Form 2. Point to the word Data, right-click, and select
toolbar. The Form toolbar only appears when you Label.
select Layout mode.
The Box Text or Label dialog box appears.
To create a data box:
1. From the Main toolbar, click New .
A new, blank form appears in the ChemFinder
window.
2. If the Form toolbar is not visible, click the
Layout mode tool . 3. In the Box Text or Label dialog box, type
The Form toolbar appears. Frame Box and click OK.

314 ChemFinder Tutorials CambridgeSoft


Tutorial 1: Creating Forms
The label appears above the Framed Box. The label appears above the box.

TIP: You can change the font of the label from the Box
tab of the Properties dialog box. Just click the button
labeled Font.

To place a picture in your form:

1. Click the Picture tool and drag in the


form.
The Open dialog box appears.
4. Click the Frame tool . 2. In the ChemFinder System directory, choose
Buttrfly.wmf, then click Open.
TIP: The Frame tool is useful if you want to draw a The picture appears in the area you dragged in
frame around two or more data boxes. the form.

5. Place the pointer at the corner of the upper


right data box and drag to create a border
around the group of three data boxes.

The Enter the Label dialog box appears.

Editing Data Boxes


Edit the data boxes using the Selection tool:

1. Click the Selection tool .


6. In the Enter the Label dialog box, type Frame 2. Select the upper left box by clicking anywhere
and click OK. in it.

Chem & BioOffice 2006 /ChemFinder ChemFinder Tutorials 315


Tutorial 1: Creating Forms
A selected data box is designated by four black Select a box, point within the selection, and
squares at its corners. drag the box.
Administrator

3. Click an empty space in the form with the If you select multiple boxes, dragging the center of
Selection tool to deselect the box. a selected boxes moves all of them at once.
To select multiple boxes: To edit with the Clipboard:
Press the Shift key and click in each box. 1. Select a box.
2. Try each of the following:
TIP: You can also select multiple boxes by dragging.
From the Edit menu, choose Cut.
You can select all the boxes on the form by choosing
Select All from the Edit menu. From the Edit menu, choose Paste.
From the Edit menu, choose Undo (Paste).
The frame and the box work as one object when From the Edit menu, choose Redo (Paste).
you select, move, resize, or delete. To separate them
into two objects: NOTE: Undo and Redo work over multiple levels. You can
use Undo and Redo repeatedly to reverse multi-step
1. Click inside the Framed box to select it. operations.
2. From the Edit menu, choose Bring to Front.

To resize a box: Deleting Data Boxes


Select a single box, and resize it by dragging a To delete a data box:, do one of the following:
side or corner. Select a box and press the Delete or Backspace
key.
From the Edit menu, choose Cut.
To clear the entire form:
From the Edit menu, choose Select All, and
press the Backspace key to remove the contents
of the form.

Creating and Saving a Form


To reposition a box: To create and save a new form:

316 ChemFinder Tutorials CambridgeSoft


Tutorial 1: Creating Forms
1. Draw the form shown below, using the Framed The Box Properties dialog box appears with
box tool. the Database tab displayed.

NOTE: The Data Source option is only available in


Layout mode. Make sure the Layout mode toggle
button is depressed before performing this step.

2. From the File menu, choose Save As.

3. In the Save As dialog box, save the form as


tut1.cfw in the directory of your choice.

4. From the File menu, chose Close.

Tutorial 2: Opening a
Database 4. Click Open Database.

After you create a form, you can use it to connect


NOTE: The Open and Create Database buttons
to a database that actually stores information. In
work with ChemFinder databases only. To access data
this tutorial, you use the form you saved as
in other types of databases, use the Attach Table or the
tut3.cfw in the previous tutorial to access and
Oracle button (if available). For more information
retrieve information from an existing database.
about data sources, see Attaching Tables from Other
Applications on page 373.
Connecting a Database to a
Form The Open dialog box appears.

To connect a database to your form:


1. From the File menu, choose Open.

The Open dialog box appears.


2. Select tut1.cfw and click Open.

The form you created in the previous tutorial


appears, but all of its fields are blank You can
use this form to display the demonstration
database.
3. Right-click the Structure box and choose Data
Source. 5. Select CS_demo.mdb and click Open.

Chem & BioOffice 2006 /ChemFinder ChemFinder Tutorials 317


Tutorial 2: Opening a Database
The database opens, and the Box Properties To assign fields to the other data boxes:
dialog box appears displaying the Database tab.
1. Right-click in the Name box and choose
6. Select a table. Molname.
Administrator

A list of the tables in the database and the fields


in each table are shown. The field you select NOTE: Once you have opened a database and table,
determines what type of data appears in the the shortcut menu displays the fields in the database.
box you selected in step 3.

The Molname field in the database is linked to


the Name box, and the data item for the first
record appears in the Name box.

2. Right-click in the Formula box and choose


Assigning Fields to Data Formula.
Boxes 3. Right-click in the ID box and choose MOL_ID.

To display structures from the CS_Demo database


in a Structure box on your form:

From the list of fields in the Box Properties


dialog box, click Structure, then click OK.

The Structure field is linked to the Structure


box. In the Structure data box, you can see the
contents of the Structure field for the first
record in the CS_Demo database. 4. From the File menu, choose Save As.

5. In the Save As dialog box, save the form as


tut2.cfw in the directory of your choice.

6. From the File menu, choose Close.

Congratulations! You have created your own


customized form for viewing the CS_Demo
database.

318 ChemFinder Tutorials CambridgeSoft


Tutorial 2: Opening a Database
Tutorial 3: Creating Your 6. Click Create Field.

Own Database The Create Field dialog box appears.

In this tutorial you will create a new database using


a different techniqueautomatic form generation.
1. Open a new blank form.
2. Right-click in the form and choose Data Source
from the context menu.
The Properties dialog box appears with the
Database tab displayed.
3. Click Create Database.
7. Type MolName in the text box, change the
The Save As dialog box appears. width to 254, and click OK.
4. Type mydb and click Save.
The name of the database appears in the NOTE: The maximum number of characters you can
Properties box. enter in any text field is 254 characters. If you want a
text field to contain more than 254 characters, choose
Memo/Rich Text from the Type drop-down list.

8. Click Create Field again. Type Boiling Point in


the text box, change the type to Double, and
click OK.

Database name NOTE: Use the field type Double to create a field
containing real numbers (such as -123.7 and 43.242) .

The data table tree display should reflect your


changes immediately.
ChemFinder creates one data table (MolTable)
containing four fields: Structure, Formula,
MolWeight, and MOL_ID.
5. Click the Field tab.
You are now going to add two new fields to the
data table.

Chem & BioOffice 2006 /ChemFinder ChemFinder Tutorials 319


Tutorial 3: Creating Your Own Database
9. Click the Form tab. There should be a check next to Boiling Point.

TIP: You can edit the form to suit your purposes. Notice in
the next section that the form has been rearranged to save
Administrator

space.

Generate form Adding Records


checkbox
Style button Now that you created new fields and assigned them
to data boxes, you can add data to your database.

This tutorial was written to demonstrate use of the


ChemDraw ActiveX control (the default structure
10. Click the checkbox next to Generate form. Click mode). Before you begin to add structures, you
the Style button. In the Form Generation might want to check if ChemFinder is set
dialog box, make sure the checkbox for appropriately.
Structure in upper left of form is checked.
1. Right-click in the Structure data box, and select
11. Click OK in the Form Generation dialog box Properties.
and again in the Properties dialog box.
2. In the Box Style section of the Box Properties
The Mydb form is generated. dialog box, select ChemDraw style.
When ChemDraw style is selected, ChemFinder
defaults to the ChemDraw ActiveX control.
This allows you to edit structures directly in the
Structure data box in ChemFinder. ChemFinder
style opens ChemDraw in its own window for
editing.

Now you are ready to begin adding records to your


database.

1. Deselect the Layout tool to hide the Form


Check the field assignments in the data boxes. toolbar.
2. Double-click in the Structure box.
1. Right-click in the structure data box.
The ChemDraw ActiveX toolbar appears.
There should be a check next to Structure
indicating that the Structure field is linked to TIP: Even if your default is ChemDraw style, you can
the structure data box. open ChemDraw by right-clicking in the structure box
and selecting Edit in ChemDraw.
2. Right-click in the Boiling Point data box.

320 ChemFinder Tutorials CambridgeSoft


Tutorial 3: Creating Your Own Database
3. Draw benzene. Enter two more records:

1. From the Record menu, choose Add New


Record.
2. Add a record for n-Pentane (shown below),
with a bp = 36.1.

3. Repeat step 1 then add a record for Cyclo-


hexane (shown below), with a bp = 80.7.

4. Click somewhere outside the Structure data


box to enter the structure in the data box.
The benzene molecule appears in the Structure
Data box on the form. ChemFinder calculates
the molecular formula, and assigns an ID
number of 1. NOTE: After you have two or more records in your
database, you can commit changes by moving to a
5. Click the MolName box and type Benzene.
different record using the Record tools.
6. Click the Boiling Point box and type 80.1.
4. From the File menu, choose Save.
To commit your new record:
NOTE: Choosing Save saves any changes made to
Choose Commit Changes from the Record your form. Clicking Commit Changes saves the data
menu. into your database.
You entered the first record in your database. The
size of your database is indicated in the Status Bar. Tutorial 4: Searching a
Database
NOTE: The following examples require you to search the
entire database. This is the default search, unless the Over
Current List command is activated on the Search menu.
Please take a moment to make sure this command is NOT
activated before beginning this tutorial.

ChemFinder helps you organize and find


information. One way to find information is to
browse through the database one record at a time,
like turning the pages in a book. This is a good way

Chem & BioOffice 2006 /ChemFinder ChemFinder Tutorials 321


Tutorial 4: Searching a Database
to see some of the information available. However,
(

because databases can be very big, browsing is often


inefficient.
Searching a database is like using the index of a
Administrator

book. With an index, you can quickly focus on the


few pages you are interested in. When you search a
database, you find only those few records that have
the information you look for. After you have this
smaller collection (a hit list), you can then browse it
much more efficiently than you could the whole
database.
ChemFinder performs the following types of
searches: 3. In the Samples directory, select CS_demo.cfw
Text and structure searches, demonstrated in and click Open.
Tutorial 4. The CS_Demo database opens in
Reaction searches, demonstrated in Tutorial 5. ChemFinder.
In this tutorial, you will learn how to search
substructures and text in the CS_Demo Database.
This database is included with ChemFinder as a
sample database of approximately 300 organic and
inorganic compounds.
TableFormView 225 dpi
Opening the Demo Data-
base
To open the CS_Demo database:
1. Open ChemFinder and in the Open dialog Before you begin searching, open the Explorer
box, click the Existing tab. window, if it is not already open.
2. Navigate to the...\Chem & BioOffice 2006\
ChemFinder\samples folder. (Normally, this is
in C:\Program files\.)

322 ChemFinder Tutorials CambridgeSoft


Tutorial 4: Searching a Database
1. Choose Explorer Window from the View Formula Searching
menu.
To find compounds in the CS_demo database with
six carbons and one or two nitrogen atoms:
1. In the CS_demo database, choose Enter Query
from the Search menu, .
The form is cleared so that you can enter a new
query.
2. Click in the Formula box and type C6N1-2.

NOTE: This entry specifies a molecular formula


having six carbon atoms and one or two nitrogen atoms.

3. Press the Enter key.


The Status Bar indicates that 12 hits were
The Explorer Window appears. retrieved from the 285 records in the database.

The Queries tree in the Explorer window now


displays one query as a child of the full list.
Queries are saved with the form and can be
reviewed at any time. For more information on
queries in the Explorer window, see Managing
Queries on page 421
There are three methods for browsing the hits:
2. Click the Queries tab, and you are ready to start In the Form ViewUse the Record menu
your first search. commands or toolbar to navigate through
records.
TIP: The default, set in the Preferences dialog box, is to In the Data Table ViewBrowse the table to
save all queries listed in the Queries tree. If you dont want to view the records.
save a particular query, delete it before closing the form. In the Continuous Forms Viewview
multiple records in their own forms.

Text Searching Use Switch Views from the View menu to toggle
between the different methods.
In this exercise, you perform a molecular formula To browse the hit list, use the Record menu as
search then a name search. follows:

Chem & BioOffice 2006 /ChemFinder ChemFinder Tutorials 323


Tutorial 4: Searching a Database
From the Record menu, choose First Record, The molecular weight field is sorted in
Previous Record, Next Record, Last Record, or Go increasing order.
to Record. Try it.
Administrator

NOTE: As you change records, counters in the Status bar


indicate the current record, the current list size, and the total
size of the database.

To view the database in a table that shows the


records in a list:
From the View menu, point to Data Table, and
choose In Current Window. To change the column widths of your table:
NOTE: Switch to Table is a toggle. Selecting it again will Position the pointer over a table header divider
return you to the Form view. and drag to the width you want.
Pointer
The Table view appears and displays all the
records of the current list (in this case, the 12
records that were hit by the search) in a table.

TableListView 225 dpi

To use continuous forms to browse your records:


1. On the View menu choose Continuous Forms.
You can sort the records for a specific field in Table The Continuous Forms view appears. By
View. default, the Continuous Forms view shows the
same form as the Form view.
To sort records in Table view by the MolWeight
field:
Double-click on the MolWeight table header.

Adjust the height of any form by dragging the bar


divider on the left to view the forms clearly.

324 ChemFinder Tutorials CambridgeSoft


Tutorial 4: Searching a Database
Return to the Form view: Numerical Searching
Choose Form View on the View menu.
To search in the CS_Demo Database for
To retrieve all the records in your database:
compounds with molecular weights between 90 and
Double-click Full List in the Explorer window. 100:

Name Searching 1. Switch to the Form View, if you are not already
in it.
To find all compounds in the CS_Demo Database
with molecular names starting with benz: 2. From the Search menu, choose Enter Query.

1. Switch to the Form View, if you are not already The form is cleared so that you can enter a new
in it. query.
The Form view appears. 3. Click the Molecular Weight box and type
90-100.
2. From the Search menu, choose Enter Query.

TIP: Although the Tutorials describe the use of the


Search menu, you may find using the Search toolbar
more convenient. The icons on the toolbar match those
you have already seen on the Search menu. Clicking the
Find icon is equivalent to pressing the Enter key when
you are ready to begin your search. See Chapter 20,
Searching on page 403 for information on more
advanced use of the Search toolbar.

The form is cleared so that you can enter a new


query.
4. Press the Enter key.
3. Click the Molecule Name box, and type benz*.
You get 11 hits with molecular weights
4. Press the Enter key.
between 90 and 100.
You get 12 hits with names starting with
benz.

5. From the View menu, point to Data Table, then


5. From the View menu, point to Data Table, and
choose In Current Window.
choose In Current Window.
The Table view appears. Browse to verify that
the molecular names are correct. The Table view appears. Browse to verify that
the molecular weights are correct.
NOTE: Notice that this search gave you benzene but not
bromobenzene. The query you entered above is an NOTE: A molecular weight query is a decimal value or
anchored substring and only gives you strings starting with range. The precision of the search depends on the number of
the indicated substring. For more information on how to significant digits entered. For more information on molecular
specify text searches, see Text Searches on page 403. weight searching, see Numeric Searches on page 404.

Chem & BioOffice 2006 /ChemFinder ChemFinder Tutorials 325


Tutorial 4: Searching a Database
Substructure Searching The Search menu should appear as follows:

To enter a query and search for a substructure:


Administrator

1. From the Search menu, choose Enter Query.

The form is cleared to allow you to enter your


search terms. The status indicator in the status
bar is changed to remind you that you are in
query mode and the color of the form may
change.

2. Double-click in the Structure box.

A blue box is displayed around the Structure


box and the ChemDraw ActiveX toolbar
appears.
3. Draw benzene.
3. From the Search menu, choose Find.
ChemFinder begins searching. The progress of
the search is indicated by counters in the status
bar at the bottom of the window.
When the search is complete, the number of
hits is displayed in the Current List Size
window of the Status Bar, and the form
displays the first hit.

In this search you get 123 hits of structures that


To set the correct options for a substructure search: contain an aromatic six-membered ring. The
list you can browse is limited to the hits found
1. From the Search menu, select Substructure if it
in the search.
is not already selected.
2. From the Search menu, deselect Similarity if it
is selected.

NOTE: You can also set search preferences on the


Search tab of the Preferences dialog box. For more
information, see Chapter 21, Customizing
ChemFinder on page 429

326 ChemFinder Tutorials CambridgeSoft


Tutorial 4: Searching a Database
In a substructure search, the matched portion The Table view appears. Browse to verify that
of each molecule is highlighted in red. the molecular weights are correct.

TIP: Some users prefer not to see red highlighting Congratulations! You have completed the tutorial
because it masks the atom colors. You can change the on searching a database using ChemFinder. You
highlight color on the Color tab of the Preferences dialog may now close the CS_Demo database.
box. Selecting black will effectively cancel highlight-
ing, leaving atoms to display in their normal colors. Tutorial 5: Reaction
Queries
NOTE: If a search gets no hits, an alert appears and you
are returned to the query mode with the query on display. In addition to helping you organize information
about individual substances, ChemFinder also
allows you to store and search chemical reactions.
Combined Searching
In some cases, you may want to combine structure There are many ways to search reactions, depending
searching with text searching to find a specific class on what sort of information you are interested in.
of compounds. For example, you may want to find In this set of exercises, you learn some general
all compounds in the database that have a benzene methods to search for different parts of reactions
substructure and that have a molecular weight using a sample from the ISICCR database. This
greater than 400. database is included with ChemFinder as a sample
database of approximately 250 reactions extracted
To perform a combined search: from the ISIs ChemPrep database of Current
Chemical Reactions.
1. From the Search menu, choose Enter Query.

The form is cleared so that you can enter a new Opening A Specific Data-
query.
base
2. Double-click in the Structure box.

The ChemDraw ActiveX toolbar appears. To open the ISICCR database:

3. Draw benzene. 1. From the File menu, choose Open.


4. Click the Molecular Weight box and type >400.
The Open dialog box appears.
5. Press the Enter key.
2. In the Samples directory, select Isiccr.cfw, and
You get 8 hits from the 285 records in the click Open.
database.

NOTE: The ISICCR.cfw form is formatted for a large


screen (1024 X 768). If you have a smaller screen, open
ISICCRsm.cfw for a simpler form.
6. From the View menu, point to Data Table, and
choose In Current Window.

Chem & BioOffice 2006 /ChemFinder ChemFinder Tutorials 327


Tutorial 5: Reaction Queries
The ISICCR database opens in ChemFinder. The Search menu should appear as follows:
Administrator

O
O O
H
O
+

O O O
O O
H
OO

TableFormISICCR 275 dpi

Searching for Reactants


Searching for reactants is useful if you have a
known starting material and you are interested in
learning more about what substances it can
produce.
6. From the Search menu, choose Find.
For example, to search for Grignard reactions, or
ChemFinder searches. The progress of the search is
reactants:
indicated by counters in the status bar at the bottom
of the window.
1. From the Search menu, choose Enter Query.

The form clears. When the search is complete, the number of hits is
displayed in the Current List Size window of the
2. Double-click in the Structure box. Status Bar, and the form displays the first hit. In a
substructure search, the matched portion of each
The ChemDraw ActiveX toolbar appears.
molecule is highlighted in red.
3. Draw the following:

M
g nO
R
x
MgXHit 40%
+B
r
R
x
n
O
M
g N
+
N
+
O
X
R
x
n -

O
-

This structure represents a carbon atom You get 3 hitsreactions in which an alkyl
bonded to a magnesium atom, which is bonded magnesium halide is consumed. Browse the list of
to any type of halogen. The arrow at the right three hits as in previous tutorials.
indicates that you are looking for this
substructure as a reactant. Searching for Products
4. From the Search menu, select Substructure if it
is not already selected. In the next exercise, you search for information on
a particular reaction product. Searching for
5. From the Search menu, deselect Similarity if it products of reactions is very common in syntheses,
is already selected. where you know what you are aiming for but you do

328 ChemFinder Tutorials CambridgeSoft


Tutorial 5: Reaction Queries
not know how to produce it. In this example, we 8. Press the Enter key.
look for reactions that close a ring alpha to a
You get 3 hits containing a product with a
carbonyl.
carbonyl ring that was formed during the
course of the reaction.

O
H H
O
H
O O

H H

H C
l H C
l
C
l

O O

To perform a reaction product search:

1. From the Search menu, choose Enter Query.


Searching by Reaction Type
The form is cleared so that you can enter a new
query. In many cases, you have some idea of both your
2. Double-click on the Structure data box. starting materials and your products, but are
looking for some information on how to get from
The ChemDraw ActiveX toolbar appears. one to the other.
3. Draw the following:
For example, to search for reactions that reduce a
carbonyl to an alcohol:
O
1. Click Enter Query in the Search menu.

The form is cleared.


4. Switch to either selection tool (Lasso or
Marquee) and select the single bond next to the 2. Double-click in the Structure box.
double bond.
3. Draw the following:
5. Right-click, point to Topology, and choose Ring. .

6. Select the remaining single bond. O


O
H
7. Right-click, point to Topology, and choose Ring.
Right-click again, point to Reaction Center, and
4. Press the Enter key.
choose Make/Break. Your structure should
now look like this: Browse through the 23 hits. Each of the
reactions found shows the transformation of a
R
n
g
Rx
nRgO
n carbon-oxygen double bond to a carbon-
oxygen single bond.
The arrow at the left indicates that you are This hit list includes reductions of aldehydes,
looking for this substructure as a product. acids, and ketones.

Chem & BioOffice 2006 /ChemFinder ChemFinder Tutorials 329


Tutorial 5: Reaction Queries
Search Over List You get 13 hits. Each reaction shows the
reduction of a ketone to an alcohol. In the
In this example, you start with the previous list and Queries Tree, this search is shown as a child
search again to get only ketone reduction reactions. of the first query.
Administrator

To search over a list:


1. If you are not continuing directly from the last
example, double-click the previous query in the
Query Tree to make sure it is the active hitlist.
2. Select Over Current List from the Search menu.
3. Double-click in the Structure box.
4. Draw the following:

Rxn

[NOTO,H] [NOTO,H]
TIP: If you plan to do several searches over a hitlist, use the
Set Domain to Current List command rather than Search
Over Current List. Setting a domain eliminates the need to
a. Using a Selection tool, right-click and set keep restoring the original hitlist.
Reaction Center bond properties to Change.
b. Using the Text tool, select one of the atoms Congratulations! You have completed the tutorial
where the label is shown. Type [NOT O,H] on searching for reactions using ChemFinder.You
(all uppercase) and press the Enter key. may now close the ISICCR database.
c. Still using the Text tool, select the label,
right-click and choose Repeat Last Label. Tutorial 6: Using BioViz
d. Double-click on the other atom to repro- BioViz is the ChemFinder visualization facility. In
duce the label. this tutorial, you will be introduced to the basic
You specified a search for ketones by adding concepts of data visualization by producing a
the restriction that the atoms adjacent to the simple one-variable chart. You can create multiple
carbon must not be oxygen atoms or hydrogen plots and store them with the form. You can create
atoms. You also specified that the double bond plots of the full list and of queries. In this tutorial,
had to change, not be broken. you will create a plot of a query created in a previous
5. Press the Enter key. tutorial.
Reopen the CS_Demo database. If you
remembered to save the form, you have five
queries, ranging from eight to 123 hits. In the
examples below, the queries have been renamed to
indicate the search criteria.
Before you start, go to the View menu and activate
the Structure window. The Structure window gives
you a way to display structures without taking up
room on the form.

330 ChemFinder Tutorials CambridgeSoft


Tutorial 6: Using BioViz
To create a plot of a hitlist: Experiment with pointing to the data points on the
1. Select the first query, Formula: C6N1-2 . Right- graph. Note that as you hover over a data point, its
click and choose Restore Query. structure appears in the Structure window.
2. On the View menu, point to Plots and choose Likewise, if you browse through the database, the
New. corresponding point is highlighted in red on the
The Plot Properties dialog box appears. plot.

To select a database record from the plot:

Click a data point.

The database display jumps to the data record


selected.

Return to the database form to view the result. To


plot another query:

1. Double-click the first structure query from the


3. Select the One Variable radio button.
list in the Explorer window. This is the query
The X-coordinate is grayed out and the Scatter with 123 hits.
Plot style is selected by default.
4. Select MolWeight from the drop-down menu The plot changes to display the new data set.
for the Y-coordinate.
2. This plot is a bit cluttered. Select the Zoom
5. Click the OK button. radio button at the bottom of the plot and drag
The Plot appears in a new window. over the first twenty data points.

Chem & BioOffice 2006 /ChemFinder ChemFinder Tutorials 331


Tutorial 6: Using BioViz
When you release the mouse button, the plot 2. Make some space on the right side of the form
expands to show the points selected. by rearranging the data boxes and making them
smaller.
Administrator

3. Click the Subform tool .


4. In the form, drag to create a large subform.
To restore the original scale:
Click the icons at the ends of the scroll bars. TIP: If you cannot make room on the right side of your
form, you can put the subform at the bottom of the form.
Tutorial 7: Working with
When you release the mouse button the
Subforms Subform Properties dialog box appears.
Subforms allow you to display relational data. If you 5. Select Synonyms from the hierarchical tree
have a database containing two or more data tables, display.
and these data tables share a common, linking field, 6. Click the Form tab.
then you can display data from both tables.
7. Click the Generate form checkbox, and click the
Whenever the value of the linking field changes in
Style button.
the main form, the subform only displays those
records from its table which have the same value in 8. Select the Plain form, and deselect all of the
the linking field. You can also use subforms to fields to be included except Synonym. Click OK.
display data from different databases. You are returned to the Subform Properties
dialog box.
In this tutorial, you open the CS_Demo database
and display the MolTable in the main form. Then 9. Click the Subform tab.
you display the Synonyms table of the CS_Demo 10. SYN_ID already appears as the default in the
database in a subform. By defining the MOL_ID Link to Synonyms field section. Using the drop-
field as the linking field, you display the two sets of down menu, choose MOL_ID for the Link from
data relationally. MolTable field.
11. Click OK.
Creating a Subform
You have just selected the data source for your
1. Open your ChemFinder form tut1.cfw. subform and linked it to the main form.
Opening this form connects you to the The MOL_ID field links the main form and
CS_Demo.mdb database. subform. Clicking in either form activates it.

332 ChemFinder Tutorials CambridgeSoft


Tutorial 7: Working with Subforms
To test this: To display all of the synonyms:
1. Click anywhere outside the subform box, and 1. Toggle out of Layout mode .
browse your database using the Record tools. 2. Double-click in the subform box to switch to
As each molecule record of the MolTable is Table view.
displayed, the subform shows the first
matching ID from the Synonyms table.

2. Click inside the subform box.


Now when you browse, you are browsing only
the entries in the subform.

Save and close the file:


1. From the File menu, choose Save.
2. From the File menu, choose Close.
Congratulations! You have completed the
ChemFinder Tutorials.

Chem & BioOffice 2006 /ChemFinder ChemFinder Tutorials 333


Tutorial 7: Working with Subforms
Administrator

334 ChemFinder Tutorials CambridgeSoft


Tutorial 7: Working with Subforms
Chapter 15: Creating and Editing
Forms
Overview The first step in designing a form is selecting the
database and deciding which fields to include.
You use forms to interact with information in a
database. A ChemFinder form is composed of data Selecting a Database
boxes for viewing or modifying data items, such as
A ChemFinder form does not store data directly,
structures, numbers, text, or pictures. A form can
but is simply the window through which you look at
also contain subforms for relational access to
data. When creating a form, you need to specify the
different data tables and different databases.
source of the data to display. A form displays data
You can create a form in the following ways: from a single table in a database. To specify the data
source for a form, you must open or create a
Automatically, using the Form Generator database, then select a table.
dialog box.
If you want to view data from more than one table,
Manually, using the Form tools.
you must create a form for each table. Typically, you
With the Database Tree. create a main form for one main table and a
subform for each other table. For more
The example below shows a form displaying a
information, see Chapter 16, Relational Data and
single record of information from a database.
Subforms on page 361.
You can connect a database to the form before
creating boxes, or any time after. If the form is
already connected to a database, you can change the
database or the data source. If the form has boxes
with fields connected to them, then the boxes
automatically connect to fields of the same name in
the newly-opened database.
Creating a form consists of creating a layout (see
Creating Forms Manually on page 340), and Opening an Existing Chem-
setting box properties (see Creating and Editing ical Database
Tabs on page 344), tabs (see Editing Forms on
page 352), and security (see Securing Forms on To open a database to associate with a form:
page 356).
1. Right-click on the form and select Data Source.
You can edit your form at any time (see Editing
Forms on page 352 and Changing the Layout of The Form Properties dialog box appears.
an Existing Form on page 354). 2. Click Open Database.

Chem & BioOffice 2006 /ChemFinder Creating and Editing Forms 335
Selecting a Database
The Open dialog box appears. To choose the data box to display:

1. Right-click in a box or frame, then click Field.

The Field properties appears.


Administrator

2. From the data source tree, select the field to


display.

3. In the Open dialog box, choose a database


with an .mdb file extension, then click Open.
The Form Properties dialog box reappears.
The CS_Demo database is shown below.

3. Click OK.

The field data is displayed in the box.

If you use this method with a framed box, the box


label will remain unchanged. If you want to use the
field name as the box label, you can do it in one step
as follows:

1. Right-click in a framed box.


A data source tree appears in the left side of the
Form Properties dialog box, displaying the 2. Select the field name from the list at the
fields and their tables. bottom of the context menu.
4. Click OK.
The frame receives the field name and the data
The database is associated with the form. is displayed in the box.

Selecting the Data to Display


You indicated the source of the data to display on
the form, but the form is still blank. To see the data,
you need to indicate what data to show in each box.
You can use the Box Properties dialog box, as
described in Setting Box Properties on page 44.

336 Creating and Editing Forms CambridgeSoft


Selecting a Database
Opening a Secured MS 3. Select the Users or Groups radio button to
assign permissions to individuals or groups.
Access Database
4. Select an Object Type from the drop-down
To open a secured Microsoft Access database in menu.
ChemFinder, you need to set the appropriate 5. Select the permissions you want to assign for
permissions in Access. that object type to each user or group.
6. Click Apply.
NOTE: If your database was created in MS Access 97 (as, 7. When you have finished assigning permissions,
for example, were some of the ChemFinder sample click OK.
databases), and you are using a newer version of Access, you 8. Open the database in ChemFinder.
must convert the database before you can edit it. These
instructions assume a database created in Creating a Database
Access 2002.Other versions may differ slightly as to options
and procedures. You can create a new, empty database and associate
it with a form.

To set the permissions: To create a database:


1. Open an existing form, or create a new one.
1. Open the desired database in MS Access.
2. Right-click in the form and select Properties.
2. On the Tools menu, point to Security, then
The Box Properties dialog box appears.
choose User and Group Permissions.
3. On the Box Properties Database tab, click
Create Database.
The Save As dialog box appears.

4. In the File Name box, type a name for your


database, then click Save.

Chem & BioOffice 2006 /ChemFinder Creating and Editing Forms 337
Selecting a Database
A data source tree appears, containing the
database and its tables and fields.
Administrator

4. Click the Generate form checkbox, then click


Style.
5. Click OK. The Form Generation dialog box appears.
The Box Properties dialog box closes.

Creating Forms Auto-


matically
ChemFinder provides a Form Generation dialog
box from which you can automatically create a
form. You choose the form style and properties
from pre-defined options.
To begin creating a new form:
1. Open an existing database. 5. In the Choose Fields to be included section,
click the field names to include.
2. Right-click on a blank area of the current form
and choose Data Source. 6. To have a Structure box created in the upper
The Form Properties dialog box appears. left corner of the form, click the Structure in
upper left of form checkbox.
3. In the Form Properties dialog box, select the
Form tab. If you do not select this option, the boxes are
generated in the order they appear in the list.
7. Select the form style:

If you want the Then, in the


boxes to Form style
section, click

be surrounded by a Framed.
frame

338 Creating and Editing Forms CambridgeSoft


Creating Forms Automatically
Saving a Form
If you want the Then, in the
boxes to Form style In most non-database applicationsincluding
section, click ChemDraw and Chem3Dyou edit data on the
screen, but your changes are not made permanent
be labeled above Titled. until you choose Save from the File menu.
In database programs such as ChemFinder, your
be labeled to the left Labeled. changes are automatically and permanently saved to
the database when you switch records. This is
not be labeled Plain. committing the changes. You then have the
opportunity to revert to the original data by
8. Choose the number of columns, between one choosing Undo Changes from the Record menu.
and four.
The Save command in the File menu refers only to
9. Choose the size and spacing of the boxes and changes made on the form itself, such as the position of
grid: boxes. Choosing the Save command from the File
menu has no effect on changes you make to data
If you want the Then, for Grid stored in the database. Saving a form also saves
boxes to be Size, choose subforms and changes that you make to subforms.
After you create a form, you can save it. When you
larger and spaced further Large.
retrieve the saved form, it automatically opens a
apart
connection to the database defined in the forms.

medium, relative to the Medium. To save a form:


Large and Small settings
1. From the File menu, choose Save. To save the
form under a new file name, choose Save As.
smaller and spaced closer Small.
The Save dialog box appears.
together

10. Click OK.


Your form settings are saved.
11. Click OK.
A Warning dialog box appears allowing you to
create a new form or replace the existing form.
Click No to create a new form.

2. Choose the directory in which you want to save


The generated form appears in the window. the form, type a filename, and click Save.

Chem & BioOffice 2006 /ChemFinder Creating and Editing Forms 339
Creating Forms Automatically
ChemFinder saves the form with a .cfw A blank form, Form1, appears.
extension

Creating Forms Manu-


Administrator

ally
You create a form and define it by using the Form
tools to create objects and the Box Properties
dialog box to set the form properties. Using the Grid
In a new form, the snap grid is turned on by default.
Using the Form Tools This grid helps you align boxes on the form.
Turning on the grid forces objects to snap to the
You must use the Form Tools toolbar to design a grid as they are drawn.
form. Box creation commands are not available
from the menu. To toggle the grid on or off, do one of the
following:
To display the Form tools, do one of the following:
Click the Grid tool on the Form toolbar.
Click the Layout icon on the Main toolbar. From the View menu, choose Grid.

From the View menu, point to Toolbars, and NOTE: You can change the grid spacing using the
click Form. Preferences dialog box. See Setting Preferences on page
429.
The Form toolbar appears providing tools for
you to create and edit a form.
Creating Boxes
Selection tool Frame Text Button Checkbox
A ChemFinder form is composed of a collection of
boxes that display data. Each box displays one data
item of the current record. To create a data box, use
one of the tools on the Form toolbar.

NOTE: The Form toolbar is not visible unless the Layout


Data box Framed box Picture Subform Grid
button is selected.

Creating a New Form The Data Box displays a data item or structure. You
can use it to display any data from a database,
To create a new form:
including text, numbers, dates, molecules, reactions,
or pictures. It is the only box that allows you to edit
From the File menu select New, or click . data in the database. Data boxes do not have labels,

340 Creating and Editing Forms CambridgeSoft


Creating Forms Manually
but you can label them by adding a Frame or Plain The Enter the label dialog box appears.
Text. You can also use the Data Box to display static
data not from a database.

To draw a Data Box:

1. Click the Data Box tool .


2. On the form, press and drag diagonally to 4. Type the label you want to attach to the frame.
create a box. 5. Click OK.

A fixed label appears on the frame.

To change a label:

1. Right-click on the edge of a frame and choose


Label.

2. Enter the new label as above.

Another way to change a frame's label is in the Box


To specify what type of data is displayed in the box, Properties dialog. For more information, see
see Creating and Editing Tabs on page 344. If the Creating and Editing Tabs on page 344.
form already has a database open, you can right-
click in the data box, select Field... and choose from You can use a frame to show live data from the
a list of the available fields. database. If a frame is connected to a database field,
it is updated automatically as you browse or search.
Creating Frames For example, you might place a frame around a
structure field, where the label on the frame
The Frame tool allows you to create a label represents the name of the current structure. The
label changes every time the structure does. You
surrounding a data box or group of boxes. When
must use Box Properties to set up a live data
you draw a new frame, you are automatically
connection for a frame.
prompted for a text label to be attached to it.

To create a frame: Creating Boxes with Frames


The Framed Box tool allows you to create a data
1. Click the Frame tool .
box and a frame simultaneously. You name the
2. On the form, press and drag diagonally to frame in the Enter the Label dialog box.
create a frame.
When you create a data box and frame with the
A framed box appears with the label Data. To Framed Box tool, these two items are connected.
change the label: To manipulate them separately:
3. Right-click on the label and choose Label from Select the Framed box and from the Edit
the drop-down menu. menu, choose Bring to Front.

Chem & BioOffice 2006 /ChemFinder Creating and Editing Forms 341
Creating Forms Manually
To create a framed data box: To automatically label a frame:

1. Click the Framed Box tool . 1. Right-click the frame label and select Properties.

2. On the form, click and drag to create a box. 2. On the Box Properties tab, select a field from
Administrator

the data tree. The field name will appear in the


3. In the Enter the Label dialog box, type the text box under Data Source.
label you want to attach to the frame, and click
OK.

The framed data box is labeled.

NOTE: If the text box is grayed out, you have not


clicked on the frame label.

3. Click OK.
To edit the label of a framed data box:
The frame label changes to match the field
1. Select the frame by carefully right-clicking near name selected.
the edge of the framed box and select Label.
4. Right-click in the data box and select the field
2. In the Enter Box Label dialog box, type the from the drop down list that corresponds with
new label. The label does not have to match the the new label.
name of the field displayed in the box.
NOTE: When you change a label from the Box Properties
3. Click OK. dialog box, the label and the data box are treated separately.
You must update the data box manually to match the label.
Automatic Labels

You can let ChemFinder automatically label your Adding Plain Text
framed box with the name of the field from the data
tree. This works slightly differently depending on The Plain Text tool allows you to display text
whether you created a box and added a frame, or without a box or a frame. You can use it to place a
created a framed box. static label on the form. But, like a frame, you can
use it to display live data if desired.
To automatically label a framed box:
To use the Plain Text tool:
Right-click inside the data box and select the
field from the drop down list. 1. Click the Plain Text tool .
The data appears in the data box and the frame 2. On the form, click and drag to create an area to
label changes to match the field name. specify where the text will appear.

342 Creating and Editing Forms CambridgeSoft


Creating Forms Manually
The Enter the Text dialog box appears. Adding a Checkbox
The Checkbox tool allows you to add checkboxes
to your form. A Checkbox can be assigned to either
a Boolean or an Integer field.
To add a checkbox:

3. Type the text you want to display. 1. Click the Checkbox tool.
4. Click OK. 2. On the form, drag an area large enough for the
text next to the checkbox.
The Enter the Label dialog box appears.
3. Type in the text and click OK.
4. Right-click, and assign the box to a field.

Adding Pictures
To change the font or color of the text, select it with The Picture tool allows you to create a Picture Box
the Form toolbar Selection tool . Use the text to display a Windows metafile. It can display a static
metafile stored in a.WMF file, or a live one stored in
formatting toolbar to customize the text. a picture column of a database.
Adding a Button To create a Picture Box:

To place a button on a form: 1. Click the Picture tool .


2. On the form, drag to create an area for the
1. Write a script using the ChemFinder
picture to occupy.
Automation Language (CAL).
The Open dialog appears.
2. Click the Button tool on the Form toolbar.
3. In the Open dialog box, select the Windows
3. On the form, click and drag to draw a button.
metafile (.wmf) you want to display, then click
The Enter the Label dialog box appears. Open.
The picture appears in your form.

4. Enter a label. The text can be descriptive


(Click to browse) and does not have to corre-
spond to the name of the script. Click OK.
NOTE: The metafile is not actually embedded in the form.
For more information about using a button to run Only its filename is saved with the form. If you move or
a script, see Using Scripts on page 437. rename the metafile, the form will not display the

Chem & BioOffice 2006 /ChemFinder Creating and Editing Forms 343
Creating Forms Manually
corresponding picture. However, if you make changes to the
picture and keep its filename the same, the picture in the form
will be updated.
Tabs
Administrator

To read in a picture file or to replace a picture in a


Picture Data Box:
To rename a tab:
1. Right-click a picture and choose Read File.

The Open dialog box appears. 1. Right-click the tab and choose Rename Tab.

2. In the Open dialog box, select the metafile you The Tab Name dialog box appears.
want to display in the Picture Data Box, and
click the Open button.
The new metafile replaces the picture in the
Picture Data Box.

To save a metafile from a Picture Data Box:


2. Type a name for the tab and click OK.
1. Right-click on the Picture Box and choose Save
The new name appears on the tab.
File.
To remove a tab:
2. In the Save As dialog box, type a file name then
click Save. Right-click the tab and choose Delete Tab.
The picture is saved to a file in Windows The tab is removed.
metafile (.wmf) format.
Creating Forms with the
Creating and Editing Tabs Database Tree
If you have a large number of fields in a database,
The Database Tree is the same familiar tree as in the
you can access information more easily, and make
Database Properties dialog, showing the tables
the form less cluttered, by using tabs to divide a
(or views) and columns of the currently-open
long form into smaller parts contained on separate
database. When you open or activate a form or
tabs.
subform, or change databases, the tree updates to
display the current database, and expands to show
To create tabs on a form:
the columns of the currently-selected table.
1. Right-click an empty part of a form and choose
To view the Database Tree (if it is not visible):
Add Tab.
1. Choose Explorer Window from the View
Two tabs appear in the lower left corner of the
menu.
form. Clicking on the second tab will present
you with a new empty form. 2. Click the Database tab.

344 Creating and Editing Forms CambridgeSoft


Creating Forms with the Database Tree
To use the Database Tree to build a form: The Box Properties dialog box appears.
1. Open a new form.
NOTE: The Properties option is only available in
2. Right-click in the form, and choose Data Layout mode.
Source.
3. Click the Open Database button on the Data-
base tab.
4. Select a database, and click Open.
5. Click OK in the Form Properties dialog box.
The Database Tree displays the database.

Setting Data Box Styles


You can use the Box Properties dialog box to
6. Double-click the Structure field. change the style of a data box on a form. For
example, you can change a data box to a frame or
A structure box appears in the upper left of the
picture.
form.
The Box Style menu only shows applicable styles
for each field. For example, you cannot show a real
number in a Picture.
For information about field types, see Creating
Fields on page 374.
You can choose from the following styles:
Data Boxdisplays alphanumeric data. Can
7. Continue double-clicking the other fields. display multiple lines of data.
8. Use the Selection tool to move the data boxes Framedisplays alphanumeric data. Can
to where you want them in the form. display a single line of data.
Plain Textdisplays alphanumeric data. Text
Setting Box Properties data can be displayed in multiple lines. (Use
Use the Box Properties dialog box to set Ctrl+Enter to start a new line.) You set the
ChemFinder form attributes, including: data field size when you create the field, up to a
source, display type, font, and box style. maximum of 254 characters.
Picturedisplays Windows metafile data.
To open the Box Properties dialog box: Pictures are scaled to fit within picture boxes,
Right-click on a data box and choose Properties. with fixed height to width ratios.

Chem & BioOffice 2006 /ChemFinder Creating and Editing Forms 345
Setting Box Properties
Formuladisplays any kind of text but To set the box style:
numbers are subscripted. Formulas are 1. Right-click in the data box to change and
presented in modified Hill order, as follows: If choose Properties.
a substance contains both carbon and The Box Properties dialog box appears.
Administrator

hydrogen, the carbons are listed first, followed


by the hydrogen atoms, followed by other
elements alphabetically by element symbol. If a
substance contains carbon, the carbons are
listed first, followed by other elements alpha-
betically by element symbol. Otherwise, all
elements are listed alphabetically by element
symbol.

Buttonused to create buttons to actuate


scripts. Buttons display button labels.
2. From the Box Style menu, choose the box
Rich Textdisplays styled data in multiple
style.
lines. (Use Ctrl+Enter to start a new line.) You
3. Click OK.
can format text with the Text Format toolbar.
If the data in a field contains rich text, markup Viewing Structures
characters are displayed.
You can display structures in a structure box in
Structure (ChemDraw style)displays chem- ChemFinder, ChemDraw, or Chem3D styles. The
ical structures or reactions. Reactions are laid Chem3D style is a display only format that allows
out for best fit with the box and the layout may you to rotate and analyze structures within a
ChemFinder structure window. See the Chem3D
change if the box is reshaped. The box defaults
Users Manual for information on using the
to using the ChemDraw ActiveX control to Chem3D ActiveX control.
create and edit structures, but you can reset the
If you choose ChemFinder style, ChemDraw will
preference. For more information, see Setting
open when you want to edit structures or create a
Preferences on page 429. query. If you choose ChemDraw style, editing is
Structure (ChemFinder style)as above, but done in the structure box using the ChemDraw
ActiveX control.
defaults to opening ChemDraw to create and
edit structures. The ChemDraw format displays more graphically-
rich drawings than the ChemFinder format.
Structure (Chem3D style)as above, but However, ChemFinder does not use all of the
defaults to display 3D structures. Chemdraw drawing features when searching.

346 Creating and Editing Forms CambridgeSoft


Setting Box Properties
For example, textual annotations are ignored, control. When you point inside the Structure Box,
R-group tables are not recognized. Certain the cursor becomes a hand that lets you grab and
graphics, such as rectangles and orbitals, are not rotate the structure.
transferred. and ChemFinder does not consider
their chemical implications.
To choose how to view structures:
1. Right-click in a structure data box and choose
Properties.
The Box Properties dialog box appears.
2. On the Box tab, in the Box Style section, select
the structure format to view from the menu:

If you want to Then choose Dragging within the structure allows you to freely
rotate the structure.
edit in the Structure Structure (ChemDraw
box using the Chem- style).
Draw ActiveX
toolbar

edit in ChemDraw Structure (ChemFinder


style).
Dragging the cursor across or up and down rotates
insert 3D images Structure (Chem3D the structure around the X and Y axes . To rotate
style). around the Z axis, drag outside the structure.

Right clicking displays a menu that allows you to


Viewing Structures in Chem3D Format modify the display.
Unlike the ChemDraw and ChemFinder styles,
Chem3D style is view only. You cannot edit the
structures in Chem3D style. Double clicking in the
Structure Box activates the Chem3D ActiveX

For more information on the Chem3D ActiveX


control, see the Chem3D Users Manual.

Chem & BioOffice 2006 /ChemFinder Creating and Editing Forms 347
Setting Box Properties
Setting Fixed and Live Data The Choices tab appears.

In the Box Properties dialog box, you can


designate whether the data source is fixed or from a
Administrator

field. Fixed data is attached to the form and does


not change as you browse. Data from a field is
stored in the database and is different for each
record. As you browse, the record display updates
according to the contents of the field.

To specify live data for a data box:

1. In the Box tab, select the field to associate, then


click Field. 3. Take the appropriate action:
2. Click OK.
If you want to Then click
The box display updates as you change records.

To specify fixed data for a data box: use a list from a data- From table and follow
base table as the data the instructions at the
1. In the Box tab, select the field to associate, and box menu bottom of the dialog
click Fixed. box.

2. Type a label. If you choose a structure or


create your own list Fixed list of choices
picture field, click to browse to the file to
for the data box and follow the
display.
menu instructions at the
3. Click OK. bottom of the dialog
box.
The box display is fixed.
use a list from a data- a. From table. A
Adding a Data Box Menu base table and add list appears.
your own items to the
You can add a menu containing a list of choices to b. Click Fixed list of
data box menu
a data box so you can choose an item from it to choices, and edit
appear in the data box. the list.

To add a menu: 4. Click OK to close the dialog box, then click in


the data box.
1. Right-click on a data box and choose Properties. A button appears in the lower right corner of
The Box Properties dialog box appears. the box when you click in the box.

2. On the Box tab, click the With drop-down


choices checkbox.

348 Creating and Editing Forms CambridgeSoft


Setting Box Properties
5. Click the button to display the menu. To set when boxes are hidden:
1. Right-click on the box and choose Properties.
2. In the Box Style area, select Hidden in Browse
Mode or Hidden in Query Mode.
3. Click OK.
6. Select any item on the menuthe text appears
4. Deselect the Layout Mode button to view the
in the top left corner of the box and the button
results.
disappears.
Click within the data box to make the button Customizing Text
reappear.
You can customize text fonts, sizes, styles, colors,
Adding Scroll Bars and alignment in form boxes using the Text Format
toolbar. All of the standard text formatting options
You can add scroll bars to a data box so you can are available.
scroll through any additional data that is not visible
To display the Text Format toolbar:
within a data box.
From the View menu, point to Toolbars, then
To add a scroll bar: select Text Format.
1. Right-click a data box and choose Properties. The Text Format toolbar appears.
The Box Properties dialog box appears.
NOTE: Text copied from a word processor such as
2. In the Box style section, select With scroll bars. Microsoft Word retains its styles when pasted into a Rich
3. Click OK. Text box.
The scroll bar appears on the bottom right in
the data box. The text format toolbar is active:
When you are editing a memo field in a rich
text box. In this case, font changes apply only
to the current selection within the text.
need a graphic here of a data box with scroll bar.
When you are editing in a regular data (or struc-
ture) box. Font changes apply to the entire
contents of the box.
Hiding Data Boxes When you are in form edit mode, with the
selector tool active, and one or more boxes are
You can show or hide boxes when switching selected. Font changes apply to all selected
between query and browse mode. For example, boxes (except frames around data boxes).
hide data boxes when you want hide non-searchable
boxes during query entry. Show data boxes to Customizing Fonts
display information useful for query entry.
All the labels on ChemFinder objects can be edited
When you are in form layout mode, all boxes are to your specifications. You can edit any labels font,
visible, regardless of the setting. font style, size, and color.

Chem & BioOffice 2006 /ChemFinder Creating and Editing Forms 349
Setting Box Properties
To set the font for a label: To specify the numeric format:
1. Click Font. 1. Right-click on a data box containing numeric
The Font dialog box appears. data and choose Properties.
Administrator

The Box Properties dialog box appears.

2. Set the text font, style, size, and color.


The sample area previews the font.
3. Click OK to commit the changes.
2. Click Format.

NOTE: To change the color of the atom labels in the The Numeric Format dialog box appears.
structure box, you must use the Periodic Table. See Using
the Periodic Table on page 434

Customizing Numbers
Using the Box Properties dialog box, you can
specify how numeric data is displayed in forms you
can customize the following properties:
Currency symbol
Decimal position
Scientific notation 3. Select the appropriate option:

If you want to Then click


display

a varying number of Unformatted.


decimal places

a currency symbol Currency and select


the symbol from the
drop-down menu.

350 Creating and Editing Forms CambridgeSoft


Setting Box Properties
The Form properties appear.
If you want to Then click
display

the currency symbol Symbol on right when


to the right of the a currency symbol is
number selected.

a standard Fixed point and select


floating-point value the number of
with a selected decimal places.
number of decimal
places
3. Take the appropriate action:

the numbers Scientific and select


displayed in scientific the number of To set the Click
notation decimal places. background
color of the
An example of the format you select is shown
in the Sample area of the dialog box. form Form Background.
4. Click OK.
The format is applied to the current data box. form in query mode Query Background.

Setting Color The Color dialog box appears.


You can set the following color options:
The form background color
The color of the form in query mode
The default background for all forms
To set the form background and form query colors:
1. Right-click on a data box and choose Properties.
The Box Properties dialog box appears.
2. Click the Form tab.

4. Select a color.
5. Click OK.
The Form or Query Background button
changes to reflect the color you choose.

Chem & BioOffice 2006 /ChemFinder Creating and Editing Forms 351
Setting Box Properties
To set the default background color: Press the Shift key and click on the multiple
objects.
1. From the File menu, choose Preferences.
Drag the Selection tool around the boxes
2. In the Preferences dialog box, click Color.
you want to select.
Administrator

3. On the Color tab, click Form Background.


To select all the objects in the form:
4. In the Color dialog box, select a color and click
OK. From the Edit menu, choose Select All.
The color you chose becomes the default form
background color. Moving Objects
Editing Forms You can move data boxes or any other object to a
different place on a form with the Selection tool.
You can move or resize boxes and other objects on
your form with the Selection tool and the items in To move objects on a form:
the Edit menu.
1. On the Form toolbar, click the Selection
tool .
Selecting Objects on a Form
2. Select the objects to move.
You can use the Selection tool to choose data boxes
and other objects on a form so you can move, 3. Drag the objects to a different place.
resize, or delete them.
NOTE: To move a subform, you must click- drag the title
When the selection tool is active, the Edit menu bar of the subform, not its contents.
commands apply to the boxes themselves. When
the selection tool is not active, the Edit Menu
commands apply to the contents of the active data To move objects one pixel at a time:
box.
1. Select the objects you want to move.
To select an object on a form: 2. Press an arrow key in the direction you want to
On the Form toolbar, click the Selection move the objects.
tool , then click an object on the form to The objects move one pixel in the direction of
select it. the arrow key.
A highlight appears around the object
indicating that it is selected. Resizing Objects
You can resize a data box or any other object by
Selection Marks
stretching it with the Selection tool.

NOTE: You cannot resize more than one object at a time


To select multiple objects on a form: or simultaneously resize a box and its frame, unless you
create a framed box using the Framed Box tool. For more
1. On the Form toolbar, click the Selection
information, see Creating Boxes with Frames on page
tool .
341.
2. Do one of the following:

352 Creating and Editing Forms CambridgeSoft


Editing Forms
To resize objects on a form: From the Edit menu, take the appropriate
action:
1. On the Form toolbar, click the Selection
tool .
If you want to Then choose
2. Position the pointer over an edge or corner of
the object until the pointer is a double-headed
arrow. reverse the effect of Undo.
the last change you
made to the form or
object

3. Drag in the direction you want to resize.


reverse the effect of Redo.
Undo
To resize objects one pixel at a time:
1. Select the object you want to resize. NOTE: Undo and Redo work over multiple changes.
2. Place the mouse pointer over an edge or corner Either command can be used repeatedly to reverse multi-step
of the object until it is a double-headed arrow. operations.
3. Press an arrow key in the direction you want to
resize the object. Ordering Objects
The edge of the object moves one pixel in the
direction of the arrow key. You can use the Bring to Front and Send to Back
commands to place data boxes in a specific
Deleting Objects sequence as follows:

You can remove data boxes and other objects from Select which overlapping data box is on top.
a form with the Selection tool or items on the Edit Set the order in which the cursor moves when
menu. you press the Tab key.
To remove objects from a form completely: To put a box on top or bottom:
1. On the Form toolbar, click the Selection 1. Select the box.
tool . 2. From the Edit menu, choose Bring to Front to
2. Select the objects you want to delete. put it on top, or choose Send to Back to put it
3. From the Edit menu, choose Clear. on the bottom.
The object is removed from the form. The order in which data boxes are created is the
order in which the cursor moves as you press Tab.
Reversing and Restoring You can set to which data box the cursor moves
Changes first or last.

You can use the items on the Edit menu to reverse To set the cursor to move to a data box first:
or restore changes you made to a form. 1. Select a data box.
To reverse or restore changes: 2. From the Edit menu, choose Send to Back.

Chem & BioOffice 2006 /ChemFinder Creating and Editing Forms 353
Editing Forms
3. Press the Tab key.
If you want to Then choose
The cursor moves to the box you set.
Administrator

line up along the


To set the cursor to move to a data box last:
middle of an object in Horizontal Center.
1. Select a data box.
a horizontal line
2. From the Edit menu, choose Bring to Front.
The box you set is the last box the cursor right edge of an Right.
moves to when you press Tab repeatedly. object

Aligning and Distributing The form objects line up according to your


choice.
Objects
You can line up objects relative to each other by To evenly space objects on a form:
aligning them and space objects at an equal distance
1. Press the Shift key and click the objects to
apart by distributing them.
distribute.

NOTE: In framed dialog boxes, the inner data box is 2. From the Edit menu, point to Distribute, then
aligned, not the frame. take the appropriate action:

To line up objects on a form:


If you want to Then choose
1. Press the Shift key and click the objects to align. space objects
evenly between
2. From the Edit menu, point to Align, then take
the
the appropriate action:

outer boxes of the Vertically.


If you want to Then choose
form
line up along the

left and right of the Horizontally.


top edge of the first Top.
form
object you place on
the form
The form objects are spaced according to your
choice.
middle of an object in Vertical Center.
a vertical line
Changing the Layout of
bottom edge of an Bottom. an Existing Form
object
You can use the Form Generation dialog box to
left edge of an object Left. automatically change the overall layout of an
existing form.
354 Creating and Editing Forms CambridgeSoft
Changing the Layout of an Existing Form
To change the layout of an existing form: 6. In the Form style section, select the form style:

1. In a form, right-click the background, then


choose Data Source. If you want the Then, in the
boxes to Form style
2. In the Form Properties dialog box, click the
section, click
Form tab.

be surrounded by a Framed.
frame

be labeled above Titled.

be labeled to the left Labeled.

not be labeled Plain.

7. In the Columns list, choose the number of


3. Click Generate new form, then click Style. columns, between one and four.
The Form Generation dialog box appears. 8. In the Grid size list, choose the size and
spacing of the boxes and grid:

If you want the boxes Then


to be choose

larger and spaced further Large.


apart

medium, relative to the Large Medium.


and Small settings
4. In Choose Fields to be included section, click
the field names to include.
smaller and spaced closer Small.
5. To have a Structure box in the upper left corner
together
of the form, click Structure in upper left of form.
9. Click OK.
A message box appears.

Chem & BioOffice 2006 /ChemFinder Creating and Editing Forms 355
Changing the Layout of an Existing Form
10. Take the appropriate action: Setting Security Options
If you want to Then click
To set what ChemFinder form options are available
to users:
Administrator

change the overall layout for Yes. 1. Right-click in the form you want to secure, and
the current form choose Properties.
The Form tab of the Box Properties dialog
create a new form based on No. box appears.
the existing form

Securing Forms
You can control the options available to users of
your forms by setting the security options.
You can also provide the database connection
information used to log on to an MS Access
database. MS Access provides a security system that
allows the creation and management of usernames
and passwords, and the assignment of permissions
to those usernames. MS username password 2. Click Security.
account information is stored in the Workgroup
NOTE: The Security button does not appear if the
Information file (.mdw, .mda). For more
security on your form has been set to not allow access to
information about securing an MS Access database,
the Security options.
see Opening a Secured MS Access Database on
page 337. The Form Security dialog box appears.

The lower left corner of the dialog box


indicates whether security is defined.
3. Type the user name to use for logon in the
Username box.
The Enable button becomes available.

356 Creating and Editing Forms CambridgeSoft


Securing Forms
4. Type the password to use for logon in the Pass-
word box. If you want users Then click
to
Use of a password is optional.
To enforce Workgroup Security in an MS Access
use a username pass- Logon to MS Access
Workgroup Administrator database: database
word to log on to the
Take the appropriate action: MS Access database
(.mdb files)
If you want to Then
be prompted to log on Prompt for database
to a database with a logon
enter a work- Type the name of the MS
group file name Access Workgroup data- username password
base in the Workgroup when the form is open
Information file box.
use a username pass- Protect molecule
word to open the database
browse for the Click File and select the
workgroup file file. molecule database
(.mst files)

NOTE: Enforcing workgroup security is optional. be able to access the Security dialog avail-
Form Security dialog able.
To select the Database Security options you want box
enabled:
Take the appropriate action: encounter all of the Database security.
above options
If you want users Then click
to To select the Forms options you want enabled:

be prompted to log on Password to open


with a username pass- Form
word to open a form

Chem & BioOffice 2006 /ChemFinder Creating and Editing Forms 357
Securing Forms
Take the appropriate action:
If you want users Then click
to
If you want users Then click
to
Administrator

use scripts Can use scripts menu

open or create data- Open/create data-


bases base edit scripts Edit scripts

create forms Create new forms use all of the above Automation
options
open forms Open other forms
To select the Edit options you want enabled:
Take the appropriate action:
edit forms Save changed forms

If you want users Then click


change the layout of a Change form layout
to
form

clear forms Clear


use all of the above Forms
options
delete relational and Cut
structural data
NOTE: The behavior of Forms permissions has changed
from earlier versions of ChemFinder. If you disable Forms copy relational and Copy
permissions you cannot open the Properties dialog box by structural data and
right clicking on the form. You must go to the File menu and multiple table rows to
select Database to open the Properties dialog box. the clipboard

To select the Automation options you want paste relational and Paste
enabled: structural data from
Take the appropriate action: the clipboard

If you want users Then click Perform all of the Cut/copy/paste


to above functions

To select the Browse options you want enabled:


access OLE automa- Allow CAL/OLE
tion writing and Automation access
programming
NOTE: Must be
checked to enable
export to Excel

358 Creating and Editing Forms CambridgeSoft


Securing Forms
Take the appropriate action
If you want users to Then click

If you want users Then click


to search exact structure Full structure
only
browse databases Browse database
records search substructures Substructure
only
view data in forms in a View form as table
table search similar struc- Similarity
tures only
view data in contin- View in continuous
uous view forms view use all of the above Searching
options
edit and view struc- Edit/view structures
tures in ChemDraw in ChemDraw To select the Update records options you want
enabled:
view structures in View structures in Take the appropriate action:
Chem3D Chem3D
If you want users to Then click
perform all of the Browse be able to
above options
update database Update records
To select the Search options you want enabled: records
Take the appropriate action:
add database records Add new records

If you want users to Then click


delete database records Delete records

submit queries Query database


To allow users to import data SDFiles or RDFiles:
records
Click Import data.
use current hit list for Search over current To allow users to export data, including delimited
searching list text files:
Click Export data.
search the entire data- Search over full data-
base To select the Print options:
base

save and manipulate hit Enable hit list tools


lists

Chem & BioOffice 2006 /ChemFinder Creating and Editing Forms 359
Securing Forms
Take the appropriate action: 2. Enter your password, then click OK.

Security is disabled and the defaults are reset.


If you want users to Then click
Security Disabled appears in the lower left
Administrator

corner of the Form Security dialog box.


print a single record only Single record

Print several records Several records


Overriding Security
You can temporarily remove security in order to
Use print preview mode Print preview
edit the security options.

perform all of the above Print To temporarily disable security:


functions
1. In the Form Security dialog box, click
To finish selecting options: Override Security.

1. Click Enable. The Validate Security dialog box appears.

2. Click OK.
NOTE: This form only appears if you entered a password
The options you choose are applied to the when you enabled security. SeeSetting Security Options on
form.
page 356

Disabling Security
You can disable security and reset the defaults.

To disable security and reset defaults:

1. In the Form Security dialog box, click Disable.

The Validate Security dialog box appears.


2. Enter your password, then click OK.
NOTE: This form only appears if you entered a password
when you enabled security. SeeSetting Security Options on You are allowed to edit the security options.
page 356 Security Overridden appears in the lower left
corner of the Form Security dialog box.

To turn the security back on:

In the Form Security dialog box, click Over-


ride Security to toggle security back on. Secu-
rity Enabled appears in the lower left corner
of the Form Security dialog box.

360 Creating and Editing Forms CambridgeSoft


Securing Forms
Chapter 16: Relational Data and
Subforms
Overview You are running a stockroom and you want to
store package sizes and prices in the same place
because they are related. Each chemical may be
Subforms allow you to work with multiple data
available in lots of package sizes, and you
tables in a relational database. You should be wouldnt want to re-draw the structure every
familiar with working with ChemFinder forms and time you added a new package. You can use a
databases before proceeding to subforms. subform so the physical property information
is entered once in the main form and the
Accessing Relational package sizes and prices are entered many
times in the subform.
Data Using Subforms By linking these two data tables with a linking
field you can make these tables relational; one
A subform is a special box within a form that table can interact with the other. The contents
behaves like a separate form file. A subform is used of a linking field are not important, as long as
to display information stored within a database, but they are different for each record in the main
it usually displays data from a different database (or form. Various forms of ID numbers are often
different table within the same database) than the used as linking fields. As you browse through
main form. A subform is usually linked to the main the main form, corresponding records in the
form, so that retrieval of data in the main form also subform appear.
retrieves related records in the subform.
Creating a Subform
Like other types of boxes, you can move select and
resize a subform on the main form. However, you You create a subform, place form objects on it, and
cannot select it by clicking inside it. You must click connect the subform to a database just as you do a
the title bar. When you click inside a subform, you regular form. For detailed information on these
you activate the miniature form inside the box and procedures, see Chapter 15, Creating and Editing
can work within it. Forms on page 335.

Below are examples of subform use: Subform Generator


You have data that is associated in a New in ChemFinder 10: The Automatic Subform
one-to-many relationship. For example, you Generation feature enhances the Form Generation
want to view a chemical structure together with feature introduced in ChemFinder 7, making it
its physical properties, stored in a separate possible to create subforms along with standard
table. data boxes.

Chem & BioOffice 2006 /ChemFinder Relational Data and Subforms 361
Creating a Subform
Generating Subforms Automatically The Subform Generation dialog box appears.

Automatic subform generation is part of automatic


form generation (see Creating Forms Automati-
cally on page 338). link to field
Administrator

1. Open the Box Properties dialog box and link from field
select the Form tab.
2. Check the Generate Form checkbox, then click
Add button
the Style button.

4. For each subform you want to include:


a. Choose a field in the Link from box to specify
the linking field of the parent form.
b. Expand the table you want to display in the
Form generation subform in the Link to box, and select the
linking field of the subform.
c. Click the Add button to append the selected
subform to the list being generated.
The Form Generation dialog box appears. 5. When you have added all subform links, click
the OK button to close the dialog box and
3. Click the Subforms button.
return to the Form Generation dialog.

Subform Changes in Chem-


Finder 9
Creating and linking subforms in ChemFinder has
been simplified, beginning with version 8.5. Users
subforms button of previous versions should note the following
changes:
There is now a single dialog box which sets
properties of both the subform box and its
subform. You set all of the details in one place,
in a single operation.
In the new dialog box, the Database, Table, and
Field tabs reflect the data source of the
subform, not the parent form. The database
tree control in the dialog box also shows
subform data source. You can use the Explorer
window to display the tree control of the
parent data source, if they are different.

362 Relational Data and Subforms CambridgeSoft


Creating a Subform
As before, the Form tab shows properties of the By default, newly created subforms are associated
subform, while the Subform tab shows with the same database as the main form.
properties of the box and the linkage between
the subform and its parent. To use a different database as the data source for
the subform:
When creating a new subform, you get the
same dialog box by clicking within the subform 1. Click the Open Database button.
as by clicking on the box header.
The Open dialog box appears.
For convenience, the dialog box comes up
automatically whenever you create a new
subform box.
After you have created a subform, the subform
tool is deselected. This prevents the frequent
mistake of drawing a subform box, then trying
to draw a data box within it and getting another
subform.

To create a subform:

1. Start ChemFinder and open or create a form.

The form should have at least one data box, 2. Choose a database and click Open.
and be linked to an existing database.
The Database table appears in the tree control.
2. Click the Subform button on the Form The following illustration shows the CS_Demo
toolbar. database.

3. Click somewhere in the form and drag to create


a data box.
When you release the mouse button the
Subform Properties dialog box appears.

3. Select the table to be linked (in this case,


Synonyms).

4. Click the Form tab. Check Generate form. Set


the style if you like.

Chem & BioOffice 2006 /ChemFinder Relational Data and Subforms 363
Creating a Subform
5. Click the Subform tab. The tab should contain Changing the Layout of
reasonable data (Link To SYNONYMS (subform)
= SYN_ID, Title = Synonyms) based on the an Existing Subform
choices made so far. You can use the Form Generator to automatically
Administrator

change the overall layout of an existing subform.


To change the layout of an existing subform:
1. Right-click on the title bar of the subform data
box and choose Properties.
2. Click the Form tab.
3. Select the Generate New Form checkbox, then
click the Style button.
4. In the Form Generation dialog box, click the
checkboxes of fields you do not want to
include. (The default is all fields selected.)
6. Choose Mol_ID from the Link from MOLTABLE 5. In the Form style section, select the form
(main form) drop-down menu. options you want. For a detailed description of
the options, see Changing the Layout of an
NOTE: To use the subform relationally to the main
Existing Form on page 354.
form, the two forms must have one field in common. 6. Click OK.
This Linking Field must share the same data type 7. In the Properties dialog box, click OK.
(text, integer, real) as a field in the main form. The
An alert box appears.
fields do not need to have the same name.

7. Modify box properties as desired. You may


want to change the box title, font, presence of
scrollbars, etc.

8. Click OK. The new subform appears showing


8. Take the appropriate action:
one synonym.

9. Optional: double-click in the subform to If you want to Then click


switch it to table view.
change the overall Yes.
The Subform is connected to the database you
layout for the current
chose.
subform
In this example, when a record is retrieved in the
main form, its Molname is used to search the create a new subform No.
Synonym field of the Synonyms table of CS_Demo.
The subform displays the hits from this search. The subform is automatically changed.

364 Relational Data and Subforms CambridgeSoft


Changing the Layout of an Existing Subform
By default, the table name of the subform is If the subform is not linked to the main form, it
displayed in bold, 8 point Arial font. behaves independently of the main form and is
searched separately.
Working with Subforms
Viewing Subform Data
You must select a subform to work with it. The
subform title bar is highlighted when the subform
in a Table
is selected. After a subform is selected, the toolbars
If you have more than one record in the subform
affect the subform. You can use the Record tools to
associated with a single record in the main form, it
browse the subform and add records.
may be more convenient to view the subform as a
To select a subform: table while you browse through the main form. The
table view shows you the complete list of related
Click anywhere in the subform. records for each entry in the main form.
To return to the main form: To display a subform in Table view:
Click the main form. Select the subform and do one of the
following:
To select a subform box:
Double-click on a record in the table.
With the selection tool, click in the title bar.
From the View menu, point to Data Table,
Searching a Subform and choose In Current Window.
A table view of the records in the subform
You search a subform the same way you search the appears.
main form. You can search a subform and the main
form simultaneously. To return to the Form view, repeat the above action.

To search: Using Scripts in Subforms


1. From the Search menu, choose Enter Query to You can specify a CAL script to be executed when
clear the subform and main form. you click an item in a subform in table view. The
2. Enter a query in the data boxes you want. subform can then be used as a list selection box.
The script can use CAL commands to retrieve the
3. From the Search menu, choose Find. clicked item, and perform an action on it. For more
If the subform is linked to the main form, a information about CAL, see Appendix M: CAL
cleared form appears. The search is executed, Commands.
and ChemFinder returns you to the main form
To specify a CAL script:
where it displays a hit list containing records
related to those that match in the subform 1. Right-click on the subform header and choose
search. You can browse and save this hit list Properties.
just as you would a hit list from a main form
search. The Subform Properties dialog box appears.

Chem & BioOffice 2006 /ChemFinder Relational Data and Subforms 365
Working with Subforms
In Table view, the entries are blue and
underlined indicating that they are hot linked to
a script.
4. Click any of the hot links to run the script.
Administrator

2. In the Table script box, type the name of a CAL


script or click and select a script.
3. Click OK.

366 Relational Data and Subforms CambridgeSoft


Viewing Subform Data in a Table
Chapter 17: Working with Data
Overview Secured accessyou must open the database
with a user name and password. You are
Working with data includes: subject to the security restrictions applied to
the database.
Opening Databases
Browsing Databases NOTE: Earlier versions of ChemFinder cannot read
Creating a Database ChemFinder 7.0 .cfw files.
Creating a Portal Database
Entering Data into a Database Read-Only Access
Editing Data Any of the following conditions determine whether
Changing the Database Scheme a database opens in read-only mode:
You work with data within ChemFinder by entering If the component files (extensions .cfw, .mdb,
it into a database, editing it, and interfacing with .ldb, .mst, .msi) have read-only attributes.
ChemDraw and Chem3D.
If the files are on read-only media, such as
You can perform all of these functions on data CD-ROM.
using the commands in the menus, or you can use
If you select Read-only in the File Open dialog
the buttons in the Record toolbar for most of these
box when you open a form or database.
functions.
When you open a read-only database, the following
Add Commit Omit conditions apply:
Record Changes Record
READ appears in the status line.
You can not modify data in text or structure
boxes.

Delete
NOTE: If only the form (.cfw) file is set to read-only
Undo
Changes Record READ does not appear on the status line and the database
can be modified.
Opening Databases
When you open a database in ChemFinder, you can Multi-user Access
access the data in any of three ways:
If a database resides on a network, more than one
Normal accessyou can read and write data. ChemFinder user may access it at the same time.
Read-Only accessyou can read but not Each user can view, print, or modify records
write data. The database is write-protected. independently of the others.

Chem & BioOffice 2006 /ChemFinder Working with Data 367


Opening Databases
The following table shows how the type of user Microsoft Jet Relational Database
affects the other users in the group. Enginethe database engine that underlies
Microsoft Access enforces security. The user
User type Affect on other users names and passwords are stored in an MS
Administrator

Access Workgroup Administrator database.


Multiple readers in User actions do not affect each For more information on Form access, see
read-only access other. Securing Forms on page 356. For more
information on MS Access security, see Opening a
Secured MS Access Database on page 337.
Multiple writers in All users can read and write. A
normal access user may see another users edits. When you open a form or database that has security
If two users try to edit the same options applied to it, you are prompted to enter a
area at the same time, one is username and password to log on.
alerted that the database is tempo-
rarily locked. When you open a secured MS Access database
from within ChemFinder, a username, password,
and workgroup information file is required.
One writer, The writer, in normal access, is not
Contact your Access Database Administrator for
multiple readers affected by the readers. The
this information.
readers, in read-only access, may
see the writers edits. To open a secured form:
1. In the Validate Form Security dialog box,
If two people are viewing the same record within a type your Username and Password, then click
database, and one person changes the data in that OK.
record, the second person will not see the changes
immediately. The changes will be visible when the
second user switches to another record, then back
to it.

Secured Access
ChemFinder supports the following types of If the form you access includes a secured
security: molecule database, the Database Logon
dialog box appears.
Form accessChemFinder enforces form
access security by requiring a user name and
password, which are stored in the form (.cfw)
file.

Molecule file accessChemFinder enforces


molecule file access security by requiring a user
name and password, which are stored in the
databases .mst file.

368 Working with Data CambridgeSoft


Opening Databases
2. Type your Username, Password, and Workgroup The specified record is displayed.
Information File name (if applicable), then click
OK. NOTE: Record numbers are temporary, referring only to
The form opens. positions within the current list in its current sort order. For
example, if you have done a search that found ten hits, then
Browsing Databases the only valid record numbers are 110. If you want to move
to a specific absolute location in a database, you must run a
You can browse a database using the buttons on the search for a value in a field that identifies that location.
Record toolbar.

First Record Go to Record Last Record The Data Table


Sometimes browsing through a data record set is
more convenient if the data is presented in tabular
format.

Previous Record Next Record


NOTE: You cannot add or modify records while viewing
To Browse: data in a table.
Click First Record to display the first record in
the database. To display data in a table:
Click Previous Record to display the record On the View menu, point Data Table, then
before the currently shown record. choose In Separate Window.
Click Next Record to display the record after the A list window containing the fields and records
currently shown record. in the form appears.
Click Last Record to display the last record in
the database.
You can go directly to a specific record as follows:
1. From the Record menu, choose Go To Record.
The Record Number dialog box appears.

NOTE: The current record number is displayed in the


Status Bar.

To display a particular record in the form:


Click that records entry in the list window.
By default, the fields in the Data Table are displayed
in the order in which they were created.
2. Type the number of the record (within the
current list) to display, and click OK. To reorder the columns in the Data Table:

Chem & BioOffice 2006 /ChemFinder Working with Data 369


Browsing Databases
1. Click one of the column headers to select the 2. Click-drag to adjust the column width.
column.
NOTE: To hide the column, right-click and choose
Column selection indicator Hide Column from the context menu.
Administrator

To resize the row heights in the Data Table:

1. Place the cursor on the dividers in the left


header.
The cursor changes to the icon shown below.

2. Drag that header to a new position.

The cursor changes to the icon shown below.


The new position is indicated with a dashed
vertical line.

2. Click-drag to adjust the row height.

NOTE: To resize all rows, right-click in a column


header and choose Resize Rows to Fit from the context
menu.

To resize the column widths in the Data Table: R-Group Tables


1. Place the cursor on the dividers in the top In Data Table display, you can display a
header. substructure search as table of R-group
substituents.
The cursor changes to the icon shown below.
1. Run a substructure search. You cannot prepare
a table from a full structure or similarity search.

NH

370 Working with Data CambridgeSoft


Browsing Databases
2. Switch to Data Table view. Creating a Database
Instead of opening an existing database, you may
want to create a new, empty one. This procedure
results in a simple database with one table for
storing structures.
To create a database:
1. Right-click and choose Properties.
2. Click Create Database.
The Save As dialog box appears.
3. Choose the directory to which you want to save
3. Right-click in the Structure column, and the database.
choose R-Group Table from the context menu. 4. Specify a name for the database, and click Save.
The following changes occur: ChemFinder creates the database containing one
the topmost structure is replaced with the table (called MolTable) with four fields:
template not exactly the same as the query
you used, but one with Rs attached at all Structure
positions which found substituents. Formula
new columns are generated for all the Rs. Molecular weight
the other rows are populated with the Rs hi.t
Mol_ID
The Mol_ID field corresponds to a column in the
table where a numeric ID is automatically entered
as each structure is registered. The other fields
represent information stored in the structural
portion of the database, linked to the assigned ID.
Molecular formulas and molecular weights are
automatically calculated from a structure. These
internal fields cannot be edited or deleted.
After creating a database, you can create fields for
NOTE: The data in this table is just for display. It is not storing other types of data. It is not necessary to
saved anywhere, nor can it be exported or sorted. create the entire set of fields before working with
the database. You may add more fields later.

Chem & BioOffice 2006 /ChemFinder Working with Data 371


Creating a Database
Creating Tables The Create Table dialog box appears.

There is no limit to the number of tables a database


can contain. You may want multiple tables in a
Administrator

database in order to manage relational data, or


simply to organize different collections of
information in the same place.

A table must contain at least one column. When


you create a new table, ChemFinder creates a 4. Type a name for the new table, then click OK.
numeric column called ID. You can use this column The table appears in the Data Source tree.
to store integer data, or delete it and replace it with
your own columns.

Table names must:

Begin with a letter

Not contain punctuation characters

Not be the same as a table already on display

To create a new, empty table:

1. Right-click and choose Properties.

The Box Properties dialog box appears.


Deleting Tables
2. Click the Table tab. To delete a table from the database:

The Table tab appears: 1. In the data source tree, select the table to
delete.
2. Click the Delete Table button.

3. Click Yes.

The table and all data it contains are


immediately deleted from the database.

CAUTION
You cannot undo a deleted table. Before you delete a table,
create a backup copy of the database to prevent accidental
loss of data. For more information, see Backing up
Databases on page 377.
3. Click Create Table.

372 Working with Data CambridgeSoft


Creating a Database
Attaching Tables from Other 4. From the Files of Type drop-down menu,
choose the type of database you want to access.
Applications
You can use ChemFinder to add chemical NOTE: The list of file types available in the Attach
structures to a database you have already developed. Table Open dialog varies from one computer to another.
If your database was developed in Microsoft The files for which you have drivers installed shown. For
Access, you can open it directly in ChemFinder. example, if the Paradox is not installed, you may not
have Paradox drivers on your system or in the
If you are using another database system such as drop-down list.
FoxPro, dBASE, Btrieve, Paradox, or Oracle, you
cannot open the database directly. You must open
NOTE: If the database type you wish to access is not
or create a ChemFinder database, and use Attach
on the list, it may not be a file-based system, and you
Table to link to tables in the data source. After you
need to connect using ODBC. For detailed instructions,
attach a table, it appears and functions as if it were
see Attaching Files from a Non File-Based
part of your local ChemFinder database.
Database on page 373.
The procedure you use depends on whether the
tables you want to attach are from a file-based 5. Choose the database to access, then click OK.
(Access, FoxPro, dBASE) or non file-based
6. In the tree diagram, click the name of the table
(Oracle) database system.
you want to attach, then click OK.

Attaching Files from a File-Based Data- The Database dialog box appears, showing the
base newly-attached table along with the original
MolTable. The database is ready to use.
To attach a file-based database table:
Attaching Files from a Non File-Based
1. Right-click and choose Properties.
Database
2. Click the Table tab, then click Attach Table.
If the database you want to attach is not file-based,
The Attach Table dialog box appears. such as Oracle, you can attach it using Microsoft's
3. Click Open MS Access Database. Open Database Connectivity (ODBC).

To attach a non-file-based database table:

1. Right-click and choose Properties.

2. Click the Table tab, then click Attach Table.

The Attach Table dialog box appears.


3. In the Attach Table dialog box, click Open
Oracle/ODBC Data Source.

The Select Data Source dialog box appears.

Chem & BioOffice 2006 /ChemFinder Working with Data 373


Creating a Database
Creating Fields
Whether you created a new database or are working
in an existing one, you can add or remove fields in
Administrator

the selected table.

You can choose from the following types of fields:

Text fieldAllows you to enter text such as


names, comments, and references. A text field is
fixed in length, and requires that you choose a
maximum length (width) for any data item to be
4. From the Machine Data Source tab, select the stored in the field. If you enter a width of 50, then
ODBC data source to access, then click OK. you cant store any item with more than 50
NOTE: The ODBC data source dialog box shows all characters in that field.
data sources known to ODBC, including ChemFinder,
You can specify widths of text fields as large as 254
Access, and other file-based data sources. If you attempt
to open one of these through the ODBC dialog, you get characters. If this is insufficient, you need to create
an error message. File-based data sources must be a Memo/Rich Text field instead.
opened using Open Database, as described above.
Because the text field width cannot be modified
after a field is created, it is often wise to err on the
NOTE: If the ODBC data source dialog does not side of caution and make it longer than you need
show the database you seek, you may need to create a initially. On the other hand, larger field widths also
new data source. You can do this using the New button.
create larger files and slower search times.
For details, click the Help button in the ODBC dialog
box.
NOTE: Non-ASCII characters will not display correctly
5. If you are prompted for a user name and pass- in a data table text field.
word, enter it. If you don't know what name
and password to use, see your System Admin-
istrator. Integer fieldUsed for whole numbers such
6. Click on the name of the table you want to as ID's. All integers in ChemFinder are long, so can
attach, then click OK. accommodate billions of values (232 of them).
The source of the data to display on the form is
indicated, but the form is still blank. To access the Double fieldUsed for real numbers such as
data, you need to draw some data boxes, and physical constants and unit prices. Real numbers in
indicate what data to show in each of those boxes. ChemFinder are double-precision.

374 Working with Data CambridgeSoft


Creating a Database
Picture fieldAllows you to store a Windows Structure fieldConsists of four fields: a
metafile, such as a spectrum or experimental setup, numeric ID stored in the relational database, plus
as a data item in a database. three fields (Structure, Formula, MolWeight) that
take data from the ChemFinder structure database
NOTE: A Picture box on a form may be used to display a files.
static, decorative picture attached to the form, or it may be
used to show pictures stored in the database which change as BooleanUsed with checkboxes. When searching
you move from record to record. Boolean fields, you can only search for ON. This is
because ChemFinder automatically clears all fields
when activating the Queries form.
Memo/Rich Text fieldUsed to display text.
Memo fields can be of any length. Because memo You can create more than one set of structure fields
fields are less structured, searching them can be in a table. Each is assigned a unique set of names,
slower than searching a text field. Additionally, and each refers to its own ID column in the table,
memo fields cannot be sorted. although all structural data is taken from the same
To search for text: structure database files.

1. Right-click in a memo or plain text field. To create a field:


2. Select Find Text.
1. Right-click on a data box and choose Properties.
The Find Text dialog box appears.
The Box Properties dialog box appears.
2. Click the Field tab.

The Field properties appear.

3. Enter the text and the match conditions.


4. Click Forward or Backward to search.
5. Click Find Next on the context menu, or use F3
to search for the next occurrence.
Memo fields can store Styled Text. For more
information, see Styled Text on page 383.
Date fieldAllows you to store dates. The
dates are displayed according to the settings in the
Windows Regional Settings control panel. 3. Click Create Field.

Chem & BioOffice 2006 /ChemFinder Working with Data 375


Creating a Database
The Create Field dialog box appears. The structure displayed as a diagram.
The Molecule ID, which connects the structure
to a record in a relational table.
The formula derived from the structure.
Administrator

The molecular weight derived from the struc-


ture.
To create multiple structure columns in a table:
1. From the File menu, choose Database.
The Form Properties dialog box appears.
4. In the Name box, type a name.
5. In the Type box, choose a data type.
6. For text fields only, in the Width box, choose a
width.
7. Click OK.
The name of the new field appears in the data
source tree.

Deleting Fields
Just as you can create any field and assign it to a data
box at any time, you can modify the database by
deleting fields from the selected table. 2. Create or open a database.
To delete a field: 3. Click the Field tab.

1. In the field list, select the field to be deleted. 4. Select the Table in which you want to create
new structure columns.
2. Click Delete Field.
5. Click Create Field.
3. When prompted whether you want to delete
the selected field, click OK to delete it or click The Create Field dialog box appears.
Cancel to leave it unmodified.

CAUTION
When you delete a field, all data contained in the field is
also deleted. You are not warned explicitly about this.

Adding Multiple Structures


You can include more than one structure on the
6. Select Structure from the Type drop-down list.
same form by creating multiple structure columns
in a table. Each structure column you create An uneditable name is assigned to the field.
represents four types of data: 7. Click OK.

376 Working with Data CambridgeSoft


Creating a Database
Four new fields appear in the list and are A complete set of ChemFinder database files is
named to belong to the same set of structure created in the selected location.
columns.
8. Connect the new fields to boxes by Moving Databases
right-clicking on the appropriate data box and
ChemFinder saves only the definition of the form
choosing the field.
and information for connecting to the database.
The actual data are stored in files with .msi and .mst
Adding Structures to
extensions for structure data and in files with an
Non-Chemical Databases .mdb extension for non-structural data. If you want
If you opened a database that you created using a to move a database to another computer, you must
move (for a default ChemFinder database) at least
program other than ChemFinder and you want to
four separate files. This number might be greater if
add structures to it, you can create structure fields
you have several forms that access the same
in any modifiable (non-attached) table.
database.
To create a structure field:
1. Open a database. NOTE: The .msi, .mst, and .mdb files all have the same
file name, but the name of the .cfw files might be different
2. Right click, choose Properties.
depending on how you saved them.
3. Click the table to which you want to add struc-
tures. After you move the database to its new location,
4. Click the Field tab. open your forms to make sure the data source links
have been retained. If ChemFinder cannot locate
5. Click Create Field. the data source and displays an empty form, you
need to use the Database command on the File
The Create Field dialog box appears.
menu to reconnect to the data source.
6. From the Type drop-down list, choose Struc-
ture, then click OK. If the form is connected to a remote data source on
a network, you have fewer files to move. The data
You do not provide a name or other details when
source can remain on the remote machine, and you
you create Structure columns. ChemFinder
only move the .cfw file that contains your form for
automatically creates four columns and names
accessing the data. You may need to reconnect it to
them. These columns contain no data until you
the data source if it is not done automatically. This
enter structures into the database.
situation is common in large organizations where
several people access the same central data source.
Backing up Databases
To back up the current ChemFinder database: Creating a Portal Data-
1. Choose Copy Database from the File menu. base
A Save As dialog box appears. By default, your To carry out certain operations, such as sorting
copy is named YourDatabase_copy.cfw. structural data, ChemFinder needs to create
2. Rename your copy (if you wish), select a loca- temporary tables in a database. This cannot be done
tion, and click OK. in a read-only source such as a data CD.

Chem & BioOffice 2006 /ChemFinder Working with Data 377


Creating a Portal Database
Instead of accessing the read-only source directly, Clearing the form
you can create a portal databasea local, writable Adding new data
database with attachments to the external tables of
Committing the new entries
interest. The portal looks and behaves just like the
Administrator

target database, but without the limitations.


Clearing the Form
ChemFinder creates a portal database when
needed. For example, if you are using a database To begin adding a new record:
CD, perform a search, and attempt to sort by 1. Create a form and link it to a database. For
formula, a message appears that offers to create a more information, see Creating Forms Manu-
local database, attach the current table, save the ally on page 340.
form, and proceed with the sort. If you create the The form should contain all the data boxes you
local database, you can use the new form to get the want to view and edit. The boxes should be
data with full functionality and performance. assigned to their appropriate fields.
When you are using a read-only database, 2. From the Record menu, choose Add New
ChemFinder offers to create a portal database. Record.
ChemFinder does not automatically create a portal 3. All of the boxes in the form are cleared to
database during searching because it would destroy prepare for entering new data. The Status Bar
the hit list. When this happens, ChemFinder is updated to show that you are in record addi-
displays a message. You can manually create a portal tion mode:
database or sort to automatically create one, then
repeat the search.

Entering Data into a Adding New Data


Database To add alphanumeric data:
You enter data into a database by adding a new Click in a box with an alphanumeric field and
record. Adding a new record consists of three steps: type the data.

378 Working with Data CambridgeSoft


Entering Data into a Database
To add a structure: The new record is added to the database.

1. Right-click in a box with a structure field.


NOTE: Selecting Commit Changes (or moving to another
2. Do one of the following: record if you have two or more records) saves the data to the
database. You do not need to select Save from the File menu;
If you want Then right-click and choosing Save saves any changes to the form layout, not
to choose changes to data in a database.

draw a structure a. Edit Structure.


Duplicating Records
ChemDraw opens.
You can create a new record by modifying an
b. Draw the new structure existing one. To duplicate a record:
in the From ChemFinder
From the Record menu, choose Duplicate
window.
Record.
c. From the File menu, You are in Add Mode and the form fills with
select Exit and Return to... data from the previously displayed record.
to insert the structure When you select Commit Changes, you create
into the form. a new record whose fields contain the data on
displayed. Before committing the duplicate,
import a struc- a. Read Structure. you can modify fields or structure and commit
ture changes just as you would with any other new
b. Select the file to insert
record.
and click Open.

The file is inserted into NOTE: When duplicating records, only those fields that
ChemFinder. are visible on the form are duplicated. Data in fields present
in the database but not visible on the form are not copied into
the new record. The new record has a new Molecule ID.
NOTE: See the ChemDraw Users Guide for information
about using ChemDraw.
Undoing Data Entry
Committing the New Data Before committing a new data entry, you can revert
the contents of the form to its previous unmodified
When you finish entering all of the data items, do
state.
one of the following:
Perform another action such as moving to
To undo your changes:
another record or printing. From the Record menu, choose Undo
The record is automatically committed. Changes.

From the Record menu, choose Commit After you commit the changes, they cannot be
Changes. undone.

Chem & BioOffice 2006 /ChemFinder Working with Data 379


Entering Data into a Database
Editing Data (for compounds containing carbon) followed
alphabetically by any other elements. Formulas for
Modifying the data in a database is performed by compounds without carbon are sorted in
directly changing the data items on the form and alphabetical order. Sorting text fields such as
Administrator

committing those changes. molecular name sorts the records alphabetically.

After sorting, the database must be reset to its


NOTE: The Formula and MolWeight fields are original state before you can update it.
automatically calculated by ChemFinder from the Structure
field and cannot be edited by the user. The MOL_ID field
NOTE: You cannot edit records sorted by formula or
is also set automatically by ChemFinder and cannot be
molecular weight. However, if you attempt to sort one of these
edited.
fields, ChemFinder offers to set up a database (a portal
database) which allows the operation. For details, see
Editing Data Attaching Tables from Other Applications on page 373.

To edit data:
Sorting Fields
Click the data box whose data item you want to
edit. To sort a field:

If you click on a Structure data or a picture box it is Right-click in the field you want to sort, point
highlighted. If you click on a data box containing to Sort, then choose Ascending or Descending.
alphanumeric data, a cursor appears in the data box.
Sorting from the Data Table
To edit alphanumeric data:
1. Replace it with the text or number you want. To sort directly from the Data Table:

2. From the Record menu, choose Commit 1. From the View menu, choose Data Table.
Changes, or move to a different record.
2. In the Data Table, double-click on the table
header of the field you want to sort.
NOTE: Moving to a different record always commits
changes first.

Sorting Data
You can sort most types of data in a form. Sorting
the Mol_ID field, the molecular weight field, or any
other numeric field arranges the current list in
increasing or decreasing order. Sorting the structure
field arranges that field by increasing number of
atoms contained in the structure. Implicit Sorting in Reverse Order
hydrogens are not counted. Sorting the formula
field orders the records by increasing C-H-N count To sort a column in reverse order:

380 Working with Data CambridgeSoft


Editing Data
Double-click on the table header again. From the Search menu, choose Retrieve All.

NOTE: There is also a context menu option for sorting in Editing Structures
Data Table view. Right-click in a column and choose Sort
Column. You can edit structures by using the ChemDraw
drawing tools. You can also neaten the appearance
of a structure by cleaning it up.The Clean Structure
Sorting Languages Other Than English command is used to neaten the appearance of
molecules by regularizing bond lengths and angles.
Text that you sort must be in the same language as
Since the degree of change required cannot be
default language of the system on which the
determined a priori, the Clean Structure command
database was created, or an incorrect sort order can
begins gently. You may need to repeat the
occur.
command to get the changes you wish. For more
The ChemFinder sample databases, created in details about how the command works, see Using
English, can be sorted correctly using the following Structure CleanUp in Chapter 7: Advanced
languages: Drawing Techniques of the ChemDraw Users Guide.
English Before committing a data entry, you can revert to
German the previous unmodified record by choosing Undo
Changes from the Record menu.
French
Portuguese To edit structural data:
Italian 1. Do one of the following:
Modern Spanish Right-click in the structure box and choose
Edit Structure.
If you want to sort text in a different language than
the one in which the database was created, perform Double-click the structure box.
the following procedure: ChemDraw opens and the structure appears in
the From ChemFinder window.
1. On a computer using the same language as the
text you want to sort, open MS Access. 2. Edit the structure using ChemDraw.

2. Open the .mdb file you want to sort. 3. Click in the ChemFinder window or close the
ChemDraw window when you are finished.
3. Compact the database: on the Tools menu,
point to Database Utilities, and click Compact 4. From the Record menu, choose Commit
Database. Changes, or move to a different record.

4. After the database is compacted, close MS The changes are stored.


Access. To clean up a structure:
The correct sort information is written into the
database. When you perform a sort in 1. Right-click in the box containing the structure
ChemFinder, the sort order will be correct. to neaten.
2. Choose Clean Structure.
Resetting the Database 3. To save the cleaned up structure, choose
To reset the database to its original state: Commit Changes, from the Record menu.

Chem & BioOffice 2006 /ChemFinder Working with Data 381


Editing Data
Working with Structures Using Chem- The new or edited structure is now displayed, but
Draw has not yet been added to the database.

You can enter or edit ChemDraw structures within From the Record menu, choose Commit
Administrator

Data Boxes that are of the Structure field type. You Changes, or move to a different record.
can work in ChemDraw directly, or work in the
Structure data box using the ChemDraw ActiveX The changes are stored.
toolbar. You choose the default in the Structure With a few exceptions, ChemFinder can store any
data box Box Properties dialog box.
chemically meaningful structure or reaction that
To set the preference: can be drawn in ChemDraw. Within ChemDraw,
you can confirm that a structure is chemically
1. Right-click in the Structure box. meaningful by selecting it and choosing Check
2. Choose Properties from the context menu. Structure from the Structure menu. For more
information, see the ChemDraw Users Guide.
3. Use the drop-down menu in the Box Style
section to choose your default: Two exceptions are:
a. ChemDraw style to use the ActiveX toolbar
ChemFinder does not support importing
b. ChemFinder style to edit in ChemDraw. molecules with multiple or variable points of
attachment such as ferrocene.
TIP: When ChemDraw style is the default, you still
have the option of editing directly in ChemDraw. Just ChemFinder does not recognize bare
right-click in the Structure box and choose Edit in heteroatoms. For example, if you draw the
ChemDraw. following structure:

To edit a structure:
N
Double-click in the structure data box.
ChemDraw opens or the ActiveX toolbar ChemDraw reports an illegal valence when you
appears, depending on your default. choose the Check Structure command.
ChemFinder automatically infers hydrogen atoms
If you already have a structure in a data box, that
to main-group elements as necessary to fill their
structure appears in the edit window. You can
lowest acceptable valence. The structure above is
modify and manipulate the structure just like any
registered in ChemFinder as methylamine,
other ChemDraw structure.
CH3NH2.
If there is no structure in the Structure data box, the
edit window is blank. You can draw a structure to Structures and reactions drawn with query
store in the ChemFinder database. When you have properties are generally meaningful only in the
finished, do one of the following: context of a query. Query structures can be stored
in a ChemFinder database, but they are not treated
If you are editing in ChemDraw, choose Exit as Markush structures and are not guaranteed to be
and Return to Structure from the File menu.
hit by all valid search queries. For more
If you are editing with the ActiveX toolbar, information, see Appendix J: Structural Query
click outside the Structure box. Features.

382 Working with Data CambridgeSoft


Editing Data
ChemDraw allows you to draw many objects that The Structure field displays a 3D structure.
have no chemical meaning. These include boxes,
circles, arrows, orbitals, and others. It also allows
you to assign non-chemical styles (color) to objects
that have chemical meaning. ChemFinder ignores
these properties, and stores only objects with
chemical meaning in structure fields.

To store a ChemDraw drawing exactly as drawn,


store it as a picture. You can copy and paste a
ChemDraw drawing into a Picture field.
To rotate the model or modify the display, double-
click in the field. If you then right-click in the field,
the context menu displayed is the Chem3D control
context menu, giving you access to Chem3D
commands.

See the Chem3D Users Guide for more


information about using Chem3D.

NOTE: Objects stored in a Picture field have no chemical NOTE: Unlike interaction with ChemDraw, changes you
significance and cannot be searched. make to a model within Chem3D are not transmitted back
to ChemFinder, and thus are not saved. You can put a
picture of the Chem3D model into a database by saving the
Viewing Models using Chem3D
Chem3D model as a metafile and inserting it into a Picture
ChemFinder also provides access to Chem3D; a field. The picture does not retain a connection table and
Structure data box can be designated as Chem3D cannot be edited.
style.

To view the molecular model for a structure:


Styled Text
You make changes to text fonts, sizes, styles, colors,
1. In the Database pane of the Explorer window,
and alignment with the tools on the Text menu or
double-click the Structure field to add another
the Text Format toolbar shown below.
Structure field to the form.

2. Right-click in the field to display the Box To display the Text Format toolbar if it is not
Properties dialog box. visible:

3. In the Box Style section, select Structure On the View menu, point to Toolbars, and
(Chem3D style) from the drop-down menu. choose Text Format.

Chem & BioOffice 2006 /ChemFinder Working with Data 383


Editing Data
The Text Format Tool appears. To delete an entire record:
1. Move to the record that you want to delete
.

Subscript
Font Bold Bullets
using the Record commands or tools.
Align
Administrator

Left 2. From the Record menu, choose Delete Record.


The record is permanently removed.

Font Size Superscript Center NOTE: You can delete multiple records if you use the Table
Right view.

You can format text in plain text or Memo/Rich


Text data fields. Changing the Database
Scheme
Undoing Changes
You can create or remove tables or fields in an
Before committing your changes, you can revert to existing or new database as long as the database is
the previous unmodified state. not read-only and you have permission to modify it.
You may also attach, or link, tables from external
To undo your changes: data sources.

From the Edit menu, choose Undo. You use the Box Properties dialog box to perform
the following procedures.
After you commit the changes, they cannot be
undone. To access the Box Properties dialog box:
1. Create or open a form and link it to a database.
Redoing Changes For detailed instructions, see Creating a Data-
base on page 371.
When you undo an action, the Redo command 2. Do one of the following:
becomes active. You can reverse the effect of the From the File menu, choose Database.
Undo command by choosing the Redo command.
Right-click any empty space in the form
To redo the last action performed: window and choose Data Source.
The Box Properties:Database dialog box
From the Edit menu, choose Redo. appears.
The last action undone is reinstated. If the database contains more than one table, only
one is selected at any given time. The contents of
the Field tab of the dialog box, and of the form,
Deleting Data reflect the selected table.
You can delete the contents of individual fields by To select a table:
using the Delete or Backspace keys. You cannot
Click the table name.
delete a structure, formula, molecular weight or
Mol_ID.

384 Working with Data CambridgeSoft


Changing the Database Scheme
Chapter 18: Visualizing Data
With BioViz
ChemFinder 10 extends and improves the BioViz (pointed at) are displayed as red solid with a black
charting tool to make it even more useful, most circle. Mousing over a selected point displays a
importantly by adding Statistical Analysis. double hollow red circle surrounded by a black
circle. Points belonging to queries are displayed as
With BioViz, you can identify trends and solid colored points without circles.
correlations in your data, and within subsets of your
data, without the extra step of exporting to another Figure 18-1Point Selection
application. You can have as many plot windows as
you like, each showing a different visualization of
moused-over point
data from the current form.
BioViz is designed to be used with the Structure query point
Window and the Queries Tree. While not necessary
selected point
to creating visualizations, they offer considerable
convenience when working with plots. Before
working with BioViz, go to the View menu and More plotting flexibility
activate the Structure and Explorer windows. The
Structure window gives you a way to display You can now change the field plotted on the X or Y
structures without taking up room on the form. axis with the context menu.
The Queries Tree in the Explorer Window gives
1. Point in the area of the numbers just below or
you an easy way to track multiple hitlists.
to the left of an axis.
To create a new plot, view an existing plot, or delete 2. Right-click. The context menu displays a list of
a plot, use the BioViz Plots submenu of the View plottable fields.
menu. Plots are saved with the form and will come
back when it is opened, though they may be hidden. 3. Select a different field to plot on that axis.
Figure 18-2Changing Fields with the Context Menu
Improvements in Version
10
Better Selecting And Mouse-
overs
To facilitate viewing selected points when queries NOTE: You can only change fields when the chart is not
are displayed, the selected point is displayed as a locked.
double hollow red circle. Points being moused-over

Chem & BioOffice 2006 /ChemFinder Visualizing Data With BioViz 385
Improvements in Version 10
Details Window Removal of Empty Points
In ChemFinder 10 a new Details Window displays In version 9, a point which has an X value, but not
field values (other than Structure) when viewing a a Y value, is represented as a so-called empty
BioViz plot. To display the Details window, select it
Administrator

point on the plot with a distinctive marker. If there


from the View menu. is a Y value, but no X value, the point is simply
Figure 18-3: View menu New Toolbar Options omitted (though noted). Version 10 omits both
empty X and empty Y points. All omitted
points are noted, and may be reviewed by clicking
the Notes button at the bottom of the chart.
Figure 18-5: Notes

The window floats by default, but can be docked


with other windows.
Figure 18-4: Details Window
Histogram Improvements
In ChemFinder 10, each bin in a histogram is
labeled with its high-low cutoff points.Note also
that the data for the selected bin is displayed at the
bottom of the screen.
Figure 18-6Histogram Labeling

To add new fields to the Details Window:


1. Right click in the Details Window.
2. Select the field to be displayed.
A check mark appears next to the selected field.
Fields display in the order you select them. data for selected bin
3. To remove a field from the Details Window,
right-click and deselect it. Also, histogram plots now respond to filtering.

386 Visualizing Data With BioViz CambridgeSoft


Improvements in Version 10
Figure 18-7Histogram Filtering The BioViz Plot Properties dialog box
appears.

Creating a Plot
To begin working with BioViz, select a set of data
to work with. You can plot an entire database or the 2. Select a Dimension (one or two variables) and a
results of database queries. You can filter the plot to Style (line, scatter, or histogram).
limit the data range within a given dataset.
3. Select the variable(s) from the drop-down
To create a new plot: list(s).
1. From the View menu, point to BioViz Plots and 4. Optional: select other options, change the
select New. name.
5. Click OK to view the plot.

The plot appears in a separate window.

In a 2D plot, you may plot any numeric field on the


X axis and any other on the Y. For a 1D plot, you
choose only the value to be plotted on the Y axis,

Chem & BioOffice 2006 /ChemFinder Visualizing Data With BioViz 387
Creating a Plot
where the X axis represents record number. For a
histogram, choose a single value to be plotted on Dialog Option Description
the X axis, with the frequency plotted on Y.
Another way to select a field to be a variable, or Bin By number: Sets up n bins
Administrator

create a 1-D plot is to right-click in a property field evenly spread across the
and select BioViz Plot from the context menu. whole range of values.

By size: Sets up bins of size n.


The number of bins will be
as many as are necessary to
cover the range.

Log scale Select this checkbox to


display a log scale.

When you right-click in a numeric data box, you Base Base of the log scale. You
may choose that value to be plotted on either axis, must enter a number, thus
or as a 1D plot against record number. In the latter for a base e log scale, you
case, the plot appears immediately when you release must enter 2.718281828
the mouse button. For a 2D plot, you must first
select a data box for the other axis. Use the Reset
X,Y command to clear both X and Y settings and
Locked Locks the display. When the
start again. display is locked, the
following have no effect:
BioViz Options filters
BioViz options are available from the Properties
changes in the current
dialog box and from the context (right-click) menu.
Some of the context menu commands repeat list
options in the Properties dialog box. These are not list coloring
repeated in the following tables.
Properties dialog box
Dialog Option Description options (except Name) are
blocked.
Dimension Number of variables plotted. Selection and mouse-overs
One and two dimensional are not affected.
plots are currently
supported.

Style Currently supported plot


styles are Line, Scatter, and
Histogram.

388 Visualizing Data With BioViz CambridgeSoft


Creating a Plot
Dialog Option Description Context menu Description
options
Name BioViz automatically names
plots with sequential Copy Image Copies the plot to the Clip-
numbers (BioViz1, etc.) Edit board, allowing it to be
this field if you want to give pasted into other documents.
your plot a different name.
Selection to List Creates a hitlist from selected
data points. The list is
displayed in the Queries Tree
Context menu Description and is treated and saved like
options any other search query.

Zoom on Drag A toggle which selects the You cannot use Restore
mode of operation when you Query on a list selected this
drag a rectangle on the plot. way, but you can use Restore
If Zoom On Drag is checked, List to retrieve the records.
the rectangle defines the area
you want to examine, and Statistical Analysis
releasing the drag will cause
the plot to zoom in on that You can now perform statistical analysis of BioViz
area. When unchecked, drag- plots. When you specify two variables, a second tab
ging a rectangle selects the appears on the BioViz Plot Properties dialog box.
points within it without Figure 18-8BioViz General Properties
changing the scale. You can
use zoom to reset the scale analysis tab appears when
even on locked displays. 2 variables are specified

Unzoom Resets the scale after a zoom,


or a series of zooms.

Rescale to All Scales the plot so that the


Points visible points fill the plot
window.
For descriptive statistics, minimum, maximum,
Autoscale Automatically rescales every mean, median, and standard deviation can be
time you change the list (that calculated for both X and Y variables. R-Squared is
is, perform a search, restore a available only when curve fitting is chosen.
list, etc.).

Chem & BioOffice 2006 /ChemFinder Visualizing Data With BioViz 389
Statistical Analysis
Figure 18-9BioViz Analysis
Cleaning Up the Plot
Sorting and Filtering
Administrator

Once you have created a plot, you might want to


clean up the display. There are two ways to do this:
sorting the data on a field, and using filters.

The standard ChemFinder sort feature is the first


R2 is available when curve fitting is step in cleaning up a graph. You may sort into
selected ascending or descending order. There are two ways
to sort a dataset on a given field:
Results of descriptive statistics are displayed at the
bottom of the plot. Right-click in the field box and select Sort from
Figure 18-10Displaying Statistical Analysis Results
the context menu.

Display the Data table view, and double-click


on the table header of the field you want to
sort.

For more information on sorting, see .

Filtering

descriptive statistics display BioViz filters limit the display of a variable by


trimming either end of the range, that is, you can
eliminate high points, low points, or both from the
display. Filters can be set for either or both plotted
variables. You may also filter the dataset on other
You may choose from linear, quadratic, or cubic variables, up to a total of 31 filters per chart.
curve fitting. A confidence interval of one to three
standard deviations may also be displayed. Both Filters are set in the filter window, which, by default,
descriptive statistics and the curve fit update is displayed below the Queries window. When a
dynamically when the recordset changes or filters filter is set:
are applied.
All plots associated with a given form are
affected, unless the plot is locked before
applying the filter.

Points missing a value for a given field are


hidden whenever the filter for that field is
visible.

To display the Filter window:

390 Visualizing Data With BioViz CambridgeSoft


Cleaning Up the PlotSorting and Filtering
Check the box next to Filter Window on the The following bio-assay example shows two plots
View menu. of the octanol/water partition coefficient (CLogP)
plotted against an activity measure called
Fold_Above_Control. The second is filtered on
molar refractivity. Note that the upper chart has
been locked to prevent the filter from affecting it.

Filter window lock

To apply the filter:


To activate a filter: Press the thumb at one end of the slider and
Right-click in the Filter window, and select a drag along the slider.
variable from the list. When you view the In the bottom diagram, the plot is limited to
context menu again, the variable will appear Molar_Refractivity from 10 to 33.
with a check mark next to it.
Filter Slider Adjustment
In ChemFinder 10, filter sliders can be adjusted in a
new way. Once the top and/or bottom of the range
has been set, you can move the entire range. For
example, in Figure 18-11A, the Boiling Point filter
has been set to display a range of about 250
from 501.3K to 753K.

Figure 18-11Filter Slider Adjustments

A
To remove a filter:
Right-click in the Filter window to display the
context menu, then click the variable to B
deselect it.

Chem & BioOffice 2006 /ChemFinder Visualizing Data With BioViz 391
Cleaning Up the PlotSorting and Filtering
By dragging the blue part of the slider, you can view To display the results of an overlay on the full list:
any 250 range of the chart that you want. In Figure
18-11B, the range being displayed has been moved 1. Open the Queries pane of the Explorer
to 651.5K903.2K. The size of the range hasnt Window.
Administrator

changed, just its location. 2. Double-click on the Full List to make it the
current list.
Plotting Searches 3. Click the query to select it for display, over the
When you perform queries (see Chapter 20, current list.
Searching on page 403), and have one or more :

hitlists attached to your form, the BioViz plot


displays the results of the current hitlist. You can
display overlays by selecting hitlists rather than
making them current.

For example, the following plot shows results of a


screening test relative to a control.

Selected query shows a check mark ( b )

Selecting a list by single-clicking in the queries tree


(or choosing Color On Plot from the tree context
menu) causes points on the plot to be recolored.
The recolored points are those which are on both
the selected list and the plotted one. You may color
more than one list at a time. When a list is colored
on the plot, its item in the queries tree is shown with
To remove outliers more than 2.5SD from the a check mark; clicking it a second time uncolors it
control: and removes the check mark.

Search for <2.5 and >-2.5 in the SDs Above Synchronization of Plots
Control field.

The plot displays the results for the hitlist. Multiple plots attached to a form are synchronized.
If you select (mouse over) a point in one plot, the
NOTE: By default, the hits are shown on the same same point is highlighted in all other plots (and the
scale as the original list, which may cause them to cluster related structure is displayed in the Structure
in one sector of the window. If this happens, right-click Window).
the plot and choose Rescale to All Points or
This behavior is slightly modified if one of the plots
Auto-scale. Rescale to All Points operates on the
is a histogram. Selecting a histogram bar does not
current datapoints only; Auto-scale sets a switch so that
highlight points in other plots, but selecting a point
all subsequent searches and list operations will
in a line or scatter plot will highlight the corre-
automatically rescale the plot.
sponding histogram bar.

392 Visualizing Data With BioViz CambridgeSoft


Plotting Searches
Changing the Display This time, when you release the mouse
button, the plot display zooms in to show
Once you have selected data points and produced a only the points selected. When the plot is
plot, there are several options for modifying the zoomed, scrollbars appear. Use these to
display. reposition your view of the zoomed plot.
Click the circled-point icon on a scrollbar
Changing Colorsto change the color of a
to restore that axis to the previous zoom
plot:
a. Open the Queries pane of the Explorer win-
dow.
circle-point icons
b. Right-click a list and choose Change Color.
Selection and Zoomingto select a part of
the plot and zoom in:
To select part of the plot:
a. Drag a rectangle across a portion of the plot.
The portion of the plot is displayed in red.
b. To select more than one section, use Right-click and choose Unzoom to restore to
Shift+drag or Ctrl+drag. the full view.
To zoom-in on part of the plot: Changing the Styleyou can change the style of
an existing plot. For example, you can turn a
a. Right-click in the plot and choose Zoom on
scatter plot into a histogram.
Drag. This is a toggle switchchoose it again
to deselect. a. Right-click in the plot and select Properties.
b. Drag a rectangle across a portion of the plot. b. In the properties dialog box, select the style
and click OK.
The plot displays in the new style.

Chem & BioOffice 2006 /ChemFinder Visualizing Data With BioViz 393
Changing the Display
Administrator

394 Visualizing Data With BioViz CambridgeSoft


Changing the Display
Chapter 19: Importing and Exporting
Data
Overview Supported formats for output files only:

Bitmap (bmp)
You can move data into and out of a database if the
data is in a supported file format. You can import ChemFinder XML (cfxml)
single files, import or export databases, or add data
to an existing database. Encapsulated Postscript (eps)

GIF (gif)
Supported File Formats
Microsoft Word (doc)
ChemFinder allows you work with individual
chemical structures and reactions in various file TIFF (tif)
formats. The supported formats are:
Windows metafile (wmf)
ChemDraw (cdx) For information on the .cdx, .ct, and .cdxml file
ChemDraw XML (cdxml) formats, see the ChemDraw Users Guide. For
information on the .c3d file format, see the Chem3D
Chem3D (c3d) Users Guide. For information on MDL file formats,
see http://www.mdli.com/ (A document describing
Connection Table (ct)
the file formats is available in PDF format.)
Delimited text (csv, txt)

MDL Molfile (mol)


Importing Data
MDL RXNfile (rxn) ChemFinder allows you to import ChemDraw
structures, Structure Data files (SDFiles) and
MDL RDFile (rdf)
Reaction Data files (RDFiles) directly into a
MDL SDFile (sdf) database. In addition, you can import text files that
are comma or tab delimited.
MDL Sketch (skc)

MDL Graphic (tgf) Importing Structures


Questel F1D (f1d) ChemFinder imports structure files directly into a
Questel F1Q (f1q) database. You can choose to replace the existing
records, append new records, or merge the data,
SMD 4.2 (smd) eliminating duplicates.

Chem & BioOffice 2006 /ChemFinder Importing and Exporting Data 395
Importing Data
The general procedure for importing structures is: The Data Import dialog box appears.
1. From the File menu, point to Import and
choose type of structure file to import.
Administrator

The Open Chemical Structures dialog box


appears. 4. Click the File button, and select a database to
import into.

TIP: You can also type in a name to create a new


database file.

5. Choose the type of import: Overwrite,


Append, or Merge.
a. If you have selected Merge, click the Merge
tab and choose the matching field, match
options, and logging options.
6. Select the fields to be imported with the check-
boxes.
b. Optional: Double-click the field name to
2. Browse to a folder containing structures.
change the name of the field, field type, and
width in the Data Field Import dialog box.
3. Select a file or files (using Ctrl+click or
Shift+click) and Click Open.

396 Importing and Exporting Data CambridgeSoft


Importing Data
7. Optional: Click the Logging tab to change To import structure and reaction data files:
details of the log file.
1. From the File menu, point to Import, and
8. Optional: Click the Form Style tab to select the
choose the type of file you want to import
style of boxes that will be created for new
import.
fields.
9. Optional: Click the Advanced tab to set the The Open dialog box appears.
Advanced options.
2. Choose the file to import and click Open.
10. When you have finished selecting your options,
click Import. The Data Import dialog box appears.

The structures are imported to the specified The Data Import dialog box scans the file to
database. determine what data fields are present and how
much space to allow for them in the database. The
Importing Structure Data number of records scanned is shown in the status
bar. If the input file is large, the scan may take a
and Reaction Data Files while.
ChemFinder allows you to import Structure Data
files (SDFiles) and Reaction Data files (RDFiles)
directly into a database. Because these files contain
both structures and data, ChemFinder creates fields
in the database to accommodate the incoming data.

In RDFiles, incoming data may be hierarchical and


complex. When loading RDFiles, ChemFinder
converts the data to a relational form, creating new
tables as necessary and generating linking data.

NOTE: When importing RDFiles, boxes are


automatically created on the form only for fields in the root
table of the RDFile. Subforms must be created and
positioned manually.

If you have a blank form when you import,


ChemFinder creates boxes on the main form. If you
To interrupt the scan:
have a form with boxes when you import, new
boxes are created on tabbed forms. Press the Esc key.
You can import with a form linked to a database, a A message box appears to confirm that you
blank form, or no form. If you import with no really want to stop. The scan continues until
form, ChemFinder creates a new form. Selections you click Yes.
you make on the Form Style tab of the Data Import
dialog box determine what the form will look like. To abort the scan:

Chem & BioOffice 2006 /ChemFinder Importing and Exporting Data 397
Importing Data
Click Stop scanning.

NOTE: You should let the scan go to completion so that all


needed fields are created in the database before loading.
Administrator

Using Log Files


During the import, ChemFinder creates a log file of
the actions taken. The log file (.log) is a text file that
is created alongside the input file and overwrites any
previous log file. The log records data of your
choice form the following options during the
import.
Errorserrors and warnings
General datainformation about the input
file and import process
Records processedlogs an entry for each 2. Select the appropriate options.
record of the input file
Structures registeredlogs an entry for each To start from Click
structure stored in the database
Data registeredshows each data item the beginning of the beginning.
stored in the database SDFile or RDFile
Database schemashows input fields found
and columns generated a specified line line and type the
number line number.
The log file for an RDFile import additionally
presents an overview of the data table hierarchy
within the RDFile. a specified byte byte and type the
number byte number.
You can choose whether to create the log file or
not. If you choose to create the log file, you can save
a specified record record and type
it with a different name or append to an existing log
the record
file.
number.
Importing from a Specified Location
You can start an import from an arbitrary location 3. Click Import.
in an SDFile or RDFile, such as a byte or line
number. Reading a Structure
To set the location from which to import:
In addition to importing, ChemFinder can read files
1. Click the Advanced tab of the Date Import of any of the supported structural formats. For
dialog box. example, if you have structures stored in

398 Importing and Exporting Data CambridgeSoft


Importing Data
ChemDraw format, you can open them directly Multiple files can be dropped at once, but you
from ChemFinder without having to import or cannot mix types (as defined in column 1 of the
redraw them. table). If several structure or graphic files are
dropped at once, they are loaded into successive
To read a structure from a file into a structure box: ChemFinder records. If only one is dropped, you
1. In the structure box, right-click and choose are asked if you wish to append the
Read Structure. structure/graphic in a new record or overwrite the
existing record. If more than five
The Open dialog box appears. structures/graphics are dropped, an alert will ask
2. Choose the file to read. you if you wish to proceed.
3. Click Open. Dropping one or more form files opens the forms,
The structure is read into the structure box. without affecting the current form and database.
The database is not affected by this operation
until you choose Commit Changes or move off Importing Text Files
of the record. You can import comma or tab delimited text files.
The Import Delimited Text command uses the
Drag and Drop same dialog and has most of the same features as
You can drag certain types of files from the Import SDFile. Delimited text (DT) differs from
Windows Explorer or Desktop onto ChemFinder. SD files in that:
The following table summarizes the ChemFinder DT files cannot contain structures.
Drag and Drop options.
DT files are not as well defined, and require
interpretation in order to determine field
type of supporte comments names and delimiter type.
file d file
types To import text records into a new database:
4. Open a new, blank form.
Structure CDX Must be dropped into 5. On the File menu, point to File Import and
a structure box. choose Delimited Text.
SKC
6. In the File Open dialog, browse to select the
MOL input file.
The input file is scanned to determine the field
MST
delimiter. If the file extension is .csv, the
delimiter is taken to be comma. If the
Graphic WMF Must be dropped into extension is .txt, the first few lines of the file
a picture box. are examined for the presence of commas or
EMF tabs. If one or the other is found, it is taken as
the delimiter. If not, an alert is presented.
Form CFW Does not need to be This alert will appear in two cases:
dropped onto an
existing form. c. The input file contains only a single column.
The alert can be ignored (click OK).

Chem & BioOffice 2006 /ChemFinder Importing and Exporting Data 399
Importing Data
d. The input file has some delimiter between (*.txt) format, or in the Comma Separated Value
fields other than tab or comma. (*.csv) format readable by most spreadsheets.
In this case you must specify the delimiter When you export a file, all records in the current
using the File Export dialog box. hit list are exported. You can include or exclude
Administrator

fields to be exported from a checklist.


To specify the delimiter using the Role Export
dialog box: To export a file:
1. Click Cancel to dismiss the alert and abort the 1. From the File menu, point to Export, and select
import. the output file type.
2. Open a form containing data, and retrieve a
small hit list.
3. On the File menu, point to File Export and
choose Other.
The File Export dialog box appears.
4. Click the Text Options tab.
5. Choose the Other radio button, and specify a
delimiter.
6. click Export to save the choice (and carry out an
export)
7. Go back to step 1 of the import procedure to
begin the import again.

TIP: Once you have specified a delimiter, it will be


remembered and you will not have to repeat this
The Data Export dialog box appears.
operation.

The input file scan also determines the names and


types of the data fields in the input file. Field names
must appear in the first line of the file, in the correct
order, separated by the same delimiter as the data
items. Field types are determined by examining all
the data in each column, using the same rules as for
SD import: if all items in one column are integers,
then the field type is set to integer, and so on.
Widths of text fields are set to accommodate the
largest item in the file.

Exporting Data Files


You can create a new SDFile, RDFile, ASCII text,
or MS Word file by exporting records from an
existing database. Text files can be saved in text

400 Importing and Exporting Data CambridgeSoft


Exporting Data Files
The Data Export dialog box is similar to the Data Exporting an ASCII File
Import dialog box. It gives you options for file
naming and file type selection, and lets you select Delimited text files may be the most universal file
which fields will be exported. If you save to an format used by non-chemical applications. In a
existing file, you have the option to replace or delimited text file, each line represents a record, and
append the records. all fields in the record are listed in order from left to
right, separated by some character such as a tab or
2. Type a name and path for the file, or click File
a comma. Individual records are separated by
and browse to an existing file.
carriage returns. ChemFinder allows you to include
3. For delimited text exports, click the Text a header line at the start of the file that lists the
Options tab and choose appropriate options. names of all of the fields. It also allows you to
append to, or overwrite, existing text files.
NOTE: Choosing Comma delimited does not
automatically set the file type. Text files (*.txt) may be You can import a delimited text file saved by
either tab delimited or comma delimited. If you want to ChemFinder into many other applications,
export in the Comma Separated Value (*.csv) format, including spreadsheets and external database
you must name your file accordinglyeither by typing the systems. Choose the .csv file format to export to
name or selecting the file type from the Save As dialog spreadsheets, and the .txt format for general export.
box.

4. Click Export. NOTE: In delimited text files, structures are automatically


The file is exported. exported as SMILES strings.

Saving Structures
Exporting a Word file
Saving structures is similar to exporting them,
without the fuss. The export to MS Word option is similar to the
other export options, however a couple of points
To save the structure on display: are worth noting:
1. Right-click in the structure data box, and Export to Word is much slower than to other
choose Save Structure. formats. For this reason, you should probably
The Save As dialog box appears. limit the use of this option to relatively short
hitlists.
2. Choose the destination directory.
3. Type the file name and choose a file format.
You can speed up the export by not exporting
the structure field.
4. Click Save.
Structures are exported as OLE objects, and
The structure is saved to the indicated file. You can
can be edited in Word with the ChemDraw
read these files with any application that supports
ActiveX toolbar.
the specified file format.
If you should, by accident, begin exporting a
NOTE: To save most of the file types listed above, you must large database, you can terminate the export by
have ChemDraw Pro installed. bringing ChemFinder to the front and pressing
the Esc key.

Chem & BioOffice 2006 /ChemFinder Importing and Exporting Data 401
Exporting Data Files
Export to SDFile field name. Deselect any subform fields you do
not wish to export (and select those main form
When you export to SDFile, you are allowed to
fields you do wish to export).
export subform fields. Each subform field is
exported to a separate record in the SDFile, but
Administrator

4. Click the Export button.


separate subform records are concatenated into a
single multi-line text block.
NOTE: Re-importing a file of this type will not regenerate
To export subforms: the original database! It will bring back the data, but not in
1. Point to Export on the File menu, and choose the subtables and subforms you started with. To do this,
SDFile. export to cfxml.
The Data Export dialog box appears.
2. Click the Text Options tab, and select the Export When exporting to SDFile, you may append to, or
subform data checkbox. overwrite, existing SD files. This option is only
3. Return to the Export tab. In the Field column of available for SD files and delimited text exports.
the Data Fields table, all subform fields now
appear with checks in the checkbox next to the

402 Importing and Exporting Data CambridgeSoft


Exporting Data Files
Chapter 20: Searching
Overview When searching a memo field, a plain text
string is unanchored, and hits any string which
contains it anywhere.
You can search a ChemFinder database by querying
any field or combination of fields. You can specify When searching a normal text field, if the text
a chemical structure and/or text as the query. When query starts with = (for example =toluene) then
searching text or numbers, you can use wildcards or the search requires an exact text match.
specify a numerical range. When structure Text strings may contain wild cards or Boolean
searching, you can search by sub- or full structure, operators. Standard wild cards are % or *.
search for an exact match, similarity, or These characters are equivalent and hit any
tautomerism, and specify how stereochemistry will string. Other wild cards are also possible. If
be matched. You can also combine structure wildcards are present, they override the above
searching with text or numerical searching. A new defaults.
Find Structure command performs duplicate,
error, isotopic label, and other special structure NOTE: Using wildcards or a = in memo fields may
searches. lead to unexpected results. This is because a memo field
may contain formatting information surrounding the
The chapter describes the different types of text you see, so a search like benz* may give no hits.
searches and how to set up and manage searches. It Using *benz*, however, will give the same results in a
concludes with some examples of advanced memo field as in a plain text field.
techniques.
A checkbox in the Search Preferences dialog
allows you to request a full-word match. When
Text Searches this box is checked, a hit must contain the
query as a complete word, not embedded
ChemFinder, like all databases, supports text
within a larger string.
searching. You can search any alphanumeric field
for strings of text. You could use text searching, for Boolean operators are NOT, OR, and AND.
example, to find chemical names, or comments in a They may be used to combine search terms
reference field. within one field.

For text searches, ChemFinder interprets the query, TIP: Use NOT* to search for empty fields.
then passes it as Structured Query Language (SQL)
to the relational database. The following rules apply Examples of queries:
to these queries:
Entry Possible Hits Will Not Hit
When searching a normal text field, a plain
text string is taken as an anchored substring, benz Benzene, Bromobenzene
which hits any string starting with the indicated Benzoic acid
substring.

Chem & BioOffice 2006 /ChemFinder Searching 403


Text Searches
benz OR Benzene, Azobenzene
Molecular Formula
*bromo* Benzoic acid, Searches
Bromobenzene,
Dibromobenzene
Administrator

Formula searching allows you to search molecular


compositions. Searches can be inclusive, exact
=benzene Benzene Benzoic acid, (designated with an equals sign) or with the element
Benzene-d6, range you specify.
Bromobenzene
The following table shows query examples.
Numeric Searches
Entry Possible hits
Searching numerical data allows you to find
information such as boiling points and molecular C6H6 compounds with 6 carbons and
weights. 6 hydrogen atoms, plus any
number of other elements.
Ranges are specified using a hyphen between the
values at either end of the range. =C6H6 compounds with 6 carbons and
For numerical searching, the query is a decimal 6 hydrogen atoms and no other
value or range. If a single value is given, the number elements.
of significant digits determines the precision of the
search. A hit is any value that rounds off to the C6N0 compounds with 6 carbons, no
query. nitrogens, plus any number of
other elements.
Examples of queries:
C6 N1-3 compounds with 6 carbons and
Entry Possible hits one to three nitrogen atoms,
plus any number of other
90 values from 89.5 to 90.5 elements.

90.1 values from 90.05 to 90.15 Formula queries consist of element symbols and
element counts or ranges. The following rules
90100 values from 90 through 100, apply:
inclusive
Symbols may be one or two letters. Symbols
may be in upper or lower case; if there are
>=90 and <=100 values from 90 through 100, ambiguities, the program resolves them
inclusive according to rules described in Appendix K,
Formula Input Rules..
>90 and <100 values from 90 through 100,
exclusive Capitalize the symbols properly and insert
spaces between elements.

404 Searching CambridgeSoft


Numeric Searches
Use the Periodic Table to enter formulas. For The following table shows query examples.
more information, see Using the Periodic
Table on page 434 and Appendix K, Entry Possible hits
Formula Input Rules.
Element counts are single integers or ranges Apr 11, 1971 the exact date April 11, 1971
(two integers separated by a hyphen). If a count
is omitted, it is assumed to be 1. March 31, 1971 any date in the second
If the formula query is preceded by = (for July 1, 1971 quarter of the year 1971
example =C6H6) then the search requires an
exact formula match, containing no elements >4/ 11/71 any date after April 11, 1971
other than those indicated. If there is no =, then
the search is a partial match: other elements
may be present in the hits. Find List
Symbols may be repeated. For example,
CH3CH3 is interpreted as C2H6. Use the Find List command to retrieve records
having specific values in any non-structure field.
NOTE: Formula searches are completely non-
structural: CH3CH2OH matches both dimethyl ether Type parameters into the Find List box as follows:
and ethyl alcohol because both compounds have the same
condensed formula: C2H6O. If the column you search is an integer type, you
can use hyphens to indicate ranges.
Parentheses may be used to group elements
If the column you search is a number or text
and apply a count to the entire group. For
type, you cannot use hyphens to indicate
example, (CH2)3 is interpreted as C3H6.
ranges; you must search for an exact match.
Spaces or non-alphanumeric characters other
than parentheses are ignored. NOTE: To search for a list of records using partial
text (a wildcard search) or range of numbers, do a
Date Searches search on the relevant field.

Dates might be used to track individual reaction If the column you search is a text type, you
runs, purchasing histories, and so on. Searching must use quotes around any item that contains
dates is very similar to searching numerical data. commas. For example, you must type 1,2-Pyran
as 1,2-Pyran.
Ranges are specified using a hyphen between the
values at either end of the range. Ranges may also You may save a list as a text file and retrieve it
be indicated using inequality operators (<, >) later with the File button.
together with the AND operator.
To find a list:
Dates are always displayed according to the
preferences set in the operating systems 1. From the Search menu, choose Find List.
International control panel, but need not be input
in that format. The Find List dialog box appears.

Chem & BioOffice 2006 /ChemFinder Searching 405


Date Searches
Search Type
Normal Searching
Administrator

A Normal search finds structures that either


contain (Substructure) or match (Full Structure) the
query. When drawing a structure query, you can
attach different features to a query, such as atom
lists and variable bond types, to perform a narrower
or broader search. You can also modify the results
of a Normal search by selecting options in the
Search Details tab of the Preferences dialog box.

2. From the Column menu, choose a field.

3. Paste or type a list of field parameters into the


Find List text box.

4. Click OK.

The list of matching records is retrieved.

Structure Searches
You can search a ChemFinder database by sub- or
full structure for similarity or exact matching. To
define your search more precisely, use the query
functions in ChemDraw. These are described in The query structure is highlighted in red in the
Chapter 9 of the ChemDraw User Manual, and in hitlist structures to visualize the match.
Appendix J: Structural Query Features. in this
manual. Exact Searching

ChemFinder matches structures in three ways: NOTE: The Exact search type was known as the Identity
search type in previous versions of ChemFinder.
Search type (Normal/Exact/Similar)

Structure mode (sub- or full structure) The Exact search type is intended for use in
compound registration, when you must know if a
Tautomerism perfectly identical copy of your query compound is
already present in the database. It is similar to a
NOTE: Not all options for each type are compatible with Normal Full Structure search, except that generic
other types. For example, Tautomeric searches must be either atom and bond types such as R, A, and Double-or-
Exact or Normal. Aromatic in the query will match corresponding
atom and bond types in the target only if they are

406 Searching CambridgeSoft


Structure Searches
also of the same generic type. Thus, an R hits only toolbar, you can attach different features to a query,
another R atom. Moreover, stereochemistry must such as atom lists and variable bond types, to
match precisely between query and target. If the perform a narrower or broader search.
stereochemistry of the query is unspecified, it will
For more information about what query features
only hit targets which do not specify
you may use and how these features affect a search,
stereochemistry.
see Appendix J, Structural Query Features..
The Search Details tab in the Preferences dialog
An example of substructure searching of
box is unavailable for Exact searches. Cyclopentane:
Similarity Searching
This substructure will hit
A Similarity search finds structures that have query
structural features that generally correspond to
those in the query. Similarity searches are by their
nature fuzzy. In a Full Structure similarity search, O

the results are guaranteed to include all hits you


would obtain from a substructure search with the
same query. Usually, they include additional hits.
For this reason, similarity searches are useful if you
have a general idea of the types of compounds you
are looking for, but dont have a precise conception HO

of the target compound.

Unlike exact searches, similarity searches do not


highlight matched portions of the target
compounds. Similarity searching matches general
structural features and not specific atoms and
bonds, so highlighting specific areas would not be O

and other molecules


appropriate.
You can adjust the degree of similarity by using the
slider on the Search Type tab of the Preferences NOTE: In searching substructures, ChemFinder finds the
dialog box. substructure query regardless of its orientation or drawing
presentation in the targeted molecules. Bonds shown in bold
For a detailed description of the similarity searching
above are actually highlighted in red in ChemFinder.
algorithms, see Appendix L, Similarity Rules..

Substructure Searching Fragment Searching


The default search type is Normal Substructure You can draw more than one structure or structure
searching. It finds structures that contain the query, fragment in your substructure search query. In the
plus any additional attachments at the open Search Details tab of the Preferences dialog box,
positions. The substructure is highlighted in red in you may allow fragments to overlap in the target
the hitlist structures. Using the ChemDraw ActiveX structure.

Chem & BioOffice 2006 /ChemFinder Searching 407


Structure Searches
For example, if you perform the following absolute configuration. To specify this, centers
substructure query with Query fragments may are drawn, not with the standard hashed and
overlap in target selected: wedged bonds, but with thick stereo bonds.
If these options are checked in the Search tab of the
Administrator

OH
Preferences dialog, then any stereochemistry
indicated on the query must be matched by the
The hit list will include the following:
target. For more information on changing searching
preferences, see Setting Search Details
OH Preferences on page 414.

The dot indicates an atom shared between the two


fragments. The hit list will not include this molecule 3D Properties
if the overlap option is deselected.
3D queries are particularly useful in
Full Structure Searching pharmacophore searching where you are looking
for a particular 3D relationship among atoms and
Selecting the Full Structure radio button in the
bonds, for example in a series of potential receptor
Search Type Preferences finds structures that
ligands. You can create a 3D query in ChemDraw
completely match the query. You may get more than
Pro by adding geometries (lines, planes, etc.) and
one hit if there are duplicates in the database or if
constraints (specified as ranges) to a query
there are stereoisomers in the database and you did
structure. For example, you might specify that two
not specify a particular one to be matched. For
atoms must be between 4 and 5 apart, or that
more information, see Stereochemistry on page
two planes must be separated by 80-100.
408.
ChemFinder can then use these properties to refine
Stereochemistry a search. See the ChemDraw Users Manual for
information on how to add 3D properties to
You can specify whether or not you want a structures.
structure search to consider stereochemistry. Given
a structure with one or more stereocenters, you can
Searching with R-Groups
store four different possibilities:
A given absolute configuration. To specify this, ChemFinder 10 supports queries using R-tables,
centers must be drawn with stereo bonds, and including multiple R-tables. Queries containing
the entire structure marked Abs (CHIRAL). large numbers of R-groups or large numbers of R-
values are not advisable however, because
A racemic mixture of the drawn configuration
ChemFinder pre-processing expands the query,
and its mirror image. This is drawn as above,
substituting all combinations from the R-group
but without the Abs (CHIRAL) mark.
table(s).
An unmarked structure, representing unknown
stereochemistry, or a mixture of all possible
Alternative Groups
stereoisomers.
A given relationship between centers. That is, a Instead of submitting multiple queries on structures
known orientation of the substituents with that share a common substructure, you can submit
respect to each other, rather than a known a single query with the parent structure and variable

408 Searching CambridgeSoft


Structure Searches
functional groups or substructures. The parent 6. Type a title in the Alternative Group Title box.
structure is drawn with attachment point(s) that The title must match the atom label in the
refer to a list of alternative groups that you define. parent structure (R, in the example above).
Figure 20-12: Alternative groups, sometimes called R- Figure 20-13: Defining an R-Group: Step 4
Groups or G-Groups (Generic Groups) Title box

F G
1

NH2
G

1 F

1 NH2
7. Draw the substructure fragments in the Alter-
1 OH
native Group box. Use the single bond tool to
OH
define a fragment, and the text tool, atom
HotKeys, or Nicknames to create atom labels
for each variable.
Figure 20-14: Defining an R-Group: Step 5
R

Defining an Alternative Group


1 Cl
R
To define an alternative group:
CH2OH
1. Click the query icon to begin the search.
2. You will need a bit more space than the struc- Ph
ture window provides, so right-click in the
structure window and click Edit in ChemDraw
8. Add the Attachment Points:
on the context menu.
a.Click the diamond shaped
ChemDraw opens to a new page.
Attachment Point tool on the Chemical
3. Draw the parent compound. Label the atom Symbols palette.
where the alternate groups will attach with a
b. Click the open atom position on each
generic label such as R.
substructure fragment.
4. Click the Alternative Group query tool .
5. Drag with the tool in an open part of the page
TIP: Alternatively, the HotKey .(period) can be
to create an area large enough to draw the alter- used to add attachment points.
native groups.

Chem & BioOffice 2006 /ChemFinder Searching 409


Structure Searches
Figure 20-15: Completed R-Group complete reaction implies many subreactions, such
R as:
(B) (D) and (A) (B).
1
1 Cl
Administrator

1 CH2OH
Reaction Centers
1 Ph
The most important part of a reaction is the part
that actually changes from the reactants to the
products. This part, which probably includes a
number of atoms and bonds, is called the reaction
NOTE: In the above procedure, the parent structure was center. For example, only the bold bond below (and
drawn, then the R-Group table was added. In fact, the order the two atoms on either side) is part of the reaction
doesnt matter. You may create the R-Group table first, then center. The rest of the structure is unchanged from
draw the parent structure. In either case, as soon as a generic the reactant to the product:
atom label in the structure matches the group title in the R-
Group table, a hollow attachment point symbol appears next O OH

to the label in the parent structure.

9. Type Ctrl+W to return to ChemFinder.


F Cl F Cl
The structure and the R-Group table appear
in the structure window. By default, ChemFinder considers reaction centers
whenever you search for reactions. ChemFinder
10. Continue the query as usual.
assumes that any atoms and bonds that change in
the query must be part of the reaction center of the
Reaction Searches target.
You can search and store reactions. In a reaction, For example:
one or several compounds (reactants) are
transformed into other compounds (products). F Cl
Individual reactants (or products) are separated
from each other with plus signs. The reactants are does not hit
separated from the products with an arrow.
O OH
Reactions may have multiple steps, for example
(A) (B) (C) (D). Here, (A) is the
reactant and (D) is the product. (B) and (C) are
intermediates for the complete reaction. F Cl F Cl

A multi-step reaction is actually a shorthand when the Reaction query must hit reaction center
notation for many related reactions. In the example preference is selected. Even though there is a C-F
above, (B) is an intermediate for the complete bond in the target reactant and a C-Cl bond in the
reaction, but it is also a reactant relative to (C) or target product, these bonds do not participate in the
(D). It is also a product relative to (A). The reaction, which really affects another part of the

410 Searching CambridgeSoft


Reaction Searches
compound. If you deselect the Reaction query must of the data about a reaction. Maps are used during
hit reaction center preference, this query hits the searching to resolve certain types of structure
target above. search hits.

When creating reaction queries, it is important to Consider a simple esterification reaction:


consider what sort of information you are really
looking for. Suppose you want to convert n-decanal O O
OH
to n-decanol: H2O
OH O

O
Does the ester oxygen come from the acid or the
alcohol? You specify the fate of individual atoms
through an atom-to-atom map. In reality, the ester
oxygen in this reaction originates in the alcohol, so
OH
the atom-to-atom map looks like this:
Are you really interested only in these two 3 3
compounds? You might be interested in any O
6
O
OH
reaction that converts a straight-chain aldehyde to 2
Rxn
5 2
5 H2O 4

the alcohol: 1 OH 4 1 Rxn O


6

H H By matching numbers across the arrow, you can see


H
O
H
OH
where atoms move during the course of the
reaction. The other reaction (not observed
H H
experimentally), where the ester oxygen comes
from the acid, would be mapped like this:
Since the corresponding n-octanal n-octanol 3 3
O O
reaction would probably occur under very similar Rxn OH 6

conditions, it is a reasonable thing to look at. 2 5 2


5 H2O 6

OH 4 O
Generally, you want to use substructure queries that 1 1
4
Rxn

include little beyond the reaction center in question


when you are searching for reactions. ChemFinder uses atom-to-atom map information
to determine reacting centers for reactions. If only
some atoms are mapped, ChemFinder uses that
NOTE: ChemFinder supports several query properties to information and does not worry about the specific
allow you to specify exactly how a bond participates in a fates of the other atoms. For example, if you dont
reaction center. For more information about these properties, know (or dont care) about the mapping of some
see Setting Search Details Preferences on page 414. atoms, you can leave them unspecified in the atom-
to-atom map.

Atom-to-Atom Mapping By default, atom-to-atom mapping is not displayed


within ChemFinder. To turn on this display, select
The second most important part of reaction Atom-to-Atom Map on the Structure sub-menu of the
searching is the atom-to-atom map. You can specify View menu. For more information, see Setting
maps in ChemDraw, where they are stored as part Preferences on page 429.

Chem & BioOffice 2006 /ChemFinder Searching 411


Reaction Searches
NOTE: For information about specifying atom-to-atom
Searching for Intermediates
maps with ChemDraw, see the ChemDraw Users Guide.
Rarely, you may be looking for reactions for which
you only know something about an intermediate.
Administrator

An Intermediate Search is very similar to a normal


Searching for Reactants reaction search, except that there are arrows on
both sides of the target structure. For example,
If you know what starting materials you are consider the query:
interested in but dont know their products, you
might perform a reactants query. A reactants query
R C C O
is very similar to a reaction search, except that there
is nothing to the right of the arrow. For example,
This finds any reactions containing the Ketene
consider the query:
structure shown as an intermediate.
O

NOTE: ChemFinder cannot predict products or


intermediates of reactions. It finds this information only if it
O
is already present in the database.

Combined Searches
If you are doing a substructure search, this finds any
reactions in which maleic anhydride or a compound You can combine structure searching with text
containing a maleic anhydride substructure is searching to find a specific class of compounds. For
consumed or transformed. example, you may want to find all compounds in the
database whose names end in mycin and whose
Searching for Products structures contain a phenyl ring. Because you are
entering multiple queries in different data boxes,
If you know the desired end product but not how there is an implicit AND condition between data
to get there, you can do a products query. A items in different fields.
products query is similar to a reaction search,
except that there is nothing to the left of the arrow. To perform a combined search:
For example, consider the query:
1. From the Search menu, choose Enter Query to
clear the form.

2. Enter the structural query, if any.

3. Enter the text and/or numeric queries in the


appropriate boxes.
If you are doing a substructure search, this finds any
reactions in which bicyclo[2.2.1]heptane or a 4. From the Search menu, choose Find.
compound containing this substructure is
produced. An example of combined searching:

412 Searching CambridgeSoft


Combined Searches
Suppose you want to find all molecules in the Searching Procedures
CS_Demo database that contain a benzene ring and
which have names related to penicillin. Searching includes the following steps:
1. From the Search menu, choose Enter Query to Setting the search type preferences (Structure
clear the form. searches only).
2. Draw a benzene ring.
Entering the query in the form.
3. Enter *penicillin* in the Molname field.
Submitting the query to the search engine.
4. With the Substructure option selected, choose
Find from the Search menu. To perform a search, use the Search menu or the
You get 2 hits of molecules whose names contain corresponding tools in the Search toolbar.
penicillin and whose structures have an aromatic
ring of six carbon atoms. Enter Retrieve Previous Restore Over
Query All Query List Current
List
NOTE: In a combined search, progress reports are given
only during the structure search part. When the counters at
the bottom of the screen are advancing, structures are being
searched. You can press Esc to end a search during the
structure searching. You cannot end a search during the SQL Find Find Current Save Restore Find
searching by pressing Esc. Molecule List Previous List
List

The following procedures describe searching with


SQL Searches the Search menu. You may use the Search toolbar
SQL (Structured Query Language) can be used to instead for most procedures.
create powerful searches. The details of the
language are not discussed here. Setting Search Type Prefer-
Queries beginning with a backslash (\) are taken as ences
straight SQL, and passed directly to the database as
You can set preferences for the type of structure for
the WHERE clause of the SQL query. These must
which you want to search.
contain column names and punctuation as dictated
by SQL. For example, a valid query might be To set Search Type preferences:
\[molname] like 'benz*' and [bpoint] > 200.
1. Right-click in the Structure box and choose
A straight SQL query may be entered in any box of
Preferences.
the form which contains non-structural data. The
SQL query is not associated with the box in which The Preferences dialog box appears, with the
it is entered. Search Type tab displayed.

Chem & BioOffice 2006 /ChemFinder Searching 413


SQL Searches
If you want to Then click

find structures that are Tautomeric.


Administrator

tautomeric forms of the


query

match bonds as drawn, Non-tautomeric


without tautomeric forms

3. Click OK.

TIP: You dont always have to access the Preferences dialog


to change search preferences. Switches on the Search menu
allow you to toggle Substructure/Full Structure and
2. Take the appropriate action: Normal/Similarity.

If you want to Then click Setting Search Details Preferences


find structures containing a Substructure. You can set preferences for the details of each
common structural search.
component
To set Search Details preferences:

find a particular structure Full Structure. 1. From the File menu, choose Preferences.
The Preferences dialog box appears.
search with variability in Normal
2. Click the Search Details tab.
the query
The Search Details tab appears.
search for a precise match Exact.

find structures having Similar and set


features similar to the query the degree of
similarity.

NOTE: The
higher the
value, the fewer
hits found.

414 Searching CambridgeSoft


Searching Procedures
3. Take the appropriate action:
If you want to Then click
If you want to Then click
Require that any reac- Reaction query must
tion center present in hit reaction center.
Allow uncharged non- Hit any charge on
the query overlap with
carbon atoms in the heteroatom.
reaction centers in the
query to match charged
target. This preference
atoms in the target.
applies only to reaction
NOTE: Charged atoms searching.
in the query must always
match charged atoms in Prohibit generic struc- Generics hit only
the target, regardless of tures from hitting any generics.
this setting. other structures in a
query.
Allow uncharged Hit any charge on
carbon atoms in the carbon. Require full-word text Text: match full word
query to match charged matching. If you do not only
carbon atoms in the check this box, the
target. query will hit any
matching text fragment.
NOTE: Charged atoms
in the query must always
Require that the stere- Match stereochem-
match charged atoms in
ochemistry of the target istry and click How to
the target, regardless of
structure match that of set how the stere-
this setting.
the query structure. ochemistry is
matched.
Allow hits to contain Permit extraneous
molecular fragments in fragments in full struc-
addition to the structure ture searches. Setting Stereochemical Search Prefer-
hit by the query. ences

The Stereochemical Search Preferences dialog


Allow fragments in the Query fragments can
box is activated from the Search Details tab of the
query to overlap (share overlap in target.
Preferences dialog box.
one or more atoms) in
the target.
To set Stereochemical preferences:

1. Click the How button on the Search Details tab


of the Preferences dialog box.

The Stereochemical Search Preferences


dialog box appears.

Chem & BioOffice 2006 /ChemFinder Searching 415


Searching Procedures
set to Same, a query marked with thick bonds will
only hit a target that has the same relative
relationship between centers.
3. Set the Double bond hits:
Administrator

If you want the Then in


configuration of a
double bond in
the query to

match the target struc- Double bond hits, click


ture exactly. Same.

2. Set the Tetrahedral stereo center hits: match any configura- Double bond hits, click
tion in the target. Any.
If you want a Then
tetrahedral 4. Click OK.
stereocenter in the
query to Entering Query Mode
To clear the form and enter Query Mode:
match the target exactly. in Tetrahedral stereo
From the Search menu, choose Enter Query.
center hits, click Same.
You are in Query mode.
match same or opposite in Tetrahedral stereo In Query mode:
configuration at the center hits, click Either.
The form background color changes.
center of the target.
QRY appears in the status bar.

match any target. in Tetrahedral stereo Form boxes which do not permit data entry
center hits, click Any. become editable for entry of queries.
Form boxes are displayed according to their
match a relative relation- click Thick bonds visibility properties. For more information, see
ship between centers represent relative Hiding Data Boxes on page 349.
stereochemistry.
Entering and Submitting a
When Thick bonds represent relative stereochemistry Query
box is cleared (default), thick bonds are
interchangeable with hash/wedge bonds. When the To enter the query:
box is checked, and Tetrahedral stereo center hits is 1. Position the cursor over the field you want to
search and click to select it.
2. Enter the query in the data boxes.

416 Searching CambridgeSoft


Searching Procedures
3. From the Search menu, choose Find. ChemFinder searches over the previously
retrieved hit list. If no hits are found, a message
TIP: Press the ESC key to leave Query Mode without appears asking whether to search over the
searching. entire database.

ChemFinder searches. The number of hits is As long as the Over Current List switch is on, each
shown in the Status Bar at the lower right search further refines the current list. Use the
corner of the window. Retrieve All command to reset. You may also use the
Restore Previous List command, which acts like a
NOTE: If a search gets no hits or an error occurs, an alert Back button. Restore Previous List goes back one in
appears and you are returned to Query mode to enter a the history, including any Retrieve Alls you might
different query or modify the current one. have done.

The hit list is a subset of the complete database. Entering a Structural Query
You can browse it as you would any database using
the Record commands in the Record menu or To begin a structural query:
toolbar.
For example, to view the hits in tabular form: 1. From the Search menu, choose Enter Query, to
clear the form.
From the View menu, choose Data Table.
2. Place a structure into a data box use any of the
Stopping a Search following methods:

To stop a structure search in progress, press the Esc a. Double-click in the structure box and edit
key. The query stops and you return to browse with the ChemDraw ActiveX toolbar.
mode. b. Right-click and select Edit in ChemDraw.

NOTE: Only queries that involve structural data c. Right-click and use Read Structure... to open
(structure, molecular formula, and molecular weight searches) an existing molecule file.
can be stopped in this manner. SQL searches and searches d. Use Paste from the Edit menu to insert a
that involved non-structural data cannot be aborted. structure from the clipboard.
3. Choose Preferences from the Search menu,
Refining a Search and click the Search Type tab.
You can refine a hit list of one or more records by 4. Select the appropriate options. Optionally,
entering a query that searches only the hit list, not select options on the Search Details tab as well.
the entire database.
5. Choose Find from the Search menu.
To refine a search:
The status bar counters indicate search progress.
1. On the Search menu, verify that Over Current When the search is complete, the form displays the
List is selected. first hit. The list you can browse is limited to the
2. From the Search menu, choose Enter Query. hits. For Normal or Exact searches, the hit portion

Chem & BioOffice 2006 /ChemFinder Searching 417


Searching Procedures
of each molecule is highlighted in red. If a search structure, substructure, and/or similarity) is
doesnt find any hits, you are returned to query determined by what you have selected in the
mode. Search menu.
To find the current molecule:
Administrator

TIP: You can change the highlight color in the preferences


dialog. For example, to show no highlighting, choose black as 1. Browse to the record containing the structure
the highlight color. See Color Preferences on page 430 for of interest.
more information.
2. From the Search menu, choose the type of
structure search you want to perform.
Using the Current Molecule as a Query 3. From the Search menu, choose Find Current
Mol.
As you browse through a database, you may submit
any structure on the screen as the structural query. ChemFinder begins the search and displays the
Often, you use similarity or substructure searches search status on the lower right corner of the status
(see above) with this type of query to find related bar. When the search is complete, the form displays
compounds. the first hit, and the list you can browse is restricted
to the records hit by the query.
To use the current molecule for a query:
1. Using the Record commands, go to the record
Entering a Reaction Query
containing the structure that you want to use as The general procedure for creating a reaction query
a query. is very similar to creating a structural query.
2. From the Search menu, choose Current Mol As
Clear the form:
Query.
From the Search menu, choose Enter Query.
All boxes of the form are cleared except the
structure so that the molecule on display can be The form clears.
used as part of the query. You can then Enter the query:
continue with the query as if you had drawn the
structure from scratch. 1. Double-click in the Structure box.
The ChemDraw ActiveX toolbar appears.
Finding the Current Molecule
2. Draw the structure or substructure or reaction
The Find Current Molecule command, located in in the From ChemFinder window.
the Search menu and on the Search toolbar, is 3. Click somewhere in the form outside the Struc-
similar to the Current Mol as Query command ture box.
discussed above. As you browse through the
database you may find a molecule that interests you, Now you can enter more query terms in the other
and want to find other related records. data boxes for a combined search.

The Find Current Molecule feature lets you 1. From the Search menu, select or deselect the
perform a quick structural search of the structure Substructure option.
currently being displayed on the form. However,
NOTE: The Similarity option is not available for
this feature does not allow you to enter other search
reaction queries.
terms. The type of structure search (complete

418 Searching CambridgeSoft


Searching Procedures
2. From the Search menu, choose Find. With Stereo CentersFinds structures
The search proceeds as with simple structure containing tetrahedral stereochemistry.
searching. With Isotopic LabelsRetrieves records
containing a structure with an atom that either
Special Structure has a mass number, or has an Isotopic Abun-
dance attribute.
Searches
Query StructuresLocates structures with
The Find Structures submenu on the Search menu any generic variability such as atom types (R, A,
provides for several common types of searches that M, Q, X, Alkyl, Aliphatic, EDG, EWG), bond
would be awkward or arcane to conduct using types (single-or-double, etc.), variable charge,
regular means. As with other searches, all of these element lists ([C,N,O]), ring bond count, etc.
searches operate within the current record set if the
Over Current List option is in effect. Otherwise, the 3DLocates structures that
whole list is searched, regardless of how many could be targets in a 3D search. These are
records are currently displayed. structures scaled in Angstroms and having Z
coordinates. Both conditions must be met.
Structures that meet only one of these condi-
tions can be found by using the With Errors
search.
Fischer ProjectionsLocates structures
drawn as Fischer Projections.
DuplicatesLocates all records whose struc-
tures duplicate at least one other.
If Clustered is selected, the query will be a list of
duplicates only, clustered together (that is, a
sorted list). This makes duplicates easier to
compare, but you cannot edit records displayed
in a sorted list.
If Unique Structures Only is selected, the query
will be the same as the parent list, but with only
These are generic searches, made without entering one unique copy of each duplicate structure.
any query information. The options are:
NOTE: The Duplicate search must be performed in Full
Empty StructuresLocates records Structure mode. If the Search type is set to Substructure, you
containing no structure. It is equivalent to will get an error message reminding you to reset the search
specifying a molecular weight of zero in a type preference to Full Structure.
regular search. It is provided because the latter
method is a bit obscure. With ErrorsLocates records with possibly
ReactionsLocates structures that are reac- faulty structures. Depending on the error,
tions. The same effect can be achieved by and whether the database is read-only, it may be
entering a bare arrow as a structure query. possible to automatically re-register the struc-

Chem & BioOffice 2006 /ChemFinder Searching 419


Special Structure Searches
ture with a corrected version. Unlike other of explicit bonds must not exceed the capacity
search operations, this scan begins at the of either atom.) You get this sort of structure
currently displayed record and proceeds to the when attempting to draw a bond from an
end of the record set, or until the scan is existing atom, but miss and accidentally create
Administrator

aborted. a new atom. ChemDraw flags these cases with


a wavy red box.

3D not scaled in Angstroms


Flags structures with Z coordinates not scaled
in Angstroms. Such structures will not be
struck in a 3D search.
Outdated representationAs the MST data-
base format evolves, it becomes problematic to
correlate old stored information with the
current live data structures. Moreover, bugs
affecting stored data (e.g., molecular weights)
get fixed, making the stored data become grad-
The following categories of structural error are
ually less effective for searching. The best solu-
treated:
tion is to upgrade databases periodically. This
Ambiguous stereochemistryFlags struc- menu option lets you locate and repair faulty
tures with ambiguously drawn tetrahedral or data in an older database without upgrading the
double bond stereochemistry. Not correctable. database.
Valence/chargeFlags structures containing MiscellaneousPresently, this checks one
an atom with an impossible valence or charge. thing: that isotopic masses seem reasonable.
Sometimes correctable.
Net charge presentFlags structures To perform a With Errors search:
containing a net charge. This option is not 1. Select the categories of interest.
checked by default because it is not normally
2. Click the Scan button.
useful. Not correctable.
Unrecognized atomsFlags structures When a structure is flagged, its record is
containing an atom that was not interpreted by displayed, the offending atom or bond (if any)
ChemFinder. Such atoms typically have atom is flashed and an alert offers the user several
type R with a greyed text label containing ques- choices.
tion marks. Not correctable. The options are:
Mass imbalanceFlags reactions in which
the molecular formulae of reactants is different if you want to... then click...
from products. Not correctable.
Doubly drawn atomsFlags structures in ignore the error and Continue
which two atoms are very close together and at continue checking the
least one of which lacks a label. (Also, to qualify same structure.
as a doubly drawn pair, the combined valence

420 Searching CambridgeSoft


Special Structure Searches
if you want to... then click...
Managing Queries
ChemFinder 9 has a new tool to manage queries.
rewrite the MST record, Reregister The Queries Tree Control in the Explorer window
thus correcting the maintains a list of search queries from the current
problem. and previous sessions. Queries are associated with
forms, and the query list is saved when you save the
The Register (and like form. When you open or activate an existing form,
buttons) will not appear if the tree updates to show only the queries for that
the database is read-only or form.
if re-registering would not
Each time you carry out a search or list operation, a
correct the problem.
new query is generated in the tree. A name is
assigned to the query, and it is displayed in the tree
re-register other records Rereg. Sim. Recs. along with the size of the list (number of hits) and a
that exhibit the same type (Re-register Similar brief description. The generated name is Q<n>*,
of error automatically. Records) where n is a sequential number, and * indicates that
the query has not been named or marked for saving.
suppress all alerts and re- Reregister All
register all records that may CAUTION
benefit from it.
Depending on your preference settings, unnamed queries
may be automatically discarded. See Saving and
leave the current record as Skip to Next Record Restoring Lists on page 423 for details.
is (uncorrected) and
continue the scan from the
To activate the Queries tree control:
next record.
1. Select Explorer Window from the View menu.
stop the scan. Stop Scanning 2. Click the Queries tab to display the Queries
This leaves you on the last tree.
record that exhibited a Queries are listed as children of the database
problem (displayed as Full List). When you select Search Over
Current List from the Search menu before
flash the problematic Flash performing a query, it is displayed as a child of the
atom or bond. previous list. (The current list is indicated with a
frame around the colored box.)
This button only appears
when the error revolves
around an atom or bond.
Clicking the button creates
a circle that moves toward
the atom/bond, drawing
the eye to it.

Chem & BioOffice 2006 /ChemFinder Searching 421


Managing Queries
Database (Full List) if you want to... then
choose...
Current list (marked with
a frame)
Administrator

Search Over Current List choose a different query icon Change Color
query (child list) color from the Color Picker
dialog.

modify the query and/or rerun Restore Query


it.

To restore a query: Restore Query goes to Query


mode and displays the structure.
Double-click a query. You may modify the query, then
rerun it manually.
TIP: Double-clicking the root item, Full List, has the
same effect as choosing Retrieve All from the Search
save the query to a separate file, Save Query...
menu.
with extension .cfq.

The Queries context menu mark the query so it will be Keep


saved (as named) when the form
When you right-click on a query, you display a menu is saved.
with commands to manage the query.
This has no effect unless the
Query Saving preference has
if you want to... then been set to Discard unnamed
choose... queries. See Saving and
Restoring Lists on page 423.
repeat the search using the Rerun
selected query. (This is the same delete the selected query from Remove
as double-clicking on the query.) the tree.

The next time you save the


merge the hits of the selected Restore List
form, this query will be lost. If
query with the current list. See you delete by mistake, you can
Restoring a Hit List on page close and reopen the form
424 for details. without saving.

apply the query's color to a plot Color On Plot


of the intersection of the
selected query with the current
list. (This is the same a single-
click on the query.)

422 Searching CambridgeSoft


Managing Queries
The current list acts like a full database. For
if you want to... then example, a Retrieve All command will retrieve
choose... only this list; without selecting Search Over
Current List, searches will go over it only, etc.
rename the query. Rename
To reset searches to the full database:
When the Query Saving prefer- On the Search menu, point to Domains and
ence has been set to Discard select Reset to Full Database.
unnamed queries, this has the
same effect as Keep. NOTE: Set Domain to Current List remains in
effect until cancelled. If you save the form, it will be
for all queries at the same depth Sort Folder saved with the form file and will still be in effect when
in the tree, sort alphabetically by you open the form again.
name.
You also use the context menu to display the Query Saving and Restoring Lists
Properties dialog box. In this dialog box, you can
modify the query name, add a comment, or change You can save queries individually as .cfq files (as
the color used in plots. Text entered in the with previous versions of ChemFinder) or
Comments box will replace the standard description automatically when saving the form. The old
displayed along with the number of hits. commands for saving and restoring lists (as .cfq
files) still appear on the Search menu, and on the
context menu displayed when you right-click on a
specific query. If you close a form without having
saved your queries (or other changes), you are
prompted to save or discard changes.

On the General tab of the Preferences dialog box,


there is an option to save all queries (the default), or
only those that have been renamed. If you select
this option, there are two ways to save a query with
the form:

Domains Rename the query, either with the Rename


command in the context (right-click) menu, or
If you are browsing a list other than the full from the Query Properties dialog box (also
database, you can make it seem that the database accessed from the context menu.)
consists only of the current child list.
Mark the query with the Keep command on the
On the Search menu, point to Domains and context menu. Query saved in this way retain
select Set Domain to Current List. their standard name.

Chem & BioOffice 2006 /ChemFinder Searching 423


Managing Queries
To edit a saved hit list, open the text file with a text
editor such as Notepad and edit the values you want
changed.
Administrator

Restoring a Hit List


Once you have saved a hit list, you can perform
another search then integrate the results from the
second search with the results from the first. Thus,
you can perform Boolean operations on different
searches.

To integrate the results of two searches:

1. Perform a search and save the hit list.

Saving a Hit List 2. Perform another search.


3. From the Search menu, choose Restore List.
Create a query and perform the search.
The Open dialog appears for you to choose the
file that you want to integrate with the current
1. When you have received the hit list, choose
hit list.
Save List from the Search menu.
4. From the Open dialog box, open the text file
The Save As dialog appears for you to save the that you want to integrate with the current hit
hit list as a text file. list.
The Restore List dialog box appears.

5. Select the integration option and click OK.


Replace current listdiscards the current hit
list and displays the records from the hit list
2. In the Save As dialog, type a filename for the you chose to open.
hit list, and click Save.
Intersect with current listdisplays only
The file consists of a list of values of the primary those records that appear in both the current
key of each record in the hit list. If there is no hit list and in the saved hit list. This is a
primary key, the molecule ID is used. Boolean AND operation.

424 Searching CambridgeSoft


Managing Queries
Subtract from current listdisplays only To create the hitlist for the first part of this search:
those records that are in the current hit list but
1. Open the CS_Demo database.
that are not in the saved hit list. For example, if
the current list contains records, 1, 2, 3, 4, and 2. Create the first query by drawing benzene in
5, and the restored list contains records 4, 5, 6, the Structure data box and entering 50-200 in
and 7, then only records 1, 2, and 3 will be the Molecular Weight Data Box.
displayed. This is a Boolean NOT operation; it 3. Search the query.
shows the records in the current list that are You get 75 hits.
not also in the restored list.
4. From the Search menu, choose Save List.
Union with current listdisplays all records 5. Save the hitlist as benz.txt.
in either the current list or the saved hit list.
This is a Boolean OR operation. To create another hitlist for the second part of the
search:
The hit lists are integrated. You can browse and
save this new hit list just as any other hit list. 1. Draw the query shown below in the Structure
Data Box.
NOTE: If you merge two lists and get an empty result, N
an alert appears and the list reverts to the previous list. C

2. Search the query.


Search Examples You get 103 hits.
3. From the Search menu, choose Save List.
The following are examples of searching options.
By specifying atom and bond properties, you see 4. Save the hit list as c-n.txt.
how to use the query functions in ChemDraw to Integrate the two hitlists:
search the database more effectively. All
substructure search query properties recognized by 1. From the Search menu, choose Restore List.
ChemFinder are listed and described in Appendix J, 2. In the Open dialog box, open the benz.txt file.
Structural Query Features..
3. In the Restore List dialog box, click Replace
current list,
Working with Multiple Hit Lists 4. then click OK.
A detailed example of how you can use hitlist You return to your first list of 75 hits
management to perform specific, sophisticated 5. From the Search menu, choose Restore List.
searches follows. 6. In the Open dialog box, open the c-n.txt file.

Suppose you want to search for all compounds in 7. In the Restore List dialog, click Subtract from
the CS_Demo database that contain a benzene current list, then click OK.
substructure and have molecular weights between The hit list is reduced to the 60 records with
50 and 200. After you perform this combined compounds containing a benzene
search, you want to find which of these compounds substructure, not containing a C-N
do not contain a carbon-nitrogen bond. By substructure, and having molecular weights
integrating hitlists, you can perform this search. between 50 and 200.

Chem & BioOffice 2006 /ChemFinder Searching 425


Search Examples
If you had chosen the Replace current list option in The A label denotes that the atom may match any
the last step, then only the C-N records would be atom except hydrogen. The indicator near the bond
displayed. Choosing Intersect with current list would indicates that the bond has been defined; in this
display those records in either list. Finally, choosing case, in the Bond Properties dialog of ChemDraw,
Administrator

Union with current list would display all records from


you specified that the bond type may be single or
both lists.
double, S/D. Finally, by entering S,Se,Te enclosed
Using Atom Lists in brackets, you specified that one of these elements
must match in the target molecules.
Using the text tool in ChemDraw, you can enter in
a structural query a list of possible atom types, one
of which must match in the target compound. Searching Fullerenes
If you want to search for molecules containing a A search of fullerenes can illustrate the restrictions
benzene ring with an ether, amine or phosphane you can place on a formula search. Suppose you
group, a query might look like the following:
want to find all fullerenes containing 20 to 80
[O,N,P] carbon atoms, but you also do not want to include
large organic molecules.

The formula query could be:


Atom Types and Bond Types C20-80 H0
To broaden or narrow a search query, you can
define the properties of the atoms and bonds in a By designating zero hydrogen atoms, you exclude
structural query. These properties are definable in hydrocarbons from the hit list. By clearly
ChemDraw Pro using the Atom Properties and capitalizing the elements and spacing the query, you
Bond Properties dialogs accessible from the avoid searching ambiguities, although there were no
Structure menu. ambiguities in this example.
Suppose you want to find all molecules that contain
a non-oxygen chalcogenide bonded to another Searching Link Nodes and Multivalent
atom, not necessarily carbon. You also want the Rs (MVRs)
bond type between the chalcogen and the other
atom to be a single or double bond. The query, ChemFinder versions 8 and later contain a new
drawn in ChemDraw Pro, may look like this: atom type, the link node. A link node is a
placeholder for zero or more unspecified atoms. It
This atom may be any non-hydrogen atom is especially useful when searching for targets with
A
any of several ring sizes, or chains substituted in
S/D This bond may be single or double
particular ways at either end. While link nodes are
[S,Se,Te]
traditionally divalent, ChemFinder places no
This atom must be S, Se, or Te
constraints on the upper limit of the range. Multi-

426 Searching CambridgeSoft


Search Examples
valent R (and A) atoms are functionally similar to Using ChemDraw's Atom Properties menu to
link nodes. They may be thought of as higher apply either of these properties to the link node
valent link nodes. restricts the range of target atoms to the specified
topology. For example, specifying the link node to
O be aromatic would give the following results:
(C
H2)0
-200
B
r Br Query Results
(C
H2)1
-2

Hits cyclopropanones, Hits alpha, omega- Will hit


cyclobutanones, and dibromides and Br Br

-lactams bromine
(C
H)0-200 Br
C
l P
h C
l P
h B
r B r
A (L
N )1-999 Br Br

A multivalent A query Br

Will not hit


The traditional representation of a link node is CH2, Br Br

but this is misleading because any atom type can


substitute for the link node. For this reason,
ChemFinder represents link nodes as LN.

NOTE: ChemDraw recognizes link nodes, but does not


support an LN atom type. Use (R) instead of (LN) when Searching More Than One Substructure
drawing the query in ChemDraw or with the ChemDraw
A substructure search may contain more than one
ActiveX control.
substructure unit. Suppose you want to find all
compounds in the CS_Demo database which
Although any atom type of a target atom matches a
contain a benzene substructure and another
link node, you can impose two restrictions the on
substructure unit containing chlorine bonded to
the link node:
any atom. A structure query, as drawn in
Unsaturation ChemDraw would look like this:
Ring topology.
A Cl

You should get five hits. Browse the hits. By


specifying the query as above, you obtain hits such
as benzyl chloride, shown below, where the
substructure units are not connected.

Chem & BioOffice 2006 /ChemFinder Searching 427


Search Examples
.
H Cl O Cl
O

H Cl
OH
O
Administrator

O
OH
The substructure units can overlap; they can share
a common atom. Examples of this overlap are
shown below
Cl

428 Searching CambridgeSoft


Search Examples
Chapter 21: Customizing ChemFinder
Overview Structure Display
To display carbon atoms on methyl groups or on
You may customize ChemFinder in the following
interior aliphatic or aromatic chains, check the
ways:
relevant check boxes in the Carbon labels section.
Customize display of your molecules, fonts,
pictures and forms. To display hydrogen atoms on heteroatoms or on
terminal carbons:
Customize the Favorites tree
Design the toolbars to your specifications. Select the Fill valence radio button in the
Hydrogen Labels section.
Perform automated tasks, such as interfacing
with Microsoft Excel, or by using CAL, the Selecting None means these types are displayed
ChemFinder Automated Scripting Language. without implicit hydrogens.

Setting Preferences
The Preferences dialog box allows you to
customize the display of molecules, pictures, and
forms, and set options for searching and exporting.
1. Click the tab containing the preferences to set.
2. Select the preferences, and click OK.

Display Preferences
To set the Display preferences:
From the File menu, choose Preferences. To display reaction centers:
The Preferences dialog box appears with the On the View menu point to Structure, and
Display tab on top. select Reaction Info.

Chem & BioOffice 2006 /ChemFinder Customizing ChemFinder 429


Setting Preferences
With reaction centers shown, any bond that B: show/hide bond numbers
changes in the course of a reaction is colored. M: show/hide atom-to-atom maps
Additionally, any atoms that participate in
reaction centers are circled if none of their R: show/hide reaction centers
Administrator

adjacent bonds participate in the reaction S: show/hide stereochemistry


center.
Scaling Structures
To scale each structure so that it is as large as
possible within its structure box:
Click Fit to box.

To display atom-to-atom maps: To display all structures with a constant bond


length:
On the View menu point to Structure, and
select Atom-to-Atom Map. 1. Select Uniform bond length.

With atom-to-atom maps shown, equivalent 2. Select the bond length percentage.
atoms in reactants and products are colored the With Uniform bond length selected, structures
same. may be reduced in size if they are too large to
fit within the structure box, but they will never
be enlarged.

Framing Pictures
To select whether the pictures in a form are
These two preferences affect only the display surrounded by a border:
of reactions. Not checking the boxes means
Select Framed.
these types are displayed as all other atoms and
bonds.
Grid Spacing
Using Keyboard Shortcuts To set the grid spacing (in pixels) on a form:

When using a form, you can use keyboard shortcuts Type in a number, or press the up and down
to show or hide atom-to-atom maps, reaction arrows to change the current value by one unit.
centers, atom numbers, and bond numbers. Choosing a small grid spacing allows you to place
objects more precisely by snapping to a tighter
To use keyboard shortcuts select Enable keyboard matrix.
shortcuts on the Display tab of the Preferences
dialog box. Color Preferences
When keyboard shortcuts are enabled, the To set the color preferences:
following keys toggle these properties:
In the Preferences dialog box, click the Color
A: show/hide atom numbers tab.

430 Customizing ChemFinder CambridgeSoft


Setting Preferences
ASCII file export (see Exporting an ASCII
File on page 401)
Alerts
ChemFinder opening window
List of the last files used

To set the general preferences:

1. From the File menu, click Preferences.

The Preferences dialog box appears.


2. Click the General tab.

The General tab appears.


The color tab allows you to specify the color of
various interface elements.

To set a color:
3. Click the button corresponding to the interface
element you want to change.
The Color dialog box appears.

Structure Registration Options


To have ChemFinder present an alert when
attempting to enter a structure with an atom in a
non-standard valence state:
In the Registration section, click Check valences.
To have ChemFinder confirm when you are about
to modify data in the database:
In the Registration section, select Ask to commit
4. Select the new color. changes.

5. Click OK. ChemFinder Opening Options

General Preferences You can set ChemFinder to open with the


ChemFinder Opening dialog box or to open the
The general preferences are as follows: last form you were using.

Chem & BioOffice 2006 /ChemFinder Customizing ChemFinder 431


Setting Preferences
To set the options for what ChemFinder displays
when it starts up:

1. On the General preferences tab, select one of


Administrator

the following:

If you want to Then click


set ChemFinder
to

You can open items in the Favorites Tree from


start with the Show opening dialog.
within ChemFinder by double-clicking them:
Opening dialog box

if the file is double-clicking


open the last form Open last form on
will
you used startup.

a ChemFinder form, open it.


2. Click OK.

a ChemFinder script, execute it.


Setting the Recent File List Size
You can set the number of files you opened recently an SD- or RDFile, load it.
that ChemFinder shows.
a ChemFinder query, restore it.
To set the list size for the most recent files opened:
any other type of open it in its source appli-
1. From the General preferences tab, choose the document, cation.
number of file names to display.
2. Click OK. There are two ways to add items to the Favorites
Tree:
Customizing the Favor- Drag one or more files from Windows
Explorer into the Favorites window.
ites Tree Use the context menu.
The Favorites Tree is a user-constructed collection To create a new folder in the Favorites Tree:
of file system objects. It may include folders,
1. Point to the parent folder. (The new folder
subfolders, ChemFinder forms, structure files, and
will be a subfolder of this folder.)
documents of all kinds. Its purpose is to allow you
to collect, organize, and access the data and 2. Right-click and choose New Folder.
documents you use regularly. 3. Type in a new name for the folder.

432 Customizing ChemFinder CambridgeSoft


Customizing the Favorites Tree
To add an item to a folder: To add an option to a toolbar that is already in the
ChemFinder window:
1. Point to a folder.

2. Right-click and choose New Item. 1. In the Customize dialog box, click the
Commands tab.
A File dialog box opens.
2. Locate the command and click+drag an option
3. Browse to the file you want to add, select it, and
from the Commands window to a toolbar in the
click Open.
ChemFinder window.
The item is added to the folder.
The option appears where you drop it on a
To rearrange items or folders in the tree: toolbar.
Drag the item to a new location. You can delete a button by dragging it off the
To resort a folder or subfolder alphabetically: toolbar.

Right-click on the folder and choose Sort To return a toolbar to the default settings:
Folder.
1. In the Customize dialog box, click the Toolbars
Customizing Toolbars tab.

ChemFinder lets you format your toolbars. You can The Toolbars tab appears and shows all of the
Customize the toolbars by dragging buttons on or toolbars that currently appear in the
off. ChemFinder window.

To open the Customize dialog box:


From the View menu, point to Toolbars, and
choose Customize.
The Customize dialog box appears.

2. Click the toolbar you want to return to default


settings, then click Reset.

The toolbar in the ChemFinder window


changes to the default settings.

Chem & BioOffice 2006 /ChemFinder Customizing ChemFinder 433


Customizing Toolbars
To return all the toolbars to the default settings: 3. In the form, click the formula box into which
you want to paste the text and press Ctrl+V.
1. In the Customize dialog box, click the Toolbars
tab. To display data about the selected element in the
Element Editor, do one of the following:
Administrator

The Toolbars tab appears and shows all of the


toolbars that currently appear in the Display the desired element and click the
ChemFinder window. display box at the top of the Periodic Table
2. Click Reset All. window.
Double-click the desired element button.
Using the Periodic Table
ChemFinder features a periodic table for data
display and formula entry. Selecting an element
displays physical and historical data.

To display the Periodic Table window:


1. From the View menu, choose Periodic Table.

The Element Editor displays properties of the


selected element. The color of the element is shown
in the periodic table for that element and in any
structure data boxes in which that element is
2. Click on an element to display its name, mass,
present.
and other properties in the top box, and to To change the color of an element:
display its symbol in the bottom edit box.
Click Color.
By clicking on different elements and numbers
sequentially, you can create a molecular formula in To reset an elements color to the default:
the bottom editable text box. You can then paste
this formula into the form for a formula query. In the Element Editor, click Revert to Default.

To copy a formula from the Periodic Table to the


NOTE: The data of the Periodic Table is stored in a tab-
form:
delimited ASCII file called CS ChemFinder Custom
1. Drag the text to copy, then press Ctrl+C. Elements.txt located in your ChemFinder system directory. It
can be easily edited with a text editor or spreadsheet program
2. Click OK in the Periodic Table window to close if you want to change default data values.
it.

434 Customizing ChemFinder CambridgeSoft


Using the Periodic Table
ChemFinder Automation The Enter CAL Command dialog box appears.
You can type CAL commands and execute them
Language (CAL) one at a time.
ChemFinder is equipped with its own scripting The Command drop-down list contains previously
language, the ChemFinder Automation Language entered commands.
(CAL). CAL is used to operate the program from
To rerun a previously entered command:
the keyboard, or to create custom scripts for
automating simple operations such as switching 1. Select the command from the list.
between forms or sending data to Microsoft Excel. 2. Click Execute.
CAL scripts are stored in text files, with their For detailed information about the command
pathnames stored in forms. In Chem & BioOffice language, see Appendix M, CAL Commands.
2006 you have the option of storing scripts directly
in formfiles. Scripts created in Chem & BioOffice Getting CAL Help
2006 are stored internally by default. When you To display information about the CAL scripting
open a form which references external script files, language:
you will be prompted to store the script internally.
In the Enter CAL Command dialog box, click
If you choose to convert the external script files to Help.
internal, the scripts will be saved when the form is
The CAL Scripting Help window appears
saved, and the original script files may be deleted.
containing commands, variables, and syntax
Scripts originally saved as internal may be also be
notes.
saved externally.

TIP: You can save the form with a different name, and the
original will remain untouched (in which case deleting the
script files would not be a good idea).

If you choose to leave the form unmodified, the


alert will continue to show up every time the form
is opened. You can suppress the prompt with the
Check for external scripts checkbox in the General
tab of the Preferences dialog box.
To perform a CAL command: TIP: In Chem & BioOffice 2006 this window is resizable.
From the Scripts menu, choose Command
Line.
Creating a Script
To create a script:
1. Create a button on a form.
2. Label the button.
3. Right-click and choose Edit Script.

Chem & BioOffice 2006 /ChemFinder Customizing ChemFinder 435


ChemFinder Automation Language (CAL)
The CAL editor appears. To execute a script not assigned to a button:

Choose the script from the Scripts menu.


Administrator

NOTE: To execute a script that does not appear on the


menu, use the Command line and enter Call <script
filename>.

Debugging a Script
You can step through a script line-by-line when
4. Type in your script commands, or use the debugging it.
Import button to import an existing script.
To view a script line-by-line:
5. Click OK to create a new file.
1. From the Scripts menu, choose Command
TIP: You can still create scripts in Notepad or another text Line.
editor if you wish. Save the file with extension .cfs in the The Enter CAL Command dialog box
\ChemFinder\System subdirectory if you want the name appears.
of the script to appear on the Scripts menu.
2. Type step on and click Execute. this turns on the
step mode, where each step is displayed.
The CAL editor is a simple, resizable text-entry
window. It accepts carriage returns and tabs. To 3. Run a CAL script by doing one of the
copy /paste, use Ctrl+C/Ctrl+V. To undo or redo following:
(last change only) use Ctrl+Z.
If your script Then
The Verify button runs the script through the CAL
command parser. The parser checks only that lines appears in the choose the appropriate
begin with recognized keywords, so just because a Scripts menu. script.
script is parsed without error does not mean it will
run correctly. does not appear in in the Enter Script
the Scripts menu. Command dialog box,
The Properties button displays a dialog box used to
type call and the name
specify whether the script is to be stored in an of your script, then
external file or internally, and to provide a file path click Execute.
or script name. You can assign a script any name
you like, but the name must be unique among
4. Press any key except Escape to execute the
scripts on the current form.
command and go to the next command.
The OK button saves the script. The Run button As each step is encountered, it is displayed in
saves the script and runs it. the status line.

436 Customizing ChemFinder CambridgeSoft


ChemFinder Automation Language (CAL)
5. Press the Esc key to stop debugging the script. The script will automatically be executed at the
specified event.
CAUTION
5. Save the form if you wish to keep the changes.
In the Enter Script Command dialog box, type step off to
exit the debugging mode. Communicating with
Other Applications
Trigger Scripts There are two general methods of communicating
Trigger scripts run in response to certain with other Windows applications such as Microsoft
predefined events. A trigger script can, for example, Excel: by using a script within ChemFinder, or by
automatically load a box with data calculated from using a Visual Basic procedure within the other
the contents of another box whenever you move to application. The following is an overview of each
a new record. method.

You access a trigger script from the Run script on Using Scripts
listbox in the Form tab of the Properties dialog box.
The listbox shows the available trigger events, and A ChemFinder (CAL) script can communicate with
allows you to create, edit, enable, or disable scripts other Windows applications using either of two
for each event. commands:
EXECto start an application and possibly pass
information on the command line.
DDEto communicate using Dynamic Data
Exchange with a DDE-ready application.
Using EXEC is straightforward, but limited. You
can start all Windows applications by this
Run script on... command. Most can be passed a filename on the
command line, such that the specified file is opened
(or printed) on startup. A few applications can
accept more detailed instructions. Consult the
applications manual for information about how it
To run a script on an event: can be operated using the command line.
1. Click the checkbox of the desired event in the If you have Visual Basic or similar programming
listbox. If an event is not checked, no script will language, you can extend the power of EXEC. You
run on that event, even if one is available. can write an application using the advanced features
2. Click the event name to highlight the row of of Visual Basic, then call the application from
the listbox. (Clicking in a checkbox does not within ChemFinder using the EXEC command.
select the row.)
Using DDE is more complicated. You can operate
3. Click the Edit button to write or edit the script most Microsoft Office components and many
in the CAL Editor. other programs to varying extents with DDE. For
4. Click OK to return to the form. example, practically every command on the Excel

Chem & BioOffice 2006 /ChemFinder Customizing ChemFinder 437


Communicating with Other Applications
menu can be executed by DDE. The syntax is WRITETEXT C:\DATA.TMP
rather difficult, but can usually be worked out by DDE Excel System [OPEN(C:\DATA.TMP)]
experimenting and consulting ChemFinder help.
DDE Excel
An example is given below.
Administrator

System [COLUMN.WIDTH(1,C1:C4,,3,1)]
DDE is the most direct way of using Excel to view
data from ChemFinder. The first line writes out the current ChemFinder hit
list as a temporary delimited ASCII file. By default,
To use MS Excel to view ChemFinder data: all fields that appear in boxes on the current form
1. Start MS Excel. You can start it manually using except structure, but including formula and
a CAL script or by starting the application in molecular weightare written. The second line
Windows. instructs Excel to open the file. Excel can
automatically recognize the file format as tab-
2. In ChemFinder, obtain the hit list you want to
delimited. The third line instructs Excel to auto-size
transmit to Excel. If you want to work with the
column widths 14 to fit their contents.
entire database, from the Search menu, choose
Retrieve All.
NOTE: This example requires that the text export
3. Execute a short CAL script (below) which
exports the hit list as comma-delimited text to delimiter be set to TAB in the General tab of the Preferences
a temporary file, then instructs Excel with dialog, otherwise Excel may not read the file correctly.
DDE to load that file into a spreadsheet.
You can include either or both of these scripts on
4. Activate Excel to work with the data in the
spreadsheet. the Scripts menu, and you can activate them with
buttons on the form. To include a script on the
This procedure takes data one way, from Scripts menu, give it a filename with extension
ChemFinder to Excel. Returning modified data .cfs, and place it in the ChemFinder System
from Excel to ChemFinder can be done using other directory, or in the directory containing the
techniques described in this chapter. ChemFinder application. To activate a script from a
Here is a script to start up Excel: button, label the button with a script filename or
string which can be converted into a filename. For
*RUNEXCEL.CFS script to start Excel example, if TOEXCEL.CFS exists in the
* ChemFinder System directory, label a button
EXEC c:\msoffice\excel\excel.exe ToExcel to start the script. For more
If the Excel program is on your search path, you information, see Adding a Button on page 343.
can eliminate the complete pathname and just give
the executable name (exec excel.exe); if not, you Using Visual Basic
may need to modify this script to indicate where The second method of communicating between
EXCEL.EXE is located on your system. ChemFinder and other applications such as Excel is
Here is a script to transfer the current hit list from using OLE Automation. ChemFinder is an OLE
ChemFinder to Excel: Automation server, meaning that it offers a
collection of data management capabilities to
*TOEXCEL.CFS script to send data
outside programs capable of communicating with
*to Excel OLE objects. While this collection is currently fairly
* small, it is adequate for a variety of data retrieval and

438 Customizing ChemFinder CambridgeSoft


Communicating with Other Applications
search tasks. This feature allows you to write a extensions .mdb and .ldb), and the forms (with file
custom Visual Basic procedure that directly extension .cfw) used to view the structures and the
retrieves and manipulates data from ChemFinder. data.

The general procedure for accessing ChemFinder If you have Access on your system, double-clicking
data from within a Visual Basic script is as follows. an .mdb file in Explorer starts up Access and opens
the specified database.
1. Create a ChemFinder Document object, When you open a ChemFinder database in Access,
typically passing a filename so that you open a you will see the same tables as displayed in the
form complete with its database connection. ChemFinder Database dialog box, including the
main structure table (usually named MolTable),
2. Use methods of the Document object to move
but you will not see columns for structure, formula,
through the database, search, and access data.
or molecular weight. These fields cannot be
Document methods include some that access manipulated directly using Access.
Field objects, used to query the data in the data-
base, and Molecule objects, for accessing The following are some of the operations you can
details of molecular structures. perform on a ChemFinder database using Access.
Most of these capabilities are not available through
For more information, see the CambridgeSoft SDK the current version of ChemFinder:
web site:
Compress or repair the database.
http://sdk.cambridgesoft.com/ Change column (field) or names or formats.
Change table names.
Using Microsoft Access with
Add or delete columns or tables.
ChemFinder
Import or export tables.
The methods described above for communicating Load non-structural data from various file
between ChemFinder and Excel apply also to types, including delimited ASCII, Excel, or
Access. You can start Access using the EXEC Word.
command. You can send it DDE commands
Move quantities of data from one column or
contained in a CAL script, although Access row to another.
provides fewer capabilities with DDE than does
Excel. Or you can write programs using Access Carry out complex queries on non-structural
Basic that rely on the OLE Automation methods data.
found in ChemFinder. In addition, you can use Permanently change the sort order of a table.
Access directly to operate on a ChemFinder
For more information about these actions, please
database.
consult the Microsoft Access Users Guide.
A ChemFinder molecule database consists of three Do not add or delete records to the MolTable
components: the structure storage files (with file within Access, because the data component of the
extensions .mst and .msi), the data storage files, database will become out of synchrony with the
which include a Microsoft Access database (file structure component.

Chem & BioOffice 2006 /ChemFinder Customizing ChemFinder 439


Communicating with Other Applications
Administrator

440 Customizing ChemFinder CambridgeSoft


Communicating with Other Applications
Chapter 22: Pro ChemFinder/Oracle
Overview When working with large databases, you can
choose a new mechanism which eliminates
certain slow operations associated with large
Users familiar with ChemFinder will find that, for
recordsets (e.g., Move Last). This is a user
the most part, ChemFinder/Oracle operates the
choice because there are trade-offs involved.
same way. You should be able to open a database,
browse, search, register, load and so forth, without You cannot create an Oracle database, but if
worrying about what sort of database is on the back you have the privileges you can create a table
end. In practice, however, there are several visible within one. This causes import operations to
differences and a lot of invisible ones. work somewhat differently.
To improve performance, you can create
When you open an Oracle database in indexes on selected columns.
ChemFinder/Oracle, you enter a new body of code
Other more subtle differences are noted in the
which connects directly to Oracle, and carries out
sections below.
all searches and transactions on the server. This
new mode of operation requires a different
underlying technology, based on Microsoft ActiveX
Setup
Data Objects, and a different philosophy in some Before you can make use of the
aspects of usage, such as the handling of lists, and ChemFinder/Oracle, your machine must be
new features, such as index management. All of configured as an Oracle client. If you are already a
these are described in this document. user of the CS Oracle Cartridge, you are probably
all set. If not, you will need to enlist the help of an
In ChemFinder/Oracle: Oracle administrator to set up the server and set
Searches are carried out on the server, you up as a client.
including structure searches. For ChemFinder 10 installation instructions, see the
readme.txt included on the distribution media.
Search results are automatically deposited
directly into tables in the Oracle database. Ideally, ChemFinder/Oracle should access any
existing Oracle database in any format. In practice,
Hitlists are not saved in files, but to other tables
there are some limitations. See Pre-Setup
in Oracle.
Procedures on page 491 for notes and
Saved lists can be annotated, and on restore can recommendations about preparing an Oracle
be selected from a pick-list directory. database for use with ChemFinder/Oracle.

Chem & BioOffice 2006 /ChemFinder ChemFinder/Oracle 441


Setup
Opening an Oracle Data- The database is opened and the list of tables
displayed.
base
NOTE: The list of tables shown in the tree consists of
all tables and views owned by the current user, plus
Administrator

To open an Oracle database:


those to which the user has been granted certain
1. Click the Oracle Database button in the privileges. To see the details, you can turn on SQL
Database tab of the Properties dialog. tracing while a database is being opened.

This brings up the CS Oracle Connection 3. Proceed as you would for any ChemFinder
dialog. database: click to select the table you want to
display, set other desired options, and check the
box on the Form tab if you want to generate a
form automatically.
Notice the new Oracle tab of the dialog,
described in Setting Oracle Preferences on
page 444 The features on this tab are mainly for
advanced users and do not require adjustment.
Oracle
Database
NOTE: The Oracle tab appears in the Properties
button dialog only when an Oracle database is open.

4. Click OK.
NOTE: The Oracle Database button is available to The database opens, in a display form if you
any user. There is no check to see whether the machine requested one.
is a valid Oracle client. The Database Wizard can also be used to open an
Oracle database. A button on the Wizard labelled
2. Enter values for host name, user name, and CS Oracle Cartridge brings up the appropriate
password the same values you use to log in Oracle parts of the process.
from any Oracle client. OR:
When you have opened an Oracle database, note
Choose a name from the drop-down list of that some Properties dialog tabs show entries not
recently-used items. When you choose an item available in ChemFinder, including:
from this list, it automatically fills in the user
Database tab: CS Oracle Cartridge version if
name, and the password if Save password was
any.
checked when the item was created.
Table tab: Table owner name; name of primary
NOTE: The first time you bring up the Oracle index if any.
Connection dialog box there is no list of recent items, so Field tab: Oracle native data type name; name
ChemFinder offers to create one for you. If you accept, it of associated index if any.
generates a list of all available hosts, as found in the file
When you open an Oracle database and select a
tnsnames.ora created during Oracle client
table, ChemFinder/Oracle gathers information
configuration.
about the columns. If you open a table you know to

442 ChemFinder/Oracle CambridgeSoft


Opening an Oracle Database
contain structures, and ChemFinder/Oracle does 2. The query is converted to a SQL select state-
not show a structure (or formula or molweight) ment. Query components in form boxes are
column, then it may be necessary to set up some ANDed together (just as in ChemFinder), where
configuration information about the table. For the structural parts are calls into the CS Oracle
details, see Configuration Via CF_SETTINGS Cartridge structure search functions.
Table on page 492. 3. The hits table is created, if it does not already
exist.
Searching
4. A unique ID is assigned to the new list which
From the user's point of view, searching in will result from the search.
ChemFinder/Oracle works basically the same way
5. The select statement is wrapped in a larger
as in ChemFinder: you enter a query, search, then
work with the hitlist. Internally, however, the SQL statement which will cause the results to
ChemFinder/Oracle machinery is quite different. be deposited directly into the hits table.
6. The SQL is executed.
There are three types of table involved in handling
hit lists. All are created in your own tablespace. One 7. When the search is complete, the results are
is global, applying to all lists saved from any table; new rows in the hits table. Each row contains
others are connected to the particular table or view the new list ID alongside the ID of a record
being searched. from the searched table.
CF_HITLISTS. The directory of all saved 8. The final list is prepared by a join, selecting
lists. This table is created the first time any list rows from the main table which have record
is saved. ID's matching those of the new list in the hits
table.
SAVED_tablename: All lists which have been
explicitly saved from a given table or view. This The resulting list is ready to browse, save,
is created the first time a list is saved. export, etc.
HITS_tablename: All lists automatically saved
after every search over a given table or view. NOTE: Text searches in Oracle are case sensitive. You will
This table is created the first time a search or get different hits from the query benz* than from
list operation is carried out and is deleted at the Benz*.
end of the session.
Here's what happens when you present a query to Handling Lists
ChemFinder/Oracle:
There are differences between ChemFinder and
1. If the query contains a structure, it is converted ChemFinder/Oracle in working with hitlists:
to a text representation and copied to a
temporary table. Save List does not bring up a file dialog in
ChemFinder/Oracle; instead, it presents a
NOTE: The table is called temp_queries. It is dialog in which you enter a name and a line of
created in the CSCartridge tablespace, and removed as comments for each list.
soon as the search is finished or interrupted.
Restore List presents a dialog in which you
ChemFinder does not yet handle the case of multiple
choose from the available saved lists (see
structure boxes where more than one contains a query.
screen shot below); double-click to select one.

Chem & BioOffice 2006 /ChemFinder ChemFinder/Oracle 443


Searching
Restore Previous List is no longer dimmed after Records per retrieve. Sets the size of the
you have done a single search; it is available, ADO recordset cache, that is, the number of
and will return you to the full list. (This is true records brought to the client for each retrieve
also in ChemFinder 10.) operation. This value can be adjusted for better
Administrator

performance, but in practice it does not have


much effect.

Cache ID's for faster moves. Checking this


box enables a new record-retrieval scheme
designed for more efficient browsing of large
lists; details are given in Fast-Move Caching
Scheme on page 491. The state of this
Over Current List, Omit From List, and Find List checkbox is saved with the formfile. Currently,
work as before. when you check or uncheck this box, you must
save and reopen the form before proceeding.
Setting Oracle Prefer- SQL Trace to file. Check this box to generate
ences a text file of the SQL being sent from Chem-
Finder to Oracle. To specify an output file,
When you are working with an Oracle database, the
Properties dialog contains a tab for Oracle settings. enter a pathname or use the browse
Items currently in this tab are as follows: button. The file is never overwritten: new data
are always appended. Tracing begins when this
Oracle box is checked, and ends when it is unchecked.
tab If you exit ChemFinder with tracing in effect, it
will be in effect the next time you start up, and
you will be given a quick warning about it on
the status bar.

CAUTION

The trace file can become very large if you turn on this
feature and forget about it.
Auto-sort on. Displays the default sort field.
All lists will be sorted in ascending order over
this field if no other sort criterion has been Updating and Adding
specified. At present, the auto-sort field is
always the primary key, and cannot be changed.
Data
Primary key. Names the primary key of the If you have privileges to add, update, and delete in
current table, if any. the table connected to your form, then you should
Saved hits. Displays the name of the table in be able to do these operations on records in the
which saved hitlists are stored for the current database just as in ChemFinder. However, there are
form, if one has been created. some cautions:

444 ChemFinder/Oracle CambridgeSoft


Setting Oracle Preferences
Do not modify data in an existing Web Server, To import data and structures into a new table:
RegDB, or E-Notebook database. Chem-
1. On an empty form, right-click and choose Data
Finder/Oracle does not automatically prevent
Source.
you from doing this, but you are sure to foul up
those systems unless you go through their 2. Click Oracle Database and proceed as
normal registration procedures, or know described under Opening an Oracle Data-
exactly what you're doing. base on page 442. It doesn't matter what table
you select, since you will be creating a new one.
Most database alterations are possible, as in 3. Click OK to return to the blank form.
ChemFinder: you can add, modify, and delete tables You are now ready to import.
and fields, assuming you have the appropriate
privileges. Differences include: NOTE: When you click OK to dismiss the properties
dialog, you will get a warning if the selected table does
When you create a structure field, you can give not have a primary key defined. You can ignore this if
it any name you like. you are about to create or load a new table. Otherwise,
you should consider using an Oracle tool to define a
Structure columns in tables managed by the CS primary key for the table.
Oracle Cartridge can be in any of several
formats, but ChemFinder/Oracle does not 4. Choose Import SDFile or Import Structures and
allow you to choose one: it defaults to a char- select the source file(s).
acter (CLOB) column storing text-encoded The Data Import dialog appears:
CDX.
Import tab
ChemFinder/Oracle does not allow you to
create an Oracle database in the same way Output database
ChemFinder creates an Access mdb file. The text box
equivalent in ChemFinder/Oracle is to create a
table.

Loading
You can build ChemFinder/Oracle databases by
loading from SDFiles or using Import Structures. 5. In the Output database box, you see the name
(RDFiles should work also, but have not been of the database followed by the table name in
tested.) However, because you cannot actually brackets. To specify the table to load, edit the
create a new database, the procedure is somewhat table name by typing between the brackets. If
different from ChemFinder. You must already have you want to create a new table, enter the name
a database open, then you can import to an existing you wish to give it. If you want to append to an
table or have a new one created. existing table, enter its name.

Chem & BioOffice 2006 /ChemFinder ChemFinder/Oracle 445


Loading
6. Set other options as desired, and click Import to ChemFinder provides information about these
begin the process. indexes, and allows you to create or recreate them if
necessary.
TIP: for text fields being imported, make them wider
To create a structure index:
Administrator

than the value determined by the input scan. (To do this,


double-click the name under Input Field and enter a
larger Width value.) Otherwise you might have 1. Right-click on the structure box of an Oracle-
problems if you append more records later. connected form, and choose Properties.
2. Go to the Field tab of the dialog.
7. After importing, you should create a primary
key and index; see Indexing on page 446. If the selected field is indexed, the index name
is shown in the properties box. In the example
To append to an existing table follow the procedure below, the index is named IX50.
above except:
Step 1: You can start with an existing form Field
instead of a blank one tab

Step 2: You should select the target table. When Index


you do, there will be no need to edit the table Name
name in Step 5.

Indexing
As every Oracle administrator knows, a key to good
performance is to index certain columns so that
searches over them become fast lookups. If you
intend to create, load, or manage tables, then you
NOTE: If there is no index, or the field is not
are an administrator, and need to know something
about indexing. ChemFinder/Oracle provides a indexable, the Index line does not appear in the list.
few tools to assist you.
3. If there is no index, click Create Index.
There are two types of index of interest to
ChemFinder/Oracle: NOTE: If this button does not appear, it means the
selected field is not a candidate for indexing.
Structure indexes. Any column containing
structures should have an index created by the 4. In the Create Index dialog, provide a name for
CS Oracle Cartridge. If there is no index, the new index and click OK.
searching is still possible, but very slow.
The index is created.
Primary keys. A table containing a column of
structures should also have a column of unique You will get an error message from Oracle if:
record identifiers for use in various list-
You provide an index name which is already in
handling operations. Preferably this column is
use, OR...
of type INTEGER and is designated as the
primary key of the table. The column already has an index.

446 ChemFinder/Oracle CambridgeSoft


Indexing
ChemFinder/Oracle does not provide a direct way Example:
to delete or overwrite an index, but the CAL SQL
command can be used for this purpose. SQL create table mytable (id
integer).
To create a primary key index:
CURR_TABLE variable. This variable
The process is the same as for a structure contains the name of the table connected to the
index, except that you carry it out on a field of current form. This works whether or not you
type Long. This creates an index on the field are in Oracle.
and also designates it as the primary key. It will
fail unless the column already contains unique, Example:
non-null values.
MSG Current table is
$CURR_TABLE
NOTE: A new button, Set As Structure, may
appear if you have selected a certain type of column. This OPENDB allows change of table. Normally
is an advanced feature described in Configuration Via this command takes the name of a database,
CF_SETTINGS Table on page 492. followed optionally by the name of a table in
angle brackets. In ChemFinder 10, it can now
TIP: If you want to create a primary key, but don't take just the table name, and causes the form to
have a column of unique integer values, you can create become attached to a different table in the
one using a CAL script. For example (assuming you've current database as if you had brought up
already created a column and form box called ID): Properties and clicked a different table name.

Example:
loop
putdata ID $index OPENDB <CHEM_STRUCTS>

record commit causes the current form to be connected to the


record next table CHEM_STRUCTS.

endloop STATMSG command displays a message on


the status bar. Format: STATMSG <message>.
CAL Example:
Some new features have been introduced into STATMSG Search is now in
ChemFinder Automation Language (CAL) to progress...
support Oracle. Some are not specific to Oracle,
but of general utility: SEARCH SAVE LIST, RESTORE LIST
work with Oracle. Normally you can follow
SQL command. When you are connected to an either of these commands with the name of a
Oracle database, you can pass any SQL file; in ChemFinder/Oracle you can instead
command which does not return records. The provide a list name.
format is simply SQL <command> where the
command is not quoted.

Chem & BioOffice 2006 /ChemFinder ChemFinder/Oracle 447


CAL
Administrator

448 ChemFinder/Oracle CambridgeSoft


CAL
Chapter 23: ChemFinder/Office
Overview Substructure
Full structure
ChemFinder/Office allows you to search data Similarity
sources (documents and databases) to find chemical
Identity
structures so that you do not need to search
manually. You can save frequently-used collections of data
sources (documents and databases) in Data Source
Using ChemFinder/Office, you can browse the Definition (.dsd) files. Instead of checking many
following types of files for chemical information: data sources that you want ChemFinder/Office to
MS Word documents search, ChemFinder/Office can search one .dsd
file.
MS Excel spreadsheets
ChemFinder databases You can also generate and store combinatorial
libraries from experiments performed with generic
ChemDraw files
reactions. For more information, Using
SD files ChemFinder/Office with CombiChem on page
Isis/Draw files 461.
In addition to browsing, ChemFinder/Office can ChemFinder/Office helps you to build databases
search files by: by extracting information from various sources and
exporting to another source.
Chemical structure
Chemical formula The ChemFinder/Office
Molecular weight
Graphical User Interface
Draw structures you want to find with the
ChemDraw plug-in. ChemFinder/Office can (GUI)
search for the whole structure, a substructure, ChemFinder/Office is installed when you install
or a structure similar to the one you draw. ChemOffice Ultra. The GUI window, titled Find
When searching by structure, you can specify a Chemical Structures, is shown in the following
search by: illustration:

Chem & BioOffice 2006 /ChemFinder ChemFinder/Office 449


The ChemFinder/Office Graphical User Interface (GUI)
ChemFinder/Office
title bar Menu bar
Administrator

Standard Toolbar
Search Record toolbar

Structure tab Find Now button

Look In tab Stop button

Search Options tab New Search button

Structure window

Molecular Weight text box

Formula text box Search type radio buttons

Status bar Edit Structure button


Show/Hide Hit List

Selecting Files to Search 3. Click Open.

Use the File menu or the Look In tab to tell When you select a single file, the first structure in
ChemFinder/Office where to look for structures. the file appears in the Structure window as soon as
you open the file. You can browse through the file
Selecting Files From the File using the forward and back arrows in the Search
Menu Record toolbar.

Use the File menu to look for a structure in a


specific file or data source: Selecting Files With the Look
1. From the File menu, choose Open.
In Tab
The Open dialog box appears. Use the Look In tab window to search for a
2. Select a file or data source you want to search structure in multiple files. The Look In tab window
by doing one of the following: shows all the documents and databases (data
In the File Name text box, type the name of sources) on your mapped network, CD-ROM,
the file to search. floppy, and hard drives. You can select entire folders
Use the directory tree in the Open window to search, or multiple individual files, by using the
to browse to a file to search. checkboxes next to the file names.

450 ChemFinder/Office CambridgeSoft


Selecting Files to Search
To look for a structure in specific files or data For example, you want to find a specific benzene
sources: file you saved. However, you are not sure what part
of ChemDraw you saved it in. Click the ChemDraw
1. Click the Look In tab. box and all of the ChemDraw files are searched.
The files and data sources appear in a tree When you have selected your data sources, return to
directory. the Structure window by clicking the Structure tab.

Searching by Chemical
Structure
You can find chemicals based on their structure
with ChemFinder/Office.

NOTE: Any search method that you use in ChemFinder


you can also use in ChemFinder/Office

To search by chemical structure only:


1. Open ChemFinder/Office.
The Find Chemical Structures - Data Source
window, appears.

NOTE: You can set Preferences to keep the file names


hidden in the directory tree. For more information, see
Changing the ChemFinder/Office Preferences on
page 460.

2. In the Select files of type box, use the drop-


down menu to choose types of files in which to
search.
You can select all data sources or files with the
following extensions:
.cdx and .mol
.doc and .xls
2. Do one of the following:
.cfw
From the Look In tab, select files to search.
.sdf
From the File menu select Open, or choose
3. Click the box next to the file(s) or data a file name from the most recently used list
source(s) that you want to search. of files.

Chem & BioOffice 2006 /ChemFinder ChemFinder/Office 451


Searching by Chemical Structure
For more information about opening files to ChemFinder/Office shows all of the files with
search through, see Searching .dsd Files on the structure that you specify in the Hit List
page 455. window shown below. Each entry in the Hit
3. Click New Search. List is a record or a hit.
Administrator

4. Click Edit Structure.


The ChemDraw plug-in tools palette appears.
5. Selecting appropriate ChemDraw tools, click in
the Structure window and draw the structure
you want to search for.

N NH2

For more information about using the


ChemDraw plug-in, see the ChemDraw Users
Guide.
8. Use the forward and back arrows on the
6. Alternately, you can select a structure from Record Search toolbar to navigate through the
ChemDraw or from a ChemFinder database hits.
and paste it in the Structure window using the
context menu. If ChemFinder/Office finds no hits, a warning
7. Click Find Now. message appears. To refine your search so that
ChemFinder has a greater possibility of finding
NOTE: If the Find Now button is grayed out, you have not hits, use the Search Options tab.
selected a file or directory to search. Click the Look In tab and
make a selection. Searching by Multiple
Properties
You can search for a chemical structure, chemical
formula, molecular weight, or any combination of
these properties simultaneously.

To search for other properties or more than one


property at a time:
1. Click New Search.

452 ChemFinder/Office CambridgeSoft


Searching by Multiple Properties
2. Take the appropriate action: Browsing Search Results
If you want to then in the You can view the search results in the Hit List. The
search for... Structure Hit List displays all of the files in which your search
window, ... found matching structures.

a specific molecular type a molecular


weight, weight (g) in the Mol.
Wt. text box.

a molecular weight type a range of molec- To view the search results:


within a range, ular weights (g) with
< or > in the Mol. To view the entire Hit List, use the scroll bars.
Wt. text box. To display each hit in a given file in the Struc-
ture window, select the file in the Hit List and
a chemical formula, type a chemical use the arrows in the Search Record toolbar.
formula in the
Formula text box.
To display the actual file double-click on a file
more than one crite- enter the appropriate name in the Hit List, or right-click and select
Activate, with any of the following extensions:
rion (structure, criteria.
formula, or molecular .docMS Word
weight), .xlsMS Excel
.cdxChemDraw
NOTE: When you search by chemical structure, .cfwChemFinder
formula, and molecular weight, ChemFinder/Office
The application in which the structure was
uses all the criteria together. The information about each
saved opens. In MS Word, the application
property adds to the search criteria of the other
opens directly to the first hit in the document.
properties.
When you view the structure in the original
3. Click Find Now. application, the Hit List record is not copied to
ChemFinder/Office shows all of the files with the other application.
the properties that you specify in the Hit List You can use the Hit List menu to add or remove
window below the Structures window. Hit List records.
If ChemFinder/Office finds no hits, a warning
To add or remove Hit List records with the Hit List
message appears.
menu:
To refine your search so that ChemFinder has
1. In a Hit List with records, right-click a record.
a greater possibility of finding hits, use the
Search Options tab. To expand your search, The record is selected and the Hit List menu
use the Look In tab. For more information, see appears.
Refining Your Search on page 457. 2. Select Add.

Chem & BioOffice 2006 /ChemFinder ChemFinder/Office 453


Browsing Search Results
The Open Chemical Structures window For more information about exporting files to
appears. other applications, see Sending a File to Another
3. Double click the file you want to add to the Hit
Application on page 455.
List, or type the name of the file in the File
Saving Data Sources as .dsd
Administrator

Name text box.


4. Click Open.
Files
The file appears as a record at the end of the After you complete a search, you can save all the
Hit List. records from the Hit List as a Data Source
Definition (.dsd) file so that you can search through
To take a record off the hit list, right-click and select them again.
Remove.
You can use .dsd files to search for structures,
Saving Files or Data substructures, or structures similar to your previous
search through the .dsd file.
Sources
To save the results of a search as a .dsd file:
A data source, or file, can be any of the following:
1. After completing a search, choose Save Source
A document, like an MS Word document or an As from the File menu, .
MS Excel spreadsheet. The Save As dialog box appears.
A database, like a ChemFinder database. 2. In the File Name text box, type a name for
Any combination of documents or databases. the group of files.
You can save search results as a file to search 3. Click Save.
through again. The files are saved with a .dsd extension.

Saving Search Results as Saving Lists of Directory


.sdf Files Paths as .dsd Files
The .sdf file format saves the Hit List records as NOTE: Only advanced users familiar with text editors
complete structures in MDL SDFile format. You should use this procedure.
can import .sdf files from ChemFinder/Office into
applications like ChemFinder. You can save lists of directory paths that you search
as .dsd files. You can create these lists with a text
To save search results in the .sdf format after a
editor such as Notepad. Saving a list of directory
search:
paths as a .dsd file saves the directories in which you
1. From the File menu, choose Export SDFile. search frequently.
The Save As dialog box appears. To save a list of directory paths:
2. In the File Name text box, type a name for
1. Open Notepad or some other ASCII text
the file.
editor.
3. Click Save.
2. Type the directory or database paths you want
The file is saved with an .sdf extension. to search.

454 ChemFinder/Office CambridgeSoft


Saving Files or Data Sources
3. From the File menu in Notepad, choose Save Sending a File to Another
As.
Application
The Save As dialog box appears.
You can send a structure or a file of structures (like
4. In the File Name text box, type a name for .sdf files) to another application. You can cut a
the file and include a .dsd extension. single structure from an application and paste it
For example, type a File Name like into another, or you can send more than one
search1.dsd. structure directly into another application.
Use the items in the Send To menu to send files to
5. Click Save.
these applications:
6. Close Notepad.
MS Word
MS Excel
Searching .dsd Files
CS ChemFinder
To search for a structure in a .dsd file: CS ChemDraw

1. From the ChemFinder/Office File menu, choose


ChemACX.Com Search
Open. To send a file to another application:
The Open dialog box appears. 1. In the Data Source - Find Chemical Structures
window, click the Send To menu.
2. In the Files of type: text box, select Data
source definitions (*.dsd) from the drop-down The Send To menu appears.
menu. 2. From the Send To menu, choose an applica-
tion to send a file to.
3. In the File Name text box, type the .dsd file
name, or select the file from those listed. The Send To dialog box appears.

4. Click Open. NOTE: When you send files to Chem.ACX.Com,


the Send To dialog box does not appear. The structure
The first structure associated with the last associated with the file is sent directly to
saved version of the .dsd file appears in the ChemACX.Com.
Structure window.
5. Click New Search.

ChemFinder/Office clears the Structure


window.
6. Click Edit Structure, and draw a structure to
search for.
7. Click Find Now.

ChemFinder/Office searches through the files


specified in the .dsd file. Any hits appear in the
Hit List.

Chem & BioOffice 2006 /ChemFinder ChemFinder/Office 455


Searching .dsd Files
3. From the Molecules section, select one of the If you select Send all molecules in current hitlist,
following: ChemFinder/Office will create a table in your
document, and the molecules in the current
If you want to Then click hitlist, along with their molecular formulas,
Administrator

weights, and source file paths, will be entered


into the table.
send the structure Send current molecule.
If you select Send current molecule, Chem-
displayed in the
Structure window, Finder/Office will export only the structure.

NOTE: If you need to interrupt a long Send To Word


send all the structures Send all molecules in operation, bring ChemFinder/Office to the front and click
listed in the Hit List, current hit list. the Stop button

4. From the Document section, select one of the To send a file to ChemFinder or ChemDraw, you
following, if available: must save the file you want to send:
1. Click the Send To menu.
If you want to... then click...
2. Select CS ChemFinder... or CS ChemDraw Files.
3. Select the appropriate radio button in the
send structures to a Send molecule(s) to a
Molecules section, and click OK.
new (untitled) docu- new document.
ment in an applica- A Save As dialog box appears.
tion,
NOTE: If you have a ChemFinder .cfw file open, you
have the option of selecting it in the Document section of
send structures to a Send molecule(s) to a the Send To dialog box.
document you already currently open docu-
have open in an appli- ment. 4. Type in a name in the File Name: text box.
cation,
NOTE: If you are sending multiple structures to
ChemDraw, choose a base name for the filesfor
5. In the Document section select the name of example, if there are three molecules in the current
the file from the drop-down list, if necessary. hitlist and you specify the base name molecule, the
files will be saved as molecule1.cdx, molecule2.cdx, and
If the text box in the Document section is not molecule3.cdx.
available, skip this step.
5. Click Save.
6. Click OK.
If you send a file to ChemFinder, ChemFinder
If you choose Send To MS Word or MS Excel, the opens and the file you save appears as a form.
document type opens a new file or the file whose If you send a file to ChemDraw, a warning
name you entered. The structures you send to the appears to tell you the path of the file you
application appear in that application as follows: saved.

456 ChemFinder/Office CambridgeSoft


Sending a File to Another Application
Refining Your Search If you want to... then click:
You can refine your search so that you have a
greater chance of finding the structure you want. see all the records in Retrieve All .
Use the Search tools and the Search Options tab to the search, including
change your query to refine your search. records without a
match to your search,
To refine your search:
1. From the Search menu, choose Restore search for the struc- Find Current Structure
Previous Query or click . ture currently .
2. Change your query with the Search Options. displayed in the struc-
ture window, but
3. Select the files and data sources you want to
ignore any other
search.
search properties like
4. Click Find Now. molecular weight,
ChemFinder/Office shows all of the files with
the structure that you specify. These files restore the previous Restore Previous
appear in the Hit List window below the Data search, so you can Query .
Source - Find Chemical Structures window. modify the search
If ChemFinder/Office finds no hits, your criteria,
search may be too narrow and you should
broaden your search options. For more information about the Search tools, see
the Searching chapter in the ChemFinder Users
Using the Search Tools Guide.

Some ChemFinder tools used to refine your search Refining Your Query With
can also be used in ChemFinder/Office. the Search Options
To use the search tools: You can refine your ChemFinder/Office search
From the Search menu or Search toolbar, take with the Search Options.
the appropriate action:

If you want to... then click:

begin a new search, Enter Query .

search for the current Find Current


properties (chemical Query .
structure, chemical
formula, molecular
weight),

Chem & BioOffice 2006 /ChemFinder ChemFinder/Office 457


Refining Your Search
To use the Search Options:
If you want to... then click:
1. Click the Search Options tab.
The Search Options window appears. require that any reaction Hit must overlap reac-
Administrator

center present in the query tion center.


overlap with reaction
centers in the target. This
preference applies only to
reaction searching,

allow hits to contain Extra fragments may


molecular fragments in be present in hit.
addition to that which was
hit by the query,

allow uncharged carbon Match any charge on


atoms in the query to carbon.
match charged carbon
atoms in the target,
2. Take the appropriate action:
NOTE: Charged atoms in
the query must always
If you want to... then click: match charged atoms in
the target, regardless of
require that the tetrahedral Match tetrahedral this setting.
stereochemistry of the stereo.
target structure match that allow uncharged atoms in Match any charge on
of the query structure, the query to match heteroatom.
charged atoms in the
require that the double Match double bond target,
bond stereochemistry of stereo.
the target structure match NOTE: Charged atoms in
that of the query structure, the query must always
match charged atoms in
allow fragments in the Fragments may
the target, regardless of
query to overlap (share overlap.
this setting.
one or more atoms) in the
target, allow a query drawn as Absolute center hits
absolute (hash/wedge relative
bonds) to hit a target
stored as relative.

458 ChemFinder/Office CambridgeSoft


Refining Your Search
If you want to... then click: If you want to... then, from the
View menu, ...
match a relative relation- Relative tetrahedral
ship between tetrahedral stereo show the Status bar, make sure the box
stereocenters. next to the Status bar
is checked.
Changing Chem-
Finder/Office Settings hide the Status bar, click Status bar.

The status bar disap-


You can change ChemFinder/Office settings so
pears.
that ChemFinder/Office appears the way you want.
You can customize the way the
ChemFinder/Office window appears with the show the Hit List, click Show List.
items on the View menu. You can change some of which shows all of the
places that Chem- NOTE: This option
the ChemFinder/Office display features with the
Finder/Office has only appears when
Preferences window. the list is hidden.
found the structure
you want to find,
Customizing the Chem-
Finder/Office Window hide the Hit List, click Hide List.

Use the View menu to change the appearance of NOTE: This option
the ChemFinder/Office window. only appears when
the list is showing.
To use the View menu:
customize features, click Customize.
1. In the Data Source - Find Chemical Structures
including:
window, click the View menu. The Customize
Commands, Tool-
bars, Menu, and window appears.
The View menu appears.
Keyboard options,
NOTE: This is a
2. Take the appropriate action:
standard Windows
feature. For more
If you want to... then, from the information, see the
View menu, ... MS Word online
Help.
show the Standard make sure the box
toolbar, next to the Toolbar
option is checked.

Chem & BioOffice 2006 /ChemFinder ChemFinder/Office 459


Changing ChemFinder/Office Settings
Changing the Chem-
If you want to... then...
Finder/Office Preferences
To change the ChemFinder/Office preferences: open the last file you click Reopen last
Administrator

used when you start source on startup.


1. From the File menu, choose Preferences. ChemFinder/Office,
The Preferences window appears.
show all files in the click Show files in
directory tree, directory tree.

use the ChemDraw click the ChemDraw


ActiveX control to style radio button.
draw and edit struc-
tures,

open ChemDraw to click ChemFinder style


2. Take the appropriate action: draw and edit struc- radio button.
tures,
If you want to... then... 3. Click OK.
The Preferences window closes.
choose a specific type the path in the
directory for the Startup directory text
Look In tab to open, box or click
to browse to a file in
NOTE: This setting
the Startup directory.
does not affect any
query properties.

specify the number of type the number or


most recently open click the Up and Down
files to show in the Arrows in the
File menu, Number of recently
used files to show on
File menu: box to
set a whole number
from zero to 10.

460 ChemFinder/Office CambridgeSoft


Changing ChemFinder/Office Settings
Chapter 24: Using ChemFinder/Office
with CombiChem
The CombiChem engine can be used with Reaction Template Basics
ChemFinder/Office to generate libraries of
combinatorial experiments. These libraries can be The example of a reaction template that follows is
drawn from any type of file that supported by CombiChem:
ChemFinder/Office can read, and stored as .mst R2

format databases.
R2
R1
R1
NH2
N H2O
H
O
N

CombiChem Overview
N
H

CombiChem, the CambridgeSoft engine for R2

generating combinatorial libraries, was previously R1

available only as an add-in extension for Microsoft NH3


NH

Excel for Windows. Starting with ChemOffice 8,


A reaction template must meet the following
the engine was incorporated into E-Notebook and
specifications:
other products by means of a new Automation
interface in MolServer. This new approach means All sites of variability require unique R-group
that the engine can be used by developers designations.
everywhere. For more information, see Solvents, catalysts, and other real-world
http://sdk.cambridgesoft.com/chemfinder. elements should not be included in the reaction
template drawing.
Working with Reaction Multi-step reaction templates are supported.

Templates Entering a Template


There are two ways of entering a CombiChem
CombiChem is a reaction-based combinatorial
template in ChemFinder/Office:
product. You first enter a reaction template with
R-groups at the variable sites in your starting by creating a generic reaction in ChemDraw or
materials, then search for reactants based on these with the ChemDraw ActiveX control.
structures. CombiChem puts your final product by creating a ChemFinder database of generic
structures together and creates a virtual library. reactions.

Chem & BioOffice 2006 /ChemFinder Using ChemFinder/Office with CombiChem 461
Working with Reaction Templates
Using ChemDraw or the edit the reaction in ChemDraw by double
clicking in the window, or continue with the
ChemDraw ActiveX control: reaction as entered.
1. Open ChemFinder/Office
Administrator

2. Click the Edit Structure button. Depending on


your Preferences setting, this will open Chem-
Draw or activate the ChemDraw ActiveX
control.
3. Draw a generic reaction. For more information
on generic structures, see the ChemDraw
Users Manual.

Using a ChemFinder data-


base:
You can create a database of generic reactions in
ChemFinder. ChemFinder/Office can open .cfw
2. Click the Analysis tab.
files directly and browse through them.
An analysis of the reaction steps appears below
Once you have a generic reaction in the Structure the reaction display.
window, do the following:
1. From the Search menu, select Enumerate.
The Combi Enumerator window appears,
showing the reaction as you entered it in the
Structure window. You may add another step
to the reaction by clicking the Add Step button,

462 Using ChemFinder/Office with CombiChem CambridgeSoft


Entering a Template
3. Click the tab for the first reactant. Use the b. Click OK to open ChemFinder. Edit the
Browse button to select a ChemFinder or hitlist by selecting Omit from List from the
SDFile database, or other source of chemical Record menu.
structures such as a collection of ChemDraw
files. Click Search. 4. Click the Enumeration tab. Use the Browse
button to select a database in which to store the
results. Click Go.

NOTE: You can create a new database file by typing


in a file name.

The results are stored in the database.


5. When you are finished, click OK to exit the
Combi Enumerator and return to Chem-
Finder/Office.

To view the results:

1. Open ChemFinder
You may edit the hit list before continuing.
a. Click Edit Hitlist. 2. From the File menu select Import, then click
An instructional dialog box appears. Structures.

3. Select the database from the Open Chemical


Structures dialog box.

Chem & BioOffice 2006 /ChemFinder Using ChemFinder/Office with CombiChem 463
Entering a Template
Administrator

464 Using ChemFinder/Office with CombiChem CambridgeSoft


Entering a Template
Appendix J: Structural Query Features
Overview Atoms
Atom types specified in the query must match
To perform a substructure search in ChemFinder,
you must first draw the query structure itself. Query atoms at corresponding positions in the target.
structures can be drawn in many different Hydrogen is an exceptionsee Substituents on
programs, but we recommend using ChemDraw, page 466.
and this Appendix is focused on using ChemDraw
to draw query structures. For more information Bonds
about the structure drawing and query capabilities All bonds explicitly drawn in the query must match
of ChemDraw, please consult the ChemDraw in the target. For certain caveats, see
Users Guide. Stereochemistry on page 467 and
Normalization on page 469. ChemFinder
ChemFinder does its best to follow your
recognizes the following standard bond types:
instructions even if those instructions are
contradictory. For example, you can create a query
such as the following: Bond Type Description

This bond must not Single target must have single bond
be in a ring. here
Chn

That bond is already in a ring, so ChemFinder Dashed same as Single


returns no hits for this query.
Hashed same as Single
General Properties
Thick same as Single
ChemFinder allows the following general
properties to be assigned to a query:
Wedged Hashed specifies stereochemistry down
Atom from the point end to the wide
end
Bond
Substituents Wedged specifies stereochemistry up
from the point end to the wide
Charges and radicals
end
Isotopes
Stereochemistry Wavy specifies stereochemistry
either at both ends
Normalization

Chem & BioOffice 2006 /ChemFinder Structural Query Features 465


General Properties
Hydrogen atoms in the query must match
Bond Type Description hydrogens in the target when the query hydrogen is
at the end of an explicit bond. The matched
Hollow Wedged same as Wedged hydrogen in the target may be implicit in an
Administrator

unlabeled carbon atom.


Dative same as Single

H O
Double target must have double bond;
stereo dictated by geometry
H N
Double Either target must have double bond;
any stereochemistry ok finds any of: does NOT find any of:
OH

Double Bold same as Double Cl

O NH2
HN O

Triple target must have triple bond


here Br

O
H OH OH
NH2

Substituents H OH

H N

In ChemFinder, a substituent is defined as a non- Br


H NH2

hydrogen atom connected by a bond of any order.


For example, a carbonyl oxygen is a substituent of
the carbonyl carbon.
All unfilled valences in the query may be filled by
hydrogen atoms or by non-hydrogen substituents.
Charges and Radicals
The normal valence of an atom is determined from Charges or radicals specified on atoms in the query
data in the Periodic Table window. For example, must match those in the target. Uncharged atoms in
carbon has a valence of 4, while sulfur has valences the query may or may not match charged atoms in
of 2, 4, and 6. Any explicit charges, radicals, or the target, depending on the state of the appropriate
query properties modify the normal valence. For check box in the Search tab of the Preferences
example, a carbocation has a valence of 3. dialog.
Hydrogen atoms in the query may match non- The valence of a charged atom is taken to be the
hydrogen substituents in the target if the hydrogen valence of the isoelectronic neutral atom.
in the query is implicit on an unlabeled carbon atom
or heteroatom. With a substructure search, the query:

N+

466 Structural Query Features CambridgeSoft


General Properties
finds any of: does NOT find any of: Stereochemistry
OH
Stereochemistry specified on the query must match
Cl
the target if the relevant Match Stereo item is
NH2
selected in the Search tab of the Preferences.
Stereochemistry is specified at a tetrahedral site by
N O using stereo bonds (up, down, either).
Stereochemistry about a double bond is specified
Br
OH by the geometry of the drawing. ChemFinder
H OH cannot currently interpret other stereochemistry
OH
types (allenic, square planar, octahedral, etc.) and
NH2
H NH2 ignores them during a search.
N When evaluating a possible match, the following
rules are applied:
Isotopes Unspecified stereochemistry (a plain bond)
Isotopic labels specified in the query must match may match any stereochemistry (either a
the target. Unlabeled atoms in the query match wedged, hashed, bold, or a plain bond).
unlabeled or isotopically labeled atoms in the target. Specific bond types need not match as long as
Additionally, D is treated interchangeably with 2H, the overall stereochemistry at a given atom
and T is treated the same as 3H. does match.
Implicit hydrogens are taken into consideration
in both the query and the target if doing so
With a Substructure Search, the query: helps to determine the chirality of a stereo-
center.
D
13
O C
With a full structure search and the Match
finds any of: does NOT find any of: Tetrahedral stereo option selected, the query:
HO
O

13
13
HO CH3
C O OH
D finds any of: does NOT find any of:
T
13
2
O CH3
H
13
O CH3

HO
D
D

D
13
O C

Chem & BioOffice 2006 /ChemFinder Structural Query Features 467


General Properties
HO
O
HO
O
MDL File Formats

All bond styles available in ChemDraw are retained


N OH N OH
H H
in CDX files. The same is not true of major MDL
Administrator

structure files: MolFiles, SDFiles, and RDFiles. In


H
H
N OH N OH these formats, only three stereo bond types are
available: hash, wedge, or either (squiggly bond);
HO
O HO
O thick bonds are not recognized. This presents a
problem for the ChemFinder user wishing to
HO
O
import or export structures having relative
HO
O
stereocenters.
N OH
N
H H OH H ChemFinder addresses this problem by using a
proprietary tag in the file, recognized only by
Relative Tetrahedral Stereochemistry ChemFinder. The tag is BOND_RELS, and is
applied to every stereo bond of thick type. For
Relative Tetrahedral Stereochemistry, or RTS, example, here is an excerpt from the bond table of
specifies a given relationship between the centers. a molfile with relative bonds.
That is, a known orientation of the substituents
with respect to each other, rather than a known ...
absolute configuration. To specify this, centers are 4510000
drawn, not with the standard hashed and wedged 2611000 <- bond 5, marked as UP
bonds, but with thick (bold) stereo bonds. 4711000 <- bond 6, marked as UP
M CFW 5 BOND_RELS <- overrides type of
Relative and absolute configurations may be bond 5 to be UP/THICK
registered separately in ChemFinder, and can be M CFW 6 BOND_RELS <- same for bond 6
distinguished by various search options. The basic
ChemFinder search philosophy can be summarized The consequences of having a ChemFinder-only
tag are:
as follows: a more specific query is a more precise
request, and should get fewer hits than a more When any of the MDL file formats is saved
general query. If the query represents a particular from within ChemFinder, the tag is written.
absolute configuration, it should hit only that; if it Reading these files back into ChemFinder will
represents a mixture, it should hit any of the retain the thick bond types.
components.
If a structure is drawn in ChemDraw and saved
If you choose Same in the stereo search choices, you as MDL Molfile, thick bonds are lost, and are
are requesting that whatever stereochemistry is converted to normal hash/wedge bonds. (This
is not true if the file is saved as CDX).
specified in the query must match that of the target.
If the query has relative bonds and RTS is activated, If a structure is saved as molfile from Chem-
a hit must have the same relationship between Finder, reading it into ChemDraw loses the
centers. thick bonds.

468 Structural Query Features CambridgeSoft


General Properties
Mol- or SDFiles obtained from ISIS or other Atom Properties
programs do not know about this tag, and thus
cannot convey thick bonds. However, such ChemFinder allows special atom properties to be
files may be edited by hand to include the assigned to an atom in a query. These properties are
ChemFinder tag. usually only meaningful during a search. They
An MDL file written by ChemFinder, generally serve to broaden or narrow the scope of
containing tags, should in principle be readable the search.
by any program which can import such a file.
The unrecognized tags should simply be Special Atom Types
ignored. ChemFinder recognizes six special atom types that
can match any one of a predefined set of elements:
Normalization
A matches any non-hydrogen atom.
Closed rings of alternating single and double bonds
Q matches any heteroatom (non-hydrogen,
match their alternative resonance forms if aromatic
by the Hckel 4n+2 rule. non-carbon).

With a full structure search and the Match R matches any atom, including hydrogen.
Double Bond stereo option selected, the query: X matches any halogen (F, Cl, Br, I, At).
LN matches a link node (placeholder for
unspecified atoms). See Searching Link
OH Nodes and Multivalent Rs (MVRs) on page
426 for details.
finds any of: does NOT find any of: M matches any metal atom, shaded in the peri-
odic table below:

OH OH

OH
OH

O
O
H
H Atom Lists
As with the predefined special atom types, an atom
list is a list of atoms, one of which must match the
target atom.
For example:
[Cl,Ag,N] atom must be Cl or Ag or N

Chem & BioOffice 2006 /ChemFinder Structural Query Features 469


Atom Properties
Atom lists may contain only elements. Special atom Cl
types, nicknames (Ph), and structural fragments
(NH2, OCH2CH3) may not be included in an atom
list. ChemFinder recognizes a maximum of five
Administrator

atoms in an atom list.


O
Atom Not-Lists
HO
The opposite of an atom list is a list of atoms, none O

of which must match the target atom. For example: O

[NOT O,S,Se] atom must not be O or S or Se (but


may be any of the 100 other elements)
Atom not-lists have the same restrictions as atom
lists.
Substituents: Up To
Substituents: Exactly
This property specifies a precise value for the This property specifies a maximum value for the
number of substituents on an atom, including those number of substituents on an atom, including those
explicitly drawn. This property is only meaningful explicitly drawn. This property is only meaningful
in a substructure search. in a substructure search.

With a substructure search, the query: With a substructure search, the query:

X3 U2

This atom is marked This atom is marked


with the atom property with the atom property
Substituents Exactly:3 Substituents Up to:2

finds any of: does NOT find any of: finds any of: does NOT find any of:

HO

CH3

470 Structural Query Features CambridgeSoft


Atom Properties
Substituents: Free Sites This property is only meaningful in a substructure
search.
The Substituents: Free Sites property specifies the
maximum number of additional substituents that
NOTE: This atom property does not affect the display of
may be present on an atom. This property is only
implicit hydrogens, only their presence in a search. For more
meaningful in a substructure search.
information about displaying implicit hydrogens, see
Setting Preferences on page 429.
NOTE: Specifying Free Sites: 0 is a quick way to indicate
that you want no further substitution at a site. Target
structures will match the query structure as drawn, with no Unsaturation
additional ligands.
Sometimes it is useful to specify that an atom must
or must not be attached to unsaturated (aromatic,
With a substructure search, the query: double, or triple) bonds. ChemFinder allows
searches for atoms whose unsaturation Must Be
2 Absent (all bonds to the atom are single). It also
This atom is marked allows searches for atoms with at least one multiple
with the atom property (double, triple, or aromatic) bond. The default
Substituents Free Sites:2
value, Undefined, finds targets without regard to
finds any of: does NOT find any of: the hybridization of the atom.

Cl This property is only meaningful in a substructure


search.

With a substructure search, the query:

This atom is marked O


HO O with the atom property
Unsaturation: must be present
OH
S
O O

finds any of: does NOT find any of:

Implicit Hydrogens
This atom property may have either of two values:
Allowed (default) or Not Allowed. If implicit
hydrogens are Not Allowed, the atom must be fully
substituted in the target.

Chem & BioOffice 2006 /ChemFinder Structural Query Features 471


Atom Properties
O O
Bond Type Description
OH OH
S/A target must have a single bond or
Administrator

O
an aromatic bond here
HO

HO

O Topology
If Ring or Chain is chosen, the target bond must or
OH
must not be in a ring, respectively.
OH
OH
O
Reaction Center
O
The reaction center refers to those bonds that are
Bond Properties directly affected by a reaction. This property allows
you to specify just how a given bond is affected.
ChemFinder allows special properties to be
assigned to bonds in a query. These properties Property Description
usually will only be meaningful during a search.
They generally serve to broaden or narrow the Unspecified target must have a bond here,
scope of the query. but the bond can participate
in the reaction in any fashion,
Special Bond Types or not at all
The table below describes the special bond types target must have a bond here
Center
that ChemFinder allows. that directly participates in
the reaction in some way
Bond Type Description
Make/Break target must have a bond here
that is either made (if in a
Aromatic target bond must be aromatic as product) or broken (if in a
defined by the Hckel 4n+2 rule reactant)

Any target can have any bond type here Change target must have a bond here
whose bond order changes
S/D target must have a single bond or over the course of the reac-
a double bond here tion, but is not made or
broken
Tautomeric same as S/D

D/A target must have a double bond or


an aromatic bond here

472 Structural Query Features CambridgeSoft


Bond Properties
Property Description Property Description

Make&Change target must have a bond here Not Modified target must have a bond here,
that is either made (if in a and regardless of whether it
product) or broken (if in a is part of the reaction center
reactant) or whose bond or not, its order must not
order changes over the change over the course of the
course of the reaction reaction

Not Center target must have a bond here, This property is only meaningful when searching a
and that bond must not reaction database.
participate in the reaction

Chem & BioOffice 2006 /ChemFinder Structural Query Features 473


Bond Properties
Administrator

474 Structural Query Features CambridgeSoft


Bond Properties
Appendix K: Formula Input Rules
Overview If symbols are not properly capitalized (such as all
lower-case), then, with the exception noted below,
When you type a formula in ChemFinder, you are the shortest symbol which matches is preferred.
not required to enter symbols in any particular case. Thus co is taken as carbon-oxygen instead of
This can give rise to ambiguities. This appendix cobalt.
describes how ChemFinder interprets formulas and
The exception is: if two characters represent a valid
resolves these ambiguities.
two-letter symbol and also a valid one-letter symbol
Consider an example. In entering a formula query, followed by an invalid one, then the two-letter
you type: symbol is favored. Thus cl is not taken as carbon
followed by the (invalid symbol) L, but instead is
cooh taken as chlorine.
Most chemists recognize this as a carboxyl group:
carbon, two oxygens, hydrogen. However, it might Examples
be interpreted as cobalt (Co), oxygen, hydrogen.
Similarly, CLI might be carbon-lithium or it There is an easy way to experiment with formula
might be chlorine-iodine. PHE might be interpretation: use the Periodic Table. Type a
phosphorus-helium or, since ChemFinder allows 3- formula into the text box at the bottom, then click
character amino-acid symbols as special atom types, anywhere outside that box. ChemFinder interprets
it might be phenylalanine (Phe). the formula and redisplays it with correct
capitalization.
One way to avoid ambiguity is to separate letters
with spaces. For example, the string c o cannot ChemFinder interprets some ambiguous formulas
possibly be interpreted as cobalt. Another way to as follows:
avoid ambiguity is to enter formulas using the
Periodic Table instead of typing them. ChemFinder Formula Chemfinder
allows free-format input, and attempts to make the Interpretation
most reasonable interpretations of them by using
the rules described below.
cooh COOH
Rules
Cooh CoOH
If a symbol is properly capitalized (first letter upper
case, followed by zero, one, or two lower-case cnosi CNOSI
letters), then the longest valid symbol which matches
is preferred. Thus Phe matches phenylalanine
cNoSi CNoSi
rather than phosphorus; Co matches cobalt.
Because of this rule, if you properly capitalize all bru BrU
symbols, no ambiguities will arise.

Chem & BioOffice 2006 /ChemFinder Formula Input Rules 475


Rules
Formula Chemfinder
Interpretation
Administrator

b ru BRu

476 Formula Input Rules CambridgeSoft


Examples
Appendix L: Similarity Rules
Overview Consider the query and target compounds shown
graphically below. Both have similar numbers of
Often you might not be looking for a specific descriptors present - the query has 23, while the
compound, but any compound that is close target has 24. But are they close enough?
enough will do. ChemFinder uses the Tanimoto
equation to determine if compounds are similar.
Bitscreen Desc. # Name
You can specify how similar in the Searching tab
of the Preferences dialog.
Query 23 Q
Exact searching relies on the notion of an atom-
and-bond table: a specific set of atoms joined to
each other in a certain order by a given set of bonds. Target 24 T
If some atoms or bonds are missing, added, or
different, the query structure and the target Q and T 17 Q T
structure do not match.
Most similarity searching, on the other hand, relies Q or T 30 Q T
instead on the notion of molecular descriptors.
Each compound can be represented by a collection
of qualitative terms that describe general aspects of Complete Structure Simi-
the structure.
For example, benzoic acid might be described as:
larity
organic acid One of the hallmarks of a good similarity algorithm
contains 6-membered ring is whether it is commutative. That is, two compounds
contains delocalized ring should have the same similarity value no matter
contains C-double-bond-O which you compare to which. The full structure
Tanimoto similarity test is commutative. It
As you can see, the descriptors can be very broad,
and they can overlap. The set of descriptors used by compares the number of descriptors they have in
ChemFinder is very large. common (in the intersection of the query and the
target) to the number of descriptors they have in
When you draw a compound, ChemFinder
total (in the union of the query or the target). The
compares it against all of the descriptors it knows
ratio of these two values is known as a Tanimoto
about. Some descriptors will be present in your
compound and some will not. Since each descriptor coefficient, and is always a value between 0% and
for a given compound is either Present or Not 100%.
Present, they are often stored as bits, and another
name for a compounds set of descriptors is its Q
T
bitscreen. Tanimoto Coefficient
Q
T

Chem & BioOffice 2006 /ChemFinder Similarity Rules 477


Complete Structure Similarity
For the two compounds above, the Tanimoto to which. In considering substructure similarity,
coefficient is 17/30, or about 57%. This is not very ChemFinder finds what percentage of descriptors
similar. Although ChemFinder will allow you to in the query are also present in the target.
specify any Tanimoto value down to 0%, for most This value will always be at least as large as the
Administrator

cases you will likely be looking for compounds that complete-structure Tanimoto coefficient for the
have Tanimoto coefficients of 90% or higher. same two compounds, and usually it will be larger.
The two compounds above are 17/23, or about
Substructure Similarity 74% similar by substructure similarity. For a given
coefficient value, a substructure similarity search
Unlike full structure similarity, substructure will always return all of the hits in a full structure
similarity is not commutative: you are comparing a similarity search, and will often return additional
ones as well.
portion of one structure against the entire other
structure, and so it does matter which you compare

478 Similarity Rules CambridgeSoft


Substructure Similarity
Appendix M: CAL Commands
Overview CAL Help
ChemFinder Automation Language (CAL) is a set Information about the CAL command and
of commands that control many ChemFinder variables is available in the CAL Scripting Help
operations. window.
You invoke CAL commands in either of two ways: To access CAL Help:
Interactively Type commands and execute
1. From the Scripts menu select Command Line.
them one at a time on a command line.
ScriptsUse ASCII files containing a series of The Enter Cal Command dialog box appears.
CAL commands to be executed automatically 2. In the Enter Cal Command dialog box, click
in sequence. the Help button.
Arguments to commands consist of numbers and The CAL Scripting Help window appears:
text strings. You can enter a text string without
punctuation unless the argument is not the last one
on the command line and contains multiple words
or spaces. In this case, you must enclose the
argument in quotation marks.

New in ChemFinder
Two new features in CAL improve program
control:
IF / ELSE / ENDIF
bidirectional GOTO
Previously, a GOTO statement could only jump to a
Menu Commands
label which had already been encountered while the
Menu commands consist of a two-word command
script was being read, that is, could only jump
from the main menu and in some cases an optional
backwards. This limitation is now removed. GOTO
argument.
can jump to any label.
New Commands: Following are examples of commands:

TO/FROM_SMILES, _CANONICAL file new


SQL, SQLSELECT (Oracle) edit paste
SUBSTRextracts part of a string from a vari- search find
able. record next

Chem & BioOffice 2006 /ChemFinder CAL Commands 479


CAL Help
You do not need to spell out menu commands. You
can enter just enough letters to uniquely identify the Box Type String
menu option. For example, to execute the Record
Next command, type: Text static text
Administrator

rec n
Picture pathname of a Windows meta-
Some menu commands open a dialog box and wait
file
for user feedback. To avoid this, a limited number
of menu commands can take explicit arguments:
Button pathname of a script file, or
FILE OPEN [filename] name as it appears on Scripts
FILE SAVE [filename] menu
RECORD GO TO RECORD [recno]
Subform <nothing>
Box Creation Commands
DBOX coords [fieldname] Arrowbox <nothing>
FRAME coords [text]
TEXT coords [text] Framedbox name of database field to be
PICT coords [filename] displayed in the box, and static
label for upper left
BUTTON coords [scriptname]
SUBFM coords If the text string is omitted, you can supply it later
ARROWBOX coords using SETFIELD or SETTEXT. For a button, you
FRAMEDBOX coords [fieldname] [text] must use SETTEXT if you want its visible label to be
different from the name of its script.
To create a new box on the form:
1. Specify the box type with the appropriate Box coordinates are specified in this order: left, top,
keyword. right, bottom. Units are in pixels; the origin is at the
2. Type four integers giving the rectangular coor- upper left, with coordinates increasing from left to
dinates of the box after the keyword. right and top to bottom, so that coordinates will
range from left = 0 to right = 640 or 1024 or
3. If desired, type a text string giving further
information appropriate to the box type, as whatever fits your screen, and from top = 0 to
shown below: bottom = 480 or 768 or similar.

When a new box is created, it adopts the current


Box Type String
font. To specify a particular font for a box, use the
FONT command prior to creating the box.
Data box name of database field to be
displayed in the box When specifying a script name, give one of the
following:
Frame static label for upper left
The complete pathname of the script file.

480 CAL Commands CambridgeSoft


Box Creation Commands
A simple name without extension, if the script To work with a box or subform on the form, you
is stored in the standard scripts subdirectory specify a keyword followed by a box identifier. A
with the standard file extension. If the script box is identified in one of two ways:
name appears on the Scripts menu, you can
By pointGive the coordinates of a point
use the name from the menu.
anywhere within the box. When coordinates
The table below shows examples of Box Creation fall in more than one box, the most recently
Commands: created box is used.

Command Action By textThe text you enter to identify a box


may be:
FRAME 10 10 300 create frame with label
60 Molecular The field name, if the box contains data
at upper left
Formula from a database.
DBOX 20 20 290 create data box for The text label, if the box contains static text,
50 formula formula in above frame such as frames or text labels.
TEXT 100 100 300 create a static text The box name assigned in Box Properties.
150 A Label string For subform boxes, the table name.
PICT 500 300 600 put specified picture at In all cases, you need not spell out the entire
400 C:\LOGO.WMF lower right name, just enough to be unique.
BUTTON 500 10 create button at upper Often, more than one box matches the text you
550 40 DEMO right to run script enter, for example a box displaying field
DEMO.CFS molweight within a frame labelled
MolWeight. In this case, preference is given
to the box connected to the database.
FORMEDIT controls the behavior of the SELECT
command. With FORMEDIT ON, SELECT affects
boxes. With FORMEDIT OFF, SELECT affects the
Box Manipulation contents of those boxes.
Commands SELECT and UNSELECT choose boxes to be
modified by editing operations. DELBOX is a
FORMEDIT ON|OFF shortcut for FORMEDIT ON, followed by SELECT,
SELECT box followed by Edit Clear. SETFIELD connects a
UNSELECT box database field to an existing box; for a button, it
DELBOX box attaches a script name (see above regarding script
names). SETTEXT attaches a text string to a box or
SETFIELD box fieldname
replaces the one currently attached; see box
SETTEXT box text creation commands (above) for a list of what the
ACTIVATE subform text strings mean for various box types.
DEACTIVATE
ACTIVATE and DEACTIVATE are the same as
SCALE SELECT and UNSELECT, but work on subforms.
SCALE_TO_FIT Following an ACTIVATE command, all subsequent

Chem & BioOffice 2006 /ChemFinder CAL Commands 481


Box Manipulation Commands
commands apply to the active subform and any Program execution commands call up external
boxes it contains. The DEACTIVATE command is processes and pass data to them. All require an
required to once again refer to the main form and argument, which may need multiple components.
its contents.
CALL executes a specified CAL script. If the call is
Administrator

SCALE scales all items in the current form by the made from within another script, when the called
percentage factor you specify. Use this to fit your script finishes executing it returns control to the
forms to different size screens. See SCALE_TO_FIT caller. CALL must be followed by a scriptname, as
below. described above.

SCALE_TO_FIT scales all elements in the form such DOS executes a DOS command line. Follow the
that the string you specify will fit in the form at the DOS keyword with any string you might type at a
currently selected font size. See FONT below. DOS command prompt. If you do not type any
arguments after the DOS command, you get an
The table below shows examples of Box interactive command prompt window. You can use
Manipulation Commands: this feature to manipulate files, execute programs or
batch files, get directory listings, format disks, etc.
During execution of the command, a command
Command Action
prompt window appears on the screen; when
SELECT 11 11 select formula frame created finished, the window goes away and control returns
to the calling script.
above
EXEC starts a Windows program and optionally
SELECT formu select formula data box passes it command-line arguments. Follow the
created above EXEC keyword with any string you might use in the
Program Managers File Run command. This
SETFIELD 21 change field for formula data command starts a program, but does not return
21 molweight box to molweight from it. To return to ChemFinder, you need to use
Task Manager or click in the ChemFinder frame
window.
DDE sends a Dynamic Data Exchange message to a
specified application. Follow the DDE keyword with
three arguments:
The service nameusually the name of the
Program Execution recipient application.
Commands The topic namea string recognized by the
recipient, identifying the nature of the message.
CALL scriptname
It is typically SYSTEM.
DOS doscommand
The commandan instruction to the service
EXEC wincommand indicating what you want it to do.
DDE ddecommand Details of these components depend on the service
LAUNCH filename youre addressing.

482 CAL Commands CambridgeSoft


Program Execution Commands
The table below shows examples of Program FONT changes the current font. Any boxes created
Execution Commands: subsequently adopt this font. Follow the keyword
with a name from your Windows font list, followed
Command Action optionally by:
1. Font size in points (default is 8).
CALL execute script file located in 2. Style from the list below (default is 0, or plain
myscript scripts directory text).
3. Color; three values for red, green, and blue,
DOS erase execute DOS command to each ranging from 0 to 255 (default is 0,0,0, or
junkfile.dat delete a file
black).

EXEC notepad
Font styles are sums of bold (1), italic (2), and
execute Windows program underline (4). Thus a style value of 1 means bold, 3
myfile.txt
means bold+italic, 6 means italic+underline, and so
DDE CHEM3D send DDE message to quali- on.
CFWIN "open fied service SEEPTAB briefly displays the periodic table window,
benz.mol" then closes it. The window will be displayed for the
amount of time specified (1 decisecond = 0.1
General Commands second). If the duration is omitted, it will be
displayed for four seconds.
MSG message
STATMSG message QUITECLOSE closes the active form. This
TIMEDMSG [n] <msg>W command is similar to FILE CLOSE, but
FONT fontname [size [style r g b]] automatically discards any changes instead of
SEEPTAB [decisecs] prompting the user what to do.
QUIETCLOSE HIDETABLE closes the Table View window for the
HIDETABLE current form. If a subform is active, it returns the
SET subform to form view.
CLEAN [cleanup, tidy, redraw, denovo]
SET allows you to modify basic ChemFinder
HELP
settings, including most of those found in the
GET [v] section number, itemnumber
Preferences dialog and several that cannot be
SOUND filename.wav accessed in any other way. See the online help for a
SYSMETRIC [v] index complete listing of parameters that can be SET.
MSG displays a message box with the specified text,
CLEAN will attempt to standardize the bond lengths
and waits for the user to click OK. and angles of the current molecule. It is the same as
STATMSG displays information on the status line. opening the molecule in ChemDraw, and selecting
the Clean Up Structure command. The arguments
TIMEDMSG displays a message box similar to the
are optional.
MSG command, but the message disappears
automatically after a specified number of seconds. HELP displays a list of all valid CAL commands.
For example: TIMEDMSG 10 This message will The valid parameter types are listed for each
disappear automatically after 10 seconds. command, as is a brief description.

Chem & BioOffice 2006 /ChemFinder CAL Commands 483


General Commands
GET retrieves a value from the ChemFinder.ini file. created, otherwise it is overwritten. For both
Follow the keyword with a variable name and the READMOL and WRITEMOL, the format of the file
section and item number of the value you want to is determined by its extension; for example,
retrieve. benzene.cdx is a ChemDraw file.
Administrator

SOUND plays a .wav file you specify. WRITETEXT exports the current list as delimited
text with whatever delimiter is specified in the
SYSMETRIC retrieves the specified system metric
Preferences dialog.
into a variable.
The table below shows examples of File
The table below shows examples of General Commands:
Commands:

Command Action
Command Action
READMOL read specified file to become
MSG Click OK display message, wait for benz.mol current molecule
to continue click
WRITEMOL write current molecule to spec-
FONT Times 12 1 change font to red 12- saved.mol ified file
255 0 0 point Times bold
WRITETEXT export current list to a text file
GET V1,4,5 place the value of item hits.txt
number 5 in section 4 into
the variable V1
Database Commands
SOUND beep.wav play the sound in the files OPENDB [R / R / RE] dbname
beep.wav CRETABLE tablename
DELTABLE tablename
SELTABLE tablename
File Commands CREFIELD fieldname
READMOL filename DELFIELD fieldname
WRITEMOL filename SORT [D] fieldname
WRITETEXT filename Oracle database commands:
READMOL and WRITEMOL operate on the current
SQL <SQLStatement>
molecule. These commands will work only if there
SQLSELECT [v ] <SQLSelectStatement>
is at least one structure-related box (structure,
formula, or molweight) on the form, and you are OPENDB opens a standard molecule database.
positioned to a valid entry in the database. Specify a pathname to the .mdb file, or a name from
READMOL reads a specified structure file and the ODBC Data sources list. When connected to an
replaces the current molecule in the form. Oracle database, OPENDB takes a table name
WRITEMOL saves the current molecule to a instead of a database name. You can specify the
specified structure file; if the file doesnt exist, it is mode of database opening:

484 CAL Commands CambridgeSoft


File Commands
Rread-only CRETABLE MyTable creates a new table
Eexclusive
REread-only and exclusive DELTABLE MyTable deletes a new table
CRETABLE creates tables in the current database.

DELTABLE deletes tables in the current database.

SELTABLE selects a table form the current database Variable Commands


and makes it the current working table for
subsequent field actions. SETVAL [v] text
READVAL [v] filename
CREFIELD creates fields in the current table in the
WRITEVAL [v] filename
current database. You can specify the field type and
width in the CREFIELD command. The default text INPUT [v] [prompt]
field is 50 characters wide. PASSWORD [v] [default]
DELFIELD deletes fields in the current table in the GETDATA [v] box
current database. PUTDATA box text
APPEND ON|OFF
SORT sorts the database contents on the specified
field. The default sorts the database in ascending APPENDVAL [v] [text]
order. You can specify descending order with D. INCREMENT [v]
DECREMENT [v]
SQL allows SQL to be passed directly from CAL.
SQLStatement is a SQL statement that returns no LET v v op v
results. It is therefore useful for data manipulation SUBSTR [v] <str> <from> [<to>]
operations. Available only when connected to an
CAL has nine variables called V1, V2, ..., V9. These
Oracle database.
are temporary storage locations you can use to
SQLSELECT returns a one-row recordset. It is move information between form boxes and other
useful for calculations or lookups. v is the name or data sources.
number of a variable to receive the results of a
Variable names can be substituted in any CAL
Select statement; SelectStatement is a SQL Select
command. Any item shown in italics in a command
statement designed to retrieve a single result. If v is
description may be replaced by the name of a
omitted, results go in V1. Available only when
variable, prefixed with a dollar sign.
connected to an Oracle database.
If you omit the password from the connection For example:
string, and you will be prompted for it when MSG messagemay be either:
running the command.
MSG "An explicit message"
The table below shows examples of Database
Commands: a message explicitly coded into the scriptor
MSG $V2
Command Action
a message taken from variable 2 at run time

Chem & BioOffice 2006 /ChemFinder CAL Commands 485


Variable Commands
You may concatenate variables, and variables and APPENDVAL is a shortcut designed to make it easier
literals together in CAL commands. You must add to build string values. It is the same as setting
both a leading and trailing dollar sign to the variable APPEND ON, doing a SETVAL, then restoring
name. APPEND to its original state.
Administrator

For example:
TIP: The difference between APPEND ON and
MSG$V2$$V1$ APPENDVAL is that APPENDVAL does not add a
carriage return to the string being appended, whereas
Displays a message box with the value of V2 APPEND ON does. If you want to insert a carriage return
immediately followed by the value of V1. at the end of the string, use APPEND ON.

Most commands for manipulating variables take an INCREMENT adds 1 to the value of a variable. Use
optional variable number as the first argument. If INCREMENT in loops.
the number is omitted, it is assumed to be 1.
DECREMENT subtracts 1 from the value of a
SETVAL puts the specified text into a variable. variable. Use DECREMENT in loops.
READVAL reads the contents of a text file into a
LET allows you to perform mathematical
variable. WRITEVAL copies the contents of a operations on variables that contain integer or real-
variable to a file. number values. Only one operator per line is
INPUT displays a text input dialog, accepts data
supported. It recognizes the following operators:
from the user and stores it in a variable. An optional + for addition
prompt string is displayed in the box when it
- for subtraction
appears.
* for multiplication
PASSWORD is the same as INPUT, but displays all
/ for division
characters as asterisks.
SUBSTR extracts a substring from a variable. The
GETDATA retrieves the contents of a form box (as extracted substring extends from a specified
long as it is not a structure) into a variable; see character to the end of the string, or from one
above for how to identify a box. PUTDATA copies specified character to another.
specified text into a form box. Form names are
The table below shows examples of Variable
case-sensitive. Be sure to use the same case as the
Commands:
form box name into which you want to store data.

APPEND determines whether data in a storage Command Action


location is kept if other data is being moved there.
This setting is now also consulted when you do a SETVAL "some store text in V1
File Export to SD or delimited text file. text"

APPEND ON causes any subsequent data SETVAL 2 "other store text in V2


movements to append new data to old; APPEND text"
OFF causes old data to be overwritten. This applies
READVAL 9 read text from file into V9
to all variable commands except PUTDATA. The
default at program startup is APPEND OFF. tmpdata.txt

486 CAL Commands CambridgeSoft


Variable Commands
$SYSTEM_DIR
APPEND ON turn on append mode
NOTE: To view a complete list of variables, click Help on
WRITEVAL append contents of V1 to the Enter Cal Command dialog box.
output.txt file
ChemFinder provides several variables to allow you
SETVAL 2 to retrieve information about the current
append text to contents of
"append me" ChemFinder environment. They cannot be set
V2
directly, but are modified as a consequence of other
APPEND OFF commands.
turn off append mode
For example, the menu command:
INPUT 2 "enter prompt and get user input Record Next
new data" to V2 increments the current RECNO by 1.
GETDATA 3 The table below shows examples of Environment
copy data from molname
molname Variables:
box to V3

PUTDATA molname store given string in Command Action


benzene molname box
SETVAL 1 V1 now equals the number
LET 3 $V1 + $V4 sets V3 equal to the value $RECNO of the current record
stored in V1 plus the value
stored in V4 SETVAL V1 V1 now equals total
$NUM_RECS number of records in the
SUBSTR 2 abcdef stores cde in V2
current list
3 5
SETVAL V1
Environment Variables $DTBA_NAME_
V1 now equals, for
example c:\chem-
LONG finder\mydb.mdb
$INDEX
$RECNO SETVAL V1 V1 now equals, for
$NUM_RECS $FORM_NAME_ example mydb
SHORT
$DTBA_NAME_LONG
SETVAL V1 V1 now equals, for
$DTBA_NAME_SHORT
$SYSTEM_DIR example, c:\chem-
$FORM_NAME_LONG fndr\system
$FORM_NAME_SHORT
$CFW_DIR Script-Only Commands
$FORM_DIR *text

Chem & BioOffice 2006 /ChemFinder CAL Commands 487


Environment Variables
:label LOOP begins a section of code that will execute
repeatedly, until ENDLOOP is reached. By default,
label:
the number of times the code executes is equal to
GOTO label the number of records in the current list, but you
Administrator

can provide a specific count in the LOOP statement.


IF v1 op v2 stmt
IF v1 op v2 TIP: ENDLOOP can be used anywhere within a loop
clause to mean continue to the next iteration. Example:
<stmt(s)>
LOOP
[ELSE RECORD NEXT
IF $HAS_MOL = 0
<stmt(s)>] ENDLOOP
ENDIF
ENDIF
CLEAN
LOOP [count] ENDLOOP
In this example, if a record has no structure, the program goes
ENDLOOP to the next record and skips the CLEAN.
PAUSE [dseconds]
PAUSE temporarily stops the script from executing
EXIT for a specified number of tenths of a second. If no
INTERACTIVE ON / OFF number is given, the duration of the pause is 2
seconds.
STEP ON / OFF
EXIT ends the script immediately.
Script-only commands are useful only in script files, INTERACTIVE turns interactive mode on or off.
not interactive CAL.
STEP toggles single-step (debugging) mode on and
An asterisk (*) is used to mark a line as a comment off.
and not a command that should be executed.

Labels and GOTO give a mechanism for jumping


backwards or forwards in a script. A label may be
any text string starting or ending with a colon. It
may appear anywhere in the script. (Prior to Chem
& BioOffice 2006, it had to appear prior to any
GOTO that referenced it.)

IF is a standard conditional statement. It compares


two values according to an operator, then executes
its final statement if the result is true. In the IF/ELSE
format, it executes the ELSE statement when the IF
statement is false. Valid operators are:
= <> < >

488 CAL Commands CambridgeSoft


Script-Only Commands
The table below shows examples of Script-Only
Commands:

Command Action

start: a label

IF $V1 = "" provide an error message if the


MSG Empty variable V1 is empty
value!

PAUSE 100 pause 10 seconds

GOTO start go to specified label

LOOP 10 begin loop to repeat ten times

PAUSE pause the default time: 2


seconds

ENDLOOP return to LOOP statement


until done

NOTE: Script commands are subject to change. See the


Readme for up-to-date information.

Chem & BioOffice 2006 /ChemFinder CAL Commands 489


Script-Only Commands
Administrator

490 CAL Commands CambridgeSoft


Script-Only Commands
Appendix N: CS Oracle
Cartridge
Pre-Setup Procedures In principle, ChemFinder/Oracle can access any
Oracle database and make sense of it. In practice,
Before you can use ChemFinder/Oracle to connect some preparations are recommended:
to an Oracle database, some preparations are You can access data in Oracle databases which
required: do not have the CS Oracle Cartridge installed
for example, biological databases but you
1. Download and install the Oracle Client
cannot search or sort by structure or structure-
software (version 9i). This is available free from
related properties. ChemFinder/Oracle has
Oracle.
been developed with CS Oracle Cartridge
The minimum install alone (called Runtime) version 2.0.1, and is not likely to work with
is not adequate to provide support for earlier versions. (To display the Cartridge
ChemFinder/Oracle. In addition, you must version, look in the Database tab of the Prop-
subsequently choose the Custom install, and erties dialog. The version is listed, or None
select Oracle Windows Interfaces. If you do if unavailable.)
not have the requisite components installed, an
Any table containing structures should have a
attempt to open an Oracle database will
unique primary key. If you connect to a table
generate the error: Provider cannot be found. It
without a unique primary key, you get a
may not be properly installed.
warning message. You can set up a primary key
2. Have the Oracle administrator install CS in ChemFinder (see Indexing on page 446.)
Oracle Cartridge (2.0.1 or later). You can use ChemFinder/Oracle users must have sufficient
ChemFinder/Oracle to access any Oracle data- privileges to create tables in their own
base, but one without the CS Oracle Cartridge tablespaces.
cannot be used to store or search chemical
structures.
Fast-Move Caching
3. Have the administrator set up a user account
for you. ChemFinder/Oracle requires that you Scheme
log in to a tablespace in which you have write
Normally, when you open a database or do a search,
privileges. For access to corporate files, the
ChemFinder issues a select statement. The server
administrator needs to grant you read-only
then processes the statement, prepares a set of
privileges to tables and views of interest
records, and provides a cursor for navigating
outside your tablespace.
through them to retrieve the data. Unfortunately,
4. On your machine, use Oracle Net Configura- when the cursor is asked to move to a position N
tion Assistant to establish a connection to each records from the current one, it requires all N to be
Oracle database you intend to use. downloaded to the client. In the worst case, you

Chem & BioOffice 2006 /ChemFinder CS Oracle Cartridge 491


Fast-Move Caching Scheme
open a large table and use Move Last to see the last 5. Save the form, close it, and reopen it. This is
record, and the entire table is sent down from the currently necessary in order to reinitialize the
server. database connection with the caching scheme.
To get around this problem, an alternative Configuration Via
Administrator

mechanism is available in ChemFinder/Oracle. In


this scheme, instead of requesting complete forms- CF_SETTINGS Table
full of data over a list or query, ChemFinder/Oracle
retrieves only the ID or primary key field, and When you select a table in an Oracle database,
stores (caches) the results in an array in memory. ChemFinder determines and displays the types of
It then need not rely on the normal recordset columns in the table. Heres how it decides whether
cursor. When a request is made to move to record a particular column contains structures:
N, the key for that record is looked up in the array, The column must be of type CLOB or BLOB.
and a new select statement is issued to retrieve only
If the column has been indexed by the CS
the corresponding record. Thus, Move Last takes no
Oracle Cartridge, then it is a structure column.
more time than Move Next.
If there is no index, then ChemFinder/Oracle
There are tradeoffs between the two schemes: looks for a table of configuration info called
The new scheme takes time to retrieve the set CF_SETTINGS. If the column is listed in that
of ID's during a database open, or after a table as being of type STRUCTURE, then it is a
search or sort. Normally, this is quite fast even structure column.
for a large table, and steps are taken to avoid The CF_SETTINGS table is also used to determine
repeating the operation unless necessary. A whether a particular column of type BLOB contains
message on the status bar indicates when this ChemFinder pictures (Windows metafiles).
caching process is taking place.
To designate an unindexed column as a structure
In the new scheme, moving from one record to column:
the next is somewhat slower, since each move
involves a (fast, one-hit) search. This is not very 1. In the Field tab of the Properties dialog, select
noticeable during list browsing, but slows a column of type BLOB or CLOB.
down multi-retrieve operations such as filling 2. Click Set As Structure.
table view.
If the CF_SETTINGS table has not yet been
Because of these drawbacks, the new caching created, an alert indicates that it is about to be
scheme is OFF, by default. To turn it ON for an created.
Oracle-connected form:
3. Click OK to proceed and create the table, or
1. Choose File Database or otherwise bring up the Cancel to abort without creating.
Properties dialog. If the table already exists and there is already an
2. Go to the Oracle tab of the dialog.
entry for the selected column, you are given an
alert and a chance to cancel.
3. Check the Cache ID's for faster moves box.
4. Click OK to proceed.
4. Click OK.
A new entry is created in the table, marking the
You will get an alert instructing you to: selected column as a structure column.

492 CS Oracle Cartridge CambridgeSoft


Configuration Via CF_SETTINGS Table
To designate a BLOB column as a picture column: a. with an Oracle client tool such as SQL*Plus,
OR...
1. If the CF_SETTINGS table does not exist,
create it using steps 1-3 of the above b. by opening it in ChemFinder and creating a
procedure. form.
2. Edit the table one of two ways: 3. Add a row containing the table name, column
name, and a column of type PICTURE.

Chem & BioOffice 2006 /ChemFinder CS Oracle Cartridge 493


Configuration Via CF_SETTINGS Table
Administrator

494 CS Oracle Cartridge CambridgeSoft


Configuration Via CF_SETTINGS Table
Section III: CombiChem
Overview Reaction Template Basics
The example of a reaction template that follows is
CombiChem, the CambridgeSoft engine for supported by CombiChem:
generating combinatorial libraries, was previously
R2

available only as an add-in extension for Microsoft R1


R2

R1
NH2

Excel for Windows. Starting with ChemOffice 8,


N H2O
H
O
N
N

the engine was incorporated into E-Notebook and


H

other products by means of a new Automation


interface in MolServer. This new approach means R2

that the engine can be used by developers NH3


R1

everywhere. For more information, see NH

http://sdk.cambridgesoft.com/chemfinder.
A reaction template must meet the following
specifications:
Working with Reaction All sites of variability require unique R-group
Templates designations.
Solvents, catalysts, and other real-world
CombiChem is a reaction-based combinatorial elements should not be included in the reaction
product. You first enter a reaction template with template drawing.
R-groups at the variable sites in your starting Multi-step reaction templates are supported.
materials, then search for reactants based on these The following sections describe the use of
structures. CombiChem puts your final product templates in both CombiChem/Excel and in
structures together and creates a virtual library. ChemFinder/Office.

Chapter 25: CombiChem/Excel


Working with Excel Users Guide.

CombiChem/Excel Initializing
The CombiChem/Excel add-in requires Microsoft
CombiChem/Excel
Excel 2000 or later. The following procedures When you install ChemFinder or ChemOffice, the
assume you are familiar with Excel for Windows. CombiChem/Excel add-in is automatically
For more information about using Excel, see the installed.

Chem & BioOffice 2006 /CombiChem CombiChem/Excel 495


Working with Reaction Templates
To activate CombiChem/Excel: The CombiChem Help dialog box appears.

1. Open Microsoft Excel. Help drop-down list

2. From the Tools menu, choose Add-ins.


Administrator

The Add-Ins dialog box appears.

Navigation buttons

To use Help, do one of the following:

Choose a topic from the drop-down list.

3. Select the CombiChem for Excel and ChemDraw Browse through the topics using the navigation
for Excel add-ins and click OK. buttons, Previous and Next.

NOTE: CombiChem must have the ChemDraw for Excel To close Help:
addin in order to work.
Click Exit.

The CombiChem/Excel add-in is available until


you cancel it by unchecking the box. Excel will save
Using CombiChem/Excel
the setting, so you dont have to activate each time with secured databases like
you use Excel. ChemACX:
Using Help ChemACX and ChemACX-SC have security which
prevents programs like CombiChem/Excel from
CombiChem/Excel provides abridged Help right using them. To get around this, the ChemFinder
in the worksheets. If you would like to see a fuller samples directory has included two special forms,
explanation of any of the steps, do the following: ACX2005INDEXA.CFW and
ACXSC2005INDEXA.CFW, as alternate forms
On the ChemOffice menu, point to which do allow access. To use these forms:
CombiChem, then select Help from the
submenu. If ChemACX is installed on a hard drive:

496 CombiChem/Excel CambridgeSoft


Working with CombiChem/Excel
Copy <CFW 5. If there are any existing paths, DO NOT
dir>\samples\ACX2005INDEXA.CFW and remove them. Make sure all paths are separated
<CFW dir>\samples\ACXSC2005INDEXA.CFW by semi-colons.
into the directory with the other ChemACX
and ChemACX-SC files, respectively. 6. Click OK.

If you are using ChemACX from the DVD-ROM,


the forms should be left in the samples directory. Creating a New CombiChem
You must, however, configure ChemFinder to Workbook
point the ACX2005INDEXA.CFW form to find
the data on the DVD-ROM. To use CombiChem/Excel, you first create a
To do this, you will need to edit your registry. Reaction worksheet in which to store your reaction
templates.
CAUTION
To create a Reaction worksheet:
CAUTION: Editing your registry can cause serious
problems with your system if you are not careful. On the CombiChem submenu click New Reac-
tion.
1. Launch Regedit. (Go to the Start menu,
choose Run, and type regedit in the text entry
box).
2. Open the following location:
HKEY_CURRENT_USER\Software\Cambridg
eSoft\ChemFinder\10\Pro\Options
3. Right click on the DB_SEARCH_PATH key in
this folder and choose Modify.
4. Add the exact path to the directory that
contains the database.
i.e. E:\ChemACX\ (where E is the letter for
your DVD-rom drive).

NOTE: The last backslash is important. Do not omit


A new worksheet, named Reactions, appears
it.
in your workbook.

Chem & BioOffice 2006 /CombiChem CombiChem/Excel 497


Working with CombiChem/Excel
Adding a Reaction Template
to the Reaction Worksheet TIP: The cell will display Structure 1. You can display
or hide the reaction at any time with the Show Picture
and Hide Picture icons.
To add a reaction template to your worksheet:
Administrator

You can edit the reaction in ChemDraw at any time


if you... then... by double-clicking the cell that contains the reaction
template. You must double-click the cell, not the
have a reaction 1. Click the Load Molecule picture. (That will open Excels Format Picture
saved as a Chem- icon on the ChemOffice dialog box.) Hide the picture, or click near the edge
Draw file toolbar or select Load from of the cell, to avoid clicking the picture.
the Molecule submenu of
the ChemOffice menu. CAUTION

2. Browse to the location of Do not add more than one reaction to a reaction template.
the file and click Open. If you want to start a new combinatorial experiment, save
your workbook and open a new one.
The reaction appears in the
A1 cell of the Reactions
worksheet. Processing the Reaction
Template
do not have a 1. Double-click the cell on the
CombiChem analyzes your reaction and creates a
saved reaction Reactions worksheet
worksheet for each generic reactant (reactant
file labeled: Reaction - double-
containing R-groups) in the template.
To create Reactant worksheets:
click to edit.
On the CombiChem submenu of the ChemOf-
2. Click Yes in the dialog box fice menu click Make Reactant Worksheets.
that asks if you want to add
New worksheets are added to your reaction
a molecule to the worksheet.
workbook.
ChemDraw opens. The Reactant worksheets are named Reactant1,
Reactant2, and so on, up to the number of initial
3. Draw a reaction. generic reactants in your reaction. If your reaction
is a multi-step reaction, intermediates (products of
4. When you are finished,
a prior step in the reaction) are not included.
choose Close and Return to
New Molecule from the When you create worksheets, note the following:
ChemDraw File menu.
If you edit the reaction template by
The reaction appears in the double-clicking on the structure in Excel, it is
A1 cell of the Reactions not automatically reprocessed. You must repeat the
worksheet. Make reactant worksheets step after editing
your template.

498 CombiChem/Excel CambridgeSoft


Working with CombiChem/Excel
If you process a reaction template and there are Searching Databases
already Reactant sheets in the workbook, a
message appears asking if you want to delete To search a database:
the existing sheets.
1. On the CombiChem submenu click Search for
Reactants.
If you want to then
A dialog box appears asking if you want to
search in ChemFinder or search directly.
replace the previous Click Yes
worksheet(s) 2. Select the appropriate choice.

preserve the previous 1. Click No NOTE: If you are searching an SD format datafile,
worksheet(s) select Search Directly.
2. From the File menu,
select Save As and 3. Use the Browse button, or type in the full-path
save the workbook name of the database file you wish to search.
under another name. Click Go.

3. Process the reaction If you selected Search Directly, the hit list is
template imported into the worksheet.
If you selected Search in ChemFinder,
Working with Reactant Lists ChemFinder displays the hit list in the selected
database. You can work in ChemFinder to
After you process a reaction template, the reactant refine the list by modifying the search
worksheets have the generic reactants at the top, conditions and repeating the search and using
one per worksheet. These worksheets hold your Omit Record if you like. When the list contains
reactant lists. the reactants you want to import, return to
Reactant lists contain the building blocks from Excel and use Import Current ChemFinder Hitlist
which you create a product library. The source of on the CombiChem menu to import the list.
these lists can be a ChemFinder database or any You can also copy and paste the query structure
data source in your institution capable of exporting into ChemFinder to perform a search.
MDL SDFiles. When CombiChem processes the
reaction template, it creates query structures. These 1. Select the cell containing the structure.
structures are set up with all the proper parameters
2. Click the Copy Molecule icon on the
to perform a general search on any structure-
ChemOffice toolbar.
searchable database.
3. Open a ChemFinder database, click the Search
Query icon, and select Paste from the Edit
or context menu.
4. After performing the search, use Import Current
ChemFinder Hitlist on the CombiChem menu,
or the import hitlist icon on the ChemOffice
toolbar , to import the list.

Chem & BioOffice 2006 /CombiChem CombiChem/Excel 499


Working with CombiChem/Excel
Reactant List Format performing some property calculations on these
products, you might decide that 10% of these
A Reactant sheet with imported data contains the products are worth synthesizing in the lab. You
following columns: could then create a new experiment with just those
Administrator

Structure products that the calculations show to be


promising.
Use (Y/N)
To create a new experiment:
NOTE: Other columns may be included, depending on the
method used to import the data. 1. On each reactant sheet, select the reactants to
use by typing a Y in their Use(Y/N) column.
Structure Column Type a N for those reactants you do not wish to
use.
The Structure column is headed by the generic
structure that represents all of the reactants on this NOTE: Cells without n or N default to Y.
sheet. Use the Show Picture/Hide Picture
commands to toggle the display. 2. On the CombiChem submenu, point to Experi-
ments then click New.
Use (Y/N)
CombiChem/Excel adds a Use (Y/N) column to
your imported data. When you create experiments,
you enter Y or N in this field to select whether you
want to use that reactant in that experiment. For
more information, see Creating Experiments
below.

Other Data
Other columns contain data from the SDFile or
ChemFinder database you imported, such as A dialog box appears asking if you want to
formula, molecular weight, or Mol_ID. This data is create the experiment with the selected number
not used by CombiChem. You can delete it if you of reactants.
wish.

Creating Experiments
A experiment is a library of product molecules,
created from the reaction template and the reactant
lists you imported or entered manually. You can use NOTE: Enumeration of a product library may take a long
CombiChem/Excel to create, or enumerate, time, especially if there are many reactants or you are using a
multiple experiments per workbook. slower processor.
For example, you can take all the reactants you
imported and enumerate an experiment containing 3. Click Yes when you are satisfied with the
all possible combinations of reactants. After number of reactants to process.

500 CombiChem/Excel CambridgeSoft


Working with CombiChem/Excel
A file browser appears. CombiChem/Excel Working With Experiments
saves your enumeration to a database, so that
there is no longer any limit on the number of After enumerating a experiment, you can do several
products that can be generated. When the things with it. For example, you can calculate
enumeration is done, CombiChem/Excel properties of the products in your experiment using
imports your data to a worksheet. If your ChemDraw/Excels property calculation methods.
experiment exceeds the maximum data For more information, see Using ChemProp Pro
memory for an instance of Excel, (typically, Functions in the ChemDraw Users Manual.
more than 8000 products) you are warned and
advised to save your workbook in case the Configuring Plates
import fails.
You can assign your products to product wells and
After the experiment is created, several new sheets your experiment reactants to reactant block plates
are added to your workbook: with CombiChem/Excel. This is especially useful if
Experiment Reactant sheetscontain lists you are going to use a robotic synthesizer. You can
of the reactants actually used in the experiment. configure plates of up to 50 rows and 50 columns.
There will be one Experiment Reactant sheet
To set up assignments:
for each Reactant sheet.
Experiment Product sheetcontains the 1. Navigate to an Experiment Reactant or
enumerated products in the experiment. Experiment Product worksheet.
2. On the CombiChem submenu, point to Plates,
Using the Products Only Option then click Configure Plates.
The Experiment Product sheet normally shows the The Plate Configuration dialog box appears.
products by displaying the entire reaction. You can The numbered buttons represent wells in the
elect to generate only products by selecting the product or reactant plates.
Make Products Only option on the Experiments
submenu.

Select the option by clicking it. When you next run


3. Use the drop-down Configuration of: menu
a new experiment, the menu option will be checked
to select Product Plate or Reactant Block Plate.
and the new Experiment Product sheet will have
only products, not full reactions. 4. Enter the number of rows and columns.

Chem & BioOffice 2006 /CombiChem CombiChem/Excel 501


Working with CombiChem/Excel
The Plate Configuration dialog box display To remove all plate assignments:
resets according to the values you enter.
1. Select the worksheet where you want to
You can configure plates with three types of remove assignments.
wells:
Administrator

2. On the CombiChem submenu, point to Plates,


reactant or product (green) then click Remove Assignments.
empty (white)
Browsing Plates
controls (orange).
After assigning reactants or products to wells, you
By default, all wells have reactants or can view them.
products assigned to them. Clicking on
1. On the CombiChem submenu click Browse
a well cycles through the well types.
Plates.
5. When you are finished, click Save.
The Plate Browser dialog box appears. The
The template is used when assigning numbered buttons represent the wells in your
experiment reactants or products to plates. plate.
2. Click the appropriate button to move to the
Assigning Plates corresponding reactant or product worksheet
You have to make assignments to plates on each row.
reactant and product worksheet separately.

To assign the reactants or products to plates:

1. Select a reactant or product worksheet.


2. On the CombiChem submenu, point to Plates,
then click Assign To Wells.
Three columns are added to the reactant or
product worksheet: Well plate, Well row, and
Well column.

3. To move between plates, click the navigation


buttons at the top of the dialog box.

Viewing Related Structures


To change plate assignments: After enumerating an experiment, you may want to
see which reactants went into a product or which
Edit the values on the worksheet. products arose from a given reactant.

502 CombiChem/Excel CambridgeSoft


Working with CombiChem/Excel
To highlight products or reactants: 3. Draw a generic reaction. For more information
on generic structures, see the ChemDraw
1. Select a row on a Experiment Reactant or Users Manual.
Experiment Product sheet.
Using a ChemFinder database:
2. On the CombiChem submenu, point to High-
light, then click Highlight Related Records. You can create a database of generic reactions in
ChemFinder. ChemFinder/Office can open .cfw
The related records on the Experiment files directly and browse through them.
Reactant Reactant and Experiment Product
sheet are displayed in color. Once you have a generic reaction in the Structure
window, do the following:
To remove the highlighting from all rows:
1. From the Search menu, select Enumerate.
On the CombiChem submenu, point to High-
light, then click Unhighlight All.
The Combi Enumerator window appears,
showing the reaction as you entered it in the
Structure window. You may add another step
Using CombiChem with to the reaction by clicking the Add Step button,
ChemFinder/Office edit the reaction in ChemDraw by double
clicking in the window, or continue with the
The CombiChem engine can be used with reaction as entered.
ChemFinder/Office (formerly known as
ChemFinder for Word) to generate libraries of
combinatorial experiments. These libraries can be
drawn from any type of file that
ChemFinder/Office can read, and stored as .mst
format databases. For general information on using
ChemFinder/Office, see ChemFinder/Office on
page 449.
There are two ways of entering a CombiChem
template in ChemFinder/Office:
by creating a generic reaction in ChemDraw or
with the ChemDraw ActiveX control.
by creating a ChemFinder database of generic
reactions. 2. Click the Analysis tab.

Using ChemDraw or the ChemDraw ActiveX


control:

1. Open ChemFinder/Office
2. Click the Edit Structure button. Depending on
your Preferences setting, this will open Chem-
Draw or activate the ChemDraw ActiveX
control.

Chem & BioOffice 2006 /CombiChem CombiChem/Excel 503


Using CombiChem with ChemFinder/Office
An analysis of the reaction steps appears below You may edit the hit list before continuing.
the reaction display.
a. Click Edit Hitlist.
An instructional dialog box appears.
Administrator

b. Click OK to open ChemFinder. Edit the


hitlist by selecting Omit from List from the
Record menu.
4. Click the Enumeration tab. Use the Browse
button to select a database in which to store the
results. Click Go.

3. Click the tab for the first reactant. Use the NOTE: You can create a new database file by typing
Browse button to select a ChemFinder or in a file name.
SDFile database, or other source of chemical
structures such as a collection of ChemDraw The results are stored in the database.
files. Click Search.
5. When you are finished, click OK to exit the
Combi Enumerator and return to Chem-
Finder/Office.

To view the results:

1. Open ChemFinder

2. From the File menu select Import, then click


Structures.

3. Select the database from the Open Chemical


Structures dialog box.

504 CombiChem/Excel CambridgeSoft


Using CombiChem with ChemFinder/Office
Section IV: E-Notebook
Chapter 26: Introducing
E-Notebook 10.0
E-Notebook 10 is an electronic notebook that You can use E-Notebook to organize a wide variety
facilitates daily record-keeping for scientists. of other information critical to your work processes
E-Notebook makes it possible for you to manage as well. For example, common reactants used in
diverse types of data on electronic pages that are reaction preps can be stored in the E-Notebook
much like the pages of a paper notebook. The database and shared among researchers. In large
electronic pages make it easy to organize enterprises, E-Notebook can be configured to both
supply and retrieve information from other
information and streamline your workflow.
Enterprise systems, such as chemical registration or
E-Notebook also provides a full audit trail and
chemical inventory management systems.
change tracking features for compliance with 21
CFR Part 11. E-Notebook supports the Oracle database format.

E-Notebook has many advantages over traditional, New Features


paper notebooks. With E-Notebook, you can set up
Notebooks and Pages to manage information NOTE: Note: the label Enterprise indicates that the
about organic syntheses and related information feature is only available in Enterprise versions of
such as stoichiometry calculations, reaction preps, E-Notebook, not in the Desktop version.
spectra, analytical methods, notes, and
spreadsheets. Since E-Notebook has electronic E-Notebook 10 offers many new features,
rather than paper pages, you can conduct searches including:
by substructure, key word, date, and so on. You can Reaction Section Enhancements E-Note-
set up templates to avoid reentering information book now updates the stoichiometry grid auto-
that you often use. Also, E-Notebook fully matically when you edit a reaction drawing.
automates stoichiometric calculations. Additional features for working with salt codes
and solvents have been added as well.
With E-Notebook, you can create a customized Reaction Toolbar a new toolbar makes it
electronic notebook that matches your workflow. easy to manage reactants and products in
You can develop new fields to manage specialized your reactions.
types of data, and configure your own forms to AutoText text in the preparation is
manage the information that is important to you. updated automatically, based on change you
You can also add your own data analysis tools and make to the reaction drawing or
customized searches to E-Notebook. stoichiometry grid.

Chem & BioOffice 2006 /E-Notebook Introducing E-Notebook 10.0 505


New Features
Reaction Explorer you can now view a Enhanced table of contents You can now
reaction tree that displays the predecessors create a customized table of contents: hiding
and successors of a batch or compound. columns, showing additional columns, and
(Enterprise version only). sorting items in an ascending or descending
Administrator

order.
Enterprise ISIS/Draw Integration with
the E-Notebook's ISIS Draw Tool, you can Enterprise Offline data management
draw and store chemical structures and You can create or modify experimental records
reactions in the Chemical Structure Field off-line, then upload them at a later time.
just as you would do with ChemDraw Tool.
Send2ENotebook/Send2File It is now
New Section Enhancements Some more possible to render the contents of a document
sections have been added to E-Notebook envi- using a print driver, and insert the contents into
ronment to increase the range to express your a collection.
ideas.
Enterprise E-Signatures You can now get
Captured Image Sections allow you to your experiments electronically signed then
manage PDF files in E-Notebook. stored in PDF format once they are finished.
MS PowerPoint Sections You can use MS
PowerPoint Sections to manage MS Power- Terminology
Point slideshows in E-Notebook. Many of the terms used to describe the features of
E-Notebook are the same terms that one would use
Formulas You can now associate your own
in describing a paper notebook. In some cases,
custom formulas with tables or property lists in
however, the terminology is different, and familiar
E-Notebook. The formulas can refer to other wordssuch as collection or sectionmay have
values in an E-Notebook form. different meanings. The following terminology is
used in the E-Notebook application and
Enterprise PDF Rendering You can now throughout this guide:
export Collections to PDF, then manage them Administrator The person who configures
as you would PDF documents. E-Notebook and sets up security permissions.
Searching enhancements You can now Collection A set of related items in E-Note-
perform a search that is a union or an intersec- book. Collections are the items that appear in
tion of two searches. Or, you can subtract one the E-Notebook Collection Tree.
set of search results from another. Collection Listener Collection Listeners
modify the behaviors of collections, such as
Enterprise Inbox It is now possible to creating, hiding, renaming, duplicating and
moving behaviors. Administrators assign them
send data to an E-Notebook experiment or
to collections.
another E-Notebook user.
Collection Type A unit of configuration
Acronyms database E-Notebook provides that contains business rules for organizing
a database of 2400 acronyms, which you may collections and sections. Each collection type
add to your reactions. has a name, an icon for displaying collections

506 Introducing E-Notebook 10.0 CambridgeSoft


Terminology
of that type in the collection hierarchy and a set Property List A list of data properties corre-
of business rules that describe what kinds of sponding to a particular section. For example,
operations can be performed on collections of the property list in a reaction section may
that type contain pressure, temperature, etc.
Field A description of a unit of data within a Read privilege The privilege required to
section type. Each field has a type, which view a collection in the collection tree, along
describes the type of data stored in the field, with its contents
and a name. Examples of different types of Read & Write privilege The privilege
fields include a property list, a table, a chemical required to modify the contents of a collection.
structure, a spectrum, a Microsoft Word docu- The Read & Write privilege subsumes all of the
ment. Depending on the type of data stored in features associated with the Read privilege.
the field, the field may also contain additional
Region A geographic area that is used to
configuration information. For example, a
specify characteristics of a user, such as the
property list field contains a list of the proper-
name of the template used when converting
ties that can be included in the property list.
the contents of a set of sections to MS Word
Form the layout of a section is determined by document.
the Form, which contains Fields, Boxes, and Table A section (or part of a section) in
possibly Form Tools. which you can record data in a tabular format.
Form Tool a Form Tool is used to perform Template A collection containing data or
particular function in an E-Notebook section, information that you wish to reuse multiple
such as data analysis or data import/export. times. You can use the template as the basis for
Full Control privilege The privilege new collections.
required to manage the security settings of a Section A set of related pieces of data. Each
collection. The Full Control privilege piece of data is described by a field. For
subsumes all of the features associated with the example, a reaction section might contain a
Read & Write privilege chemical structure drawing, a table of reactants,
History A list of the versions and transitions a table of solvents, a table of products and a
that have been made to a collection. description of the procedure used to create the
drawing.
Home The collection that appears when you
first log in to E-Notebook. It is the collection Section Listener Section Listeners modify
associated with you as a user. the behaviors of sections, such as renaming and
moving behaviors. Administrators assign
Logging In Entering E-Notebook by Section Listeners to various types of sections.
providing a user name and password.
Meta-data Data that describes other data. Section menu icon The icon that
For example, you can use meta-data such as appears when sections are displayed. Right-
creation date or owner's name as parameters clicking the icon displays the Section menu.
when searching for data and information in Section tools icons The icons that appear
E-Notebook. immediately below the Section menu icon if
Owner, of a Collection the E-Notebook there are tools (such as import or export tools)
user who created the collection. associated with the section displayed.

Chem & BioOffice 2006 /E-Notebook Introducing E-Notebook 10.0 507


Terminology
Section Type A unit of configuration that 3. E-Notebook Administrator's Guide
contains a set of fields, form tools and a form. provides detailed instructions for configuring
In addition, you can associate section listeners E-Notebook.
with a section type to implement business rules
In addition, this guide contains instructions for
Administrator

associated with sections of this type.


using the Reagent Selector and CombiChem in
TransitionAn action performed by a user to E-Notebook. (Each of these add-in features is sold
move a collection from one state to another. as a separate component).

Transition ListenerTransition Listeners Introducing the Reagent Selector allows


modify the effect of a transition, usually by you to search ChemACX for chemical struc-
performing an operation that is associated with tures, and to add their properties and structures
the transition. System administrators configure to E-Notebook. (Enterprise version only).
Transition Listeners.
Enterprise Introducing CombiChem for
UserA person who uses E-Notebook. User
E-Notebook makes it possible for you to set
is also the term that E-Notebook uses to iden-
up and manage combinatorial chemistry
tify a person.
libraries in E-Notebook.
VersionThe contents of a collection saved at
a particular time. Getting Started in
E-Notebook
About the E-Notebook
To start E-Notebook, you must log in to the
Guide application. Then, you can begin to browse or
search through E-Notebook.
The E-Notebook Guide provides you with step-by-
step instructions for using the features of
E-Notebook. The left frame of this guide displays Logging In
the Table of Contents; you can open book icons to Depending upon your particular E-Notebook
display topics and the sub-topics they contain. The setup, you may be logging-in in one of two ways:
right frame displays the specific topic you have
selected. Each topic includes hyperlinks to related
Start Menu Login
topics in the guide. This helps you to find the
information you need quickly and easily. To log in from the Windows Start menu,
The E-Notebook Guide is organized into three 1. Select the Start menu, then All Programs.
main portions:
The programs you may launch are displayed.
1. Introducing E-Notebook 10 provides an 2. Point to Chem & BioOffice 2006, then select
overview of E-Notebook, including new E-Notebook Ultra 10.
features and E-Notebook terminology.
You are logged into E-Notebook. The
2. E-Notebook User's Guide provides Collection Tree appears, displaying your Home
detailed instructions for using E-Notebook. Collection.

508 Introducing E-Notebook 10.0 CambridgeSoft


About the E-Notebook Guide
Logging in with Internet Explorer From within the Search area, you can construct a
query to search for information. For example, you
To log in to E-Notebook with Internet Explorer: may want to search for all of the sections that
contain a certain structure, or all of the collections
1. In the address field of your browser, type in the created by a particular user. When you run a query,
address corresponding to E-Notebook. you can save both the results list and the query
itself. Clicking any item in the results list allows you
Either you will be logged in automatically, or
to browse to that item.
the E-Notebook login page will appear,
prompting you to enter your username and
password.
2. If prompted, enter your username and pass-
word, then click the Enter button.
The Collection tree appears, displaying your
Home Collection.

Navigation Overview
E-Notebook is composed of two main areas,
Browse and Search, each of which is represented by Certain menus in E-Notebook are accessed when a
a button at the top of the screen. particular item or icon is right-clicked. For example,
right-clicking a collection in the Collection Tree will
The Browse area displays the collections, organized display the Collection menu.
in a tree structure. To expand a collection and view
its contents, either double-click it or click the plus If at any point you would like to expand the size of
sign next to it. Clicking an individual collection a field in a section, you can double-click the titlebar
allows you to view and/or edit it in the right frame. of the field. The field will expand to take up the
There are a number of options for specifying your entire section area, increasing your working space.
view of the Collection Tree. See Browsing the To shrink the field, simply double-click the titlebar
Collection Tree on page 527 for more again.
information.
Security Overview
Each user of E-Notebook has a unique username
and password. Thus, only valid users may log in to
E-Notebook.

Once a user has logged in, security in E-Notebook


is set up on a collection basis. Security properties
may be set up for any collection in the Collection
Browse button Tree whether it be a User, a Notebook, a Folder,
etc. The security properties of a collection
determine who has Read, Write, or Full Control

Chem & BioOffice 2006 /E-Notebook Introducing E-Notebook 10.0 509


Getting Started in E-Notebook
access to that collection. These access privileges In addition to security at the collection level,
may be assigned to individual E-Notebook users or security may also be configured for collection
to user groups. transitions, specifying which users may or may not
perform certain transitions on collections.
Administrator

Read permission to view the collection, but If you have Full Control permission to a collection,
not edit it. you may determine who has access to the
collection. See Changing Collection Security
Read and Write permission to view the
Properties on page 593.
collection and edit it, if it is in a state that
permits edits. The Administrator Guide provides additional
information for system administrators.
Full Control Read and Write permission,
and also the ability to assign and remove secu- E-Notebook Overview
rity permissions for the collection. E-Notebook manages numerous types of data on
electronic pages that are much like the pages of a
By default, each collection inherits the security
traditional, paper notebook. This information is
properties of its parent in the Collection Tree. The
organized into collections sets of related items
inherited security option may be disabled, however, that appear in a tree structure in the left frame when
so that the security properties of a collection can be you are browsing E-Notebook.
configured independently of its parent.

Examples of some common types of E-Notebook Notebook and Page


Collections are: Therapeutic Area

510 Introducing E-Notebook 10.0 CambridgeSoft


E-Notebook Overview
Project of the E-Notebook users who are working on a
specific project. E-Notebook enables you to set up
Experiment
these relationships easily.
Reaction Scheme
Collections are extremely flexible, because they are
Synthesis designed to allow you to organize your information
in the way that is best suited to your workflow.
For example, you could create a collection that E-Notebook allows you to browse through
contains all of the reaction steps for a specific collections and to search them for important
synthesis. Typically, primary research data is stored information. Also, you can create references to
in Experiments or Pages, which are organized them, duplicate them, and, to prevent further
within Notebooks, just like the paper pages in paper changes, you can transition them to a closed, read-
notebooks. In this case, the synthesis could be a only state.
Notebook, and each of the steps could be a Page.
Each of the Pages may come from a different Just as you would use pages in a paper notebook for
Notebook and may have been created by a different recording various types of data, you can use
Chemist, but the Notebook for this, particular sections in E-Notebook for recording reactions,
synthesis could collect all of these Pages in a single spectra, or any other kind of information. For
place. example, within an Experiment, there may be
sections for Reactions, Notes, Reactants, etc.
You can organize collections in other ways, too. For whatever you need to record and display your
example, you may want to create a collection of all information the way you would with a paper
of the syntheses that lead to a certain product, or all notebook. You also have the option to use

Chem & BioOffice 2006 /E-Notebook Introducing E-Notebook 10.0 511


E-Notebook Overview
templates, so that sections are set up automatically
and uniformly with each new Experiment you
create.
Administrator

Your system configuration determines the types of


collections and sections that you can create within
E-Notebook and the rules that define their
contents. The permission to view, edit, and create
collections can be set up on a per-collection basis.

512 Introducing E-Notebook 10.0 CambridgeSoft


E-Notebook Overview
Chapter 27: Working with E-Notebook
This portion of the guide describes how to use
notebooks, experiments, and other features that Enterprise Working Offline
E-Notebook offers for managing your data.
See the following topics for more information:
Notebooks, Pages,
Notebooks, Pages, Experiments and Other
Experiments, and Other
Collections Collections
Using Templates
This portion of the User's Guide describes how to
Working with MS Office Sections, Reactions, work with notebooks, experiments, and other types
and Other Sections of E-Notebook collections.
Send2ENotebook and Send2File

See the following topics for more information: Working with Reactants Collections

Working with the User Collection Working with User Configurations and Auto-
text Definitions
Working with Pages and Experiments
For information about copying, renaming,
Working with the Inbox
exporting collections, etc., see Organizing
Working with Folders Collections on page 588.

Chem & BioOffice 2006 /E-Notebook Working with E-Notebook 513


Notebooks, Pages, Experiments, and Other Collections
Working with the User Adding a New Collection to
Collection the User Collection
Each user of E-Notebook has an associated user To add a new collection:
Administrator

collection. Your user collection is your home


collection, and appears at the top of the Collection 1. In the Collection Tree, right-click your user
Tree when you first log into E-Notebook. collection.
When your user collection is selected in the A menu appears.
Collection Tree, your home page appears in the
right frame. The home page displays summary
information about your open pages or experiments.

You may add several different types of collections


directly to your user collection:
Notebooks
Folders
2. Select New, then select a type of collection.
User Configurations and AutoText Definitions
Searches Collection Searches, Section 3. The new collection appears and you are
Searches, Text Searches, Unannotated Version prompted to rename it.
Searches, Chemical Structure Searches.
Page or Experiment Templates
Adding a Reference within
References to Notebooks the User Collection
References to Folders 1. In the Collection Tree, click the Notebook,
References to Page or Experiment Templates Folder, or Template to which you wish to
create the reference.
2. While holding the CTRL and SHIFT keys, drag the
collection until the user collection is high-
lighted.
3. Release the mouse.
The Reference appears in the Collection Tree.
Alternatively, you may right-click the collection you
wish to reference, and select Copy from the
Collection menu. Then, right-click the user
collection and select Paste Reference.

514 Working with E-Notebook CambridgeSoft


Working with the User Collection
Browsing up to the User Creating a Notebook
Group
To create a new Notebook collection:
If you have the required security permissions, you
may browse up to the next highest level in the 1. In the Collection Tree, right-click your user
Collection Tree and view the user group at that collection.
level. To do this, right click your user collection,
select Go Up To, then the name of your user group. A menu appears.

Alternatively, you may select View from the menu


bar, then Go Up To.

2. Select New, then Notebook.


Working with Note- 3. A new Notebook collection appears and you
books are prompted to rename it. Its Table of
Contents section appears in the right frame.
Notebooks contain Page or Experiment
collections. Each Notebook has a table of contents
associated with it, which displays summary TIP: If you would like to create a new Page/Experiment
information for each collection in the Notebook. within the Notebook, simply click the New Experiment icon
.

Each Notebook has a Table of Contents section


associated with it. The Table of Contents
summarizes all of the Pages/Experiments that the
notebook contains. Double-clicking the number
associated with any of the contained
Pages/Experiments listed will allow you to navigate
to that Page/Experiment. You may also print the
Table of Contents to create a hardcopy of it; see
Printing Sections on page 585 for more
information.

Chem & BioOffice 2006 /E-Notebook Working with E-Notebook 515


Working with Notebooks
When you rename a Notebook, the names of the Spectra Section
Pages or Experiments within it will change to match
Table Section
the name of the Notebook.
MS Excel Spreadsheet Section
Working with Pages and
Administrator

MS PowerPoint Section
Experiments Captured Image Section
Pages/Experiments in E-Notebook may contain
several different types of sections for experimental Creating a Page or Experi-
data. ment from a Template
Creating a Page or Experi- To create a new Page or Experiment collection
from a template:
ment
1. In the Collection Tree, click the template to
To create a new Page or Experiment collection:
select it.
1. In the Collection Tree, right-click the 2. Drag the template into the Notebook.
Notebook collection to which you would like
to add the Page or Experiment. A new Page or Experiment is created, based on
the template.
A menu appears.
Alternatively, you may right-click the template and
select Copy. Then, right-click the Notebook and
select Paste. (See Working with Templates on
page 520 for information about creating the initial
template).

Closing and Reopening


Pages and Experiments
Pages and Experiments have several states which
2. Select New, then Page (or Experiment). define their lifecycles. You may perform transitions
A new Page or Experiment collection appears on a Page or Experiment to move it from one state
within the Notebook. It is numbered to another.
automatically. Open writable, optional annotation of
You may associate several types of sections with the changes
Page/Experiment: Closed read-only
Reaction Section Reopened writable, required annotation of
MS Word Document Section changes, changes visible on the screen and in
the printed copy. (See Changes and Audit
Ancillary Data Section
Trail on page 601 for information about visu-
Spectrum Section alization of changes and providing annotation).

516 Working with E-Notebook CambridgeSoft


Working with Pages and Experiments
Enterprise Working with the Creating a Folder
Inbox To create a new Folder collection:
E-Notebook makes it possible for data to be sent 1. In the Collection Tree, right-click your user
from external sources to an Inbox or temporary collection.
holding area. For example, you could send spectral
A menu appears.
data to a particular E-Notebook user or to a specific
experiment. This could be done with, for example,
the Send2 feature. The section will appear in an
Inbox, and from there you can move it into the
appropriate experiment.
For more information, see Using the Inbox on
page 549.

Working with Folders


You can use folders to organize and manage other
types of collections:
other Folders
2. Select New, then Folder.
Saved Searches Collection Searches, Section
Searches, Text Searches, Chemical Structure 3. A new Folder collection appears and you are
Searches, Unannotated Version Searches prompted to rename it.
References to any type of collection Or, you may right-click an existing Folder collection
and select New, then Folder, to create a Folder
within a Folder.

Adding a Reference to the


Folder
You may add references to a folder if, for example,
you would like to keep the information from several
Pages/Experiments together, but the Pages/Exper-
iments exist in separate notebooks.
1. In the Collection Tree, click the Collection to
which you wish to create the reference.
2. While holding the CTRL and SHIFT keys, drag the
collection until the folder collection is high-
lighted.
3. Release the mouse.
The Reference appears in the Collection Tree.

Chem & BioOffice 2006 /E-Notebook Working with E-Notebook 517


Working with the Inbox
Alternatively, you may right-click the collection you Working with Reactants
wish to reference, and select Copy from the
Collection menu. Then, right-click the folder Collections
collection and select Paste Reference. Reactants are named shortcuts for a commonly
Administrator

used compounds. These could be either common


Working with the User reagents, or named compounds that you use
Configuration Folder frequently.

Within your user collection, there is a User You may populate reaction sections with the
Configuration Folder, which can contain Reactants, properties of reactants.
AutoText, and Templates. E-Notebook provides 2477 commonly used
reactants, as shown below:
To expand your User Configuration folder and view
its contents, either double-click it in the Collection
Tree or click the plus sign next to it:

Reactants Folder contains reactants whose Adding a New Reactant to


structures and properties you can add to Reac-
tion Sections. See Working with Reactants
an Existing Reactant Collec-
Collections on page 518 for information. tion
AutoText Definitions contains predefined To add a new reactant section to an existing collec-
text fragments that you can reuse to simplify tion.
text entry in, for example procedure text. See
Creating New Autotext Definitions on page 1. Browse to the Reactants collection to which
546 for information about configuring Auto- you wish to add the Reactant, clicking the
Text collection in the Collection Tree to select it.
Templates folder contains templates of The Reactants collection appears, with the
various types that you can use to avoid unnec- existing reactants displayed in the right frame.
essary reentry of data. See Working with 2. In the right frame, click the New Reactant
Templates on page 520 for more information. button.

518 Working with E-Notebook CambridgeSoft


Working with the User Configuration Folder
A new reactant section appears. A new Reactant section appears.
You may populate reaction sections with the
properties of reactants.

Working with Table of


Contents
E-Notebook collections often have Table of
3. To rename the section, click the Section menu Contents sections associated with them. The Table
icon and select Rename Section from the of Contents lists all of the collections that fall
menu that appears. Then type in a name. directly within the selected collection in the
Collection Tree. For example, if a
4. Draw or import the structure using the Chem-
Notebook contains Experiments, all of the
Draw tools.
Experiments in the Notebook will be listed. Or, if a
The formula and molecular weight properties Folder contains templates, all of the templates in the
are updated automatically. The compound Folder will be listed.
name may be updated as well. The compound
name will be displayed in the table of contents Double-clicking the link by any of the contained
for the Reactants Folder that contains this collections listed will allow you to navigate to that
reactant. (Click the Reactants Folder in the collection. You may also print the Table of
Collection Tree to view its table of contents). Contents to create a hardcopy of it. See Printing
Sections on page 585 for more information.
Adding a New Reactant You can customize a Table of Contents to display
Collection only the columns that are of interest to you. It is
also possible to sort items in the TOC in either an
You can add a new Reactant Collection to your User ascending or a descending order.
Configuration folder in E-Notebook. To add a new
Reactant Collection: Hiding Columns
1. Right-click the Reactants Folder and select You can hide columns in the Table of Contents. To
New, then Reactants. do this:
1. Right-click the column you wish to hide.
A menu appears.

A Reactants collection appears, and you are


prompted to rename it. 2. Select Hide followed by the name of the
2. Enter a name for the Reactants collection. column.
3. Click the New Reactant tool in the right frame. The screen refreshes, and the column is hidden.

Chem & BioOffice 2006 /E-Notebook Working with E-Notebook 519


Working with Table of Contents
Showing Columns Sorting Items in the TOC
To show additional columns that are hidden, or are You may sort items in the TOC in either an
not currently displayed in the Table of Contents. ascending or descending order. To sort items in an
Administrator

ascending order:
1. Right-click one of the columns in the Table of
1. Right-click the column by which you wish to
Contents. sort the Table of Contents.
A menu appears. A menu appears.

2. Select Sort Ascending.


2. Select Show Columns.
The items are sorted in ascending order according
The Show Columns dialog appears, listing the to the column you selected.
columns you may select for display in the TOC. The
columns that are currently displayed are denoted To sort items in an descending order:
with checkmarks.
1. Right-click the column by which you wish to
sort the Table of Contents.
A menu appears.

2. Select Sort Descending.

The items are sorted in descending order by the


3. Select and deselect columns to customize the column you selected.
TOC display.
Working with Templates
The columns you selected appear with checkmarks
next to them. E-Notebook gives you the ability to use templates
so that you can avoid reentering information
4. Click OK to close the dialog. unnecessarily. For example, you may create a
template for a particular type of Experiment or
The dialog closes, and the screen refreshes to Page. It may contain data and notes that you often
display the additional columns. use, or typical values for various properties.

520 Working with E-Notebook CambridgeSoft


Working with Templates
To create a new template: Reaction Sections

1. Within your User Configuration Folder, there Captured Image Sections


should be a My Template folder. Right click Ancillary Data Sections
this folder and select New, then the type of
template you wish to create. Table Sections

The template appears within the folder. Spectrum and Spectra Sections
2. Add any data you wish to the template. MS Word Sections
In order to use the template as the basis for a new MS PowerPoint Sections
experiment:
MS Excel Spreadsheet Sections
1. Select a notebook in the tree, and click the New Your system configuration determines the types of
Experiment button: sections that are available in E-Notebook.

Reaction Sections
Reaction Sections can be used to show one step in
a reaction. You can draw and store a reaction using
the ChemDraw reaction field. The ChemDraw
A list of the available templates is displayed. Toolbar allows you to create a chemical structures
2. Select the desired template. in the reaction field. The section contains a
stoichiometry grid as well, that analyzes the reaction
A new experiment appears within the drawing automatically. The AutoText feature
notebook. It contains all of the data that was in updates the preparation text when you change the
the template. reaction drawing and/or information in the
Alternatively, simply click a template in the tree to stoichiometry grid.
select it, then drag it into the notebook to create a
new Experiment. For detailed information about all the features of
Reaction sections, see Reactions in E-Notebook
Working with MS Office on page 530.

Sections, Reactions, and Captured Image Sections


other Sections Captured Image Sections allow you to view and
Pages/Experiments in E-Notebook may contain annotate PDF images and documents, using the
several different types of sections for your same tools as Adobe Acrobat software. With
experimental data. Just as you would use pages in a Captured Image Sections, you have the capability
paper notebook for recording various types of data, for importing, exporting, viewing, and annotating
you can use sections in E-Notebook for recording PDF documents. The section supports all image file
MS Excel data, reactions, images, and other types of types such as JPG, GIF, PNG, TIFF and BMP.
information.
For detailed information about importing,
You may associate several types of sections with the exporting, clearing etc., see Working with
Page/Experiment: Captured Image Sections on page 556.

Chem & BioOffice 2006 /E-Notebook Working with E-Notebook 521


Working with MS Office Sections, Reactions, and other Sections
Ancillary Data Sections Spectrum and Spectra
Sections
Ancillary Data Fields make it possible for you to
associate a file type which is not supported by Spectrum Sections allow you to view and analyze
Administrator

E-Notebook. Although the file cannot be viewed spectrum images, using the same tools as Galactic
from within E-Notebook, a user can export it to a GRAMS32 software. Thus, you can manage your
selected location, then open it and view or edit it spectra data easily and effectively using Spectrum
from there. and Spectra sections. You can import spectrum
images of various types. The section allows you to
When you import the file, the checksum, source copy and export spectrum images as well.
path, source file name, source file size and source
While the Spectrum Section can contain a single
file type are populated automatically into the spectrum, the Spectra section can contain multiple
E-Notebook. spectra, organized in subsections or subtabs.
For detailed information about all the features of For more information, see Working with
Ancillary Data Sections, see Working with Spectrum and Spectra Sections on page 566.
Ancillary Data Sections on page 569.
MS Word Sections
Table Sections MS Word Sections allow you to view and edit MS
Word documents within E-Notebook sections, thus
Tables enable you to organize data in an easily managing the information that you normally record
interpreted, tabular format. The Table sections in in MS Word. You can import MS Word documents
E-Notebook can be used to organize the chemical from external sources, or export MS Word
properties of compounds that interest you. You can documents and edit them in MS Word. The
add properties to a Table, pivot a Table, resize toolbars displayed with an MS Word field in
columns and rows, and organize columns and rows. E-Notebook are the toolbars that appear when you
Tables may contain several basic types of data open MS Word.
text data, numerical data, dates, or structures. You
may set up tables in different sections in For more information, see Working with MS
Word Sections on page 558.
E-Notebook to contain different types of
information.
MS Excel Spreadsheet
Another feature of tables is the ability for you to Sections
add references to them. You can insert links to
MS Excel Section allows you to manage Excel
other E-Notebook sections or collections into a
spreadsheets in E-Notebook. Its main purpose is to
table. When you add a reference or link to a table,
provide you with a facility to create, modify, and
you may navigate to the collection or section you
save your Excel spreadsheets within E-Notebook
have referenced, simply by clicking a link in the environment.
table cell.
You can import the MS Excel spreadsheets into
See Working with Table Sections on page 570 for E-Notebook. The section allows you to export and
more information. clear the slideshows as well. The toolbars displayed

522 Working with E-Notebook CambridgeSoft


Working with MS Office Sections, Reactions, and other Sections
with an MS Excel field in E-Notebook are the 2. Select Print and a Print dialog box appears.
toolbars that appear when you open MS Excel
spreadsheets.

For detailed information on this topic, see


Working with MS Excel Spreadsheets on page
555.

Send2ENotebook and
Send2File
You can send a file from another application to
E-Notebook with Send2ENotebook, and have it
appear within E-Notebook in PDF format. The
objective of the Send2 feature is to allow the 3. Select the printer Send2ENotebook from the
convenient capture or various types of data from dropdown and click OK button.
other applications into E-Notebook system. This is
A dialog appears prompting you to log into the
typically output from either instrument control
E-Notebook.
applications or from various scientific analysis
software. PDF is the format for Send2 feature.

With the Send2File feature, you can also send such


a file in PDF format to your network outside the
E-Notebook so that you can bring it later into the
E-Notebook whenever you require. This is useful
for sending files from workstations that do not have
the E-Notebook application installed. Click Connect button to send to E-Notebook and
click the Send2File button to send to file.
To start the'Send2ENotebook or Send2File process:

1. Open the document you wish to send and Working with


expand File (or whichever menu option Send2ENotebook
accesses to the Print option).
To Send a document to E-Notebook,

1. Open the document in the appropriate


application (outside of E-Notebook).

2. Select the Print option in the application.

3. After you have selected the printer


Send2ENotebook, a dialog appears prompting
you to log into E-Notebook. Click the Connect
button to send to E-Notebook

Chem & BioOffice 2006 /E-Notebook Working with E-Notebook 523


Send2ENotebook and Send2File
The following dialog box appears and you can set a. Click to open the User Collection.
the destination where you wish to send the
document in E-Notebook. A dialogue appears:
Administrator

4. Click the Set Target Collection Type button and


it displays a dialog where you can fill in the type
of your collection and click OK.

b. Click Select and you can select the User.


5. Select the Notebook or Collection where you
wish to send the document with the help of 7. Type the name of the section by which the
dropdown list. document will appear in the E-Notebook
collection in the following box:

The checkmark below is


8. Fill the properties in the Property Values List:
for the option to send the document in the Inbox
of the Collection.
6. Alternatively, you can select User In Box if you
wish to send the document to the Inbox in the
User Collection.

524 Working with E-Notebook CambridgeSoft


Working with Send2ENotebook
Click Send button to finish the Send to E-Notebook 5. Select File option as:
process:

6. Alternatively, click the Send2File button to send


to a location outside E-Notebook.

The following dialog box appears:

The document in PDF format gets added to your


collection in E-Notebook as a different section.

Working with Send2File 7. Click to open the following destination


To start Send2File, window and you can set the destination where
you wish to send the document. PDF is the
1. Open the document in the appropriate only format:
application (outside of E-Notebook).
2. Select the Print option in the application.
3. After you have selected the printer
Send2ENotebook, the E-Notebook Login
dialog appears.
4. Click the Connect button and the following
dialog box appears.

8. Click Save and the dialog appears as:

Chem & BioOffice 2006 /E-Notebook Working with E-Notebook 525


Working with Send2File
9. Click the Send button to send the file to the The document in PDF format gets saved to your
specified location and close the Send2File specified location and you can bring it into the
process: E-Notebook later.
Administrator

Enterprise Working Offline


E-Notebook makes it possible for you to work in
offline mode. In offline mode, you are
disconnected from the network. When you
reconnect, you can upload the changes you made
offline to the central, E-Notebook database. See
Working Offline on page 550.

526 Working with E-Notebook CambridgeSoft


Working Offline
Chapter 28: E-Notebook Features
The following chapters of the guide provide Changes and Audit Trail information
instructions for using the features that are available about how to save and view your changes in
in E-Notebook. E-Notebook.
See the following topics for more information:
Browsing the Collection
Browsing the Collection Tree informa-
tion about how to browse through the E-Note-
Tree
book application Collections, and their contents, are organized in a
E-Notebook Workflows description of tree structure, called the Collection Tree, on the left
reactions and other workflows in E-Notebook side of the browsing screen. E-Notebook offers a
Working with E-Notebook Data informa- number of options for browsing collections.
tion about working with the various E-Note- To begin browsing collections, click the Browse
book fields, such as MS Word, chemical button at the top of the screen.
structure, and property lists and tables
The Collection Tree appears.
Rendering in E-Notebook description of
how to create various types of output from
E-Notebook, e.g., PDF's and MS Word docu-
ments. This topic also contains a description of
how to use the E-Notebook E-Signatures
feature

Enterprise Using the Inbox instructions


for working with your Inbox in E-Notebook

Enterprise Working Offline description


of how to work in offline mode
Working with Sections information about See the following topics for more information:
the various features of E-Notebook sections: Limiting Collection Browsing
renaming, copying, deleting, etc.
Browsing from Home
Working with Form Tools descriptions of
Browsing at a Higher Level
the E-Notebook form tools, such as the tools
used import documents and create new Browsing the Entire Collection Tree
sections Use the Back and Forward arrows to the left of the
Working with Collections information Browse button to navigate the Collection Tree view.
about the various features of E-Notebook These arrows perform a similar function for the
sections: renaming, copying, moving up and collection tree that Back and Forward web browser
down in the tree, etc. buttons perform for the browser window.

Chem & BioOffice 2006 /E-Notebook E-Notebook Features 527


Browsing the Collection Tree
It is only possible for one E-Notebook user to edit To view the Collection Tree again,
an individual collection at a time. If another user is
1. Move your cursor to the left boundary of
editing a particular Collection and you select the
the section, until the double-headed
Collection in the tree, you will be presented with a
arrow appears again.
Administrator

message informing you that the Collection is locked


for editing by the other user. 2. Double-click.(Or, you may click the
touch bar at the left boundary of the
Showing and Hiding Collec- E-Notebook window).
tions The Collection Tree reappears.

The Collection Tree provides you with a means of Limiting Collection Browsing
expanding and contracting collections so that you
only see the information you need. You can limit your browsing by selecting a root
collection for the Collection Tree. The root
To show the contents of a collection: collection becomes the highest browsing level in
Click the plus sign next to the collection whose the Collection Tree. Limiting the Collection Tree
contents you wish to see. view can make it easier to find specific information.
The collection is expanded, and you can view To set a root for the Collection Tree:
its contents.
1. Click the Browse button at the top of the
To hide the contents of a collection:
screen.
Click the minus sign next to the collection. The Collection Tree appears.
The collection is minimized, so that you cannot 2. Right-click the collection you wish to be the
see its contents. root collection for browsing.
Hiding the Collection Tree A menu appears.

It is possible to hide the Collection Tree if you


would to increase the screen area you have for
entering data into a section.
To hide the Collection Tree:
1. Move your cursor to the right boundary of the
tree, so that the cursor becomes a double-
headed arrow.
2. Double-click.
The Collection Tree is hidden.
Alternatively, you may click the touch bar at 3. Select Browse Here.
the right-border of the Collection Tree.

528 E-Notebook Features CambridgeSoft


Browsing the Collection Tree
The collection you selected appears at the top Alternatively, you may select View, then Go To, then
of the collection tree. Home from the E-Notebook menu bar:

Browsing from Home


Browsing at a Higher Level
You can browse from your Home Collection, which
contains all of the collections associated with you as You can browse at a higher level in the Collection
a user of E-Notebook. This is the collection that Tree, and see all of the collections at that level.
appears when you first log in.
To browse at a higher level:
To browse to your Home Collection and bring the
Home Collection to the top of the Collection Tree: 1. Click Browse.

1. Click Browse. 2. The Collection Tree appears.

The Collection Tree appears. 3. Right-click a collection in the tree.


2. Right-click any blank area of the Collection A menu appears.
Tree.
A menu appears.

3. Click Go Home.
The Home Collection appears at the top of
Collection Tree.
4. Select Go Up To.
The collections that either contain or reference
the item are listed.
5. Select the collection that you wish to bring to
the top of the Collection Tree.
The collection you selected appears at the top
of the tree. Its contained collections and
contained references are displayed.

Chem & BioOffice 2006 /E-Notebook E-Notebook Features 529


Browsing the Collection Tree
Alternatively, you may select View, then Go Up To In E-Notebook menu bar, select View, then
from the E-Notebook menu bar. Go To, and Browse All.
Administrator

Browsing the Entire Collec-


tion Tree NOTE: The Browse All command will only be available if
Browsing the entire Collection Tree enables you to you have the Read privilege for the collection at the top of the
see all of the E-Notebook collections at once. collection hierarchy. If you do not have Read privilege for the
collection at the top of the hierarchy, it may be necessary to
To browse the entire tree: conduct a collection search in order to view some of the
collections to which you have access. See Searching on page
1. Click Browse.
609 for more information.
The Collection Tree appears.
2. Do one of the following
E-Notebook Workflows
Right-click any blank area of the Collection
tree, and select Browse All from the menu This portion of the guide describes the workflows
that appears. in E-Notebook. The E-Notebook features can be
combined to support a number of different
workflows.

Reactions in E-Notebook
The following topics describe the features that are
used in an E-Notebook reaction section:
Right-click any collection in the tree, and
Drawing and Analyzing Reactions
select Browse All from the menu that
appears.
Enterprise Editing Structures Using
ISIS/Draw
Working with the Name to Structure Feature
Working with the Reaction Toolbar
The Stoichiometry Table

Enterprise Working with Batch Explorer

Working with AutoText

530 E-Notebook Features CambridgeSoft


E-Notebook Workflows
Drawing and Analyzing Reactions 2. Using the ChemDraw tools, draw a reaction,
with reactants to the left of the arrow and prod-
You can draw a reaction using the ChemDraw
ucts to the right.
reaction field. When you draw a reaction, the
stoichiometry grid is automatically populated with
the properties of the reactants and products. If you NOTE: You can access a drawing menu by right-clicking in
remove a reactant or product from the the structure window. This menu allows you to, among other
stoichiometry grid, the corresponding structure will things, copy and paste structures.
be removed from the reaction drawing.
The ChemDraw Toolbar allows you to create a
chemical structure by connecting frequently used
Expanding the Drawing Window
substructures together. For more information
To expand the drawing window:
about using the ChemDraw Toolbar, please see the
ChemDraw User's Guide.
1. Double-click the titlebar of the chemical
Drawing a Structure or Reaction structure field.

To draw a reaction: The chemical structure field expands.

1. Click within a reaction field. 2. Using the ChemDraw tools, draw the structure
The ChemDraw toolbar appears. or reaction.

When you are finished editing, double-click the


frame of the chemical structure field to return it to
its original size in the form.

Enterprise Working with ISIS/


Draw
N
O 2

M
e
N
O 2
E-Notebook allows you to draw a reaction using
M
e
H
C(O
Et)3
ISIS Draw. If your system is configured to use
T
sOH

N
H2 N O
Et ISIS, you will be able to draw chemical structures
using the ISIS/Draw tools. For more information
about using the ISIS Draw Tool, please see the ISIS
Draw User's Guide.

Drawing a Structure or Reaction


To draw a reaction:

Chem & BioOffice 2006 /E-Notebook E-Notebook Features 531


E-Notebook Workflows
1. Double-click within the reaction field and ISIS Working with the
Draw page will launch as shown:
Name=Struct Feature
With this feature, the names of compounds you
Administrator

draw in a reaction are added to the stoichiometry


grid automatically, using ChemDraw's
Name=Struct feature. Prior to using this feature,
you need to have ChemDraw Ultra installed on your
machine.
The Name=Struct feature is designed to be as
smart as a real chemist, interpreting chemical names
into their most reasonable structures as they are
actually used by chemists.
2. Using the ISIS Draw tools, draw a reaction,
with reactants to the left of the arrow and prod- To convert a name to a structure,
ucts to the right:
1. Draw the structures in the reaction section.
2. Save your changes.
The structure names appear in the stoichiometry
grid.
If you make changes to the reaction drawing, the
names will be updated automatically.
If you manually change the name of any structure in
the grid, your change will not be overwritten if you
When you are finished editing, click on the close alter the corresponding structure drawing.
icon, to return to E-Notebook: Working with the Reaction
Toolbar
The reaction toolbar provides a number of features
for managing the reactants and products in your
reaction section.
The reaction toolbar normally appears just below
the reaction field.

532 E-Notebook Features CambridgeSoft


E-Notebook Workflows
Adding Structures with the Reaction 3. Click the down arrow by the Add button to
Toolbar display the options for adding the structure to
the reaction section.
With the reaction toolbar, you can add reactants
and products from your Acronyms collections in
E-Notebook. There are two methods for adding a
structure with the reaction toolbar:

Using the Add Dialog to Add a Structure


Using Quick Add to Add a Structure The options are:
Using the Add Dialog to Add a Structure Left of Arrow as Reactant adds the
structure to the reaction drawing to the left
The Add button on the reaction toolbar brings up a of the arrow, and adds it to the reactants
dialog that allows you to select a structure and add table in the grid.
it to your reaction section. Top of Arrow as Reagent adds the
structure to the reaction drawing above the
To add a structure:
arrow, and adds it to the reactants table in
1. Click the Add button in the reaction toolbar.
the grid.
Right of Arrow as Product adds the
The Select and Add Structure dialog appears, structure to the reaction drawing to the right
displaying the acronyms in your Reactants of the arrow, and adds it to the products
Folder: table in the grid.
To Grid as Reagent adds the structure to
the grid only, in the reactants table.
4. Select the option you desire from the menu.
5. Click the Add button.
The structure is added to the reaction section
in the manner you selected.
There are several options for filtering the acronyms
displayed in the dialog. See Filtering Acronyms
with the Reaction Toolbar on page 534.
Using Quick Add to Add a Structure
2. Click the name of a structure in the list that
With the Quick Add button, you can bypass the
appears in the right frame to select it.
Add Structure dialog and remove several steps
The structure is selected, and its structure from the process of adding a structure to your
drawing appears. reaction.

Chem & BioOffice 2006 /E-Notebook E-Notebook Features 533


E-Notebook Workflows
To add a structure with the Quick Add button: Filtering Acronyms with the Reaction
Toolbar
1. Select an acronym from the dropdown list that
The reaction toolbar offers several options for
appears in the reaction toolbar. This dropdown
filtering acronyms before selecting one to add to
Administrator

lists all of the acronyms in your Reactants


your reaction section.
Folder.
To jump to a particular structure:
2. Click the down arrow by the Quick Add button
in the reaction toolbar. 1. Click the Add button in the reaction toolbar.
The Select and Add Structure dialog appears,
The options for adding the structure to the reaction
displaying the acronyms in your Reactants
section are displayed. The options are: Folder.
Left of Arrow as Reactant adds the 2. Begin typing the name of the structure you
structure to the reaction drawing to the left wish to select.
of the arrow, and adds it to the reactants The selected structure changes to match the
table in the grid. text you have typed.

Top of Arrow as Reagent adds the


structure to the reaction drawing above the beginning
arrow, and adds it to the reactants table in of
structure
the grid. name

Bottom of Arrow as Solvent adds the


structure to the reaction drawing below the
arrow, and adds it to the reactants table in
the grid.

Right of Arrow as Product adds the


structure to the reaction drawing to the right
Applying a Filter
of the arrow, and adds it to the products
table in the grid. To filter the acronyms that are displayed in the dia-
log:
To Grid as Reagent adds the structure to
the grid only, in the reactants table. 1. Click the Filter button at the top of the dialog.
The Apply Filter window is displayed.
To Grid as Solvent adds the structure to
the grid only, in the solvents table.

3. Select the option you desired.

4. Click the Quick Add button in the reaction


toolbar.

The structure you selected is added to your 2. From the dropdown list, select either Names
reaction. Starting with or Names Containing.

534 E-Notebook Features CambridgeSoft


E-Notebook Workflows
3. Enter the text for the filter. In this example, The structure you selected is added to the
chloro was entered. collection.
4. Click OK to close the Apply Filter window. 4. Close the dialog.
The filtered list of acronyms is displayed.
Deleting a Structure with the Reaction
Toolbar
You can use the reaction toolbar to delete structures
from a reaction.
To do this:
1. In the reaction drawing, use the ChemDraw
tools to select the structure you wish to delete.
2. Click the down Delete button in the reaction
toolbar.
Removing a Filter The structure is deleted.
To remove a filter: Working with the Stoichiom-
1. Click the Remove Filter button. etry Table
The filter is removed, and the entire list of The stoichiometry table calculates and stores
acronyms is displayed. stoichiometric data for a reaction. It is filled in
automatically as you modify a reaction drawing. You
Defining a New Acronym with the Reac- may change values manually as well.
tion Toolbar
It is also possible to add reactants from the
You can use the reaction toolbar to add new Collection Tree to the stoichiometry table.
acronyms to reactants collections in E-Notebook.
Depending upon your system configuration, certain
To do this: of these properties may not appear, or additional
1. In the reaction drawing, use the ChemDraw properties may be present.
tools to select the structure you wish to define Reactant properties:
as an acronym.
Name the text name of the reactant.
2. Click the down Define button in the reaction
toolbar. Molecular Formula (MF) the chemical
formula that shows the number and kinds of
A dialog appears, prompting you to select the
atoms in a molecule of the reactant.
Acronyms collection where you wish to add the
new acronym. Limiting? a yes or no value, indicating
whether the reactant is the limiting reactant in
graphic the reaction.
3. Select the collection and click the Create Here Sample Mass the total quantity of the reac-
button. tant sample.

Chem & BioOffice 2006 /E-Notebook E-Notebook Features 535


E-Notebook Workflows
Reactant Mass the total quantity of the Molecular Weight the sum of the atomic
reactant. masses (atomic weights) of the atoms in the
Molecular Weight (MW) sum of the atomic molecular formula, as set forth in the periodic
masses (atomic weights) of the atoms in the table.
Administrator

molecular formula, as set forth in the periodic Formula Mass the sum of the atomic
table. masses (atomic weights) of the atoms in the
Formula Mass sum of the atomic masses formula of the compound. This tends to be a
(atomic weights) of the atoms in the formula of more general term than molecular weight, and
the compound. This tends to be a more general can be applied to compounds such as ionic
term than molecular weight, and can be applied compounds.
to compounds such as ionic compounds. Theoretical Moles the calculated number of
% by Weight (%Wt) the percentage of reac- moles of the product that the reaction yields.
tant in the sample.
Actual Moles the actual number of moles of
Moles the number of molecules of the reac- the product that the reaction yields.
tant / 6.023 x 1023.
Equivalents the proportion of the product
Equivalents the proportion of the reactant relative to the other components in the reac-
relative to the other components in the reac- tion.
tion.
Loading the number of product moles per
Molarity the number of moles per volume of
amount of the product.
the reactant.
Volume (Vol) the three-dimensional Adding Information to the Stoichiometry
measurement of the reactant, such as mL, L, etc. Table
Density (D) the mass per unit volume of the
reactant. You can manually type stoichiometric information
into the stoichiometry table of a reaction section, as
Loading the number of reactant moles per well as add reactants from the Collection Tree.
amount of the reactant sample.
Product Properties: To manually add information to a Stoichiometry
Table:
Name the text name of the product.
Molecular Formula the chemical formula 1. In the reaction section, click a cell in the
that shows the number and kinds of atoms in a stoichiometry table.
molecule of the product 2. Type the information into the cell.
Theoretical Mass the calculated mass of The information is saved, and the text is
product the reaction yields. displayed in blue. If you have entered a number
Actual Mass the actual mass of product the and there are default units associated with the
reaction yields. property, the units are displayed. (See
% Yield the ratio of the actual amount to the Working with Numerical Units in Tables on
theoretical amount. page 575 for more information).
% Purity the percentage of the actual 3. Repeat the process for other cells in the table,
amount that is the product. if necessary.

536 E-Notebook Features CambridgeSoft


E-Notebook Workflows
To enter reactant information into the Stoichiome- Information about the reactant is displayed on
try Table: the right side of the dialog box.
4. Click Add .
1. Right-click the a cell in the the Reactants
section of the Stoichiometry Table. The dialog box closes, and the Stoichiometry
Table is populated with information about the
A menu appears. reactant.

Removing Reactants and Products from


the Stoichiometry Table
You can remove all of the information pertaining to
a particular product or reactant from the
Stoichiometry Table automatically. If the reactant
you remove is the limiting reactant in the reaction,
the first remaining reactant becomes the limiting
reactant.
To remove a reactant or product from the stoichi-
ometry table:
1. Right-click the reactant or product you wish to
remove.
2. Select Add Reactant After, to add a reactant after A menu appears.
the selected item or Add Reactant Before, to add
a reactant before the selected item.
A dialog box appears. You are prompted to
browse for the reactant you wish to select.

2. Select Remove Product if it is a product, or


Remove Reactant if it is a reactant.
A message appears, asking you if you are sure
you want to delete the reactant or product.
3. Browse to the reactant section with the reac-
tant you wish to add. (See the Working with 3. Click Yes.
Reactants portion of this guide for information The reactant or product is removed from the
about creating and using reactants collections. Stoichiometry Table. If it was present in the
If you wish, you may add a new reactant to reaction drawing, it is removed from the
E-Notebook from the Add Reactant dialog). drawing as well.

Chem & BioOffice 2006 /E-Notebook E-Notebook Features 537


E-Notebook Workflows
Working with Salts and Solvates in a 1. Click the New Solvate button. (Or, to add a
Reaction Section new salt code, click the New Salt Code button).
In an E-Notebook reaction section, it is now easier A dialog appears and you can browse to solvate or
to represent a compound that is present in a salt or salts in your User Configuration folder.
Administrator

hydrated form. You can enter a formula that


accounts for salts and hydrates.
To enter a formula,
1. In the stoichiometry grid, double-click the
molecular formula cell.
A dialog appears.

2. Click New Solvate (or New Salt Code) and


2. Select a salt code or solvate from the dropdown enter the structure and name.
list. This list displays all of the salt codes and
solvates in your User Configuration folder. Working With Batch
Enterprise

3. Click OK to close the dialog Explorer


The formula you entered appears in the
stoichiometry grid. With the batch explorer, you can view a reaction
tree showing successors and predecessors of a
Adding New Solvates and Salts selected batch or compound.
To add a solvate or salt that does not appear in the
dropdown list: To view Batch Explorer in the reaction section:

Click the Batch Explorer tool icon in


the reaction section.
A menu appears:

The options are:

Create Chemistry Experiment As Next


Step In same Chemistry Notebook
creates a new page/experiment within the
same notebook. To do this, select the product

538 E-Notebook Features CambridgeSoft


E-Notebook Workflows
of the reaction and click the Create Chemistry Another dialogue appears which tells you that
Experiment As Next Step In Chemistry Notebook a link is set and asks you to navigate to the
link. Reaction section of the selected Notebook
collection.

Create step Link To Existing Chemistry


Experiment creates a link between two
existing E-Notebook reactions in
same/different notebooks such that the
product of one reaction is a reactant in the
other. Both the reaction sections should
Create Chemistry Experiment As Next
contain valid reactions. Hence a link is created
Step In Another Notebook creates a new between two pre-existing pages.
page/experiment in the same/different chem-
To do this,
istry notebook.
1. Click the Create Chemistry Experiment As Next
Step In link.
To do this:
A dialog appears, prompting you to select a
section that contains a Reaction.
1. Select the product of the reaction and click the
Create Chemistry Experiment As Next Step In
link.

A dialog appears, prompting you to select the


Notebook collection where you wish to create
the experiment.

2. Click Select.
Another dialogue appears which tells you that
a link is set and asks you to navigate to the
Chemistry Experiment of the selected Notebook
collection.
View Batch Explorer displays a reaction
tree showing successors and predecessors of a
selected batch or compound.
2. Click Select. To do this, select View Batch Explorer.

Chem & BioOffice 2006 /E-Notebook E-Notebook Features 539


E-Notebook Workflows
A dialogue appears, prompting you to select a 1. To view the panning window, right-click within
molecule to explore. Use the scroll buttons to a blank portion of the Batch Explorer window.
select a molecule and click OK. A menu appears:
Administrator

2. Select Panning.
A dialog appears which allows you to use the
panning feature to zoom in on a particular
portion of the reaction tree.

The Batch Explorer window appears, and you


can right-click the molecule to view the options
to display predecessors or successors or all
steps of the batch.

3. Select the portion of the reaction tree in the


panning dialog and zoom to see the selected
portion as:

Panning Experiments in Batch Explorer


You can use the panning feature to zoom in on a
particular portion of the reaction tree.
For panning an experiment:
Flipping Experiments in Batch Explorer
You can flip experiments vertically or horizontally
in the Batch Explorer window in E-Notebook.
To flip an experiment:

540 E-Notebook Features CambridgeSoft


E-Notebook Workflows
1. To view the flipping window, right-click within To save an experiment as Bitmap:
a blank portion of the Batch Explorer window.
A menu appears. 1. Right-click within the blank portion of the
Batch Explorer window and a menu appears:

2. Select Flip then Vertical or Horizontal.


A dialog appears which tells you that flipping
will change the way the entities are laid out and 2. Click Save As Bitmap... to open the following
asks you to continue. destination window and you can set the desti-
nation where you wish to save the Experiment
Link Diagram. Bitmap is the only format:

3. Click the Yes button to flip and the following


window with flipped reaction sequence
appears:

3. Click the Save button in the destination


window to save the Experiment Link Diagram
and dismiss the dialog.

Copying Experiments in Batch Explorer


Saving Experiments as Bitmap in Batch E-Notebook provides you with this feature to copy
Explorer your Experiment Links Diagram from the Batch
E-Notebook provides you with this feature to save Explorer window.
your Experiment Links Diagram from Batch
Explorer window as Bitmap files. To copy an experiment:

Chem & BioOffice 2006 /E-Notebook E-Notebook Features 541


E-Notebook Workflows
1. Right-click within a blank portion of the Batch 2. Select Print...
Explorer window to copy the experiment. A A Print Diagram dialog is displayed which
menu appears: allows you to make your selections:
Administrator

2. Click Copy to copy the Experiment Link


Diagram. 3. Click the Margins button to set the page
3. Paste the Experiment Link Diagram at your
margins.
desired location. 4. Click Preview button to see the Print Preview as
shown below:
Printing Experiments in Batch Explorer
You can print your Experiment Links Diagram
from the Batch Explorer window to maintain your
hardcopy archives.

To print an experiment:

1. Right-click within a blank portion of the Batch


Explorer window. 5. Click the Select Printer button to select the
printer.
A menu appears:

542 E-Notebook Features CambridgeSoft


E-Notebook Workflows
The Print Setup dialog box appears, and you 2. Click Select All to select the whole Experiment
can select the printer: Link Diagram, which looks like:

3. Perform the desired action on the selected


Experiment Link Diagram.
6. Make all your selections and click the Print
button. Working with Autotext
The whole Experiment Link Diagram or
portion of the reaction tree you selected is With the Autotext feature, you can add predefined
printed. fragments of text to a field. This allows you to
create the contents of a text field quickly. You may
also add text that is pulled from other fields, for
Selecting Experiments in Batch Explorer
example, reaction properties or values in the
E-Notebook provides you with this feature to select stoichiometry grid of a reaction section. As you
the whole Experiment Links Diagram at once in update the reaction drawing and the stoichiometry
Batch Explorer window and perform other grid, your changes are reflected in the AutoText.
functions.
The example below shows the Preparation field of
To select the whole experiment: the reaction section.
1. Right-click within a blank portion of the Batch
Explorer window to select the experiment. A
menu appears:

Inserting Reactants and Products with


AutoText
When you modify reactants and products in the
reaction drawing or stoichiometry grid, the
AutoText will be updated automatically.

Chem & BioOffice 2006 /E-Notebook E-Notebook Features 543


E-Notebook Workflows
Inserting Reactants and Products from the You may also use the reactants/products button to
Stoichiometry Grid populate the AutoText. To do this,

To insert a reactant or product from the stoichiom- 1. With your cursor in the text field at the point
etry grid, where you wish to insert the reactant or
Administrator

product, click the reactants/products button


1. Right-click within the text field. ,
A menu appears. A menu appears.

2. Select one of the options:

2. Select Insert, followed by the name of the reac- Insert Reactant... allows you to browse
tant or product. to a new reactant, and add it to the text and
stoichiometry grid.
The name and properties of the reactant or
Insert Product... allows you to browse to
product you selected are inserted. The text
a new product, and add it to the text and
appears in a different color, and will be updated
stoichiometry grid.
automatically if you change the name or
properties in the stoichiometry grid. Insert [Reactants] AutoText inserts
the text [Reactants], which you may then
right-click to select a reactant from the
stoichiometry grid, or to browse to a new
reactant.
Inserting New Reactants and Products
Insert [Products] AutoText inserts
To insert a new reactant or product that is not yet the text [Products], which you may then
present in the stoichiometry grid, right-click to select a product from the
stoichiometry grid, or to browse to a new
1. Right-click within the text field. product.
2. Select Insert New Reactant... or Insert New The text is updated automatically if you change
Product... from the menu that appears. the properties of the reactant or product.
A blank row is added to the reactants or
products table.
Adding Items from the AutoText Pane
You can populate the text field by selecting items
3. Add information about the reactant or product
from the AutoText pane. If you wish to add your
to the blank row.
own, custom AutoText to this pane, you can set up
The reactant or product is inserted into the your own AutoText definitions. See Creating New
stoichiometry grid, and into the text field. Autotext Definitions on page 546.

544 E-Notebook Features CambridgeSoft


E-Notebook Workflows
To add AutoText items to the text field: Organic was selected, and filled in
automatically:
1. Click the triangle button next to the word
AutoText in the upper left corner of the text
field.

The AutoText pane appears, listing the


available AutoText items. 4. You may right-click the colored text again to
modify your selection.
Certain items in the AutoText list may refer to other
data in the section. In the example below, double-
clicking Conditions in the AutoText pane
automatically fills the Reaction Conditions into the
text field. (The Reaction Conditions are shown in
the right side, below).

2. Double-click any of the items in the list to


insert the corresponding AutoText. (In this
example, Back extract was double-clicked).

Inserting Links with Autotext


From a text field, you can insert links to other
sections and collections in E-Notebook
To do this,

3. If words appear in different colored text 1. Click the Link button in the toolbar of
between brackets, this indicates that there are the text field.
multiple, possible values for the text. Right- A dialog appears, prompting you to select a
click the text within brackets to view a drop- collection or section for the target.
down list of the choices, and select one of the
values. In the example shown below, several
possible choices are listed for the layers.

Chem & BioOffice 2006 /E-Notebook E-Notebook Features 545


E-Notebook Workflows
2. Browse to the collection or section, and click The Insert AutoText dialog appears.
the OK button.
A dialog appears, prompting you to enter the
text that will appear with the link.
Administrator

3. Enter the text or accept the default text, and


click the OK button. 3. Select one of the AutoText items in the left
The link appears within the text field. frame. In this example, Products is selected.
4. Click OK .
The AutoText appears in the text field.

4. Double-click the link to browse to its target.


5. Right-click the AutoText to see the options
Alternatively, you may right-click within the text
associated with it, as shown in the example
field, and select Insert Link... from the menu that
below.
appears. Then follow the steps given above.

Inserting Custom Autotext


From a text field, you can insert custom AutoText. Creating New Autotext Definitions

To do this, Depending upon your system configuration, it may


be possible for you to set up your own AutoText
1. Right-click within the text field definitions for use in E-Notebook text fields. You
can then use these predefined fragments to add text
A menu appears. to the styled text field automatically.
1. Right-click the User Configuration point to
New, then select AutoText Definitions. (Or, select
an existing AutoText collection to modify, by
clicking the collection in the tree).
2. Enter a name for the new collection.
3. Enter the following information:
In the example below, AutoText has been set up so
that a user may automatically enter a sentence
regarding a machine type, and select from a list of
several machine types. Double-clicking Machine
2. Select Insert Custom AutoText... Type in the AutoText list for any styled text field

546 E-Notebook Features CambridgeSoft


E-Notebook Workflows
would cause the corresponding sentence to appear. properties in the Conditions property list, for
Then, the user would right-click [MACHINE TYPES] example, Conditions: (Pressure: 200 atm,
to select from the list of machine types. Temperature: 100 C).

The keyword CONDITIONS followed by a property


name, such as [CONDITIONS:Temperature], will
populate the styled text field with that specific
property for example, Temperature: 100 C.

Tables

As with Property Lists, the AutoText Item referring


to a Table should contain bracketed UPPERCASE
keywords. For example:

[REACTANTS1] is added dropwise to a 500 ml


round-bottom flask charged with [REACTANTS2]
in [SOLVENT].
TIP: The title of the keywords tab must match the field
[REACTANTS1], [REACTANTS2], and [SOLVENT]
descriptor exactly. In this case, MACHINE TYPES is the are replaced by the complete description of a
name of the keywords tab, and [MACHINE TYPES] compound from one of these tables. REACTANTS1
appears in the AutoText item. refers to a column in the table REACTANTS (or, if
the table is pivoted with properties appearing as
Autotext Based on Other Fields in the Section
columns, it refers to a row). REACTANTS is the name
of the table field.
You may also set up autotext that will fill in the
In this case, the number such as in
values from property lists and tables in a section. To
REACTANTS1 and REACTANTS2 is used to
do this, you use a field name as a keyword in an indicate that different compounds are to be used in
AutoText Item. The keywords and the field names the AutoText. In order to determine which reactant
must match exactly in order for the substitution to is to be used where more than one is present in the
take effect. reactants table, the user right-clicks the keyword
that appears within brackets. This displays a popup
Property Lists menu containing all of the possible values.

For the AutoText Item to populate the styled text The description that populates the styled text field
field with all of the properties in a property list, consists of the name (or text of the form Reactant
simply use the name of the property list as the 1 if the name is absent) followed by a list of the
keyword in the AutoText Item. For example, say properties of that compound.
there is a Conditions field, which is a property list To select individual properties, an AutoText Item
that contains reaction conditions. The AutoText can contain a keyword followed by a property
Item name, e.g., [REACTANTS:Amount] is replaced by the
Conditions: [CONDITIONS] will fill in all of the value from the Amount property for a reactant.

Chem & BioOffice 2006 /E-Notebook E-Notebook Features 547


E-Notebook Workflows
Section Names as Categories 1. Right-click a cell in the Solvents Table of the
If you add multiple sections to an AutoText reaction section.
Collection, the section names will appear as A menu appears.
categories in the autotext list. For example,
Administrator

Standard and My AutoText are two section names


that appear as categories below:

Working with Solvents in a


Reaction Section 2. Select Add Solvent After to add a solvent after
the selected item, or Add Solvent Before to add
In E-Notebook, you may populate the solvents in
a solvent before the selected item.
the reaction section from the solvents folder in
User Configuration Folder. These solvents are A dialog box appears. You are prompted to
named shortcuts for the commonly used solvents. browse for the solvent you wish to select.

To enter a solvent into the Solvents Table:

548 E-Notebook Features CambridgeSoft


E-Notebook Workflows
3. Browse to the solvents folder with the solvent To view the Inbox of a particular collection:
you wish to add. Select a solvent from the list.
This list displays all of the solvents in your User 1. Double-click the collection (or click the plus
Configuration folder. sign next to it) to expand it and view its
contents.
4. Click Add to close the dialog.
The collection expands to show the Inbox.
The formula you entered appears in the
solvents table.
If a solvent which you wish to add in the solvents
table is not listed in Solvents Folder in your User
Configuration Folder, then you can manually add
that in the table cell. To do this:

1. In the reaction section, right-click a cell in the


solvents table.
2. Select Add Solvent After or Add Solvent Before,
to add the solvent.
2. Click the Inbox to select it.
The Add Solvent dialog appears once again.
3. Checkmark the box Add Blank Solvent at the
The sections in the Inbox appear in the right
bottom of the dialog box. frame.

4. Click Add to close the dialog. 3. Click the Section menu to select one of the
sections to cut, copy, etc. as shown:

A blank row is added to the solvents table in the


reaction section where you can fill the solvent of
You can export the PDF document in the
your choice manually.
Inbox to a location outside the E-Notebook
Repeat the process for other cells in the table, if just as you would do in the Captured Image
necessary. sections.
4. Click Export PDF:
Enterprise Using the Inbox
The Inbox in E-Notebook allows the addition of
various types of documents as well as graphical data
into the E-Notebook system, typically output from
either instrument control applications or from
various scientific analysis software.

Chem & BioOffice 2006 /E-Notebook E-Notebook Features 549


Using the Inbox
Enterprise Working Offline 3. Alternatively, click Work Offline button in the
Login dialog box when you are logging into
E-Notebook makes it possible for you to work in E-Notebook to go directly to the Offline
offline mode. In offline mode, you are folder:
disconnected from the network. When you
Administrator

reconnect, you can upload the changes you made


offline to the central, E-Notebook database.
In some cases, the system will be configured to
prevent you from working offline if you are
connected to the network.

Working With the Offline Folder You can work in Offline just as you would
To work in offline mode: normally work when you are connected.
4. You can go online again by clicking Connect
1. Select the Collection or Page you wish to work
button in the upper right corner of the screen.
in and drag it to Offline folder.
A dialog appears prompting you to log into the
When a collection is available offline, all of the
E-Notebook.
data associated with that collection, as well as
the references associated that collection, are
copied to the offline database.
2. Click the Work Offline button in the upper right
corner of the screen. This takes you to the
offline mode in which the Users home collec-
tion contains only two collections, the User
5. Click Connect button
Configuration folder and the Offline Collec-
tion. The contents of only these two collec- The Synchronization Changes Dialog
tions are available offline. appears listing each collection that has changed
and each new collection added.

550 E-Notebook Features CambridgeSoft


Using the Inbox
6. Click the Synchronize button to update all the Creating an Offline Folder
changes that are stored offline in the online
If you do not yet have an offline folder, you can
content.
create one.To create a new, Offline collection:
7. Click the Show Details button.
1. In the Collection Tree, right-click your user
A dialog appears showing list of changes,
collection.
original contents and updated contents.
A menu appears.

a. Click OK to go back online and synchronize,


2. Point to New, then select Offline.
or...
A new Offline collection appears and you are
b. Click Discard Changes to remove the new
prompted to rename it.
collection or changes made in that
collection. A button, Work Offline appears in the upper right
corner of the screen. Clicking this button will
8. Click the Cancel button to cancel the login.
enable you to work in offline mode.
NOTE: Depending on your configuration, the Discard
Changes button may not always be available to you when NOTE: You should have to create the offline folder only
synchronizing the contents of a collection that has changed once. You can then continue to use the same folder.
offline.

Chem & BioOffice 2006 /E-Notebook E-Notebook Features 551


Using the Inbox
Administrator

552 E-Notebook Features CambridgeSoft


Using the Inbox
Chapter 29: Working with Data in
E-Notebook
E-Notebook enables you to work with many, Working with URL Displays
diverse types of data, then keep related data
together in collections such as Experiments and NOTE: Your system configuration determines what types of
Pages. data you can add to the sections in E-Notebook. To model
your workflow and ensure that E-Notebook accommodates
See the following topics for information about
the data types you frequently use, your system configuration
working with various types of data:
may include modified versions of these data types. Also,
Working with Chemical Structure Data certain data types may not appear in your configuration, and
Working with Images in Chemical Structure additional, custom data types may have been added.
Fields
Working with Database Tables Working with Chemical
Working with Captured Image Sections Structure Data
Working with Image Viewer Sections
Chemical structures can be drawn with the use of
Working with MS Excel Spreadsheets the ChemDraw Toolbar. The ChemDraw Toolbar
Working with MS Word Sections allows users to create a chemical structure by
Working with MS PowerPoint Slideshow connecting frequently used substructures together.
Sections For more information about using the ChemDraw
Toolbar, please see the ChemDraw User's Guide.
Working with Property Lists
Working with Spectrum and Spectra It is also possible to paste standard image files into
Sections chemical structure fields, then user the ChemDraw
toolbar for annotation, such as text and arrows.
Working with Styled Text
Text in the chemical structure fields is searchable.
Working with Ancillary Data Sections
Working with Subsections Drawing a Structure
Working with Table Sections To draw a chemical structure:

Chem & BioOffice 2006 /E-Notebook Working with Data in E-Notebook 553
1. Click within a chemical structure field. You can paste standard image files into chemical
The ChemDraw toolbar appears. structure fields, then use the ChemDraw toolbar for
annotation, such as text and arrows. Text in the
chemical structure fields is searchable.
Administrator

Inserting an Image a Structure


To insert an image into a chemical structure field:

1. Copy the image onto the clipboard. You may


do this by, for example, selecting the Select All
and Copy commands when the image file is
open in Microsoft Photo Editor.
2. Right-click within the structure field in
E-Notebook.
A menu appears.
3. Point to Edit, and click Paste.
2. Using the ChemDraw tools, draw a structure or The image appears in the chemical structure
reaction. field.

TIP: You can access a drawing menu by right-clicking in the 4. Use F7 to zoom in, and F8 to zoom out.
structure window. This menu allows you to, among other
things, copy and paste structures. Annotating the Image
To annotate the image:
Expanding the Drawing Window
1. Click the text tool in the ChemDraw
To expand the drawing window:
toolbar.
1. Double-click the frame of the chemical
2. Click in the chemical structure field, and type
structure field. any text you would like to enter.
The chemical structure field expands.
The text appears in the field.
2. Using the ChemDraw tools, draw the structure
or reaction. 3. Click the arrow tool in the tool bar to select it
if you would like to draw arrows to annotate
3. When you are finished editing, double-click the
the image.
frame of the chemical structure field to return
it to its original size in the form.
Working with Database
Working with Images in Tables
Chemical Structure Fields Database Tables are used to pull in data from an
Chemical Structure Fields can also be used to external database and display it in E-Notebook.
display and annotate standard image files. The data is for display only and cannot be edited.

554 Working with Data in E-Notebook CambridgeSoft


The table of contents is an example of a database Importing an MS Excel document
table.
To import an MS Excel document,
1. Click the import tool icon for the MS Excel
field.

In some configurations, database tables may be A menu appears when you click the icon.
filled in based on a value that you enter elsewhere in
a form. For example, the value you enter into a
particular property list field may be used to look up
and display related data, which will appear within
the database tables.

Working with MS Excel


2. Select Import MS Excel Spreadsheet.
Spreadsheets
A dialog box appears, and you are prompted to
You can use MS Excel spreadsheets to manage select the file.
Excel data in E-Notebook.
3. Select the file and click the Open button.
The spreadsheet appears in E-Notebook. The
section of the spreadsheet that was most
recently active is displayed.
To export the file:
1. Click the import tool icon:
To create a new MS Excel Section: A menu appears.
1. In the Collection Tree, click the Page or 2. Select Export MS Excel Spreadsheet
Experiment to which you would like to add the A dialog appears prompting you to select a
section. location for the exported file.
2. Click the New Section button.
3. Enter a destination for the file and a file name,
and click the Save button.
The file is exported to the location you
A list of the section types that can be added selected.
appears. To clear an MS Excel file from a section in
3. Select MS Excel Spreadsheet. E-Notebook:
A new MS Excel Spreadsheet appears in the
1. Click the import tool icon:
right frame.
4. Edit the spreadsheet just as you would A menu appears.
normally edit a spreadsheet in MS Excel. 2. Select Clear MS Excel Spreadsheet

Chem & BioOffice 2006 /E-Notebook Working with Data in E-Notebook 555
You are prompted to confirm whether you 1. Click the import tool icon for the PDF field.
wish to clear the document file. A menu appears when you click the icon.
3. Click OK. 2. Select Import PDF.
The file is cleared.
Administrator

Working with Captured


Image Sections
You can use Captured Image Sections to manage
both PDF files and standard image files in
E-Notebook in PDF format. A dialog box appears, and you are prompted to
select the file.
To create a new Captured Image Section:
3. Select the file and click the Open button.
1. In the Collection Tree, click the Page or The PDF document appears in E-Notebook.
Experiment to which you would like to add the
section. Enterprise To export the PDF file:
2. Click the New Section button.
1. Click the import tool icon.
A list of the section types that can be added
appears.
3. Select Captured Image.
The new section appears within the Page. The
image below is an example of a PDF Viewer A menu appears.
section.
2. Select Export PDF.
With this field you may import a PDF document or
A dialog appears prompting you to select a
a standard image file in PDF format.
location for the exported file.
3. Enter a name and destination for the file, and
click the Save button.
The file is exported to the location you
selected.
To clear a PDF file from a section in E-Notebook:
1. Click the import tool icon:
A menu appears.
2. Select Clear PDF.
You are prompted to confirm whether you
wish to clear the document file.
Importing and Exporting a PDF File 3. Click OK.
To import a PDF document: The PDF file is cleared.

556 Working with Data in E-Notebook CambridgeSoft


Importing an Image File 2. Select any of the editing tools present in the
menu to edit or add some text in the image.
You can import any GIF, JPG, JPEG, TIF, TIFF,
PNG or BMP image. Once imported, the image file For example, you can click the Note Tool button
gets converted to a PDF document and you may to add your comments. A dialog is displayed
edit or add text, as the Adobe Acrobat menu and within the image field where you can type your
editing tools are also present. comments as shown:
To import an image,
1. Click the import tool icon for the image field.
A dialog box appears, and you are prompted to
select the file.
2. Select the file and click the Open button.
The image in the form of a PDF document
appears in E-Notebook.

Annotating an Image File


In the Captured Image section the image is
converted to PDF upon import and you may edit or Similarly, you can use the other annotation
add text, as Adobe Acrobat menu with editing tools tools in the image field.
are also present.
To annotate, Working with Image Viewer
1. Go to the PDF converted imported image file. Sections
You can use MS PowerPoint Sections to manage
images in E-Notebook.

1. To create a new, Image Viewer Section:

2. In the Collection Tree, click the Page or Exper-


iment to which you would like to add the
section.

3. Click the New Section button:

The Adobe menu with Acrobat annotation


tools is present above the image in the
Captured Image section, as shown below:
A list of the section types that can be added
appears.

4. Select Image.

Chem & BioOffice 2006 /E-Notebook Working with Data in E-Notebook 557
A new Image section appears in the right To export the Image file:
frame. With this field, you can import images
such as GIF, JPG, JPEG, TIF, TIFF, PNG, 1. Click the import tool icon:
BMP, etc. and add text for explanation. A menu appears.
Administrator

2. Select Export Image.


A dialog appears prompting you to select a
location for the exported file.
3. Enter a file name and destination for the file,
and click the Save button.
The file is exported to the location you
selected.
To clear an Image file from a section in
E-Notebook:

1. Click the import tool icon:


A menu appears.
Importing and Exporting an Image File
2. Select Clear Image.
To import an Image File:
You are prompted to confirm whether you
1. Click the import tool icon for the Image field. wish to clear the document file.
3. Click OK.
The image is cleared.
Similarly, you can copy the images from the Image
A menu appears. sections and paste them in the other sections in
E-Notebook or in other applications.

Working with MS Word


Sections
You can use MS Word Sections to manage
information that you would normally record in MS
Word. This feature makes it possible for you to
keep MS Word information with related,
2. Select Import Image. E-Notebook information. You can edit this data
just as you would edit an MS Word document,
A dialog box appears, and you are prompted to either editing it within E-Notebook, or exporting it
select the file. to MS Word to take advantage of the full MS Word
3. Select the file and click the Open button. feature set.
The image appears in E-Notebook. To create a new MS Word Section:

558 Working with Data in E-Notebook CambridgeSoft


1. Click the collection in the collection tree to To create a new MS PowerPoint slideshows Section:
which you would like to add the MS Word
1. In the Collection Tree, click the Page or
Section.
Experiment to which you would like to add the
NOTE: In the preconfigured E-Notebook, you can section.
only add an MS Word Section to a Page). 2. Click the New Section button:
A list of the section types that can be added
2. Click the Sections icon on the right side of the
appears.
screen.
3. Select MS PowerPoint Slideshow.
A menu appears.
A new MS PowerPoint slideshow appears in
3. Select New.
the right frame.
A list of the Section types that can be added
4. Edit the slideshow just as you would normally
appears.
edit a slideshow in MS PowerPoint.
4. Select MS Word Document.
A new MS Word Document appears in the Importing and Exporting an MS Power-
right frame. Point slideshow
To import an MS PowerPoint document,
1. Click the import tool icon for the MS
PowerPoint field.
A menu appears.

2. Select Import Slideshow


NOTE: An MS Word Section is one of the preconfigured A dialog box appears, and you are prompted to
Sections of E-Notebook. Depending upon how your system select the file.
administrator has chosen to configure E-Notebook, this 3. Select the file and click Open.
Section may not be available to you, or it may be available in
a modified form. For example, an MS Word document may The slideshow appears in E-Notebook.
exist as one of multiple fields within a section. The notes associated with a slide will be rendered
along with the slide.

Working with MS Power- To export the MS PowerPoint file:


Point Slideshow Sections 1. Click the import tool icon.

You can use MS PowerPoint Sections to manage A menu appears.


MS PowerPoint slideshows in E-Notebook. 2. Select Export Slideshow

Chem & BioOffice 2006 /E-Notebook Working with Data in E-Notebook 559
A dialog appears prompting you to select a You are prompted to confirm whether you
location for the exported file. wish to clear the document file.
3. Enter a file name and a destination for the file, 3. Click OK.
and click Save. The slideshow is cleared.
Administrator

The file is exported to the location you


selected. Working with Property Lists
Property Lists are used in forms to record various
To clear an MS PowerPoint file from a section in
types of data properties. An example is shown
E-Notebook:
below:
1. Click the import tool icon:

A menu appears.
2. Select Clear.... Property lists may contain the following data types:

Data type Action to take

Date Click the date box, and select a date and time.

Text Enter text.

Number Enter a number. Certain properties may have default


units associated with them, which will appear when
you enter the number.

Enumerated Value Choose a value from the drop-down list.

560 Working with Data in E-Notebook CambridgeSoft


Adding Properties to Property Lists Removing Properties from a Property
To add a property to a property list: List
1. Right-click the within the property list in a To remove a property from a property list:
section.
A menu appears. 1. Right-click the property you wish to remove
from the Property List.

A menu appears.

2. Select Remove Property.

A message appears, asking you if you are sure


you want to remove the property.

3. Click Yes.
2. Select Add Property....
The Add Property dialog box appears, listing The property is removed from the Property
the properties you may add. List.

Setting and Editing Values in a Property


List
You can set and edit values for the properties in a
property list, such as the list shown below.

3. Click the property you wish to add. You may To set or edit the value of a property:
use CTRL+click to select multiple properties,
or SHIFT+click to select a range. 1. Click a cell in the property list.

4. Click Add. The values you can enter will depend upon the
The property or properties appear in the list. data type of the specific property.
You system configuration determines which
2. Enter an appropriate value.
properties may be added to the list, and which
properties appear by default.
Data Action to take
type

Date Click the date box, and select a


date and time.

Text Enter text.

Chem & BioOffice 2006 /E-Notebook Working with Data in E-Notebook 561
Validated Values you enter into property list
Data Action to take may be checked against an external database, to
type ensure that they are valid values. In this case, if
you enter an invalid value, you will receive an
Administrator

Number Enter a number. Certain prop- error message, and E-Notebook will not accept
erties may have default units the value.
associated with them, which
will appear when you enter the Enumerated from a database values
number.See Working with displayed in a dropdown list for any particular
Numerical Units in Property property may be pulled from an external data-
Lists on page 563 for more base.
information. When searching with the Property Query Field,
numeric values for properties are interpreted by
Enumer- Choose a value from the drop- evaluating the longest possible set of characters that
ated Value down list. are converted into a number, starting with the first
character. For example, a search for 37.5 will find
3. Click elsewhere in the section. 37.5g. A search for 2 will find 2 ATM/50. Also,
The value is displayed in the cell. conversion is performed to find equivalent values.
Depending upon your system configuration, certain For example, when searching over a volume
properties may have one or several of the following property for which mL are the default units, a
attributes: search for 50 mL will return both 0.05 L and 50 mL.

Read Only certain properties may be for


display only, and it may not be possible to edit Working with Enumerated Lists in Prop-
them. erty Lists
Required it may not be possible to delete a Property lists may contain enumerated lists, which
particular property from a property list. If a may have default values associated with them. Your
property is required, you will be presented with system configuration determines the enumerated
an error message when you attempt to delete it. values for any given property.
Not Blank it may be necessary to enter a
value for a particular property before you can A property in E-Notebook may be configured so
perform a transition on the collection. For that it will contain a list of enumerated values. You
example, an experiment collection may be set may then select one of the values from a dropdown
up such that it is necessary to enter an equip- list that appears in the property cell. This list of
ment ID before you can close the experiment. values displayed in a dropdown list for any
If this is the case, you will be prompted to enter particular property may be some values either
the values when you attempt to perform the manually entered or pulled from an external
transition. database by the administrator.

562 Working with Data in E-Notebook CambridgeSoft


For example, there may be a property of stored as grams. You may also enter any of the
Collection's Name under Metadata Properties permitted mass units shown below, such as mg or
in search mode. Once you select the checkbox, you kg.
may enter the values only from the dropdown list as
shown: Type of Permitted Units
Measurement

density g/ml
g/ml
mg/ml
g/l
mg/l
Similarly, you can select the values for other g/l
properties in the list from the dropdown lists after kg/l
clicking the checkboxes opposite them. kg/m3

Working with Numerical Units in Prop- length m


erty Lists
Property lists may contain numerical properties, nm
which may have default units associated with them. m
Your system configuration determines the default mm
units for any given property. The following types of cm
measurements may be specified or displayed in the
permitted units shown below. mass g
g
For example, there may be a property of mass mg
and its default units may be grams (g). If you enter kg
a numerical value into the property without
specifying units, the units will be displayed and
molality (quantity per mass mol/kg
of solvent or substrate) mol/g
mmol/kg
mmol/g
mol/kg
mol/g

molar mass g/mol


kg/mol
dalton
D
kD

Chem & BioOffice 2006 /E-Notebook Working with Data in E-Notebook 563
Type of Permitted Units Type of Permitted Units
Measurement Measurement
Administrator

molarity (quantity per mol/l volume ml


volume of solution) molar l
mmolar l
molar m3

moles (quantity of mmol When you are in Search mode, the property query
substance) mol field allows you to find all equivalent values entered
mol in various units that share the same unit type. For
example, a search for a volume of 500 mL will
return both 500 mL and 0.5L. The search will
normality (ion equivalents N assume the default units for the property if you do
per volume of solution) mN not enter units. Using the same example, if mL were
N the default unit for a volume property, and a search
were conducted for a property value of 0.5, no hits
pressure atm would be returned. A search for 0.5 L would return
Pa both 500 mL and 0.5 L.
kPa
torr Creating a Reference within a Property
bar
List
mbar
Within a property list, you can add a link to another
temperature C collection/section in E-Notebook or a link to an
K external URL. This makes it easy to browse back
F and forth between related data.

time s Adding a Link from a Property List to an


ms E-Notebook Collection
s
min To add a link from a property list cell to a collection
hr in E-Notebook,

1. In the Collection Tree, click the collection


velocity m/s containing the property list, then select the
km/hr section containing the property list.
mi/hr
The section containing the property list
appears.
2. Click the cell of the property list to which you
wish to add the reference.

564 Working with Data in E-Notebook CambridgeSoft


3. In the Collection Tree, click the collection you 4. Right-click within a property list cell and select
would like to reference and, holding the mouse Paste Reference from the menu that appears.
button down, drag the collection into the
The reference is added to the property list cell,
upper-left corner of the property list cell, until
and a small arrow appears in the upper-left
the cursor displays a small arrow, as shown
corner of the cell. Clicking the arrow will
.
display the section you have referenced.
4. Release the mouse.
The reference is created, and a small arrow
appears in the upper-left corner of the property
list cell. Adding a Link from a Property List to an External
URL

5. You can click the arrow in the property list cell To add a link from a Property List cell to an external
to navigate to the collection you have refer- URL or an intranet URL,
enced, and click the Back arrow to
1. Right-click within the property list cell to
return to the property list.
which you wish to add the reference.
Alternatively, you may right-click the collection you
wish to reference and select Copy. Then, right-click A menu appears.
within the property list to which you are adding the 2. Select Edit Reference.
reference, and select Paste Reference.
The Edit Reference dialog appears.
Adding a Link from a Property List to an
E-Notebook Section 3. Enter the URL and click OK.

To add a link from a property list cell to a section in


E-Notebook:
1. In the Collection Tree, click the collection
containing section that you would like to
reference, then select the section.
The section to which you would like to make a
reference appears.
2. Right-click the Section menu icon, and select
Copy Section.
3. In the Collection Tree, click the collection The reference is added to the property list cell,
containing the property list to which you are and a small arrow appears in the upper-left
adding the reference, then click the section that corner of the cell. Clicking the arrow will
contains the property list. display the URL you have referenced.

Chem & BioOffice 2006 /E-Notebook Working with Data in E-Notebook 565
Working with Spectrum and The new section appears within the Page. The
image below is an example of a spectrum
Spectra Sections section.
You can manage your spectra data easily and
Administrator

effectively using Spectrum and Spectra sections.


This topic refers to sections that contain Galactics
GRAMS32 software tools.

NOTE: Spectra may be handled differently in your specific


configuration of E-Notebook.

To create a new Spectra section for multiple spectra:


1. In the Collection Tree, click the Page or
Experiment to which you wish to add the
Spectra section.
2. Click the New Section button.
A list of the section types that can be added
There are two types of sections for spectra. Each appears.
type of section can also contain a set of properties
3. Select Spectra.
for each spectrum, and notes about each spectrum.
The new section appears within the Page. You
Spectrum Section this section can contain a
may add as many spectrum subsections as you
single spectrum.
wish (by clicking the New Spectrum button).
Spectra Section this section can contain The image below shows a spectra section with
multiple spectra, organized in subsections or two spectrum subsections.
sub-tabs.
To create a new Spectrum section for a single spec-
trum:
1. In the Collection tree, click the Page or
Experiment to which you wish to add the
Spectrum section.
2. Click the New Section button.
A menu appears, listing the types of sections
that you may add.
3. Select Spectrum.

566 Working with Data in E-Notebook CambridgeSoft


Adding a Spectrum To replace a spectrum image by copying and past-
ing another image:
To add a spectrum:
1. From within the section containing the image
you wish to copy, click the spectrum
1. From within a section with a spectrum field,
button:
click the import/export button:
A menu is displayed.
A menu appears.
2. Select Copy Spectrum.
3. Browse to the section containing the spectrum
image you wish to replace.
4. Click the spectrum button.
5. Select Paste Section.
2. Select Import Spectrum.
The new spectrum image is replaces the image
The Import Spectrum dialog box appears and in the section.
you are prompted to select a spectrum image
file. Zooming in on a Spectrum Peak
To zoom in on a spectrum peak:

1. Click the spectrum image and drag your mouse


to draw a box around the area you wish to
zoom.
2. Click within the box.
The zoomed view appears.
3. To zoom out again, simply right-click in the
spectrum image.

Other Fields in a Spectrum Section


3. Select a spectrum and click Open. Spectrum Properties List use this list to
The Import Spectrum dialog box closes and store Analyst, Type, and Date.
spectrum image appears in the section.

Replacing a Spectrum
Notes Record any notes that pertain to a
If you would like another spectrum image to take Spectrum in the text field.
the place of an image within a spectra or spectrum
section, you can replace the image. To do this, you
may either import a new image, as described above.
The new image will replace the old. Or, you may
copy an image from another section.

Chem & BioOffice 2006 /E-Notebook Working with Data in E-Notebook 567
Working with Styled Text You can also type the text, highlight it, then select
the text options you wish to apply to it. Standard
Styled text boxes can be used to record notes, editing keys such as Control+C (for copy) and
preparation information, etc. A styled text box is Control+V (for paste) may be used as well.
Administrator

often included in a form with other types of data,


making it possible to combine text notes with Note that in your system configuration, the styled
related data. Certain styled text fields in your text box may not include the formatting toolbar. In
configuration may have Autotext associated with addition, a styled text box may be read-only,
them. You can use the Autotext feature to populate meaning that you can view but not edit its contents.
the styled text field automatically. See Working A styled text box may also be required: it may be
with Autotext on page 543 for more information. necessary for you to enter text into the box before
you can perform a transition on a particular
To format the text: collection. For example, it may be necessary for you
to enter text into a text field before you can close a
1. From within a section, click within the styled
Page or Experiment.
text box.
A cursor appears in the box, and you can begin Working with Subsections
typing.
In E-Notebook, certain sections may be set up to
Immediately above the box, there may be a contain other sections, known as subsections. The
toolbar for formatting the text. subsections appear as subtabs within a section.
To add a subsection to a section, for example to a
Spectra section:
1. Click the New Spectrum button.
A new spectrum in the form of a subsection
appears within the Spectra section.

You may change the following formatting options:

Font type
Font size
Bolded Text
Italicized Text
Superscript
Subscript NOTE: The options for a subsection button under the
section will differ according to your configuration.
Left-alignment
You can manage a subsection just as you would a
Center-alignment
section. See Working with Sections on page 583
Right-alignment for more information.

568 Working with Data in E-Notebook CambridgeSoft


Working with Subsections in Button To create a new Ancillary Data section:
View 1. In the Collection Tree, click the Page or
Experiment to which you would like to add the
You can manage subsections as you would sections.
Ancillary Data Section.
Your system administrator may configure
2. Click the New Section button in the right
E-Notebook such that the subsections are forced
frame:
into button view and VCR style buttons are
A list of the section types that can be added
displayed to navigate the sections in a subsection, as
appears.
shown below.
3. Select Ancillary Data.
A new Ancillary Data section appears in the
right frame.
You may then scroll through the subsections using 4. Click the import tool to import a file:
the arrow buttons, or right-click a subsection name 5. A menu appears.
and select Go To in order to browse to a specific 6. Select Import....
subsection. A dialog box appears, and you are prompted to
select the file.
Working with Ancillary Data 7. Select the file and click Open.
Sections The type of file and its size are displayed in
E-Notebook.
You can use an Ancillary Data section to associate To edit a stored document file, you must first export
a file which is not supported by E-Notebook with it to another location.
an E-Notebook page or experiment. When you
1. Click the import tool.
import the file, the checksum, source path, source
file name, and your user name are populated A menu appears.
automatically.

Although the file cannot be viewed from within


E-Notebook, it can be exported to a selected
2. Select Export....
location, then opened, viewed, or edited from there.
A dialog appears prompting you to select a
location for the exported file.
3. Enter a destination for the file and a file name,
and click Save.
4. Open the appropriate application, and open
the file you created.
5. Edit the file just as you normally would.
6. Save the file.

Chem & BioOffice 2006 /E-Notebook Working with Data in E-Notebook 569
7. From the section in E-Notebook, click the To add a column:
import tool again.
1. Browse to the section that contains the table.
A menu appears.
2. Right-click the table at the location where you
Administrator

8. Select Import....
would like to add the column.
A dialog appears and you are prompted to
select the file to import. A menu appears.

9. Select the file and click Open.

The edited document with your changes is


stored in E-Notebook.

To clear a stored document file from a section in


E-Notebook:

1. Click the section tools icon.

A menu appears.

2. Select Clear Stored Doc. 3. Select Add Property Before, to add a property
before the current property, or Add Property
3. You are prompted to confirm whether you
wish to clear the document file. After, to add a property after the current prop-
erty.

A dialog box appears with a list of the


properties you may add.

Click OK. The file is cleared.

Working with Table Sections


You can use Table sections to organize the chemical
properties of compounds that interest you. You can
add properties to a Table, pivot a Table, resize
columns and rows, and organize columns and rows. 4. Highlight the property you wish to add to the
You can also insert links to other E-Notebook table.
sections or collections into a table.
5. Click Add.
Adding Columns and Rows to a Table
The property appears as a column in the table,
You can add columns and rows to a table in immediately in front of the location you
E-Notebook. selected.

570 Working with Data in E-Notebook CambridgeSoft


To add a row: To remove a column:
1. Right-click the table at the location where you 1. Right-click the column or property you wish to
would like to add the row. remove from the table.
A menu appears.
A menu appears.

2. Select Add Row Before, to add a row before the


current row, or Add Row After, to add a row
after the current row.
2. Select Remove Property.
NOTE: If the Table has been pivoted, you would select A dialog box appears, asking you if you are sure
Add Property to add a row, and Add Column to add you want to delete the property from the table.
a column. (Pivoting transposes the rows and columns in
the table). 3. Click Yes.

The column is removed from the table.


Removing Columns and Rows from a
Table NOTE: If the table has been pivoted, right-click a row to
You can remove columns and rows from a table. remove a property.

To remove a row:

1. Right-click the row you wish to remove from


the table.
A menu appears.
2. Select Remove Row.

A dialog box appears, asking you if you are sure


you want to delete the row from the Table.
3. Click Yes.

The row is removed from the Table.

Chem & BioOffice 2006 /E-Notebook Working with Data in E-Notebook 571
Organizing Columns and Rows in a Move a Row
Table To move a row up or down:
You can easily rearrange rows and columns in a
table, organizing them so that the information is 1. In the table, right-click the row you wish to
Administrator

displayed more effectively. You can move columns move.


left or right, move rows up or down, and sort data A menu appears.
in the table in ascending or descending order.
Move a column
To move a column left or right:
1. In the table, right-click the column you wish to
move.
A menu appears.

2. Select Move Row Up or Move Row Down.


The row is moved either up one place or down
one place in the table, depending upon your
selection.
Sort Data by a Property

To sort the table by a particular property:


2. Select Move Property Left or Move Property
1. Right-click the row or column corresponding
Right.
to the property by which you wish to sort the
The column is moved either one place to the table.
left or one place to the right, depending upon A menu appears.
your selection.

572 Working with Data in E-Notebook CambridgeSoft


2. Select either Sort Ascending or Sort Figure 29-2After
Descending.
The data in the table is sorted according
to the values of the property you
selected.
Adding Information to a Table Cell
Resizing Columns and Rows in a Table
You can easily resize rows and columns in a table, There are a number of ways to add information to
so that the information is displayed more a table cell. Data may be text, numbers, dates, or
effectively. structures. Your system configuration determines
what type of data it is possible to add to any
To resize a row or column:
particular cell.
1. Move the cursor to the border of the row or
column in a table. There are three ways to add information to a cell:
A double-headed arrow appears. Choose a value from the dropdown menu that
2. Drag the border in the direction you desire appears in the cell. You will use this option
until the column or row is the correct size. when the cell has a list of possible values asso-
The resized column or row appears in the table. ciated with it.
To autofit a column or row to the size of its Enter a value using the keyboard.
contents, move your cursor to the name of the row
or column and double-click. The column or row Draw a Chemical Structure -- See Working
resizes. with Structures and Images in Tables on page
573 for more information.
Pivoting a Table
You can transpose the columns and rows of a table In some cases, your system administrator may have
to alter the way the information is displayed. configured E-Notebook such that a particular
property in the table has one or more qualities, such
To pivot a table: as Read Only. See Setting and Editing Values in a
1. Right-click the table. Property List on page 561 for details on qualities.
A menu appears. Certain numerical properties in a table may have
2. Select Pivot Table. units associated with them.
The rows and columns of the table are
transposed. Working with Structures and Images in
Figure 29-1Before Tables
Tables may contain chemical structure fields, which
you can use to manage data about the structures of
compounds that interest you. You can also add
standard image files to the chemical structure fields.

Chem & BioOffice 2006 /E-Notebook Working with Data in E-Notebook 573
To add a structure or image to a table: Editing a Structure or Image
1. Double-click a table cell corresponding to a To edit a structure or image in a table:
structure or image.
1. Double-click the table cell containing the
The Edit Structure dialog box appears, and
Administrator

you can use the ChemDraw tools to draw the structure or image.
structure. Or, you may copy a standard image The Edit Structure dialog box appears, and
file into the field. you can use the ChemDraw tools to edit the
structure, or you may copy an image file into
the field.

2. Draw the structure or paste in the image and


click OK. Copy in an image by right-clicking
within the field and selecting Edit, then Paste.
The structure or image appears in the table. 2. Edit the structure or change the image and
click OK.
The modified structure or image appears in the
table.

Delete a Structure

To delete a structure or image from a table:

1. Double-click the cell of the structure or image


you wish to delete.
The Edit Structure dialog box appears.
2. Using the ChemDraw tools, select the entire
structure or image and delete it.
3. Click OK.
The dialog box closes and the structure or
image is deleted from the table.

574 Working with Data in E-Notebook CambridgeSoft


Changing Information in a Table Cell Creating a Reference within a Table
Cell
The data type of a cell determines what type of
information you add to a cell. For example, you can Within a table cell, you can add a link to another
only draw a chemical structure in a cell with a data collection/section in E-Notebook or a link to an
type of structure. external URL. This makes it easy to browse back
and forth between related data.
Depending upon the data type, you can edit the
information in a cell one of the following ways: Adding a Link from a Table to an E-Notebook
Collection
Choose another value from the menu that
To add a link from a table cell to a collection in
appears in the cell use this option when the
E-Notebook,
cell has enumerated values associated with it.
1. In the Collection Tree, click the collection
Enter a value with the keyboard.
containing the table, then select the section
Edit a Chemical Structure or change and image containing the table.
See Working with Structures and Images in The section containing the table.
Tables on page 573 for more information.
2. Click the table cell to which you wish to add the
Certain numerical properties in a table may have reference.
units associated with them. 3. In the Collection Tree, click the collection you
would like to reference and, holding the mouse
Working with Numerical Units in Tables button down, drag the collection into the
upper-left corner of the table cell, until the
Tables may contain numerical properties, which cursor displays a small arrow, as shown .
may have default units associated with them. Your
4. Release the mouse.
system configuration determines the default units
for any given property in a table. See Working with 5. The reference is created, and a small arrow
Numerical Units in Property Lists on page 563 for appears in the upper-left corner of the table
the table of default values. cell.

When you are in Search mode, the table query field


allows you to find all equivalent values entered in
various units that share the same unit type. For
example, a search for a volume of 500 mL will
return both 500 mL and 0.5L. The search will 6. You can click the arrow in the table cell to navi-
assume the default units for the property if you do gate to the collection you have referenced, and
not enter units. Using the same example, if mL were click the Back arrow to return to the table.
the default unit for a volume property, and a search Alternatively, you may right-click the collection you
were conducted for a property value of 0.5, no hits wish to reference and select Copy. Then, right-click
would be returned. A search for 0.5 L would return within the table cell to which you are adding the
both 500 mL and 0.5 L. reference, and select Paste Reference.

Chem & BioOffice 2006 /E-Notebook Working with Data in E-Notebook 575
Adding a Link from a Table to an E-Notebook In the example below, you are prevented from
Section adding or editing a reference to the Ancillary Data
in a collection that is in the Closed state.
To add a link from a table cell to a section in
E-Notebook:
Administrator

1. In the Collection Tree, click the collection


containing section that you would like to
reference, then select the section.
The section to which you would like to make a
reference appears.
2. Right-click the Section menu icon, and select
Copy Section.
3. In the Collection Tree, click the collection
containing the table to which you are adding
the reference, then click the section that Similarly, you may be prevented from adding
contains the table. references to several different collection types
4. Right-click within a table cell and select Paste and/or several different states of a collection type
Reference from the menu that appears. depending on your system configuration.
The reference is added to the table cell, and a
small arrow appears in the upper-left corner of Validation of Values in Tables
the cell. Clicking the arrow will display the Values you enter into a table may be checked against
section you have referenced. an external database to ensure that they are valid
values. In this case, if you enter an invalid value, you
will receive an error message, and E-Notebook will
not accept the value.

Actually, your system administrator may have


Blocking of References in Tables configured E-Notebook such that the valid and
You cannot always add links to the tables in the invalid values for a particular property in the table
E-Notebook. You may be blocked from adding a are defined and have several qualities. Therefore,
reference to a specific type of collection that is in a when you attempt to enter a value for the property
particular state. If E-Notebook is configured to that does not match the defined value, you will be
block the reference, you will be unable to add the presented with an error message to that effect. For
reference to the table. For example, you can not add example, you cannot add text into a field in a table
table references to pages/experiments that are in an which is meant for numerical values or structures or
archived state. dates.

576 Working with Data in E-Notebook CambridgeSoft


For example, in a Reaction section, the Reaction Rendering in E-Note-
Molarity property cell in a Reaction Conditions table
can only contain numerical values. If you try to book
enter text, you will see the following error message: E-Notebook provides a number of options for
rendering the contents of your experiments and
other types of collections. You can export to a PDF
file or to an MS Word file.
E-Notebook also offers an E-Signatures feature for
electronically signing your experiments.

Working with URL Displays See the following topics for more information:

URL Displays are used to store URLs within Enterprise Exporting to PDF
E-Notebook and to display their corresponding
content. A URL may be for either an internal, Exporting a Collection to MS Word
intranet site or an external webpage. Exporting a Section to MS Word
To enter a URL and display its corresponding page: Printing Collections
Printing Sections
1. Enter the URL address as shown above. In this
example, http://www.cambridgesoft.com was Enterprise E-Signatures
entered.
Exporting
You can export Sections to MS Word, or
Collections containing the sections to PDF or MS
Word, then manage them as you would PDF or MS
Word documents. Rendering to PDF expands the
Standard page size so that the page is sized to set
2. Click the Go button to the right of the address. the contents of the section.
The page corresponding to the URL appears. To export a section:
You may navigate from within the displayed
page, if desired. 1. In the Collection Tree, click the collection
containing the section(s) you wish to export to
TIP: The URL does not change to reflect your MS Word.
navigation. If you wish to change the URL that is saved The sections appear in the right frame.
with the section, you must type in another address.
2. Click the Section Menu icon.

Chem & BioOffice 2006 /E-Notebook Working with Data in E-Notebook 577
Rendering in E-Notebook
The section menu appears. Sections from X to Y to export a range of
Sections, where X and Y are values you specify.
Current Section to export only the current
Section.
Administrator

6. Click the checkbox Open Document After Export


if you would like the PDF document to be
opened immediately after the export is
complete.
7. Click the Export button.

To export a collection:

1. In the collection tree, right-click the item you


wish to export.
3. Select Export to MS Word. A menu appears.
You are prompted to choose a destination
folder and file name.

4. Choose a folder and file name and click Save.

You are prompted to choose an export range.

5. Select an export range. The options are:

All Sections to export all of the Sections. 2. Select Export to MS Word or Export to PDF.

578 Working with Data in E-Notebook CambridgeSoft


Rendering in E-Notebook
You are prompted to choose a destination 2. Select Print.
folder and file name. The Print dialog box appears, and you are
prompted to enter the information you
normally do when printing, such as page
printer and number of copies, etc.

3. Continue with step 5 in exporting a Section,


above.
If you chose to open the document after export, the
document is opened, and it displays the Sections
you selected for export. If you chose not to open
the document, the document is saved in the folder
3. Select the printer options
you specified.
4. Select the Page Range:
Printing All prints all of the sections in the collection.
You can print Sections or Collections from Selection prints only the selected section.
E-Notebook to maintain your hardcopy archives. Pages allows you to specify a range of
To print a collection: sections to print. For example 1-5 would
print the first, five sections in the collection.
1. From the Collection Tree, right-click the 5. Make your selections and click Print.
collection.
The collection or the portion of it you selected is
The Collection menu appears. printed.
To print a section:
1. In the right frame, select the section you wish
to print.
2. Click the Section Menu icon.

Chem & BioOffice 2006 /E-Notebook Working with Data in E-Notebook 579
Rendering in E-Notebook
The Section menu appears. parties have signed the experiment rendition, it is
stored in a separate database for protection of your
intellectual property.
Administrator

Signing and Closing


When you have completed your experiment, you
can electronically sign it:
1. In the Collection Tree, right-click the
experiment you wish to sign and close.
A menu appears.

3. Continue with step 2 of printing collections,


above.
Note that your system configuration contains
templates that determine exactly how the printed
page appears.
If Visual Display of Changes is enabled, the print
will include the following:
The data as is exists in the current version.
The version history, including the date and the
author for each version after the baseline
version. (The baseline version is the version
that existed when visual display of changes
began).
A list of changes grouped by field.
In some configurations, there is a Final Print
2. Click Sign and Close.
transition that automatically creates a complete
printout of the collection. A dialog appears which asks you to confirm
Sign and Close.
Enterprise E-Signatures
With E-Signatures, you can electronically sign a
PDF version of your completed experiment. This
experiment rendition is then routed to co-authors
(where applicable) and witnesses. Once all required 3. Click Yes.

580 Working with Data in E-Notebook CambridgeSoft


Rendering in E-Notebook
A dialog appears which contains a list of users You can view the record of your submitted
who can be potential witnesses and you are documents in the Display Document List Field at the
prompted to select a witness. bottom of your Home Page.

The field displays two lists:


the first is a list of documents sent to you by
some other author waiting for your action;
the second is a list of documents submitted by
you that are still going through the signature
process.
4. Select witness(es) and click OK.
The experiment is now rendered to PDF and Reviewing a Document
the experiment in PDF format appears which You can review the documents you have submitted
is now ready to submit. for electronic signature through your user home
page:
1. In the Collection Tree, select your user
collection.
Your home page appears in the right frame.
You can view the record of your submitted
documents in the Display Document List Field at
the bottom of your Home Page.
2. To review a submitted document, right-click
the document submitted by you from the
second list and click Review...
5. Scroll through the entire rendition, enter your
userID and password in the appropriate text The PDF rendition is displayed.
boxes, and click Sign and Store. 3. To make a change in a submitted document:
Upon Sign and Store, the chosen witness is Click Modify Submission to modify and
given read permission to the experiment so resubmit your rendition.
that s(he) can countersign it.
Click Cancel Submission to cancel your
submission. Once a submission has been
cancelled, there is no way to resubmit it.

Countersigning a Document
To countersign a document that has been submitted
to you:

Chem & BioOffice 2006 /E-Notebook Working with Data in E-Notebook 581
Rendering in E-Notebook
1. In the Collection Tree, select your user The PDF rendition that was submitted to you
collection. is displayed.
Your home page appears in the right frame. 3. Click the Countersign button to verify your
You can view the record of documents approval.
Administrator

awaiting your signature in the Display Document The document is countersigned and closed,
List Field at the bottom of your Home Page. or...
2. Right-click the document you wish to sign, and
Click Reject to deny your approval.
click Countersign...
The rejected submission can be reviewed by the
primary author and either resubmitted or cancelled.
The rejected submission is highlighted in the list to
distinguish it from the other entries in the list.

582 Working with Data in E-Notebook CambridgeSoft


Rendering in E-Notebook
Chapter 30: Working with Sections
and Collections
Working with Sections 3. Select the type of section you wish to create.

A section is a form for E-Notebook data. Just as A new section of that type appears.
you would use pages in a paper notebook for
recording various types of data, you can use Your system configuration determines which types
sections in E-Notebook for recording reactions, of sections can be added to which types of
spectra, and other types of information. Sections collections. These rules are very flexible, and they
are often associated with Experiments or Page make it possible to tailor the E-Notebook
collections. For example, an Experiment may application to your workflow.
contain sections for reactions, notes, etc.
You can also use templates to set up sections Changing a Section
automatically and uniformly. See Working with
Templates on page 520 for more information. To modify a section within a collection:
Your system configuration determines the types of
sections that are available in E-Notebook. 1. Go to the section you wish to change.

Creating a Section 2. Edit the data in the section. See the other
portions of the User Guide for information
You can create a new section within a collection. specific information about how to edit
To create a section: different types of data in E-Notebook.

1. In the Collection Tree, click the collection to It is only possible for one E-Notebook user to edit
wish you wish to add the section. the sections in an individual collection at any given
If the collection already contains sections, they time. If another user is editing a particular
appear in the right frame. collection and you attempt to edit it, you will be
2. Click the icon in the right frame. presented with a message informing you that the
A menu appears, listing the types of sections collection is locked for editing by the other user.
that you may add.
In some cases, you will only have Read permission
for a collection, meaning that you may view the
collection but not edit it.

See Changes and Audit Trail on page 601 for


more information about saving your changes.

Chem & BioOffice 2006 /E-Notebook Working with Sections and Collections 583
Working with Sections
Removing a Section A menu appears.

To remove a section from a collection:


1. Go to the section you wish to remove.
Administrator

2. With the section displayed, click the


section menu icon.
The Section menu appears.

3. Select Move Up to move the section the left a


single position, or select Move Down to move
the section to the right a single position.
The section is moved in the way you selected.
4. Repeat the process until the section is in the
desired location.
3. Select Delete Section.
Renaming a Section
A message appears, prompting you to confirm
that you wish to remove the section. To rename a section:
4. Click Yes.
1. Go to the section you wish to rename.
The Section is deleted.
2. Click the section menu icon.
NOTE: Your system configuration may prevent you from The Section menu appears.
deleting certain sections. For example, if you are working
3. Select Rename Section.
with a collection that has Visual Display of Changes
enabled, it will not be possible for you to delete a section. A dialog box appears, and you are prompted to
Also, in some cases, it may be possible to delete the sections type in a new name for the section.
only if no data has been added to them.

Moving a Section within a


Collection
4. Type in a new name and click the Rename
You can move a section within a collection. This
button.
allows you to organize sections in the most effective
way. The dialog box closes and the new name of the
section appears.
To move a section:
1. Go to the section you wish to move. TIP: Your system configuration may prevent you from
renaming certain sections.
2. Click the section menu icon.

584 Working with Sections and Collections CambridgeSoft


Working with Sections
Duplicating a Section within 3. Select Copy Section.

a Collection 4. In the Collection Tree, click the collection in


which you would like the copied section to
To duplicate a section within a collection: appear.
5. Click the section menu icon.
1. Go to the section you wish to duplicate.
2. Click the section menu icon. The Section menu appears.
6. Select Paste Section.
The Section menu appears.
A copy of the section appears in the right
frame.

TIP: Note that in some cases, your system configuration


may prevent you from copying the section into a collection.

Exporting Sections to MS
Word
3. Select Duplicate Section. You can export sections to MS Word, then manage
A copy of the section appears. them as you would other MS Word documents. See
Exporting on page 577 for details.
TIP: Note that in some cases, you system configuration may
prevent you from duplicating a particular section within a Printing Sections
collection.
You can print sections from E-Notebook. See
Printing on page 579 for details.
Duplicating a Section
between Collections Working with Collections
All of the information in E-Notebook is organized
To copy a section from one collection to another: into collections, which are the items displayed in the
1. Go to the section you wish to duplicate. Collection Tree. Collections may be notebooks,
folders, experiments, pages, etc. E-Notebook
2. Click the section menu icon. allows you to browse through collections and to
The Section menu appears. search them for important information.
It is possible to manage collections in a number of
ways, as discussed in the following topics:
Creating a Collection
Browsing the Collection Tree (in Ch. 3).
Organizing Collections
Working with Templates
Viewing Collection Properties

Chem & BioOffice 2006 /E-Notebook Working with Sections and Collections 585
Working with Collections
Changing Collection Security Properties For example, if a Notebook collection contains
Performing a Collection Transition experiments, and the notebook is named Chemistry
Notebook-01, the experiments within the
Exporting a Collection or Section to MS
collection will be automatically numbered (for
Word
Administrator

example, Chemistry Notebook-01-001) as shown:


Printing Collections
Your system configuration determines the types of
collections that you can create within E-Notebook
and the rules that define their contents. The
permission to view, edit, and create collections can
be set up on a per-collection basis. These rules are
configurable in E-Notebook.

Behaviors of Collections in
E-Notebook
In E-Notebook, there are diverse behaviors
associated with Collectionssuch as the creating, When renaming a collection whose name was
hiding, renaming, duplicating, and moving generated according to the auto-numbering, the
behaviors. Your system configuration determines collection will check to ensure that the name fits
the rules to define the traits reflected by a within the parameters described by your system
collection. Therefore, depending on your system administrator for the auto-numbering. For example,
configuration, there may be some additional when you rename a Notebook, the names of the
behaviors that these collections can show. Pages or Experiments within it will change to match
the name of the Notebook. The name must begin
Auto-Numbered Collections with the name of the parent collection followed by
The collections in E-Notebook may be configured a dash and a serial number.
to automatically number the collections contained
within a specific collection. Your system
Collections that Cannot be Deleted
configuration determines the parameters for auto-
numbering the collections. In E-Notebook, you may be prevented from
If the E-Notebook is configured to auto- deleting the specific collections. Actually, your
numbering of the collections, then the newly system administrator may configure some specific
created collections will be automatically named by collections so as to prevent you from deleting them
appending a serial number to the name of the once they have been created. Therefore, the Delete
collection that contains the newly created command in the Collection menu of such
collection. collections will be grayed out.

586 Working with Sections and Collections CambridgeSoft


Working with Collections
For example, if the Notebook collection has been Collections that Cannot be Renamed
configured to avoid deleting, then clicking on it will
In E-Notebook, you may be prevented from
show the menu with inactive Delete option as
renaming specific collections, for example, a
shown: collection whose name is generated by the auto-
numbering feature. If you attempt to rename an
auto-numbered collection, an error message to that
effect appears as shown:

Your system configuration determines which types


of collections cannot be renamed.

Copying Collections that Contain Refer-


ences
It is possible to copy collections that contain
references in the collection tree in the same way as
you would copy normal collections without
Your system configuration determines which types references. The copied collection contains
of collections cannot be deleted. Also, you cannot references to all of the collections that are
contained within the collection at the time the copy
delete a collection if references to it exist.
is made.
E-Notebook, by default, is configured so that you
can not delete specific collections such as, User In some cases, your system configuration may
Collection, User Configuration Folder, Notebook prevent you from copying collections that contain
Collections and Offline Folder. references to specific types of collections that are in
specific states. This pertains only to references that
exist in property lists and tables. It does not pertain
Collections that Cannot be Deleted if
to references in the collection tree. For example, an
Modified experiment/page collection type may be configured
to prevent you from copying pages/experiments
In E-Notebook, in some cases, it may only be
that contain references to folders that are in a
possible to delete collections if they have not been
Closed state.
modified since they were created. Once the
collection is modified, you are prevented from Your system configuration determines which types
deleting such collections.In this case, the Delete of collections you can copy, and into which types of
option in the Collection menu is inactive when container collections you can copy them.
collections of that type are selected. For more information about copying collections,
see Copying a Collection on page 591.
Your system configuration determines which types
of collections cannot be deleted after modification.

Chem & BioOffice 2006 /E-Notebook Working with Sections and Collections 587
Working with Collections
Creating a Collection 3. Select New.

A menu appears, listing all of the type of


Each item displayed in the collection tree represents
collections that may be added to this container
a collection in E-Notebook. In order to create a
collection.
Administrator

new collection, you must first select a container, or


parent, collection for it. The new collection will be
created within the container collection in the tree. NOTE: Your system configuration determines which
For example, you may select a notebook as the options appear).
container collection, and you may create new
experiments or pages within the notebook.

Another example would be creating notebooks


within a user collection. All of the notebooks a user
creates could fall within the container collection
that bears the user's name.

Your system configuration determines where 4. Select the type of collection that you wish to
various types of collections may be added to the create.
Collection Tree.
The new collection appears under the
container collection in the Collection Tree, and
To create a new collection:
you may be prompted to rename it.
1. Be sure you are in browse mode by clicking the 5. Type in a name for the new collection (if
Browse button. prompted).
The Collection Tree appears. The name is saved automatically.
2. Right-click the collection in the Collection Tree
that you would like to be the container for the Organizing Collections
new collection.
You can organize collections in the Collection Tree
A menu appears. to make their order meaningful to you and other
E-Notebook users. Collections can be moved up
and down within a container collection. In some
cases, collections can be moved from one container
collection to another. Your system configuration
determines which items can be moved into which
types of collections.

Moving Collections within a Container


Collection
You can organize collections within a container
collection by moving them up and down.

588 Working with Sections and Collections CambridgeSoft


Working with Collections
To move a collection up or down within its con- Moving Collections between Container
tainer: Collections
1. Click Browse. You can organize collections in the Collection Tree
The Collection Tree appears. by moving them from one container collection to
another. Your system configuration defines the
rules that determine which collections can be
moved into which types of container collections.

To move an collection between container collec-


tions:

1. Click Browse.

The Collection Tree appears.


2. To expand a collection and view the items 2. In the Collection Tree, click the collection you
within it, either double-click the collection, or wish to move.
click the plus sign next to the collection.
The collection you wish to move is highlighted.
3. Right-click the collection you wish to move up
or down within the container collection. 3. Drag the collection into the new container
collection using your mouse.
The Collection menu appears.
If your system configuration permits the move, the
collection appears in the new location. Depending
upon the rules that define your system
configuration, a copy or a reference may appear
instead. Also, it may not be possible to move the
collection into a particular type of container. If the
new container will not accept the collection you are
attempting to move, you will be unable to highlight
the container when you attempt to drag the
collection into it.

Creating a Reference within the Collec-


4. Select the appropriate option:
tion Tree
Move Up moves the collection up a single
position in the Collection Tree. Within the collection tree, you can create a
reference to a collection that exists elsewhere in the
Move Down moves the collection down a
tree. The reference acts as a shortcut to the original
single position in the Collection Tree.
collection, and it reflects any changes that are made
Alternatively you may press CONTROL and the up to the original. Also, if you have editing privileges to
arrow key to move a collection up, or CONTROL the original, any changes made to the reference are
and the down arrow key to move a collection down. reflected in the original.

Chem & BioOffice 2006 /E-Notebook Working with Sections and Collections 589
Working with Collections
To create a reference in the collection tree: The reference appears in the Collection Tree,
within the container collection you selected.
1. Click Browse.
NOTE: Your system configuration determines which
The Collection Tree appears.
Administrator

collections can be referenced within which container


2. Click the collection that you wish to reference. collections.

The collection is highlighted.


It is also possible to create references to collections
3. While holding down the CTRL and SHIFT keys, from property lists and tables.
drag the item into the Collection where you
would like it to be referenced. Duplicating a Collection within a
A Reference to the item appears in the Container Collection
Collection Tree, within the collection you
You can duplicate a collection within its container
selected. The icon contains a small arrow,
collection in the Collection Tree. The duplicate you
which indicates that it is a reference.
create contains references to all of the
collections that are contained within the collection
An alternate method for creating a reference in the
at the time the copy is made.
collection tree is the following:
To duplicate an item within the same container col-
1. Right-click the collection that you wish to
lection:
reference.
The Collection menu appears. 1. Click Browse.

2. Select Copy. The Collection Tree appears.

3. Right-click the collection into which you wish 2. Right-click the collection that you wish to
to add the reference. duplicate.

The Collection menu appears. The Collection menu appears.

4. Select Paste Reference. 3. Select Duplicate.

590 Working with Sections and Collections CambridgeSoft


Working with Collections
A copy of the collection appears within the Alternatively, you may click the collection you are
same container collection. copying to select it. Then, while holding down the
CONTROL key, drag it into a container collection to
NOTE: Your system configuration determines which create a copy.
collections can be duplicated, and where the duplicates can
reside in the Collection Tree. NOTE: Your system configuration determines which types
of collections you can copy, and into which types of container
Copying a Collection collections you can copy them.

You can copy a collection in the Collection Tree.


Renaming a Collection
To do this:
You can rename a collection to avoid a duplicate
1. Click the Browse button. name, or simply to make the name more meaningful
The Collection Tree appears. to you and other E-Notebook users.
2. Right-click the collection you wish to copy and To rename a collection:
select Copy from the menu that appears.
1. Click the Browse button.
The Collection Tree appears.
2. Right-click the collection you wish to rename
in the Collection Tree.
The Collection menu appears.
3. Select Rename.
You are prompted to enter another name.
4. Enter a name.

3. Right-click the collection that is to be the The collection is renamed.


container collection for the copy. Your system configuration determines naming
4. Select Paste from the menu that appears. conventions for various types of collections. If you
enter a name that does not adhere to the naming
conventions, an error message appears and you are
prompted to enter another name. In some cases, a
name may be assigned to a collection automatically,
and it may not be possible to rename the collection
at all.

Deleting a Collection
You can delete a collection from the Collection
Tree so that you manage only the information that
A copy of the collection appears in the is relevant to your current needs. Your system
Collection Tree, within the container you configuration determines which types of collections
selected. can be deleted.

Chem & BioOffice 2006 /E-Notebook Working with Sections and Collections 591
Working with Collections
To delete a collection from the Collection Tree: The General tab of the Properties dialog box
appears. It contains the following information:
1. Click the Browse button.

The Collection Tree appears.


Administrator

2. Right-click the collection you wish to delete.

The Collection menu appears.


3. Select Delete.

If your system configuration permits it, the


collection is deleted.
You may also delete a collection by clicking it in the
tree to select it, then pressing the DELETE key.

NOTE: You cannot delete a collection if references to it


exist. Also, in some cases, it may only be possible to delete
collections if they have not been modified since they were
created.

Viewing Collection Proper-


ties
Name the name of the collection.
You can see specific information about a collection Owner the user who created the
by viewing the Collection Properties. collection.
Type the type of the Collection or Page.
To view properties of a Collection:
Contents the number of collections
contained in the collection.
1. Click Browse.
Created the date on which the collection
The Collection Tree appears. was created.
2. Right-click the item whose properties you wish Last Modified the date on which the
to view. Collection or Page was last changed.
Status the status of the collection in its
A menu appears.
lifecycle. If no states are defined for the
3. Select Collection Properties. collection, the status is Created.

592 Working with Sections and Collections CambridgeSoft


Working with Collections
Autosave Interval the time interval after Exporting a Collection
which the collection is saved automatically.
To export a collection,
NOTE: If you wish to view the Collection Security or
1. Click the Browse button.
Transition Security properties, click the appropriate tab. If
the collection is a user collection, the Region tab appears as The Collection Tree appears.
well. 2. In the Collection Tree, right-click the collection
that you wish to export as an XML file.
Importing and Exporting The Collection menu appears.
Collections
E-Notebook provides the ability to export and
import collections as XML files. Each XML file
contains all of the data and formatting associated
with the collection.

Importing a Collection
To import a collection,
3. Select Export.
1. Click the Browse button.
A dialog appears, and you are prompted to
The Collection Tree appears.
select a location for the exported file.
2. In the Collection Tree, right-click the collection
4. Select the location for the file and click Save.
into which you would like the collection to be
imported. For example, if you would like to 5. The collection is exported to the XML file.
import an Experiment into a Notebook, you
would right-click the Notebook. TIP: When a collection is exported, the export file does not
The Collection menu appears. include any of the contained collections. Each collection must
be exported separately. For example, if you export a
Notebook that contains Experiments, only the Notebook is
exported; each Experiment must be exported as a separate
XML file.

Changing Collection Security


Properties
You can change the access that other E-Notebook
3. Select Import. Users have to a specific Collections. In order to
change the security properties of a Collection, you
A dialog appears and you are prompted to
must have Full Control privileges to the collection.
select the XML file you wish to import.
Your system administrator determines who has Full
4. Select the file and click Open. Control privileges for each Collection in
5. The collection is imported into E-Notebook. E-Notebook

Chem & BioOffice 2006 /E-Notebook Working with Sections and Collections 593
Working with Collections
The default security for any new Collection is 2. Select Collection Properties.
Inherits Security, meaning that a Collection has the The Collection Properties dialog box
same security profile as its parent Collection in the appears.
Collection tree.
3. Click the Collection Security tab.
Administrator

To disable inherited security: The Security tab appears. The Groups and
Users who have permission to access this item
1. Right-click the Collection for which you wish appear in one of the two lists: Inherited
to disable inherited security. Permissions, Assigned Permissions.
A menu appears.

Inherited Permissions are permissions


2. If Inherits Security is checked, select it to clear inherited from the parent collection in the
the checkmark. collection tree. These permissions can not be
changed from this dialog. Only the Assigned
Inherits Security is disabled. Permissions can be changed from this dialog.

Collection Security
To change the Security Properties of a Collection or
Page:

1. Right-click the Collection or Page whose


Security Properties you wish to change.
A menu appears.

594 Working with Sections and Collections CambridgeSoft


Working with Collections
4. Take the appropriate action:
Desired Action to take
Result
Desired Action to take
Result
Change the type 1. Highlight the user or group
of access for a in the list of Assigned
Add a User or 1. Click Add.
Permissions.
user or group
Group to the list
2. Select the appropriate user currently in the
list 2. Select the appropriate
or group from the tree. You
access from the listbox:
may either:
Read permits a user to
a) right-click within a blank
view the Collection, but
portion of the tree and
not edit it.
select Browse All to see all
of the Users, or Read and Write permits
a user to view and edit the
b) click the Search button
Collection.
and perform a search for a
User or group of Users). Full Control permits a
user to view the
3. Click Add...
Collection, edit it, and
4. Select the appropriate assign or remove security
access from the listbox: permissions for it.

Read permits a user to


Transition Security
view the Collection, but
not edit it. Transition Security is the security applied to the
collection transitions. For example, some users may
Read and Write permits
be allowed to close a collection while others can
a user to view and edit the
also reopen the collection.
Collection.
To change the Transition Security Properties of a
Full Control permits a
Collection or Page:
user to view the
Collection, edit it, and 1. Right-click the Collection or Page whose
assign or remove security Security Properties you wish to change.
permissions for it.
A menu appears.
Remove a User 1. Highlight the user or group 2. Select Collection Properties.
or Group from in the list.
the list The Collection Properties dialog box
2. Click Remove. appears.
3. Click the Transition Security tab.

Chem & BioOffice 2006 /E-Notebook Working with Sections and Collections 595
Working with Collections
The Security tab appears. The Groups and 4. Take the appropriate action:
Users who have permission to apply a
transition to this item appear in one of the two Desired Action to take
lists: Inherited Permissions, Assigned Permissions. Result
Administrator

Add a User or 1. Click Add...


Group to the list
The Choose User or
Group dialog appears.

2. Select the appropriate user


or group from the tree. You
may either:

a) right-click within a blank


portion of the tree and
select Browse All to see all
of the Users, or

b) click the Search button


and perform a search for a
User or group of Users.

3. Click Add.

The Choose Transition


Inherited Permissions are permissions
Types dialog appears.
inherited from the parent Collection in the
Collection tree. These permissions can not be 4. Select the appropriate
changed from this dialog. Only the Assigned transition type(s).
Permissions can be changed from this dialog.
5. Click Add.

The User or Group


appears in the Assigned
Permissions list, along
with the transition type(s)
you selected.

Remove a User 1. Highlight the user or group


or Group from in the list.
the list
2. Click Remove.

596 Working with Sections and Collections CambridgeSoft


Working with Collections
Performing a Collection Exporting a Collection or
Transition Section to MS Word
Collections may be configured to have states You can export Collections and Sections to MS
associated with them. These states define the life Word, then manage them as you would MS Word
cycle of the collections. For example, a Notebook documents. See Exporting on page 577 for
may have Open and Closed states; the Open state details.
may permit editing, and the Closed state may be a
read-only state that does not allow edits. Transitions Printing Collections
are the actions you perform to move a collection You can print collections from E-Notebook to
from one state to another, for example, from Open maintain your hardcopy archives. See Printing on
to Closed. page 579 for details.
In order to perform a transition on a collection: Printing Multiple Collections at Once
1. Click Browse. Some configurations provide the ability for you to
print multiple contained collections at once.
The Collection Tree appears.
To do this:
2. Right-click the collection in the Collection Tree
that is to undergo the transition. 1. Click the container collection in the Collection
Tree. For example, this may be a notebook, and
The Collection menu appears. you may wish to print several
3. Select the name of the transition from the experiments/pages within the notebook.
menu, for example Close, Final Print, or Reopen. 2. In the right frame, select the section that
(Again, the options will vary based upon your contains the Print Multiple tool .
system configuration). 3. Click the tool to select it.
4. You may be prompted to enter additional The Print Multiple dialog appears, prompting
information such as an annotation or addi- you to select the range of contained collections
tional data before the transition can to print.
proceed. If so, enter the information to
proceed with the transition.
The transition occurs and the collection enters
the new state. You may always view the state of
the collection by right-clicking it in the
Collection Tree, then selecting Collection
Properties.
Transitions may also perform certain functions,
such as printing a copy of the collection.
4. Select the range by choosing a starting and
Your system configuration determines which ending collection from the dropdown lists.
transitions may be performed, and by whom. 5. Click the Print button.

Chem & BioOffice 2006 /E-Notebook Working with Sections and Collections 597
Working with Collections
Performing a Collection Transitions may also perform certain functions,
such as printing a copy of the collection.
Transition
Your system configuration determines which
Collections may be configured to have states transitions may be performed, and by whom.
Administrator

associated with them. These states define the life


cycle of the collections. For example, a Notebook Working with Form Tools
may have Open and Closed states. The Open state
A form tool is used to perform a particular function
may permit editing, and the Closed state may be a
in an E-Notebook form/field. There are several
read-only state that does not allow edits. Transitions
standard form tools in E-Notebook that may be
are the actions you perform to move a collection
associated with the section or collection types, for
from one state to another, for example, from Open
example, the New Section Form Tool associated
to Closed.
with Notebook collection type or Import/Export
In order to perform a transition on a collection: Form Tool, which is present in new section types
you create.
1. Log into the E-Notebook.
The Collection Tree appears. NOTE: Your system configuration determines the
2. Right-click the collection in the Collection Tree
collections to which this form tool can be added.
that is to undergo the transition.
The Collection menu appears. The New Section Tool
3. Select the name of the transition from the The New Section Tool allows you to add new
menu, for example, Close, Final Print, or sections to a collection, for example, to a page or an
Reopen. (Again, the options will vary based experiment. When you click the tool you will be
upon your system configuration). presented with a list of the types of sections you
may add.
You may be prompted to enter additional
information such as an annotation, or additional If you would like to create a new section within a
data, before the transition can proceed. If so, enter Page/Experiment:
the information to proceed with the transition.
1. Click the New Section icon,
The transition occurs and the collection enters the .

new state. You may always view the state of the


collection by right-clicking it in the Collection Tree,
then selecting Collection Properties.

598 Working with Sections and Collections CambridgeSoft


Performing a Collection Transition
A list of the section types that can be added A new copy of the Page or Experiment
appears. collection appears within the same container
Notebook.

1. Alternatively, in the Collection Tree, right-click


the experiment/page which you would like to
duplicate.
A menu appears.
2. Select Duplicate from the menu.

The New Child Collection


Tool
The New Child Collection Tool allows you to add
new contained collections to the selected collection.
For example, you could click this tool on a
2. Select the section type.
notebook in order to create a new page/experiment
The new section appears within the Page. within the notebook.

The tool may be used to create a new page within a


The Duplication
Enterprise
notebook. To do this:
Collection Tool
1. Click the New Experiment icon/tool,
The Duplicate Collection Tool allows you to create
a copy of the selected collection. For example, if
you click the Duplicate Collection Tool/Icon on a
Page/Experiment collection, the Page/Experiment
collection will be copied. The duplicate or new copy
will appear within the same container collection in
the Collection Tree.
A list of the experiment/page types appears.
To duplicate a collection with Duplication
Collection Tool:

1. Select the experiment/page type you wish to


duplicate.
2. Click the Duplicate icon/tool,

2. Select the experiment/page type.

A new Page or Experiment collection appears


within the Notebook. It is numbered
automatically.

Chem & BioOffice 2006 /E-Notebook Working with Sections and Collections 599
Working with Form Tools
1. Alternatively, in the Collection Tree, right-click 1. Click the New Sibling icon,
the Notebook collection to which you would
like to add the Page or Experiment.

A menu appears from which you can select the


Administrator

page to be added to the Notebook Collection.

A list of the collection types that can be created


appears.

The New Sibling


Enterprise

Collection Tool
The New Sibling Collection Tool allows you to
create a new collection of the same type. For 2. Select the collection type.
example, if you click the New Sibling Tool on a A new notebook collection appears within the
notebook, a new notebook will be created. The new same container collection.
sibling will appear within the same container
collection in the Collection Tree. NOTE: Your system configuration determines the
collections to which this form tool can be added.
If you would like to create a new sibling of a
Notebook:

600 Working with Sections and Collections CambridgeSoft


Working with Form Tools
Chapter 31: Changes and Audit Trail
E-Notebook provides auditing and change control not made unsaved changes to the collection,
features for compliance with 21 CFR Part 11, which and that you have not opened the collection for
is part of Title 21 of the Code of Federal editing. The changes icon will always appear in
Regulations for the Food and Drug Administration this form if the collection is in a read-only state.
(FDA). 21 CFR Part 11 sets forth guidelines for
keeping, maintaining and authenticating electronic If you click within one of the sections in
records. the collection, the key leaves the hole. This
indicates that you have locked the collection
For every change made to E-Notebook data, an for editing, and other E-Notebook users may
audit trail records the logged in identity of the user, not edit it at this time. The Release state may
the date, and the time. This is done automatically also indicate that another user of E-Notebook
when you add, delete, or update data. The audit trail has the collection open and locked for editing.
information is stored in the E-Notebook database.
An open book in front of the key indicates
In addition, E-Notebook may be configured so that
you can annotate the changes you make to that unsaved changes have been made to the
collections by providing reasons for them. See the collection.
following topic for more information: If you are viewing a previous version, the save icon
Annotation of Changes will not appear.
Working with the Changes Icon
Saving Changes to a Collec-
Saving Changes to a Collection
tion
You can also view prior versions of collections and,
if Visual Display of Changes is enabled, you can There are a number of ways in which changes to a
view and print the changes that were made to the collection may be saved. This topic addresses each
data in a collection. See the following topics: of these items in detail. They are:
Working with the History Pane Clicking the changes icon.
Visual Display of Changes
Selecting Save Changes or Save and Annotate
Working with the Changes Changes from the Changes menu.
Browsing to another collection.
Icon
Through autosave, which your system adminis-
The changes icon appears in the right frame of trator sets up to automatically save the collec-
E-Notebook. The appearance of the icon changes tion after a set period of time has passed.
to indicate various conditions:
Selecting Backup Changes from the Changes
When you first select a collection in the menu. This option would be used in the event
collection tree, the changes icon appears as a of network failure, to prevent data loss.
key in a keyhole. This indicates that you have Closing the Internet Explorer browser.

Chem & BioOffice 2006 /E-Notebook Changes and Audit Trail 601
Clicking the Changes Icon Saving Changes through Autosave

To save your changes using the changes icon: Your system configuration may include the
autosave feature, which defines the set period of
time after which the collection is saved
Administrator

1. Click the changes icon. The open book


indicates that there are unsaved changes. automatically. If autosave occurs and annotation is
required, you will be prompted to enter a reason for
2. If the changes must be annotated, you will be your changes. To view the autosave interval for a
prompted to enter annotation . If no annota- collection, simply right-click the collection and
tion is required, your changes are saved imme- select Collection Properties from the menu.
diately.
The saved version will appear in the History
Pane. The changes icon indicates that your
changes have been saved .

Selecting Annotate Last Change from


the Collection Menu
This allows you to provide an optional annotation
for the last change you made to a collection. To save
your changes using a command in the Changes
menu:

1. Right-click the collection and select Annotate


Last Change... from the menu.

A dialog appears and you are prompted to


enter an annotation for the change. Saving Changes through Backup and
2. Select or enter an annotation and click the Restore
Annotate button.
In the event of a network failure, you can save your
changes locally, then add them to E-Notebook at a
Saving Changes by Browsing to later time using the Restore command.
Another Collection
To Backup and Restore your changes:
To save changes by browsing to another collection:
1. When the network goes down, you will be
1. Click another collection in the Collection Tree. prompted to save your changes as an XML file.
Select the name and destination for the file and
2. If your changes must be annotated, you will be
click OK.
prompted to enter annotation . If no annota-
tion is required, your changes are saved imme- 2. When the network comes back up, browse to
diately. the collection and right-click it.
The version appears in the History Pane. 3. Select Restore Changes.

602 Changes and Audit Trail CambridgeSoft


The Restore Changes dialog appears, and you Providing Required Annotation
are prompted to select the file containing the
changes. With required annotation, you must provide a
reason for your changes each time you save the
4. Select the file you saved as a backup and click
collection or an autosave occurs. You must provide
Open.
the reason before making any further changes. The
Your changes are restored. dialog lists the changes you made to the collection
since the last time the collection was saved.
Annotation of Changes
1. Click the changes icon .
E-Notebook may be configured so that you can
annotate the changes you make to data in The Annotation dialog appears:
collections. There are two possibilities for providing
annotation. They are:
Required Annotation each time you save
the collection, you must provide a reason for
the changes you made. You must also provide
a reason for the changes if autosave has
occurred.
Optional Annotation you may provide a
reason for the changes is you wish, but it is not
required.
Whether annotation is required or optional 2. Either click one of the Predefined Annotations
depends upon 1) the type of collection and 2) its to select it, or type another annotation into the
state. For example, an Experiment or Page may be bottom box.
configured such that it has three states: Open,
Closed, and Reopened. The Save button is enabled.
Open the Open state may have optional 3. Click the Save button.
annotation, so that you may provide a reason
for a change if you wish. The version of the collection is saved, along
with the annotation. The version is listed in the
Closed the Closed state may be read-only. It History Pane.
may not be possible to edit the collection while
it is in this state. Alternatively, you may save your changes by simply
Reopened the Reopened state may permit
browsing to another collection. If you have unsaved
changes, but only if they are annotated each changes, you will be prompted to enter an
time the collection is saved. annotation.

In some configurations, annotation may be required In some configurations, an autosave may occur
when you perform a collection transition. For after a certain time period has elapsed. If autosave
example, it may be necessary to provide a reason for occurs and annotation is required, you will be
moving a collection to the Reopened state. prompted to enter the annotation for your changes.

Chem & BioOffice 2006 /E-Notebook Changes and Audit Trail 603
Providing Unprompted, Optional Anno- To view the History Pane of a collection:
tation 1. Right-click the collection in the Collection
With Optional Annotation, you may provide a Tree.
reason for your changes at any time. You initiate The Collection menu appears:
Administrator

providing the reason; it is not mandatory. To


provide optional annotation:
1. Click the changes icon .
A menu appears.
2. Select Save and Annotate Changes.

NOTE: This command will only be available if there


are unsaved changes.

3. Click a predefined annotation or type in


another annotation.
4. Click Save.
The version is saved, along with the
annotation. The version is listed in the History
Pane.

Working with the History


Pane
The History Pane indicates whether prior versions 2. Select Show History. The History Pane appears
of a collection exist, and enables you to view those in a pane below the Collection Tree. It displays
versions. A version of the collection is created each all versions and transitions for the collection, in
time the collection is saved. For each version, the reverse chronological order. A save operation is
history pane shows the date, time, and the action
name - which may be save, autosave, or a transition
name.

604 Changes and Audit Trail CambridgeSoft


denoted with a paper and pencil icon. A collec- Name the action that created the version
tion transition is denoted with a rubber stamp (save, autosave, transition name).
icon Author the person who performed the
action.
.

Date the date and time the version was


created.
If there is an annotation associated with the
change, the following information appears as
well:
Person who entered the annotation
Date and time the annotation occurred
Text of the annotation
2. Click the Previous button to view information
about the previous version of the collection, or
3. To view a particular version, click the version in
the Next button to view information about the
the History Pane. The version is then displayed
next version of this collection.
in the section frame, to the right.
3. Click OK to dismiss the Version Properties
The changes icon icon is not visible when you
dialog.
are viewing older versions of a collection.
To view the properties of a version of a collection: Specifying an Annotation through the
History Pane
1. Right-click the version in the history pane.
It is only possible to specify an annotation through
Select Properties from the menu that appears. the History Pane for the most recent version of the
collection, and only if the state of the collection
does not require that changes be annotated.
To enter an annotation for the most recent version
of the collection:

The Version Properties dialog appears. 1. Right-click the version in the History Pane.
2. Select Properties from the menu that appears.
The Properties dialog appears. If the version
displayed in the Properties dialog is
unannotated and requires an annotation, the
Annotate button is visible.
3. To annotate this version, click the Annotate
button and the standard Annotation dialog
box appears.
The dialog displays the following information 4.
about the version you selected: The standard Annotation dialog appears.

Chem & BioOffice 2006 /E-Notebook Changes and Audit Trail 605
5. Enter the reason for the changes, or select a Baseline Version in the version that existed when
reason from the predefined list of reasons. the Close transition was performed. A black line
6. Click OK . appears under this version.
The annotation is saved with the version.
Administrator

Visual Display of Changes


Depending upon the type of collection and its state,
it is possible to view a Visual Display of Changes
that have been made to data in the collection. If
Visual Display of Changes is enabled, the changes
that have been made to a collection can be viewed
in E-Notebook, and a record of the changes made
will be shown as footnotes in the printed collection.
In some configurations, Visual Display of Changes If visual display of changes is enabled, there is a
will be possible from the very beginning of the
collection life cycle, when the collection is first paper and pencil icon next to data in the
created. In other cases, Visual Display of Changes section that was changed after the baseline version
will begin when a particular collection transition is was created.
performed; a common example is the transition
from a closed, read-only state to a reopened state in
To view an older version of the data:
which edits are permitted.
The version of the collection that existed when the 1. Click the paper and pencil icon that indicates a
Visual Display of Changes began is called the change was made.
Baseline Version of the collection. It is underlined
in the History Pane. In the example below, the A dropdown menu is displayed. The menu
displays a list of dates and times for every saved
version of this data since the baseline version.
The version currently displayed is denoted with
a checkmark.

2. To view a particular version, select the corre-


sponding date from the dropdown list.

The entire version of the collection as of that


date and time is displayed.

606 Changes and Audit Trail CambridgeSoft


Changes are displayed differently for different types
of data

Type of Data Change Display Example

Chemical Structure The data is displayed as it existed N/A


when the version was created.
Database tables

MS Excel Spreadsheet

Spectrum

Stored Document

Styled Text

URL Displays

MS Word The change tracking features of


MS Word are used: new text is
underlined and displayed in red.
Deleted text is displayed with
red, strikethrough text.

Property Lists Changed Cells display a pencil Changed or new property:


icon.
Tables
New cells display a pencil icon.
Deleted property:
Deleted cells display an X
through them.

If Visual Display of Changes is enabled, the printed A list of changes grouped by field.
output will include three main portions:
NOTE: Even when the visual display of changes is not
The data as is exists in the current version. enabled, the audit trail still captures the history, and the
history pane displays a list of the saved versions and
The version history, including the date and the transitions for the collection.
author for each version after the baseline
version.

Chem & BioOffice 2006 /E-Notebook Changes and Audit Trail 607
Administrator

608 Changes and Audit Trail CambridgeSoft


Chapter 32: Searching
Searching allows you to find information in 4. Select the type of query you would like to run.
E-Notebook that meets the criteria you specify.
An empty query form is displayed. An example
E-Notebook makes it possible to search for:
is shown below:
Chemical structures
Strings of text
Values in Property Lists and Tables
Collections and sections that meet specific
criteria, such as creation date or owner's name
or state.
Unannotated versions of collections

Conducting a Search
You can search for information in E-Notebook that 5. Specify the parameters that will determine the
meets the criteria you specify. You can then save search results.
your queries and the results lists.
The parameters you can specify are determined
To conduct a search: by the type of query you are conducting.
1. Click the Search button. 6. Do one of the following:

Search mode appears. Click Search Now to execute the query.


A results list appears.
Click Save Query to save the query.
The Collection Tree appears with a new
search, and you are prompted to give the
search a name.

2. From the Search for drop-down list, select the Working with Query Results
type of search you would like to conduct. When you conduct a Search in E-Notebook, the
3. Click the New Query Section icon. results are displayed in a list. You can save the
A menu appears. results list, and/or view any item on the list.

The options in the menu depend on both the Viewing Items in a Results List
type of search chosen in step 2 and your
configuration. To view an item on the results list:

Chem & BioOffice 2006 /E-Notebook Searching 609


Conducting a Search
Click the arrow in the upper left corner of the Saving a Query
name of the item, as shown below.
When you create a query in E-Notebook, you may
save the query in the Collection Tree.
Administrator

To save a query:
1. Click the Save Query... button to the left of the
The Collection Tree appears, with the item query form.
displayed. A dialog appears, and you are prompted to
select the location where you wish to save the
Saving a Results List search.
To save the results list: 2. Click a collection to select it as the location,
and click the Save button.
1. Click Save Results.
A dialog appears, prompting you to browse to The Collection Tree appears, and the query
the location in the Collection Tree where you appears in the tree. You are prompted to
would like the results to be saved. rename the query.
2. Click a collection to select it in the tree, and 3. Enter a name for the query
click the Save button.
TIP: The last query you created will appear by default
The Collection Tree appears, showing the when you enter Search mode again.
search results as a new collection. The links are
maintained so that you may browse to any of
the items. Running a Saved Query
To run a query that is saved in the collection tree:
Customizing the Display of Search
Results 1. Click the Browse button at the top of the
screen.
You can customize the display of a hitlist, just as
you can customize a table of contents. To do this: The Collection Tree appears.
2. Select the query in the collection tree by
Right-click a column in the hitlist.
clicking it.
A menu appears.
The query form appears in the right frame.
3. Right-click the section menu icon, and select
Copy Section.
4. Click the Search button at the top of the screen.
Search mode appears.

You may hide the selected column or sort the 5. From the Search For dropdown list, select the
results list. You may also specify which columns are type of query that corresponds to the query
displayed, using the Show command. See Working form you are copying.
with Table of Contents on page 519 for a more 6. Right-click the Section menu icon, and select
detailed description of these options. Paste Section.

610 Searching CambridgeSoft


Conducting a Search
The query form appears. Exclude Collections from the Previous
Search excludes collections from the
NOTE: It may be necessary to delete one of the query stored hit list that are part of the previous
forms if you do not want to use multiple query forms. search results. The stored hit list is
See Removing a Section on page 584 for more completely replaced.
information.
Exclude Sections from the Previous
Search excludes sections from the stored
Refining a Search hit list that are part of the previous search
results. The stored hit list is completely
Once you have conducted a search, you can further replaced. If the current search engine is a
refine it, performing a search that is: collection search engine, then this option is
An intersection of two searches not present.
Add to the Previous Search adds the
A union of two searches
results specified in the search query to the
The exclusion of one set of search results from previous search results. Duplicate
another collections and/or sections will not be
It is possible to refine both section searches and added.
collection searches. Remove from the Previous Search
removes the results specified in the search
To do this: query from the previous search results.
1. From the dropdown list at the top of the query 2. Fill in the new search criteria.
form, choose any of the following options: 3. Click the Search Now button.
Create a New Set of Search Results The hitlist appears, modified according to the
deletes the previous search results and option you chose in step 1.
replaces them with the search results If you wish, you may refine your search further, by
generated by the new query. selecting another option from the dropdown list.
Refine the Previous Search By
Collection uses the previous search Using the E-Notebook
results to limit the collections in which a Search Types
search is done. The stored hit list will
contain the intersection of the previous E-Notebook offers an extensive array of searching
search results and the results specified by the features. You can search for:
new query. Chemical structures
Refine the Previous Search By Section Strings of text
uses the previous search results to limit the Values in property lists and tables
sections in which the search is done. The
stored hit list will contain the intersection of Collections and sections that meet specific
the previous search results and the results criteria, such as creation date or owner's name.
specified by the new query. If the current You can search for sections that meet the criteria
search engine is a collection search engine, you specify. Similarly, you can search for collections
then this option is not present. based on specific attributes. The Chemical

Chem & BioOffice 2006 /E-Notebook Searching 611


Conducting a Search
Structure search will find structures in chemical A dialog appears, prompting you to choose
structure fields and tables in E-Notebook. The a location for waving your search.
results of the search are grouped by structure for Select a location and click the Save button.
easy analysis and organization. You can also search
Administrator

for collections that require annotation, but for The Collection Tree appears with a new
which no annotation was provided when changes Section Search, and you are prompted to
were made. You can save queries and the results lists name the search
of the searches made to the E-Notebook Collection When you conduct a search for sections, all of the
Tree. search criteria you enter into the query form must
exist in a section in order for the section to be
Searching for Sections considered a match. In other words, the search is an
You can search for sections that meet the criteria AND search. If you add an additional search
you specify. You can then refine your search, or save form, you can conduct an OR search. The search
your queries and the results lists. results will contain the sections that match 1) all of
the criteria in the first search form and 2) all of the
To conduct a search for sections: criteria in the second search form. After running a
search you may refine it, adding additional criteria,
1. While in Search mode, select Sections from the etc. See Refining a Search on page 611.
Search for drop-down list. If no form appears
in the right frame, click the New Query icon. Searches are not case sensitive. A search for
Benzene will find both Benzene and
benzene.
Your section search form may include the following
search fields:

Query Text Field


A menu appears.
The Query Text field may be used to search for the
2. Select the new query form you wish to create. following text:
The options are: Basic Query and Advanced
Query. Text in MS Word fields
An empty query form appears. Text in Styled Text fields

3. Enter your search criteria into the form, using Text in MS Excel spreadsheets
the instructions below. Text in Chemical Structure fields
Do one of the following: Properties in Property Lists
Click Search Now to execute the query. Properties in Tables
A results list appears, displaying the sections Text in several types of stored document files
for which all of the parameters you specified MS Word, MS Excel, MS PowerPoint
apply.
See Searching for Text with the Query Text Field
Click the Save Query button to save the on page 626 for a description of the search
query. capabilities.

612 Searching CambridgeSoft


Conducting a Search
Chemical Structure Field Collection (Metadata) Properties

If you wish, draw a structure or reaction using the Metadata Properties describe the collections that
ChemDraw Toolbar. (Alternatively, you may open contain the sections for which you are searching.
a structure file of a supported file type). See For Selecting, a checkbox makes visible an area that
Chemical Structure Search on page 614 for allows you to enter criteria. See Searching with
information about performing a structure search. Collection Attributes on page 623 for more
The section search differs from the chemical instructions on entering these criteria.
structure search in that the results of a section
search are not organized by substructure.

Property Query and Table Query Fields


These fields are included in the Advanced Section
Query. The Property Query Field is used to search
over Property Lists, and the Table Query field is
used to search over Tables. See Searching with the
Property Query and Table Query Fields on page
624.

Collections Search
Search Location Field
The collection search allows you to search for
The Search Location field allows you specify the collections, such as notebooks, folder, or
branch of the collection tree for your search. To experiments. You may conduct a search based for
select a search location, simply click the Search In specific content or for metadata, such as owners
checkbox to select it, and browse to or search for name and creation date. You can save your queries
the root collection for your search. The search will and the results lists in the Collection Tree.
cover the root you select and any collections within
it. To conduct a search for collections:
1. While in Search mode, select Collections from
the Search for drop-down list. If no form
appears in the right frame, click the New Query
icon.
A menu appears.
2. Select Basic Query or Advanced Query.
An empty query form appears.
3. Enter your search criteria, as described below.

Chem & BioOffice 2006 /E-Notebook Searching 613


Conducting a Search
Do one of the following: by structure for easy analysis and organization. You
Click Search Now to execute the query.
can save queries and the results lists to the
E-Notebook Collection Tree.
A results list appears, listing the Collections
that match the criteria you specified. Note that you may also search for chemical
Administrator

structures with the Section Search and Collection


Click the Save Query button to save the Search. These searches allow you to combine the
query. structure search with other search criteria. The
A dialog appears, prompting you to choose results of the Section Search and Collection Search,
a location for waving your search. however, will present the search results in a list,
rather than ordering them by structure.
Select a location and click the Save button.
The Collection Tree appears with a new To conduct a search for structures:
Collection Search, and you are prompted to 1. While in Search mode, select Chemical Structure
name the search. from the Search for drop-down list.
Your search for collections may include the 2. Click the New Query icon.
following search fields:
An empty query form appears.
Query Text Field see Query Text Field on
page 612.
Chemical Structure Field see Chemical
Structure Field on page 613.
Search Location Field see Search Location
Field on page 613.
Collection (Metadata) Properties see
Collection (Metadata) Properties on page 613.
Property Query and Table Query Fields see
Property Query and Table Query Fields on page
613.

Chemical Structure Search


Substructure searching finds structures that contain 3. Within the chemical structure box, draw the
the query and any additional attachments at the structure or substructure for which you wish to
open positions. Using the ChemDraw toolbar, you search, or right click within the structure box to
can attach different features, such as atom lists and import a file. (For more information about the
variable bond types, to a query to perform a structure drawing capabilities of ChemDraw,
narrower or broader search. please consult the ChemDraw Users Manual.)
4. Do one of the following:
The Chemical Structure search will find structures
in chemical structure fields and tables in Click Search Now to execute the query.
E-Notebook. The results of the search are grouped A results list appears.

614 Searching CambridgeSoft


Conducting a Search
Click the Save Query button to save the In searching substructures, E-Notebook finds the
query. substructure query regardless of its orientation or
The Collection tree appears with a new drawing presentation in the targeted molecules.
Structure Search, and you are prompted to
give the Structure Search a name. E-Notebook does its best to follow your
instructions even if those instructions are
contradictory. For example, you can create a query
An example of substructure searching of such as the following:
Cyclopentane. The substructure query:

This indicates that the bond


must NOT be in a ring

Chn

Will hit the following (and other molecules):


That bond is already in a ring, so no hits are
returned for this query.

General Query Properties


E-Notebook allows the following general
O
properties to be assigned to a query:

Atom

Bond
Substituents

HO
Charges and radicals

Isotopes

Atoms
Atom types specified in the query must match
atoms at corresponding positions in the target.
Hydrogen is an exception see Substituents,
O below.

Chem & BioOffice 2006 /E-Notebook Searching 615


Conducting a Search
Bonds
Bond Type Description
All bonds explicitly drawn in the query must match
in the target. E-Notebook recognizes the following Triple target must have triple bond
Administrator

standard bond types: here

Bond Type Description Substituents


In E-Notebook, a substituent is defined as a non-
Single target must have single bond hydrogen atom connected by a bond of any order.
here For example, a carbonyl oxygen is a substituent of
the carbonyl carbon.
Dashed same as Single
All unfilled valences in the query may be filled by
hydrogen atoms or by non-hydrogen substituents.
Hashed same as Single The normal valence of an atom is determined from
data in the periodic table. For example, carbon has
Thick same as Single a valence of 4, while sulfur has valences of 2, 4, and
6. Any explicit charges, radicals, or query properties
Wedged Hashed specifies stereochemistry down modify the normal valence. For example, a
from the point end to the wide carbocation has a valence of 3.
end Hydrogen atoms in the query may match non-
hydrogen substituents in the target if the hydrogen
Wedged specifies stereochemistry up in the query is implicit on an unlabeled carbon atom
from the point end to the wide or heteroatom.
end Hydrogen atoms in the query must match
hydrogens in the target when the query hydrogen is
Wavy specifies stereochemistry at the end of an explicit bond. The matched
either at both ends hydrogen in the target may be implicit in an
unlabeled carbon.
Hollow Wedged same as Wedged
Figure 32-1Query Figure 32-2

Dative same as Single H O

Double target must have double bond; H N


stereo dictated by geometry

Double Either target must have double bond;


any stereochemistry ok

Double Bold same as Double

616 Searching CambridgeSoft


Conducting a Search
Figure 32-3Finds: Figure 32-4Does not Isotopes
find: Isotopic labels specified in the query must match
Cl OH
the target. Unlabeled atoms in the query match
O
HN O
unlabeled or isotopically labeled atoms in the target.
NH2
Additionally, D is treated interchangeably with 2H,
Br
and T is treated the same as 3H. With a
H OH
O Substructure Search:
NH2
OH
Figure 32-9Query Figure 32-10:
H OH
H N
1
3
O C
Br
D
H NH2

Charges and Radicals


Figure 32-11Finds Figure 32-12Does not
Charges or radicals specified on atoms in the query find:
must match those in the target. The valence of a HO 13
CH 3
charged atom is taken to be the valence of the 13
C O
isoelectronic neutral atom With a Substructure D
T
Search: O
13
CH 3

13
O CH 3
Figure 32-5Query Figure 32-6: D
HO
D D
N
D
13
O C

Atom Properties
E-Notebook allows special atom properties to be
Figure 32-7Finds Figure 32-8Does not find: assigned to an atom in a query. They generally serve
to broaden or narrow the scope of the search.
N H 3 N H

Special Atom Types


H 2
E-Notebook recognizes six special atom types that
N N
can match any one of a predefined set of elements:
A matches any non-hydrogen atom.

N N
Q matches any heteroatom (non-hydrogen,
non-carbon).
O H
R matches any atom, including hydrogen.
X matches any halogen (F, Cl, Br, I, At).

Chem & BioOffice 2006 /E-Notebook Searching 617


Conducting a Search
M matches any metal atom: With a substructure search, the query:

Figure 32-13Query: Figure 32-14

This atom is marked


Administrator

X3
with the atom property
Substituents Exactly:3

Figure 32-15Finds: Figure 32-16Does not


Cl
find:

Atom Lists
As with the predefined special atom types, an atom
list is a list of atoms, one of which must match the O
target atom. HO

O
For example: O

[Cl,Ag,N] atom must be Cl or Ag or N

Atom lists may contain only elements. Special atom


types, nicknames (Ph), and structural fragments
(NH2, OCH2CH3) may not be included in an atom
list. E-Notebook recognizes a maximum of five Substituents: Up To
atoms in an atom list. This property specifies a maximum value for the
number of substituents on an atom, including those
Atom Not-Lists explicitly drawn. This property is only meaningful
in a substructure search.
The opposite of an atom list is a list of atoms, none
of which must match the target atom. For example: Figure 32-17Query: Figure 32-18
This atom is marked
[NOT O,S,Se] atom must not be O or S or Se (but U2
with the atom property
may be any of the 100 other elements) Substituents Up to:2

Atom not-lists have the same restrictions as atom


lists.

Substituents: Exactly
This property specifies a precise value for the
number of substituents on an atom, including those
explicitly drawn.

618 Searching CambridgeSoft


Conducting a Search
Figure 32-19Finds: Figure 32-20Does not Figure 32-23Finds: Figure 32-24Does not
Cl
find: find:

HO
O HO
O

O
O
O
CH3

Unsaturation
Substituents: Free Sites
Sometimes it is useful to specify that an atom must
The Substituents: Free Sites property specifies the or must not be attached to unsaturated (aromatic,
maximum number of additional substituents that double, or triple) bonds. E-Notebook allows
may be present on an atom. This property is only searches for atoms whose unsaturation Must Be
meaningful in a substructure search. Absent (all bonds to the atom are single). It also
allows searches for atoms with at least one multiple
TIP: Specifying Free Sites: 0 is a quick way to indicate that (double, triple, or aromatic) bond. The default
you want no further substitution at a site. Target structures value, Undefined, finds targets without regard to
will match the query structure as drawn, with no additional the hybridization of the atom. With a substructure
ligands. search, the query:

Figure 32-25Query: Figure 32-26


Figure 32-21Query: Figure 32-22
O
This atom is marked
2 with the atom property
Substituents Free sites:2 OH
S

This atom is marked


with the atom property
Unsaturation: must be present

Chem & BioOffice 2006 /E-Notebook Searching 619


Conducting a Search
Figure 32-27Finds: Figure 32-28Does not
O
find: Bond Type Description
O

OH
D/A target must have a double bond
Administrator

OH
O or an aromatic bond here

HO
HO
S/A target must have a single bond
or an aromatic bond here
O

Topology
OH
OH
If Ring or Chain is chosen, the target bond must or
OH
O
O must not be in a ring, respectively.

Bond Properties Reaction Center


E-Notebook allows special properties to be The reaction center refers to those bonds that are
assigned to bonds in a query. These properties directly affected by a reaction. This property allows
usually will only be meaningful during a search. you to specify just how a given bond is affected.
They generally serve to broaden or narrow the
scope of the query.
Property Description

Special Bond Types Unspecified target must have a bond here,


The table below describes the special bond types but the bond can participate in
that E-Notebook allows. the reaction in any fashion, or
not at all

Bond Type Description


Center target must have a bond here
that directly participates in the
Aromatic target bond must be aromatic reaction in some way
as defined by the Hckel 4n+2
rule
Make/Break target must have a bond here
that is either made (if in a
Any target can have any bond type product) or broken (if in a reac-
here tant)

S/D target must have a single bond Change target must have a bond here
or a double bond here whose bond order changes
over the course of the reaction,
Tautomeric same as S/D but is not made or broken

620 Searching CambridgeSoft


Conducting a Search
two atoms on either side) and the two atoms on
Property Description either side) is part of the reaction center. The rest of
the structure is unchanged from the reactant to the
Make&Change target must have a bond here product:
that is either made (if in a
O OH
product) or broken (if in a reac-
tant) or whose bond order
changes over the course of the
reaction
F Cl F Cl
Not Center target must have a bond here,
By default, E-Notebook does not consider reaction
and that bond must not partici-
centers in the search. In order to include the
pate in the reaction
reaction center in the search, you must select the
Map Reaction Centers checkbox before running the
Not Modified target must have a bond here, search.
and regardless of whether it is
part of the reaction center or For example:
not, its order must not change
F Cl
over the course of the reaction
will only hit the reaction shown above if the Map
Reaction Searching Reaction Centers option is not selected. The reason
for this is that, although there is a C-F bond in the
The chemical structure search in E-Notebook
target reactant and a C-Cl bond in the target
allows you to search for reactions. In a reaction, one
product, these bonds do not participate in the
or several compounds (reactants) are transformed
reaction, which affects another part of the
into other compounds (products). Individual
compound.
reactants (or products) are separated from each
other with plus signs. The reactants are separated When creating reaction queries, it is important to
from the products with an arrow. consider what sort of information you really wish to
find. Suppose you want to convert n-decanal to n-
Reaction Centers decanol:
The most important part of a reaction is that part
O
that actually changes from the reactants to the
products. This part, which normally includes a
number of atoms and bonds, is called the reaction
center. For example, only the bond below (and the OH

Chem & BioOffice 2006 /E-Notebook Searching 621


Conducting a Search
Are you really interested in these two compounds By matching numbers across the arrow, you can see
exclusively? You might be interested in any reaction where atoms move during the course of the
that converts a straight-chain aldehyde to the reaction. The other reaction (not observed
alcohol: experimentally) in which the ester oxygen comes
Administrator

from the acid, would be mapped like this:


H H 3 3
O O
H H 6
O OH Rxn OH
5 H2O 6
2 5 2
1 OH 4 1 O Rxn
4
H H
E-Notebook uses atom-to-atom map information
Since the corresponding n-octanol -> n-octanol to determine the reacting centers for reactions. If
reaction would probably occur under very similar only some atoms are mapped, E-Notebook uses
conditions, it is a reasonable reaction to look at. that information and does not worry about the
Generally, you want to use substructure queries that specific fates of other atoms. Foe example, if you do
include little beyond the reaction center in question not know (or do not care) about the mapping of
certain atoms, you can leave them unspecified in
when you are searching for reactions.
the-atom-to-atom map.

Atom-to-Atom Mapping Searching for Reactants


In chemical structure fields, you can specify atom If you know what starting materials you are
interested in but do not know their products, you
maps. These maps can be used during searching to
might perform a reactants query. A reactants query
resolve certain type of structure hits.
is very similar to a reaction search, except that there
is nothing to the right of the arrow. For example,
Consider a simple esterification reaction:
consider the query:
O O
OH
O
H2 O
OH O

Does the ester oxygen come from the acid or the


alcohol? You specify the fate of individual atoms O
through an atom-to atom map. In reality, the ester
oxygen in this reaction originates in the alcohol, so
the atom-to-atom map looks like this:
O

3 3
If you are doing a substructure search, this finds any
O O
OH 6 reactions in which maleic anhydride or a compound
2
Rxn
5 2
5 H2O 4
containing a maleic anhydride substructure is
OH 4 O
consumed or transformed.
1 1 Rxn
6

622 Searching CambridgeSoft


Conducting a Search
Searching for Products 2. Then, either:

If you know the desired end product but not how Browse to the root collection over which
to get there, you can do a products query. A you wish to select OR
products query is similar to a reaction search, Click the Search button inside the search
except that there is nothing to the left of the arrow. location field to search for the root
For example, consider the query: collection.
The collection that appears at the top of the
Collection Tree in the search location field is
the collection over which your search will be
run. This root collection, all of its contained
collections, and all of the collections
referenced within it in the collection
If you are doing a substructure search, this finds any hierarchy will be included in the search.
reactions in which bicyclo[2.2.1]heptane or a
compound containing its substructure is produced. Searching with Collec-
Searching with the tion Attributes
Search Location Field You may search for collections and sections in
E-Notebook based on specific attributes, such as
The search location field makes it possible for you owner's name and creation date.
to select the specific branch of the collection tree
To conduct a search for collections:
over which your search is conducted.
1. While in Search mode, select Collections or
To use the search location field: Sections from the Search for drop-down list.

1. While in Search mode with a search form 2. If no form appears in the right frame, click the
displayed, click the Search In... checkbox to New Query icon.
activate the field. A menu appears.
3. Select Basic Query or Advanced Query.
An empty query form appears.
The Collection Tree appears. 4. If you would like to search by collection
attributes, select the checkboxes next to any
items you would like to include in the query.
Selecting a checkbox makes visible an area that
allows you to enter criteria.

Chem & BioOffice 2006 /E-Notebook Searching 623


Searching with the Search Location Field
Specify the collection attributes that will determine
the search results. The parameters you may enter Parameter Options
are:
State Name the contains
Administrator

Parameter Options name of the current


state of the Collec- is
tion. Examples are
Collection's contains starts with
Open and Closed.
Name the name
of the Collection is ends with.

starts with Each of these options can


be specified as of a certain
ends with date. For example, Closed
as of 2/1/2003 would return
Owner's Name contains the Collections that were in
the name of the the Closed state on
User who created is 2/1/2003.
the Collection.
starts with
Searching with the Prop-
ends with
erty Query and Table
Type the Collec- is Query Fields
tion type. Examples
is not The Property Query Field is used to search over
are Notebook,
property lists, and the Table Query field is used to
Folder, Experiment,
search over E-Notebook tables. These search fields
or Page.
are normally found in Advanced Section Query
forms.
Creation Date is
the date the Collec-
tion was created. is before

is after

Last Modified is
Date the date the is before
Collection was last is after
modified.

624 Searching CambridgeSoft


Searching with the Property Query and Table Query Fields
Adding Properties to the Removing Properties from
Field the Field
To remove a property from the field:
To add properties to a Property Query or Table
Query field: 1. Right-click the property you wish to remove.
A menu appears.
1. Right-click within the field.

A menu appears.

2. Select Remove Property.


You are prompted to confirm that you wish to
delete the property.
2. Select Add Property. 3. Click Yes.

The Add Property dialog appears, listing the The property is removed from the query field.
properties that appear in E-Notebook. If Search Options
properties are already present in the field, the
You may either search for an exact match, or use
list is filtered to display only those properties
one of the following options:
that share the same section type:
Wildcard searches for text properties:
Property Query field the properties that
If a property has a Data Type of text, you can
appear in E-Notebook property lists are conduct a contains search. Use the
displayed. percentage symbol as the wildcard. In the
example below, all of the Spectrum sections
Table Query field the properties that
where the Analyst name ends in Smith will be
appear in E-Notebook tables are displayed. returned.
3. Select the properties you wish to include in the
search. You may use SHIFT+click and
CTRL+click to select multiple properties.
If a property has a numerical Data Type, you
Make sure that all of the properties exist in the
can search for a range, as shown below:
same section type, or your search will return no
hits.

4. Click the Add button.


Other search options may be used with numerical
The properties appear in the search form. properties as well:

Chem & BioOffice 2006 /E-Notebook Searching 625


Searching with the Property Query and Table Query Fields
Greater than >30 returns all sections in If you enter text into the Query Text field and you
which the property is greater than 30 have specified no other search criteria in the search
form, all of the E-Notebook sections you have read
Less than <30 returns all sections in which
access to will be searched.
the property is less than 30
Administrator

The searches are not case sensitive.


Greater than or equal to >=30 returns all
sections in which the property is greater than
or equal to 30
Less than or equal to <=30 returns all A number of basic and advanced text searching
sections in which the property is less than or options are available to you:
equal to 30.
Basic Text Searching
If you enter units, the search will return all of the Advanced Text Searching
equivalent values entered in other units of the same
type. For example, a search for a volume of 500 mL Numerical properties in Property Lists and Tables
will return both 500 mL and 0.5L. can be searched, but only as text; that is, if you
perform a search for 500* you will find 500 g, 500
The search will assume the default units for the atm, etc.; you cannot search for a numerical range or
property if you do not enter units. Using the same perform a greater/less than search with the Query
example, if mL were the default unit for a volume Text field. Also, the advanced text searching
property, and a search were conducted for a options do not apply to Property Lists and Tables.
property value of 0.5, no hits would be returned. A Depending upon your database settings, text
search for 0.5 L would return both 500 mL and entered into MS Word fields and Styled Text
0.5 L.
fields may not be available for searching
immediately after it is entered. There may be a delay
Searching for Text with of several hours.
the Query Text Field Basic Text Searching
With the Query Text field, you can search for text You can use basic text searching, or querying, to
that is contained in the following E-Notebook find information in MS Word and Notes portions
fields: of E-Notebook. There are a number of special
characters used in basic text searching which will
Styled Text fields
help narrow or increase search results.
MS Word fields
Normally, the more narrow a search, the more
MS Excel fields precise the search results become, making it easier
to find the information you need. As a search
Stored document fields that are MS Word, MS
becomes broader, the number of hits in the search
Excel, or MS PowerPoint
results list becomes greater.
E-Notebook property lists
Different types of basic text searching are available.
E-Notebook tables See the following topics for more information:
Text in chemical structure fields Exact Phrase Matching

626 Searching CambridgeSoft


Searching for Text with the Query Text Field
Wildcard Searching
Searching For ... Returns ...
Exact Phrase Matching
*ethane any word with ethane as
If a search is meant to find only exact matches for
the last 6 letters in a docu-
the text entered, exact word or phrase matching
ments text. Matches
should be used. This is the most simple search, or
include ethane, and
query, that returns exactly the information
methane.
requested.
For example, the following searches really mean: Advanced Text Searching
Searching For ... Returns ... E-Notebook offers a number of advanced text
searching options for searching Notes and MS
thymidine synthesis the words thymidine Word documents in the application. Using specific
synthesis in that order, with operators in an advanced search allows you to
no words between them in narrow search parameters dramatically.
the text of a document.
Escape Characters
cyclohexane the word cyclohexane in
the text of a document. In order to perform a query over words or symbols
that have special meaning to query expressions,
such as & or |, you must escape them. There are two
Wildcard Searching ways to escape characters in a query expression,
using curly brackets {} or a backslash \.
If a prefix or a suffix for a word is either unknown
or variable, wildcard characters become useful in a
Curly Brackets {}
free test search to return all words with the same
word root. Wildcard characters can be used in a Use braces to escape a string of characters or
basic text search when searching for all documents symbols. Everything within a set of braces in
that contain a part of a word. This kind of search considered part of the escape sequence. When you
typically returns more matches to search criteria use braces to escape a single character, the escaped
than the exact phrase search. character becomes a separate token in the query.
For example, the following searches really mean: The following table has examples of how to use
curly brackets to escape an ampersand (&) and
a dash (-).
Searching For ... Returns ...

Instead of Use
synth* any word with synth as the
first 5 letters in a docu-
ments text. Matches AT&T {AT&T}
include synthesis,
synthetic, and syntheses. high-voltage {high-voltage}

Chem & BioOffice 2006 /E-Notebook Searching 627


Searching for Text with the Query Text Field
Backslash \ The ABOUT operator becomes very powerful when
Use the backslash character to escape a single coupled with other operators, such as AND or NOT.
character or symbol. Only the character For example, the following searches really mean:
immediately following the backslash is escaped.
Administrator

The following table has examples of how to use a


Searching For ... Returns ...
backslash to escape an ampersand (&) and a dash (-
).
ABOUT (carbon) any word with words
AND diamond related to carbon as well as
Instead of Use
the word diamond in the
documents text.
AT&T AT\&T
ABOUT (carbon) any word with words
high-voltage high\-voltage NOT ABOUT related to carbon but
(diamond) excluding the word
diamond in the docu-
ABOUT
ments text.
The ABOUT operator, when used in an advanced
text search, retrieves documents that contain
information related to a word or phrase. NOTE: For advanced Oracle users: The word or phrase
specified in an ABOUT query does not have to exactly
Use the ABOUT operator by entering the word
match the themes stored in the index. Oracle automatically
ABOUT in all capital letters followed by the word or
normalizes the word or phrase before performing lookup in
phrase on which to search in parentheses.
the Text index.
ABOUT searches are always case-sensitive. The text
string inside the parentheses is interpreted with
respect to case. AND (&)
The AND operator used in an advanced text search
For example, the following searches really mean:
finds documents that contain more than one word
or phrase. The AND operator is used to search for
Searching For ... Returns ... documents that contain at least one occurrence of
each of the query terms.
ABOUT (carbon) any word with words The AND operator is used by entering the first term,
related to carbon in the then the word AND in all capital letters (or entering
documents text. Matches the ampersand (& symbol)) followed by another
include coal and diamond. word or phrase on which to perform a search.

ABOUT (carbon by- any phrases with words


products from related to carbon by-
syntheses at 25 products from syntheses at
degrees Celsius) 25 degrees Celsius in the
documents text.

628 Searching CambridgeSoft


Searching for Text with the Query Text Field
For example, the following searches really mean: For example, the following searches really mean:

Searching For ... Returns ... Searching For ... Returns ...

carbon AND diamond both the words carbon, graphite EQUIV the words graphite or
and diamond, found diamond diamond found anywhere
anywhere within a docu- within a documents text.
ments text.
graphite = diamond the words graphite or
carbon & diamond both the words carbon, diamond found anywhere
and diamond, found within a documents text.
anywhere within a docu-
ments text. carbon the words carbon dioxide,
dioxide=monoxide carbon monoxide, or both
carbon & diamond & all the words carbon, terms found anywhere
graphite diamond, and graphite, within a documents text.
found anywhere within
a documents text.
NOTE: The EQUIValent operator has higher precedence
thymidine synthesis both the phrases thymi- than all other operators except the expansion operators
AND carbon dioxide dine synthesis, and (fuzzy, soundex, stem).
carbon dioxide, found
anywhere within a docu-
ments text. Fuzzy (?)
The fuzzy operator used in an advanced text search,
EQUIValence (=)
or query, will find documents that contain words
The EQUIValence operator used in an advanced text similar to the word used in a search. For example,
search, or query, will allow the user to find the fuzzy operator can be used to expand queries to
documents that contain information about words include words that are spelled similarly to the
that can be used in place of each other, alone or in specified term. This type of expansion is helpful for
a phrase. The EQUIValence operator is used to finding more accurate results when there are
specify an acceptable substitution for a word in a
frequent misspellings, or alternate spellings in the
query.
documents in the database.
The EQUIValence operator is used by, entering
EQUIV in all capital letters (or enter the equals sign The fuzzy operator is used by entering a question
(=)), followed by the phrase on which the search is mark (?), followed by the word on which to perform
to be performed. a search.

Chem & BioOffice 2006 /E-Notebook Searching 629


Searching for Text with the Query Text Field
For example, the following searches really mean: For example, the following searches really mean:

Searching For ... Returns ... Searching For ... Returns ...
Administrator

?boron any word spelled similarly carbon - diamond the words carbon and
to boron found anywhere diamond in them, but
within a documents text. documents with diamond
Matches include baron. are listed last.

?read any words spelled similarly carbon MINUS the words carbon and
to read found anywhere diamond diamond in them, but
within a documents text. documents with diamond
Matches include read, lead, are listed last.
and real.
diamond -carbon the words diamond and
?chemist any words spelled similarly carbon in them, but docu-
to chemist found anywhere ments with carbon are
within a documents text. listed last.
Matches include chemists
and chemistry.
NEAR
MINUS (-) The NEAR operator is used in an advanced text
The MINUS operator can be used in an advanced search, or query, to find documents that contain
text search, or query, to find documents that two phrases that are close together. The maximum
contain two phrases, with the first phrase taking distance between the two terms can be specified.
precedence. The MINUS operator is used to search
for documents that contain two query terms, but The NEAR operator is used by entering the first
documents containing the second term will ranked term, followed by NEAR in all capital letters (or
lower than documents without the second term. enter a semicolon (;)), followed by the second term
The MINUS operator is useful for lowering the on which the search is to be performed.
score of documents that contain a certain term,
without eliminating those documents. Use the NEAR operator to return documents based
The MINUS operator is used by, entering the first on the proximity of two or more query terms.
term, then MINUS in all capital letters (or enter the
minus sign or hyphen (-)), followed by another term NOTE: NEAR cannot be used in ABOUT queries.
on which to perform a search.

630 Searching CambridgeSoft


Searching for Text with the Query Text Field
For example, the following searches really mean:
Searching For ... Returns ...
Searching For ... Returns ...
NEAR ((carbon, the words carbon,
diamond), 10) AND diamond, and benzene in
carbon NEAR the words carbon and
benzene them, but only when
diamond diamond in them, but
carbon and diamond
only when they appear
appear less than 10 words
less than 100 words apart
apart and in no specific
and in no specific order.
order.
NEAR uses the following defaults:
NEAR ((carbon, the words carbon,
Search terms are found if they are 100 words diamond = diamond, and graphite in
apart or less, unless specified otherwise. Use graphite), 10) them, but only when
whole numbers between 1 and 100. carbon and diamond or
Search terms are found in any order, specified carbon and graphite appear
otherwise. Use TRUE or FALSE. less than 10 words apart
The NEAR operator can be used with other and in no specific order.
operators, such as AND, OR, and EQUIValence.
For example, the following searches really mean: NOT (~)
The NOT operator can be used in an advanced text
Searching For ... Returns ... search, or query, to find documents that contain a
word or phrase, but only when it appears without a
second word or phrase. The NOT operator is used
NEAR ((carbon, the words carbon and by, entering the term to be found, followed by the
diamond), 20, diamond in them, less than word NOT in all capital letters (or enter a tilde (~)),
FALSE) 20 words apart, in no followed by the term to be excluded in the search.
specific order.
Use the NOT operator to search for documents that
contain one query term and not another.
NEAR ((carbon, the words carbon and
diamond), 20, diamond in them, less than
TRUE) 20 words apart, in this
specific order.

Chem & BioOffice 2006 /E-Notebook Searching 631


Searching for Text with the Query Text Field
For example, the following searches really mean: For example, the following searches really mean:

Searching For ... Returns ... Searching For ... Returns ...
Administrator

carbon NOT the word carbon, but not carbon OR diamond the words carbon,
diamond the word diamond diamond, or both anywhere
anywhere in the docu- in the documents text.
ments text.
carbon | diamond the words carbon,
carbon ~ diamond the word carbon, but not diamond, or both anywhere
the word diamond in the documents text.
anywhere in the docu-
ments text. carbon OR diamond the words carbon,
OR graphite diamond, graphite, or any
carbon NOT the word carbon, but not combination of the terms
(diamond OR the word diamond or anywhere in the docu-
graphite) graphite anywhere in the ments text
documents text.
thymidine synthesis the words thymidine
OR carbon dioxide synthesis, carbon dioxide,
NOTE: The NOT operator does not affect other logical or both terms anywhere in
operators. the documents text.

OR (|) Soundex (!)


The OR operator can be used in an advanced text The soundex operator is used in an advanced text
search, or query, to find documents that contain search, or query, to find documents that contain
information about any words in the query, but not words that sound like the word used in a search.
necessarily all words in the query. The OR operator The soundex operator is used by, entering an
is used by, entering the first term, followed by the exclamation point (!), followed by the word on
word OR in all capital letters (or enter the pipe (|)), which to perform a search.
followed by another term on which the search is to
be performed. Use the soundex (!) operator to expand queries to
include words that have similar sounds; that is,
Use the OR operator to search for documents that words that sound like other words. This function
contain at least one occurrence of any of the query allows comparison of words that are spelled
terms. differently, but sound alike in English.

632 Searching CambridgeSoft


Searching for Text with the Query Text Field
For example, the following searches really mean: Use the stem operator to search for terms that have
the same linguistic root as the query term. Stem
Searching For ... Returns ... expands a query to include all terms with the same
stem or root word as the search term.
!carben any words that sound like For example, the following searches really mean:
the word carben in a docu-
ments text. Matches Searching For ... Returns ...
include carbon and
carboxylic.
$commit any words with the root
commit found in the docu-
?read any words that sound like ments text. Matches
the word read in a docu- include commits, commit-
ments text. Matches ting, committee, and
include read and lead. committed.

$chemist any words with the root


Stem ($)
chemist found in the docu-
The stem operator is used in an advanced text ments text. Matches
search, or query, to find documents that contain include chemist, chemistry,
words similar to the word used in a search. When and chemists in them.
the stem operator is used, enter a dollar sign ($),
followed by the word on which to perform a search.

Chem & BioOffice 2006 /E-Notebook Searching 633


Searching for Text with the Query Text Field
Administrator

634 Searching CambridgeSoft


Searching for Text with the Query Text Field
Chapter 33: Introducing Enterprise

CombiChem for E-Notebook


With the introduction of CombiChem, it is now Configurable data sections as with all
possible for you to set up and manage E-Notebook sections, the configuration of
combinatorial chemistry libraries in E-Notebook. CombiChem sections may be modified easily
You can set up a generic reaction, add reactants, and so that your data is presented in the most effec-
automatically enumerate the products. tive manner.
See the following topics:
Features include:
Setting up the Generic Reaction
Data import/export import reactants from Managing CombiChem Reactants
an SD file or other chemical database, and Enumerating and Managing CombiChem
CombiChem will scan the database for reac- Products
tants that match generic Using the CombiChem Navigator and Struc-
components. CombiChem also allows you to ture Window
export enumerated products to an SD file.
Managing Plate Layout and Structure Palette
Select reaction sites when more than one Settings
reaction site is possible, you can select which CombiChem is sold as a separate, E-Notebook add-
reaction sites you would like to include in the in feature, and may not be available in your
product enumeration process. configuration of E-Notebook.
Automatic stoichiometry calculations Setting up the Generic
When you enumerate products in
CombiChem, you can automatically populate Reaction
the stoichiometry grid for each individual reac- In a CombiChem Library, you may either add a new
tion. generic reaction, or prepare a reaction from an
existing experiment.
Flexible plate handling you can determine
the plate size, location of blanks, and grouping
Adding a Generic Reaction
order of reactants in the plate.
CombiChem is a reaction-based combinatorial
Navigator and structure palettes you can product. You first enter a reaction template with R-
browse through CombiChem easily. Clicking a groups at the variable sites in your starting
location in the CombiChem Navigator materials, then search for reactants based on these
displays the reaction components in that loca- structures. CombiChem puts your final product
tion. With the structure palette, you can scroll structures together and creates a virtual library. All
through the corresponding structures of reac- sites of variability require unique R-group
tants and products. designations.

Chem & BioOffice 2006 /E-Notebook Introducing CombiChem for E-Notebook 635
Setting up the Generic Reaction
An example of a reaction that CombiChem To view the generic components of the reaction,
supports is shown below: click the Components tab.

H2 N
R4 R3 R4 The display changes to show one of the generic
NH R3
components of the reaction.
Administrator

R3 NH
R2 NH

R4 R2

R2

R1
R1 R1

To add a generic reaction to a CombiChem Library:


1. From a CombiChem Library section, click
Reaction in the CombiChem menu.
To view a particular component, select it from the
dropdown list.
To return to the generic reaction, click the Reaction
tab that is next to the Components tab.
2. Select Edit Reaction.
Preparing a Reaction from
The Edit Structure window, a ChemDraw
window, appears.
an Existing Experiment
3. Either draw the reaction in the window, or
CombiChem makes it possible for you to prepare a
right-click within the window and select File, generic reaction from an existing experiment.
then Open, to open an existing reaction file. When you select this option, the generic products
of the existing reaction become the generic
4. Click OK when you have finished editing the reactants of the new experiment.
reaction.
To prepare a generic reaction from an existing
The Edit Structure window closes and the
experiment:
reaction appears in E-Notebook.
1. From a CombiChem Library section, click
Reaction in the CombiChem menu.

2. Select Prepare from Existing Experiment.

636 Introducing CombiChem for E-Notebook CambridgeSoft


Setting up the Generic Reaction
The Select Experiment dialog appears, with Importing Reactants from a Chemical
the Collection Tree displayed in the left frame. Database
To add reactants to a CombiChem Library from a
chemical database:

1. From a CombiChem Library section, click


Reactants in the CombiChem menu.

The Reactants menu appears


3. Click the experiment to select it in the Collec-
tion Tree, then click the Select button. 2. Select Import Reactants.

The generic products of the reaction you The Import Reactants dialog appears, and
selected appear in the reaction field. you are prompted to select the generic
component that will be matched against the
See Adding a Generic Reaction on page 635 for chemical database.
instructions on how to edit the reaction.

Managing CombiChem
Reactants
This portion of the CombiChem guide provides
instructions for managing reactants in CombiChem O
- adding and editing reactants, and specifying
reaction sites for the product enumeration process.
R1

Adding Reactants from a


Chemical Database
After you have added a generic reaction, you may
either add reactants from a chemical database, or
draw them using the ChemDraw tools. The source 3. Select the component to be matched from the
of the reactants can be a ChemFinder database or dropdown list, and click OK.
any other datasource that can export MDL SDFiles.
The Open Chemical Structures dialog
(To create an SDFile from ChemFinder, you can
appears, and you are prompted to select the
simply select the Export command from the File
database file to be scanned for matches.
menu after you have run a ChemFinder query to
find the reactants you wish to include in the file). 4. Select the file and click Open.

Chem & BioOffice 2006 /E-Notebook Introducing CombiChem for E-Notebook 637
Managing CombiChem Reactants
The file you selected is scanned for structures The Add Reactant dialog appears, as shown
that match the generic reactant. The matches below.
are imported into E-Notebook. Each imported
reactant appears as a subsection within the
Administrator

Reactants section.

5. Use the scroll bar to scroll through the reac-


tants:

displays the first reactant

3. In the left frame, select a generic reactant from


displays the previous reactant the dropdown list.
The correct generic reactant appears in the left
displays the next reactant frame.
4. Using the navigator to the right, click a location
displays the last reactant for the reactant to select that location.
5. Select an Add Option:
You may also browse to a particular reactant by
right-clicking the scroll bar and selecting Go To Insert After inserts the reactant after the
Section. selected reactant (to the the right of the
selected reactant in the plate).
Insert Before inserts the reactant before
the selected reactant (to the left of the
selected reactant in the plate).
Overwrite replaces the reactant in the
selected location.
6. Click OK.
Adding Reactants Manually
The Edit Reactant Structure dialog appears.
In addition to adding reactants from a chemical 7. Draw the reactant or open a structure file.
database, you may add the reactants manually.
8. Click OK.
To add reactants manually: CombiChem performs a check to ensure that the
reactant matches the generic component you
1. From a CombiChem Library section, click
selected. If it does not match, a message is displayed
Reactants in the CombiChem menu.
to that effect, and you are prompted to change the
The Reactants menu appears. drawing. If it does match, the Add Reactant dialog
closes, and the reactant appears as a new subsection
2. Select Add Reactant. in the CombiChem library.

638 Introducing CombiChem for E-Notebook CambridgeSoft


Managing CombiChem Reactants
Checking Reaction Sites By default, all of the possible reaction sites will
be used in the product enumeration process. If
When a reactant has more than one possible there are certain reaction sites you do not want
reaction site, CombiChem makes it possible to to use in the enumeration process, click the Use
choose which site(s) participate in the product checkbox to deselect the site.
enumeration process, and which do not. 4. Click OK to close the Check Reactants dialog.

To check and select reaction sites: Editing Reactants


1. From a CombiChem Library section, click Once you have added reactants to a CombiChem
Reactants in the CombiChem menu. Library, either manually or from a chemical
database, you may edit their structures.
The Reactants menu appears.
To edit the structure of a reactant in a CombiChem
Library:
1. In a a CombiChem Library section, click the
Reactants tab.
2. Use the scroll bar or the Navigator to select the
reactant you wish to modify.
The reactant section you wish to modify
appears.
3. Click Reactants in the CombiChem menu.
The Reactants menu appears.
2. Select Check Reaction Sites.

The Check Reactants dialog appears. If there


are multiple matching reaction sites, a message
appears to that effect. The different reaction
sites appear in tabs.
4. Select Edit Current Reactant.
The Edit Structure dialog appears, and you
may use the ChemDraw toolbar to edit the
structure.
5. Make your edits, and click OK.
CombiChem performs a check to ensure that the
reactant matches the generic component you
selected. If it does not match, a message is displayed
to that effect, and you are prompted to change the
drawing. If it does match, the Edit Structure dialog
3. Click the numbered tabs to the right in order to closes, and the modified structure appears in the
view the different reaction sites. CombiChem library.

Chem & BioOffice 2006 /E-Notebook Introducing CombiChem for E-Notebook 639
Managing CombiChem Reactants
Removing Reactants from a 1. Click Reactants in the CombiChem menu.

CombiChem Library The Reactants menu appears.


2. Select Remove All Reactants.
After you have added reactants to a CombiChem
Administrator

Library, you may delete them. You have the option A message appears, stating that the action will
to remove a selected reactant from the CombiChem remove all reactants and invalidate all products
Library or to remove all of the reactants at once. already enumerated.
3. Click OK to proceed.
Removing a Selected Reactant All of the reactants are removed from the
To remove a selected reactant from the CombiChem Library.
CombiChem Library:
Enumerating and
1. In a CombiChem Library section, browse to
the reactant you wish to remove.
Managing CombiChem
The reactant appears.
Products
2. Click Reactants in the CombiChem menu. Once you have added reactants to a CombiChem
library, you can set up a template to be used for the
The Reactants menu appears. enumerated products. Then, you can enumerate the
products, either enumerating all possible products,
or only selected products.

Working with the Enumera-


tion Template
Before enumerating the products of a generic
reaction, you must create an Enumeration
Template, which specifies the layout and content of
the form for each enumerated product. You may
either create a template to display the reactions and
3. Select Remove Current Reactant.
their corresponding stoichiometry grids, or you
A message appears, prompting you to confirm may create a template to display the structure and
that you wish to remove the reactant. properties of the product.
4. Click OK to confirm.
Creating an Enumeration Template
The reactant is removed from the CombiChem
To create the enumeration template:
Library,
1. From a CombiChem Library section, click the
Removing All Reactants from a Products section.
CombiChem Library The Products section appears
To remove all of the reactants from a CombiChem 2. From a CombiChem Library section, click
Library: Products in the CombiChem menu.

640 Introducing CombiChem for E-Notebook CambridgeSoft


Enumerating and Managing CombiChem Products
The Products menu appears. Once you have created the enumeration template,
you may enumerate products of the reaction. If you
would like to apply different settings to different
wells, you can set up an enumeration template, then
use the Enumerate Selection feature to enumerate
only selected wells. Then, you can set up another
enumeration template, and enumerate a different
selection of wells. Each time you enumerate a
selection, the template settings will be applied to
3. Select Create Enumeration Template. each product that is enumerated.
The Select Product Template Type dialog
appears, and prompts you to select the type of Showing an Enumeration Template
template. In the example below, you may select To view the current enumeration template:
either:
1. From a CombiChem Library section, click
Parallel or Small Array displays each Products in the CombiChem menu.
enumerated product in a reaction that also
The Products menu appears
shows the reactants.
2. Select Show Enumeration Template.
Larger Array displays each enumerated
product as a structure; the output structure The Enumeration Template appears.
template does not display the reactants in
the drawing. Updating an Enumeration Template
If you wish to edit the current Enumeration
Template:
1. From a CombiChem Library section, click
Products in the CombiChem menu.
The Products menu appears.
2. Select Update Enumeration Template.
The Enumeration Template appears, and you
may edit it as desired.

4. Click the type of template you desire to select, Removing an Enumeration Template
and click OK.
If you wish to remove the current Enumeration
The template appears in the Products section Template to, for example, replace it with a new
of the CombiChem Library. Enumeration Template:
5. Add any information you wish to the template. 1. From a CombiChem Library section, click
This may be reaction properties, etc. The infor- Products in the CombiChem menu.
mation you enter will appear in the output
section for each product you enumerate with The Products menu appears.
this template. 2. Select Remove Enumeration Template.

Chem & BioOffice 2006 /E-Notebook Introducing CombiChem for E-Notebook 641
Enumerating and Managing CombiChem Products
The Enumeration Template is removed from 1. Click the Navigator button.
the CombiChem Library.
The navigator appears.

Enumerating Products 2. Using your mouse, highlight the locations


Administrator

representing the products you wish to


When you enumerate the products of the generic enumerate. You do this by clicking the first
reaction, you may either enumerate all possible location in the range, then dragging your
products, or only a selection of the products. mouse to select the entire range. Or, you may
use Ctrl+click to select multiple locations that
Enumerating All of the Products of a are not contiguous.
Generic Reaction
3. Right-click your selection, and choose
To enumerate all of the products for a reaction: Enumerate Selection from the menu that
appears.
1. From a CombiChem Library section, click
Products in the CombiChem menu.

The Products menu appears

2. Select Enumerate All.

The Enumerating Products dialog appears,


showing the progress of the enumeration.
The selected products are enumerated, and
When the enumeration is complete, each product appear in the Products section. (In this
appears as a subsection in the Products tab. example, the products corresponding to
columns 1 and 2 will be enumerated).
You may scroll through the products to view them.
Depending upon your enumeration template, the
products will either be displayed as structures or
Exporting Products to an SD
displayed in reactions. If they are displayed in File
reactions, the stoichiometry grid will be populated
for each individual reaction. CombiChem makes it possible for you to export
products to an SD file, which you may then import
If, in the enumeration process, the number of into ChemFinder.
products exceeds the number of wells in the
product plate, additional plates will be generated. To export products to an SD file:

1. From a CombiChem Library section, click the


Enumerating Selected Products of a
Products tab to select it.
Generic Reaction
The Products tab appears.
To enumerate only selected products of the
reaction: 2. Click Products in the CombiChem menu.

642 Introducing CombiChem for E-Notebook CambridgeSoft


Enumerating and Managing CombiChem Products
The Products menu appears. A message appears, stating that the action will
irrevocably remove all enumerated products,
and asking you to confirm that you wish to
remove them.
4. Click Yes to confirm.
The products are removed from the
CombiChem Library.

Using the CombiChem


Navigator and Structure
Window
The CombiChem Navigator represents a plate, and
can be used as a tool to browse through the
3. Select Export to SD File. reactants and products in CombiChem. When a
location is selected in the CombiChem Navigator,
A dialog appears, and you are prompted to the CombiChem Structure Window displays the
enter a name and location for the file. components of the reaction in that location.
4. Enter the name and location and click Save.
The products are exported to the SD File. The
file may be opened with ChemFinder.
You may also open the file with ChemFinder for
Excel, which is useful for viewing and printing the
products.

Removing Products from a Both the Navigator and the Structure Window can
CombiChem Library be viewed either in a docked position on the screen
or as floating palettes.
After you have enumerated products in a
CombiChem Library, you may remove them from Using the CombiChem Navi-
the library.
gator
To remove the products from a CombiChem
Library: CombiChem offers a color-coded Navigator palette
that represents a plate. When you are viewing the
1. In a CombiChem Library section, click the Products portion of a CombiChem library, each
Products tab to select it. location or well in the Navigator represents an
The products tab appears. individual reaction. Selecting a well makes it
possible for you to view the reaction components
2. Click Products in the CombiChem menu.
that correspond to that well. Thus, by clicking
The Products menu appears. locations in the Navigator, you can browse through
3. Select Remove Products. the reactions/products in the CombiChem library.

Chem & BioOffice 2006 /E-Notebook Introducing CombiChem for E-Notebook 643
Using the CombiChem Navigator and Structure Window
At the base of the navigator, there is a tab for each there are seven, individual structures corresponding
generic reactant, and a tab for enumerated to the second generic component. Again, each
products. Clicking a tab displays the locations of the structure is denoted with a unique color.
corresponding component in the plate. Each
Administrator

unique reactant or product is denoted with a unique


color.

In addition to the Navigator, CombiChem provides


a structure palette, which displays the structures of
the reactants and products in a well. When you click
a particular well in the navigator and the structure
palette is displayed, the structure palette will change Clicking the P1 tab displays the enumerated
to display the structures in the well you selected. See products of the reaction. In this example, there are
Using the Structure Window on page 646 for ninety one(13 C1 * 7 C2)one for each unique
more information. combination of the reactants.
When you are viewing the Reactants portion of a
CombiChem library, the Navigator changes to
display the reactants plate, and allows you to browse
through the individual reactants.

Using the Navigator when in Products


Mode
To display any one of the enumerated
Below, the Products section of a CombiChem products/reactions, simply click the well
Library is shown. The products have already been corresponding to the reaction in the Navigator.
enumerated. Clicking the C1 tab in the Navigator
displays the plate locations of the reactants that The displayed section changes to reflect your
match C1, the first generic component of the choice.
reaction. In this example, you can see that there are
thirteen separate structures corresponding to the
first generic component. Each structure is denoted Using the Navigator in Reactants Mode
with a unique color.
In addition to using the Navigator to browse
through products/reactions when in Products
mode, you may use the Navigator when in
Reactants mode. The plate in this case may
represent the locations of the reactant stocks that
are used to fill the product/reaction plate.

Below, the Reactants section of the same


Clicking the C2 tab in the Navigator displays the CombiChem library is shown. The tab for C1,
locations of the reactants that match C2, the second corresponding to the first generic reactant, is
generic component of the reaction. In this example, displayed. Click any of the locations in the

644 Introducing CombiChem for E-Notebook CambridgeSoft


Using the CombiChem Navigator and Structure Window
Navigator to view the corresponding structure that When the CombiChem Navigator is docked, you
matches C1. For example, clicking position A2 in use the Navigator button to display it. To view the
the Navigator displays the second C1 reactant. CombiChem Navigator when it is docked,
From the Reactants or Products section in a
CombiChem Library, move your cursor until it is
over the Navigator button.
The Navigator appears, sliding out from its dock.
To hide the docked the navigator, simply move your
cursor to an area of the screen that is outside of the
Clicking the location A7 in the navigator displays Navigator, and the Navigator will slide into its dock
the second structure that matches C1: again.

Viewing the Navigator as a Floating


Palette
To remove the Navigator from its dock and view it
as a floating palette, as shown below.

1. If the Navigator is not already visible, move


To view the reactants that match the second generic your cursor over the Navigator button, so that
component of the reaction, click the C2 tab. Then, the Navigator becomes visible and slides out
click any of the locations in the Navigator to view from its dock.
the corresponding structure that matches generic
2. Click the docking button in the upper
component C2.
right corner of the Navigator palette.
The appearance of the docking button changes
to indicate that the Navigator is no longer
docked.
3. Drag the Navigator to any place on the screen.
The Navigator appears in the new location
You may also resize the Navigator for more
Viewing and Hiding the Docked favorable viewing. (To do this, move your cursor to
CombiChem Navigator the edge of the Navigator until it appears as a
double-headed arrow, then drag your mouse to
You have the option to either view the navigator resize the Navigator).
palette in a docked position or in a floating position,
depending upon your viewing preference. Initially, Docking the Navigator at Another Loca-
the Navigator is docked, but you may remove it
tion
from its dock and relocate it to any area on the
CombiChem screen. This allows you to customize You may also dock the navigator elsewhere, such as
the appearance of your CombiChem library. at the top or bottom of the section. To do this

Chem & BioOffice 2006 /E-Notebook Introducing CombiChem for E-Notebook 645
Using the CombiChem Navigator and Structure Window
1. View the Navigator as a floating palette. This 1. From the Products section in a CombiChem
may require releasing the Navigator from its Library, click a location in the Navigator to
dock, as described above. select it.

The reaction or product corresponding to that


Administrator

2. Drag the Navigator toward a boundary of the


section. well is displayed.

2. Move your cursor until it is over the Structure


As you drag the Navigator a gray rectangle
button. (The button may be either vertically or
appears to show you what the new location will
horizontally oriented).
be if you release the mouse at that point.
The Structure Window appears, sliding out
3. Drag the Navigator until the gray rectangle from its dock.
expands to the width or length of the section.
This should happen when your cursor is posi- 3. Use the scrollbar at the base of the Structure
tion over an edge or corner of the section. Window to scroll through the reactants and
product in the well.
4. Release the mouse.
4. To hide the docked Structure Window, simply
The Navigator is docked at the new location. move your cursor to an area of the screen that
is outside of the Structure Window, and the
If you copy the Structure palette on top of the Structure Window will slide into its dock again.
Navigator, a button for each palette will appear,
allowing you to switch back and forth between the In the example shown below, the Navigator is
displayed in the upper left. The well at location C 4
two palettes.
is selected. The reaction corresponding to this well
is shown to the right. In the lower left, the Structure
Using the Structure Window Window displays the structure that matches the first
generic component of this reaction.
When you select a location in the CombiChem
Navigator, the CombiChem Structure Window
displays the structures that participate in that TIP: The color of the reactant in the Navigator and the
Structure Window are the same.
reaction. You may use the scroll bar to scroll
through the reactants and enumerated products in
that well.

Viewing and Hiding the Docked


CombiChem Structure Window
When the CombiChem Structure Window is
docked, you use the Structure button to display it.

To view the CombiChem Structure Window when


it is docked:

646 Introducing CombiChem for E-Notebook CambridgeSoft


Using the CombiChem Navigator and Structure Window
Scrolling one position to the right using the scroll Viewing the Structure Window as a
bar at the base on the Structure Window displays Floating Palette
the reactant in this well that matches C2, the second
generic component of the reaction. As with the Navigator palette, you have the option
to either view the Structure Window in a docked
position or in a floating position, depending upon
your preference. Initially, the Structure Window is
docked, but you may remove it from its dock and
relocate it to any area on the CombiChem screen.
This allows you to customize the appearance of
your CombiChem library.
To remove the Structure Window from its dock and
view it as a floating palette, as shown below.
1. If the Structure Window is not already visible,
move your cursor over the Structure Window
button, so that the Structure Window becomes
visible and slides out from its dock.
Scrolling to the right once more displays the 2. Click the docking button in the upper
product of the reaction in this well. right corner of the Structure Window.
The appearance of the docking button changes
NOTE: The selected tab in the Navigator does not change to indicate that the Structure Window is
automatically to reflect the component you are viewing in the no longer docked.
Structure Window. 3. Drag the Structure Window to any place on the
screen.
The Structure Window appears in the new
location
You may also resize the Structure Window for more
favorable viewing. To do this:
1. Move your cursor to the edge of the Structure
Window until it appears as a double-headed
arrow,.
2. Drag your mouse to resize the Structure
Window.

Docking the Structure Window at


Another Location
You may also dock the Structure Window
elsewhere, such as at the top or bottom of the
section. To do this:

Chem & BioOffice 2006 /E-Notebook Introducing CombiChem for E-Notebook 647
Using the CombiChem Navigator and Structure Window
1. View the Structure Window as a floating Editing Structure Palette
palette. This may require releasing the
Display Settings
Structure Window from its dock, as described
above. You can modify the settings for the structure palette
Administrator

that is used in a CombiChem library. The settings


2. Drag the Structure Window toward a boundary you apply will only be visible in the structure
of the section. window of the CombiChem Navigator.
As you drag the Structure Window, a gray To do this:
rectangle appears to show you what the new
location will be if you release the mouse at that 1. From a CombiChem library, click Tools in the
menu.
point.
The Tools menu appears.
3. Drag the Structure Window until the gray rect-
angle expands to the width or length of the
section. This should happen when your cursor
is positioned over the edge or corner of the
section.

4. Release the mouse. 2. Select Edit Structure Palette Display Settings.

The Edit Display Settings dialog appears. It


The Structure Window is docked at the new
contains a ChemDraw field.
location.
3. Right-click within the ChemDraw field to
If you drag the Structure Window on top of the display the ChemDraw menu.
Navigator, a button for each palette will appear, The menu is displayed.
allowing you to switch back and forth between the
two palettes. 4. Select File, and Apply Document Settings From.

5. Select the source for the settings from the list


Managing Plate Layout that appears, or select Other to choose another
file.
and Structure Palette 6. Click OK to close the Edit Display Setting
Settings dialog.

The CombiChem library has a number of settings Editing Reactant Layout


that you can modify in order to present your data Settings
accurately and effectively. You can modify the
layout of reactants and products in a plate. You can You can modify the layout of reactant plates in
also modify the naming and numbering schemes for CombiChem. When the Reactants tab is selected in
the CombiChem Library, the Navigator will display
enumerated products. In addition, CombiChem
the layout that you have configured.
makes it possible for you to modify the way that
structures are displayed in the library. To do this:

648 Introducing CombiChem for E-Notebook CambridgeSoft


Managing Plate Layout and Structure Palette Settings
1. From a CombiChem Library, click Tools in the Columns the number of columns in the
menu. plate.
The Tools menu appears. Rows the number of rows in the plate.
Fill Direction the direction in which the
plate is populated with the structures that
match this component.
5. Click another tab if you wish to modify the
2. Select Edit Reactant Layout Settings. layout of another component.
The Reactant Layout dialog appears. 6. Click OK to close the dialog.

Editing Product Layout


Settings
You can modify the layout of the product/reaction
plate in CombiChem, changing the size of the plate,
the grouping order of components, and specifying
which wells are to remain empty.
When the Products tab is selected in the
CombiChem Library, the Navigator will display the
layout that you have configured.
To edit the product layout settings:
1. From a CombiChem library, click Tools in the
menu.
The Tools menu appears.

3. Click the tab corresponding to the generic


reactant whose layout you wish to change. In
this example, C1 is selected.
4. You may modify the following information: 2. Select Edit Product Layout Settings.

Chem & BioOffice 2006 /E-Notebook Introducing CombiChem for E-Notebook 649
Managing Plate Layout and Structure Palette Settings
The Product Layout dialog appears, open to 2. Right-click your selection, and select Disable
the Design tab. Selection from the context menu.
Administrator

Specifying Empty Wells in the Plate The Xs are removed from the wells, leaving the
wells blank:
You can specify which wells are to be left blank in
the plate. To do this,
1. Use your mouse to select the wells you would
like to be empty. You may do this by:
Clicking the first well you are selecting and
dragging your mouse to the last well, OR
Clicking a column header or row number to
select an entire column or row. You may use
CTRL+click to select multiple columns or
rows.

Alternatively, you may click each well individually to


disable it.

Changing the Size of the Plate


To change the size of the product/reaction plate:

In the Product Layout dialog, type in new


values for the Column Count and Row Count.

650 Introducing CombiChem for E-Notebook CambridgeSoft


Managing Plate Layout and Structure Palette Settings
The plate layout changes to reflect the new The Set Product Grid Options dialog
values. appears.

Changing the Grouping Order


You can change the order in which components are
laid out in the product/reaction plate. By default,
the first generic component is filled into the plate
with a horizontal fill direction, from left to right; the
second generic component is laid out vertically,
within the array of the first component.
3. Mouse over any of the values to view its
1. In the Product Layout dialog, select the first description. You may modify any of the
component to be laid out in the plate from the following:
dropdown list. Grid First Serial Number the number that
is assigned to the first product/reaction plate.
2. Select the Fill Direction for the component The default value is 0001. (Note that there may
from the dropdown list. be multiple plates in a library if, during the
enumeration process, the number of products
The next component will automatically assume the exceeds the number of locations in the grid).
fill direction that is perpendicular to your selection.
Grid Name Format the format for the
name of the grid.
Setting Product Grid Options &P represents the collection name
&S represents the serial number
You can modify the settings that determine how
products are named and numbered in a In the example above, the name of the
CombiChem Library. collection is CombiChem-Notebook-009
and the serial number is 0001. Hence, the
1. To do this: grid name is CombiChem Notebook-009-
0001
From a CombiChem library, click Tools in the menu. Product Location ID Format the format
for the ID of the product location.
The Tools menu appears.
&R row number
&c column number. Use a lower case
letter for this value.
In the example above, the product location is
row number followed by column number.
So, the product in the first column and
2. Select Set Product Grid Options. second row would be B1; the product in the

Chem & BioOffice 2006 /E-Notebook Introducing CombiChem for E-Notebook 651
Managing Plate Layout and Structure Palette Settings
fourth column and third row would be C4, In the example above, the product name is
etc. (This assumes that the rows and columns the grid name followed by the product
have not been rearranged in the plate). location ID. Thus, the name for the product
Product Name Format the format for the in location A1 is CombiChem Notebook-
Administrator

name of the product. 009-0001-A1.


&G grid name (as specified in the grid
4. Click OK to close the dialog and save your
name format)
changes.
&W product location ID (as specified in
the product location ID format).

652 Introducing CombiChem for E-Notebook CambridgeSoft


Managing Plate Layout and Structure Palette Settings
Chapter 34: Miscellaneous Topics
This portion of the guide provides a description of Alternatively, click Tools from the menu bar at
the following features:. the top in the window and select Session
Manager.....
Using the Session Manager

Refreshing E-Notebook

Viewing User Information

Using the Session


Manager The Session Manager appears.

In certain situations, an E-Notebook session may


be left open. With the Session Manager, you can
end your old session, and release any collection that
may be locked by it.

To access the Session Manager,

1. Right-click within a blank portion of the


Collection Tree.

A menu appears:

This dialog shows the Users, Session numbers,


and Start Times for each current session.

Ending a Session
If you wish to end a session:

1. Click the session in the list.

The session is highlighted.

2. Select Session Manager.... 2. Click the End Session button.

Chem & BioOffice 2006 /E-Notebook Miscellaneous Topics 653


Using the Session Manager
A message appears, asking you to confirm that To do this:
you wish to end the session.
1. Click Browse.
2. Right-click a blank space in the Collection Tree.
Administrator

3. Click Yes.

The session is ended. Any record that was


locked by the session is released.

NOTE: You must have Full Control permission over


your home collection (your user collection) to end your
sessions. A menu appears.
3. Select User Info....

Refreshing E-Notebook The User Properties dialog box appears. It


contains the following information:
If other users add information to E-Notebook, you
may need to refresh your view of E-Notebook so
that you can see their changes. To refresh
E-Notebook:

1. Click Browse.

The Collection Tree appears.

2. Right-click any blank area in the Collections


Tree. Login ID the Login ID of the user who is
currently logged into E-Notebook.
A menu appears.
Password Depending upon the type of login
3. Select Refresh. authentication your system uses, this field may
be used to change the password for the logged-
E-Notebook information is updated. in user.
Administrator a checkbox that indicates
Viewing User Informa- whether the user has administrative privileges.
tion NOTE: This checkbox is only visible if the logged-in
user is an administrator.
You can see specific information about the
user who is currently logged into E-Notebook.

654 Miscellaneous Topics CambridgeSoft


Refreshing E-Notebook
Chapter 35: Managing Section Types
and Forms
Section types are used for displaying and managing Once you have configured the form, you create an
data in E-Notebook. Each section type has a export template, which allows users to print
single form associated with it; this form appears in sections of this type, and to export them to MS
the right frame when a section type is selected in the Word.
Collection Tree.
See the following topics for more information:
Creating a New Section Type on page 655.
Managing Fields within a Section Type on
page 656.
Managing Form Tools on page 658.
Managing Section Listeners on page 663.
Configuring a Form on page 666.
Managing Export Templates for Section
Types on page 677.
Managing Summary Fields in a Table of
To set up a section type, you add fields, form tools, Contents on page 657.
and section listeners. Then, you configure the fields
and form tools to create the form. You may also
Creating a New Section
specify a summary field for a table of contents. The Type
Section Type Configuration dialog is shown
below. A section type defines an E-Notebook data section
or search section. A section type is composed of
fields, form tools, section listeners, and an export
template.
To create a new section type,
1. In the Collection Tree, right-click the folder or
collection into which you are adding the
section type.
The Collection menu appears.

Chem & BioOffice 2006 /E-Notebook Managing Section Types and Forms 655
Creating a New Section Type
2. Select New, then Section Type. Managing Summary Fields in a Table of
Contents on page 657.

Managing Fields within


Administrator

a Section Type
You can add fields to a section type, and use them
to create a form and an export template. You can
also specify which field will appear in the table of
contents of a container collection. See the following
topics for more information:
Adding a Field to a Section Type on page
A new section type appears in the Collection Tree; 656.
its blank form appears to the right. You are Managing Summary Fields in a Table of
prompted to enter a new name for the section type. Contents on page 657.
3. Type in a new name for the section type. For information about the individual fields and
4. Right-click the new section type in the Collec-
their properties, see Managing Fields on page
tion Tree and select Section Type Configuration 697.
from the menu that appears.
Adding a Field to a Section
The Section Type Configuration dialog
appears. This is the dialog through which you Type
add the following components: In order to configure a form for E-Notebook, you
Fields must first add fields to the section type.
Form Tools To add a field to a section type:
Section Listeners
1. Right-click the section type in the collection
tree.
The Collection menu appears.
2. Select Section Type Configuration from the
menu.
The Section Type Configuration dialog
appears:

See the following topics for information


Adding a Field to a Section Type on page
656.
Managing Form Tools on page 658.
Managing Section Listeners on page 663.
Configuring a Form on page 666.

656 Managing Section Types and Forms CambridgeSoft


Managing Fields within a Section Type
3. Right-click Fields, and select New Field. Managing Summary Fields
The Add Field dialog appears. in a Table of Contents
For each section type, you can specify a summary
field that will appear in the table of contents of a
parent collection. The summary field is displayed in
the table of contents if that section is the first
section in a collection.
For example, if the chemical structure field is the
summary field of a reaction section type, and the
reaction section is the first section in a
4. Enter a name for the field and select a Field page/experiment, then the reaction drawing
Type. will appear in the table of contents for the the
notebook, as shown below:
Each type of field has its own, special
characteristics and configuration options. See
Managing Fields on page 697 for a
description of each field type, and instructions
for configuring the field.

To set the summary field for a section type,


1. Right-click the section type in the Collection
Tree.
The Collection menu appears.
2. Select Section Type Configuration from the
menu.
5. Click Add. The Section Type Configuration dialog
appears:
The new field appears in the list of fields.

6. Repeat steps 3 through 5 to add multiple fields


to the section type.

Once you have added a field to the section type, you


may add it to the form for the section type. See
Configuring a Form on page 666 for more 3. In the right frame, click the field that you wish
information. to be the summary field for this section type.

Chem & BioOffice 2006 /E-Notebook Managing Section Types and Forms 657
Managing Fields within a Section Type
You may only select one of the following types 2. Select Section Type Configuration from the
of fields as a summary field: menu.
a styled text field The Section Type Configuration dialog
a chemical structure field appears:
Administrator

a spectrum field
4. Close the dialog.
If you do not specify a summary field, the name of
the first section will appear in the table of contents.

Managing Form Tools


If you would like to perform data analysis or
messaging within a particular E-Notebook section,
3. Right-click Form Tools, and select New Form
you can associate a form tool with that section type.
Tool.
E-Notebook provides several standard form tools.
See the following topics for more information:
Adding a Form Tool to a Section Type on
page 658.
Viewing and Editing the Properties of a Form
Tool on page 659. 4. A new form tool appears in the tree, and you
Removing a Form Tool from a Section Type prompted to name it.
on page 660.
Managing the Standard Form Tools on page
660.
You can also develop your own, customized form
tools.

Adding a Form Tool to a 5. Enter a name, and fill in the IENFormTool


Section Type ProgID.

A form tool is used to perform a particular function This is the programmatic identifier that the
in an E-Notebook form. E-Notebook provides a Windows registry uses to uniquely identify the
number of form tools, such as the Reaction Form object that implements the corresponding
Tool, which you can add to new section types you interface. The format is
create. OleServerName.ObjectName.
For the ProgID's of the standard, E-Notebook
To add a form tool to a section type:
form tools, see Managing the Standard Form
1. Right-click the section type in the Collection Tools on page 660.
Tree. 6. To associate an Enabled icon with the form
The Collection menu appears. tool, click the Import... button.

658 Managing Section Types and Forms CambridgeSoft


Managing Form Tools
A dialog appears, prompting you to select the To view and edit the properties of a form tool:
file icon file.
1. Right-click the section type in the Collection
7. Select the file and click Open. Tree.
The icon is associated with the form tool, and The Collection menu appears.
appears in the Enabled Icon box. 2. Select Section Type Configuration from the
8. Associate a disabled icon with the form tool, menu.
(following steps 6 and 7, above). This icon will The Section Type Configuration dialog
appear when the form tool is disabled. appears:
9. If the form tool has properties to configure,
click the Custom Properties button.
The Form Tool Properties dialog appears,
and you may configure the custom properties
of the form tool.
10. Click OK to dismiss the Form Tool Properties
properties dialog.
The dialog closes.
3. If necessary, click the plus sign next to Form
11. To close the Section Type Configuration Tools to expand the list and view the form tools
dialog, click the close button in the upper right that are associated with the section type. Click
corner. the form tool whose properties you wish to
The dialog closes. The form refreshes, and view or change.
displays the icon associated with the form tool.

Viewing and Editing the


Properties of a Form Tool
You can view and edit the custom properties that
are associated with a form tool. For example, you
may want to associate the form tool with a different
field in an E-Notebook form. Or, if you had The ProgID's and license key information
developed a form tool to conduct calculations, you appears to the right. You may edit this
may want to change a property that defines the information if you wish.
precision of the calculated results. 4. Click the Custom Properties button.

Chem & BioOffice 2006 /E-Notebook Managing Section Types and Forms 659
Managing Form Tools
If the form tool has properties associated with 3. If necessary, click the plus sign next to Form
it, the Form Tool Properties dialog appears. Tools to expand the list and view the form tools
This example shows the dialog associated with that are associated with the section type. Right-
the Next Step Form Tool: click the form tool you wish to remove from
Administrator

the form. A menu appears:

NOTE: If the form tool has no custom properties, a


message to that effect is presented, and no properties dialog is
displayed. 4. Select Delete Form Tool.
A message appears, asking you to confirm that
5. Edit the custom properties if desired, and click you wish to delete the form tool from the
OK to close the dialog. section type.
6. To close the Section Type Configuration 5. Click Yes.
dialog, click the close button in the upper right The form tool is deleted.
corner.
6. To close the Section Type Configuration
The dialog closes. The form refreshes. dialog, click the close button in the upper right
corner.
Removing a Form Tool from The dialog closes. The form refreshes. If there
a Section Type was an icon associated with the form tool, it no
longer appears in the form.
If you no longer want a particular form tool to be
associated with a form, you can remove it from the Managing the Standard
section type. Form Tools
To remove a form tool from a section type: E-Notebook provides a number of standard form
tools. The form tools listed below may only be
1. Right-click the section type in the Collection associated with section types. There are several
Tree. form tools that may only be associated with
collection types, for example, the New Section
The Collection menu appears.
Form Tool. See Managing Collection Type Form
2. Select Section Type Configuration from the Tools on page 762 for more information.
menu.
See the following topics for more information
The Section Type Configuration dialog about the functions and attributes of the section
appears. form tools:

660 Managing Section Types and Forms CambridgeSoft


Managing Form Tools
Managing the Next Step Form Tool When you add a Reaction Form Tool to a form, you
creates a new collection with a reaction section must configure the following custom properties.
containing the products of the selected reac-
tion.
Managing the New Subsection Section
Form Tool creates a new subsection when
clicked.
Managing the Spectrum Form Tool
enables the import of various spectra files, and
The E-Notebook User Guide provides more
allows users to copy, paste, import, and export
information about the tool and the calculations in
those files.
the stoichiometry grid. The stoichiometric grid is
Managing the Active Document Form the combination of the Reactants and Products
Tool allows the import and export of MS Fields.
Word documents and stored document Fields.
Managing the New Section Form Tool
Managing the Insert Reference Form
Tool allows a user to reference to a specific The New Section Form Tool allows users to add
collection type in a target property of a prop- new sections to a collection, for example, to a page
erty list. or an experiment. When users click the form tool
they will be presented with a list of the types of
Managing the Print Multiple Form Tool sections they may add.
allows a user to print multiple collections
with a single action.
Form Tool Form Tool Control ProgID

Managing the Next Step Form Tool


New Section ENStandardCtl9.NewSectionForm
The Next Step Form Tool is used to create a new Tool
page or experiment containing the products of the
associated chemical reaction.
Managing the New Subsection Section
In order to use the Next Step Form Tool in an Form Tool
E-Notebook form, one of each of the following The New Subsection Form Tool allows users to
types of fields must be present in the form: add new subsections to a section. For example, a
Chemical Structure Field
user may add new spectrum subsections to a

Table Field with Reactants Listener


Table Field with Products Listener

Form Tool Form Tool Control ProgID

Next Step ENStandardCtl9.ReactionFormTool

Chem & BioOffice 2006 /E-Notebook Managing Section Types and Forms 661
Managing Form Tools
spectra section. When users click the form tool they Managing the Active Document Form
will be presented with a list of the types of sections Tool
they may add.
The Active Document Form Tool is used in to
Administrator

import and export documents to and from an


Form Tool Form Tool Control ProgID
E-Notebook Section. When the form tool can also
compute the checksum for the uploaded file and
New Subsec- ENStandardCtl9.NewSubsection- display it in a property list.
tion FormTool
Form Tool Form Tool Control ProgID
Managing the Spectrum Form Tool
The Spectrum Form Tool is used in conjunction Active Docu- ENStandardCtl9.ActiveDoc-
with a spectrum field to import and export spectral ment FormTool
data from a file into an E-Notebook section.
In order to use the Active Document Form Tool in
Form Tool Form Tool Control ProgID an E-Notebook form, the following types of fields
must be present in the form:
Spectrum ENStandardCtl9.Spectrum-
FormTool Active Document Field OR
Stored Document Field OR
In order to use the Spectrum Form Tool in a form,
a Spectrum Field must be present in the form. Excel OLE Control Field

When you add a Spectrum Form Tool to a form, If you wish to display the checksum, source file
you must configure the following custom path, and source file name, the section type must
properties: also contain a property list with the following
properties:

Source File Name


Source Path
Checksum

When you add an Active Document Form Tool to


a form, you must configure the following custom
properties:

662 Managing Section Types and Forms CambridgeSoft


Managing Form Tools
Managing the Insert Reference Form In this example, a user may add a reference to a
Tool collection of type Page. The collection must be in
an Open state when the reference is created.
The Insert Reference Form Tool makes it possible
for users to insert references to a specific collection Note that if you wish to prevent users from adding
type into a target property in a property list. references to other collection types, you must make
the target property read-only in the property list.
This will prevent users from dragging or copying
Form Tool Form Tool Control ProgID other references into the property, and force them
to use the Insert Reference Form Tool.
Insert Refer- ENStandardCtl9.InsertRefer-
ence enceFormTool Managing the Print Multiple Form Tool
The Print Multiple Form Tool allows a user to print
In order to use the Insert Reference Form Tool in multiple collections with a single action. .
an E-Notebook form, a Property List field must be
present in the form. Form Tool Form Tool Control ProgID
When you add a Insert Reference Form Tool to a
form, you must configure several custom Print Multiple ENStandardCtl9.PrintMultiple-
properties. FormTool

If the collection containing the section in which the


form tool appears has contained collections or
references, a dialog box appears when the user
selects the Print Multiple form tool. The dialog
allows the user to specify the range of contained
collections to be printed.
The Print Multiple Form Tool has no custom
properties.

Source Collection Type the type of collec-


Managing Section
tion that a user may reference in the target Listeners
property.
A Section Listener modifies the behaviors of
Source State the state that the collection sectionssuch as the add, duplicate, remove, move
must be in when the reference to it is created. and rename behaviors. E-Notebook provides
several, standard section listeners, which you may
Target Field the property list field in which
add to section types.
the user may create the reference.
See the following topics for more information:
Target Property the specific property in the
property list to which the user may add the Adding a Section Listener to a Section Type
reference. on page 664.

Chem & BioOffice 2006 /E-Notebook Managing Section Types and Forms 663
Managing Section Listeners
Viewing and Editing the Properties of a 3. Right-click Section Listeners, and select New
Section Listener on page 664. Section Listener.
Removing a Section Listener from a Section
Type on page 665.
Administrator

Managing the Standard Section Listeners on


page 666.
You may also develop your own section listeners to
further customize the behavior of sections in
E-Notebook. 4. A new Section Listener appears in the tree, and
you are prompted to name it.
Adding a Section Listener to
a Section Type
A section listener modifies the behaviors of
sections such as the add, duplicate, remove,
move and rename behaviors. 5. Enter a name for the section listener
To add a section listener to a section type: 6. Fill in the following information:

1. Right-click the section type in the Collection IENSectionListener ProgID the


Tree. programmatic identifier that the Windows
registry uses to uniquely identify the object
The Collection menu appears. that implements the corresponding
2. Select Section Type Configuration from the interface. The format is:
menu. OleServerName.ObjectName.
The Section Type Configuration dialog
For the ProgID's of the standard, E-Notebook
appears:
section listeners, see Managing the Standard
Section Listeners on page 666.
7. If the section listener has properties to
configure, click the Custom Properties button.
The Section Listener Properties dialog
appears. and you are prompted to configure the
custom properties.
8. Click OK to dismiss the dialog.
The dialog box closes and the form refreshes.

Viewing and Editing the


Properties of a Section
Listener
You can view and edit the properties that are
associated with a section listener.

664 Managing Section Types and Forms CambridgeSoft


Managing Section Listeners
To view and edit the properties of a section listener: Removing a Section Listener
1. Right-click the section type in the Collection
from a Section Type
Tree. If you no longer want a particular section listener to
be associated with a section type, you can remove it
The Collection menu appears.
from the section type.
2. Select Section Type Configuration from the
To remove a section listener from a section type:
menu.
1. Right-click the section type in the Collection
The Section Type Configuration dialog
Tree.
appears.
The Collection menu appears.
3. If necessary, click the plus sign next to Section
2. Select Section Type Configuration from the
Listeners to expand the list and view the section
menu.
listeners are associated with the section type.
Click the section listener whose properties you The Section Type Configuration dialog
wish to view or change. appears.
3. If necessary, click the plus sign next to Section
Listeners to expand the list and view the section
listeners are associated with the section type.

The ProgID's and license key information


appears to the right. You may edit this
information if you wish.
4. Right-click the section listener you wish to
4. Click the Custom Properties button. remove and select Delete Section Listener from
the menu that appears.
If the section listener has custom properties
associated with it, the Section Listener
Properties dialog appears.

Note that if the section listener has no custom


properties, a message to that effect is presented,
and no dialog is displayed.

5. Edit the custom properties if desired, and click


OK to close the dialog.
A message appears, asking you to confirm that
6. To close the Section Type Configuration you wish to delete the section listener.
dialog, click the close button in the upper right 5. Click Yes.
corner.
The section listener is removed from the
The dialog closes. The form refreshes. section type.

Chem & BioOffice 2006 /E-Notebook Managing Section Types and Forms 665
Managing Section Listeners
Managing the Standard Managing the Fixed Section Name
Section Listeners Listener
E-Notebook provides a number of standard The Fixed Section Name Listener prevents users
from renaming sections of this type. For example,
Administrator

Section Listeners, which you may add to section


types. you may have a procedure section associated with
each experiment/page, and you may always want
See the following topics for more information the section to bear the name Procedure. .
about their functions and attributes:
Managing the Fixed Section Name Section IENSectionListener ProgID
Listener prevents the user from renaming Listener
the section.
Managing the Required Section Listener Fixed Section ENStandard9.FixedSection-
prevents the user from deleting the section at Name NameListener
any time.
Managing the Audit Section Listener
prevents a user from deleting the section only Managing the Audit Section Listener
if it has been modified since it was created. The Audit Section Listener prevents a user from
deleting a section of this type if it has been modified
Managing the Required Section Listener since it was created.
The Required Section Listener prevents users from
deleting sections of this type. For example, you may Section IENSectionListener ProgID
have a Results section that is mandatory with each Listener
Experiment/Page.
Audit ENStandard9.AuditSectionListener
Section IENSectionListener ProgID
Listener
Configuring a Form
Required ENStandard9.RequiredSection- Each section type in E-Notebook has a single form
Section Listener associated with it. The form is what users see when
they create sections of this type.
You can configure a form to display data in the
most effective way. Boxes are the building blocks of
forms. You can add boxes to forms, delete them
from forms, and manipulate their sizes and
properties. You insert the fields you wish to appear
in a form into the boxes.
See the following topics for more information
about manipulating boxes in a form:
Configuring a New Form on page 667.

666 Managing Section Types and Forms CambridgeSoft


Configuring a Form
Reconfiguring an Existing Form on page 3. Right-click within the inner box, and select
669. Insert Box Above from the menu that appears.
Showing and Hiding the Max Button for a
Box on page 671.
Showing and Hiding the Name of a Box on
page 672.
Resizing Boxes in a Form on page 673.
Clearing Fields when Configuring a Form on
page 675.
Hiding Fields and Boxes when Configuring a A box appears on top of the box you selected.
Form on page 675. There are now two boxes, one on top of the
Changing Box Orientation on page 676. other, within the root box, as shown below:

NOTE: Prior to configuring the form, the section type must


contain the fields that are to be added to the form.

Configuring a New Form


When you create a new section type, you must
configure its form. Initially, the form has a single,
root box. You configure the form by adding
additional boxes, then inserting fields into those
boxes.
The configuration created in the steps below is an
example. There are many ways in which boxes may
The next step you take depends upon the form
be organized within the form.
layout you seek. In this example, we will configure
To configure a new form, the form so that there are two fields in a row on top
of another field, for a total of three fields in the
1. Right-click within the root box. form.
A menu appears.
4. Right-click within the top box, and select Insert
Box Within.

2. Select Insert Box Within.


A box appears within the root box. The hashed
lines indicate that there is a box behind the top
box.

Chem & BioOffice 2006 /E-Notebook Managing Section Types and Forms 667
Configuring a Form
5. Right-click within the new box, and select Insert A dialog box appears, listing the fields that you
Box to the Right. have added to the section type.
Administrator

3. Click the field you wish to insert into the box,


and click Insert.
A box appears to the right of the box you The field appears in the box. Any edits you
selected, as shown below. make to the field will appear in E-Notebook
when a user creates a section of this type.

4. Repeat steps 1 through 3 for the other boxes.


Setting the Fields in Boxes Once a field has been set in a box, you may
access the Box menu by right-clicking the
To set the field within a box,
frame of the box.
1. Right-click within the box.
NOTE: The orientation of a box is determined by the
A menu appears. orientation of its container. For example, say that Insert Box
2. Choose Set Field. Above and Insert Box Below are menu options for Box X.
Then, you insert Box Y within Box X, by using the Insert
Box Within command. The menu options for Box Y will
include Insert Box to the Right and Insert Box to the
Left. If you inserted Box Z into Box Y, the menu options for
Box Z would include Insert Box Above and Insert Box
Below. By default, the orientation of the container box is
opposite the orientation of the contained box.

668 Managing Section Types and Forms CambridgeSoft


Configuring a Form
Reconfiguring an Existing The new box appears in the form:
Form
In some cases, you may want to reconfigure a
particular form, adding new fields, removing
existing fields, or changing the layout of the fields in
the form. For audit reasons, it is not possible to
remove a field from a form if that form is in use.

Adding a Field to an Existing Form


1. Click the section type of interest in the
Collection Tree.
The form for the section type appears in the 4. Right-click within the new box, and select Set
right frame. Field from the menu that appears.
2. Right-click the frame of the box that is to be
adjacent to the new box you are adding.
The Box menu appears.
3. Select a menu option to add a new box to the
form.
In this example we are selecting Insert Box
Above to add a box above the Metadata
Properties box.

The Insert Field dialog appears, listing the


Fields that have been added to the section type.

5. Select the field to be insert, and click Insert .

Chem & BioOffice 2006 /E-Notebook Managing Section Types and Forms 669
Configuring a Form
The field appears in the form. In the example The box is moved according to the selection
below, a query text field has been inserted. you made.
Administrator

Deleting a Box from a Form


If you no longer want a particular box to be part of
a form, you may delete it. If you delete a box that
contains a field, there must be an empty box for the
field elsewhere in the form.
Rearranging Boxes in a Form To delete a box from a form:

You may rearrange the boxes in a form to change 1. Right-click the frame of the box you wish
the layout of the form. delete.
A menu appears.
1. Right-click the frame of the box that you wish
to move.
The Box menu appears.
2. Select one of the options for moving the box.

(Depending upon the orientation the box,


either 1) Move Box Left and Move Box Right, or
2) Move Box Up and Move Box Down will
appear in the menu). In this example, we are
moving a box to the left.

2. Select Delete Box.


The box is deleted from the form. (Note that if
the box contained a field, and you had
customized the field for this form, you can add
the field to another box in the form and your
changes to the field will be maintained).

670 Managing Section Types and Forms CambridgeSoft


Configuring a Form
Showing and Hiding the 3. Click the Show Max Button checkbox to clear it.

Max Button for a Box

In a form, each box may have a max button


associated with it. The button appears in the upper
right corner of the box. When a user clicks the
button, the field expands to fill the entire section
display. (Clicking the max button again returns the
field to its original size). The field below displays
the max button in the upper right corner:

4. Click OK .
The dialog closes, and the max button is no
longer visible in the box.

Hiding the Max Button

To hide the max button for a box, Showing the Max Button
1. Right-click the frame of the box. To show the max button for a box:
The Box menu appears. 1. Right-click the frame of the box.
The Box menu appears.
2. Select Box Properties.
2. Select Box Properties.

The Box Properties dialog appears. The Box Properties dialog appears.

Chem & BioOffice 2006 /E-Notebook Managing Section Types and Forms 671
Configuring a Form
3. Click the Show Max Button checkbox so that a 2. Select Box Properties.
checkmark appears:
Administrator

The Box Properties dialog appears.


3. Click the Show Name checkbox to clear it.

4. Click OK .
The dialog closes, and the max button appears.

Showing and Hiding the


Name of a Box
36 .
In a form, each box has a title bar associated with it.
4. Click OK .
You may choose to either hide of this bar or have it
appear above the box in the form: The dialog closes, and the name of the box is
no longer visible in the form.
Hiding the Box Name
To hide the name of a box,
1. Right-click the frame of the box.
The Box menu appears.

672 Managing Section Types and Forms CambridgeSoft


Configuring a Form
Showing the Name of a Box 4. Click the Show Name checkbox so that a
checkmark appears:
To show the name of a box:

1. Right-click the section menu tool on the tab,


and select Hide Fields.

5. If you wish, edit the name for the box.


6. Click OK .
The fields in the form are hidden. The dialog closes, and the box name appears in
2. Right-click within the box whose name you the upper left corner of the box.
wish to display in the form.
The Box menu appears.
3. Select Box Properties.

Resizing Boxes in a Form


You can change the size of a box to make it appear
larger or smaller in a form. You can set the
maximum dimensions, minimum dimensions, and
proportional size of a box relative to other boxes in
the same container.

Changing the Weight of a Box


To change the size of a box relative to other boxes
in the same container, you may change the weight
The Box properties dialog appears. of the box.

Chem & BioOffice 2006 /E-Notebook Managing Section Types and Forms 673
Configuring a Form
To do this, The dialog closes, and the box sizes change to
reflect your change.
1. Right-click the frame of the box whose weight
you wish to change. In this example, the weight
of the Structure box will change.
Administrator

The Box menu appears.


2. Select Box Properties.

Changing the Dimensions of a Box


Manually
1. Right-click the frame of the box whose size you
wish to change.
The Box Properties dialog appears.
The Box menu appears.
3. Change the value of the Weight. In this
2. Select Box Properties.
example, we are changing the value to 3 (three
times greater than the default box weight of 1).

The Box Properties dialog appears.


3. Click the checkboxes to apply the options you
4. Click OK
desire to the box.
The sizes of the boxes will change according to
the options you select.
Minimum Height and Minimum Width
The minimum height and width,
respectively, to which the box can shrink
when the E-Notebook window is resized or
the form is further configured in a way that
would shrink the box (for example, by
adding a box next to it).

674 Managing Section Types and Forms CambridgeSoft


Configuring a Form
Preferred Height and Preferred Width Clearing Fields when Config-
The starting height and width, respectively, uring a Form
of the box relative to other boxes in the same
container. To calculate the actual height of a When you are configuring a form, you may remove
box within a container, begin with the a field after adding it to the form. It is only possible
to clear the field if the form is not yet in use. If the
preferred height of the contained boxes.
form is in use, the field will move to an empty box.
Then, (This prevents the possibility of obscuring data that
if the preferred dimensions would leave a user has entered in a form).
extra space in the container box, add the To clear a field from a box,
extra space in the container to each
1. Right-click the frame of the box.
contained box according to its Weight
relative to the other boxes, ensuring that The Box menu appears.
each box does not exceed its maximum 2. Select Clear Field.
dimensions.

if the preferred dimensions would cause the


contained boxes to overflow the container,
subtract space from each box according to
its Weight relative to the other contained
boxes, ensuring that each box is no smaller
than its minimum dimension.

Maximum Height and Width The


maximum height and width, respectively, a
box can attain when the E-Notebook The field is removed from the form.
window is resized or as the form is further
configured in a way that would increase the Hiding Fields and Boxes
size of the box (for example, by deleting a when Configuring a Form
box next it). A scroll bar appears within the
When you are configuring a form, hiding fields and
box if the field within it requires more space boxes makes it easier for you to access box menus.
than the maximum dimension allows.
Hiding a Box
Box dimensions are expressed in twips, with 20
twips equalling one pixel. You may wish to hide a box if, for example, you
wish to access the box that contains it in a form.

NOTE: If you would like a box to simply conform to the To hide a box,
sizes of the boxes it contains, you can deselect all of the sizing
1. Right-click the frame of the box.
options for that box.
The Box menu appears.

Chem & BioOffice 2006 /E-Notebook Managing Section Types and Forms 675
Configuring a Form
2. Select Hide Box. To hide the fields in a form:
1. Right-click the section menu icon that appears
in the form.
Administrator

The Section menu appears.


2. Select Hide Fields.

The Box is no longer visible in the form, as


shown below. (In this case, the root box of the
form is visible. The root box does not display
the hash marks).
The fields in the form are hidden.
3. To see the field in a particular box again, right-
click within the box, and select Show Contents
from the menu that appears.
This menu option will only appear if 1) the box
contains a field or 2) a contained box is hidden.
3. To access the box that contains the hidden box,
right-click within the hidden box, and select
Box Properties .

The Box Properties dialog for the container


of the hidden box appears.

Hiding Fields in a Form Changing Box Orientation


You may wish to hide the fields in a form while you You may wish to change the orientation for a box,
are configuring it, so that it is easier to access the so that the stacking of its contained boxes will
box menus. This may become especially important change from horizontal to vertical, or from vertical
if you have hidden the frames of the boxes. to horizontal.

676 Managing Section Types and Forms CambridgeSoft


Configuring a Form
In this example, we will change the orientation of 3. Change the Sub Box Layout to Vertical (i.e., the
contained boxes from a horizontal arrangement to opposite of the current layout).
a vertical arrangement.
In the form we are shown below, there are three,
horizontally arranged boxes within a single
container box.

1. Right-click the frame of the box that contains


the three boxes (making sure you select the
correct box the one that is directly outside
of the three boxes; in this example, Container
Box 1 is selected). 4. Click OK.
The Box menu appears. The Box Properties dialog closes. The three
boxes are now arranged vertically, as shown
below.

2. Select Box Properties. Managing Export


The Box Properties dialog appears.
Templates for Section
Types
Export templates for section types allow users to
print E-Notebook sections and export sections to
Microsoft Word. You create export templates with
MS Word sections, using tags to refer to
E-Notebook fields.

An export template must be set up for each, new


section type you create.

Chem & BioOffice 2006 /E-Notebook Managing Section Types and Forms 677
Managing Export Templates for Section Types
To view the export template: 3. Click the New Default Section button in
the right frame.
1. Right-click the section type in the Collection
Tree. A menu appears, listing all of the E-Notebook
section types.
Administrator

A menu appears.
2. Select Show, then Export Templates.

If the section type has an export template, the


template appears in the right frame. If not, the
right frame is blank, and you must create a new
template.
4. Select Export Template.
See the following topics:
A new export template appears.
Creating the Export Template for a Section
See Editing the Export Template for a Section
Type on page 678.
Type on page 678 for instructions on setting up
Editing the Export Template for a Section the template.
Type on page 678
Editing the Export Template
Creating the Export
for a Section Type
Template for a Section Type
This topic provides instructions for setting up or
Export templates allow users to print E-Notebook modifying an export template.
sections and to export sections to Microsoft Word.
To do this:
To create an export template:
1. Right-click the section type in the Collection
1. Right-click the section type in the Collection
Tree.
Tree.
A menu appears.
A menu appears.
2. Select Show, then Export Templates.
2. Select Show, then Export Templates.

The right frame is blank if there is no export The export template appears in the right frame.
template associated with the section type. (For If no template appears, you must first create
information about configuring an existing the template.
export template, see Editing the Export You can then edit the template in one of two
Template for a Section Type on page 678). ways:

678 Managing Section Types and Forms CambridgeSoft


Managing Export Templates for Section Types
You can edit it within E-Notebook, using
the MS Word tools that E-Notebook Tag Replacement
provides.
<sectionIndex> The numerical position of the
You can export it to MS Word and edit it section within its containing set
within MS Word to make use of the full, MS of sections.
Word feature set. You can then import it
back into E-Notebook. See Working with
MS Word Documents in the User Guide if <sectionCount> The number of sections that
are contained within the set of
you would like more information about how
sections.
to import and export MS Word documents)

The body of each export template contains tags that Standard Field Types
mark the locations for the content within the
exported section. The format of a tag consists of a This section describes how each of the standard
left bracket, the name of a field, and a right bracket. add-in field types replaces the tags in an export
For example, if there is a field named Reaction it document with the field type.
will replace the first instance of <Reaction> in Active Document field type The Active
the export template. Document field type replaces the export tag
with the body of the Word document.
Each field type determines how it will replace the
ChemDraw Structure field type The
tag with its data (within the IENFieldCtl_Export
ChemDraw Structure field type substitutes a
method).
ChemDraw OLE object into the Microsoft
Word document. As a result, the ChemDraw
When a user prints a section, the printed header and
application is required to render the OLE
footer are pulled from the collection type export
object, either for display on the client machine,
template that corresponds to the user's region. See
or for printing.
Creating and Editing the Export Templates for a
Collection Type on page 780 for information Collection Query field type The Collection
about headers, footers, and setting up templates for Query field type replaces the export tag with
users from different geographical regions. tab-separated descriptions of the selected
collection query options.
Section Metadata Tags Collection Type Query field type The
Collection Type Query field type replaces the
Within the contents of the section type export export tag with tab-separated description of
template, the following tags can be inserted. Each the collection type query.
of these tags will be replaced by the corresponding Database Table field type Normally, the
information at the time of export or printout. Database Table field type creates a Word table
to replace the contents of the tag. Each column
Tag Replacement of the Database Table data corresponds to a
column in the Word table; each row of the
<sectionName> The name of the section. Database Table data corresponds to a row in
the Word table. If the tag appears within a

Chem & BioOffice 2006 /E-Notebook Managing Section Types and Forms 679
Managing Export Templates for Section Types
Word table, then, instead of creating a new State Query field type The Collection Type
Word table, the Word table that contains the Query field type replaces the export tag with
tag is used to contain the Database Table data. tab-separated description of the collection type
Any formatting within the Word table is query.
Administrator

applied to the content. Stored Document field type The Stored


Property List field type In the export Document field type replaces the export tag
with tab-separated description of the stored
template, the tag for the Property List field type
document: its type and its size in bytes.
should appear in an MS Word table; then, the
Word table that contains the tag is used to Styled Text field type The Styled Text field
contain the data. The first column of the table type replaces the tag with the formatted text
contains the names of the properties, and the stored in the section.
second column contains the values of the prop- Subsection field type The Subsection field
erties. Any formatting within the Word table is type replaces the tag with the contents of a
applied to the content. Word document that is created by exporting all
of the sections contained in the subsection.
Property Query field type Normally, the
Property List field type creates a Word table to Table field type Normally, the Table field
replace the contents of the tag. creates a Word type creates a Word table to replace the
table to replace the contents of the tag. The contents of the tag. Each column of the Table
first column of the data corresponds to the data corresponds to a column in the Word
property name, and the second column corre- table; each row of the Table data corresponds
sponds to the value. a column in the Word to a row in the Word table. If the tag appears
table; each row of the data corresponds to a within a Word table, then, instead of creating a
row in the Word table. If the tag appears within new Word table, the Word table that contains
a Word table, then, instead of creating a new the tag is used to contain the Table data. Any
Word table, the Word table that contains the formatting within the Word table is applied to
the content.
tag is used to contain the data. Any formatting
within the Word table is applied to the content. Table Query field type creates a Word table
to replace the contents of the tag. Each column
Query Text field type The Query Text field of the data corresponds to a column in the
type replaces the tag with the text stored in the Word table; each row of the data corresponds
section. to a row in the Word table. If the tag appears
within a Word table, then, instead of creating a
Search Location field type The field
new Word table, the Word table that contains
marker within the template is either deleted (if
the tag is used to contain the data. Any format-
the Search In check box is unchecked) or ting within the Word table is applied to the
replaced by the name of the selected collection content.
(if the Search In check box is checked
URL Display field type The URL Display
Spectrum field type The Spectrum field field type replaces the export tag with the
type substitutes an image of the spectrum for contents of the web page specified in the
the tag. section.

680 Managing Section Types and Forms CambridgeSoft


Managing Export Templates for Section Types
Page Breaks for the first paragraph of the corresponding export
template. This is an MS Word setting. If this
By default, if a user prints a range of sections in a
paragraph setting is not checked, then the sections
collection, the sections will print contiguously,
will appear continuously on the word page.
without page breaks. You may however, insert a
page break at the end of the section type export
template if you do not want sections to print on the
same page. To add a page break before a section,
check the Page Break Before paragraph setting

Chem & BioOffice 2006 /E-Notebook Managing Section Types and Forms 681
Managing Export Templates for Section Types
Administrator

682 Managing Section Types and Forms CambridgeSoft


Managing Export Templates for Section Types
Chapter 36: Managing Commands
Commands can be associated with a collection To add commands to a collection type:
types and sections types to render content in:
1. Right-click the collection type in the Collection
exporting to MS Word, PDF, or printing. The
results of renderings can be stored in files, printed Tree, and select Collection Type Configuration
on paper, or stored in databases. For example, users from the menu that appears.
may export a collection to MS Word or PDF and
save it at some location outside E-Notebook.

Managing Collection
Commands
You can associate commands with a collection type
to render the contents of collections in various
formats i.e. MS Word or PDF. The results of
renderings can be stored in files, printed on paper,
or stored in databases. For example, users may
export a collection to MS Word or PDF and save it
The Collection Type Configuration dialog
at some location outside E-Notebook.
appears.
This section describes how to set up an 2. Right-click Commands and select New
E-Notebook application to render the contents of Command from the menu that appears:
collection in a specific format. E-Notebook can be
configured to render the contents of a collection in
several contexts, such as in response to a menu
command or as part of a transition.

Adding a Command to a
Collection Type
You can associate commands with a collection type
if you wish the users to allow to render the contents
of collections in specific formats i.e. MS Word or
PDF.

Chem & BioOffice 2006 /E-Notebook Managing Commands 683


Managing Collection Commands
A new command appears and you are 2. If necessary, click the plus sign next to
prompted to rename it. Commands to view the commands that are
associated with this collection type. Click the
command whose properties you wish to view
Administrator

or edit.
3. Click the Custom Properties button.
The Command Properties dialog appears.
4. Edit the properties, if you wish. For example,
3. Type in a name for the command.
you may wish to add section types to be
4. Enter the IENCommandProgID for the rendered. For this,
Command you wish to add.
Click the Set Rendered Section Types button
5. To close the Collection Type Configuration to add section types. A dialog appears
dialog, click the close button in the upper right displaying the list of section types and
corner. checkboxes before their names.
The dialog closes. Checkmark the boxes to select the section
types and click OK to close the dialog.
6. To add another command to the Collection
Type, repeat steps 2 and 3. 5. Click OK to close the dialog.
6. To close the Collection Type Configuration
Viewing and Editing the dialog, click the close button in the upper right
Properties of a Collection corner.
Command The dialog closes and your changes are saved.

You can view and edit the custom properties that Removing a Command from
may be associated with a collection command. To
do this:
a Collection Type
If you no longer want a particular command to be
1. Right-click the collection type that contains the associated with a collection type, you can remove it
command in the Collection Tree, and select from the collection type. To do this:
Collection Type Configuration from the menu
that appears. 1. Right-click the collection type that contains the
command in the Collection Tree, and select
The Collection Type Configuration dialog Collection Type Configuration from the menu
appears. that appears.
The Collection Type Configuration dialog
appears.
2. If necessary, click the plus sign next to
Commands to view the commands that are
associated with this collection type.
3. Right-click the command you wish to remove
from the collection type.

684 Managing Commands CambridgeSoft


Managing Collection Commands
A menu appears. Managing the Export to MS Word
Collection Command
You can associate the Export to MS Word
command to allow users to render or export the
contents of a collection to an MS Word document
type thereby storing the results of these renderings
in files or databases.
For example, users may wish to export a collection
to MS Word and save it at some location outside
E-Notebook.
4. Select Delete Command.
A message appears, asking you to confirm that
you wish to delete the command. Command Command ProgID
5. Click Yes.
The command is removed from the collection Export to MS Word ENRenderWord9.ExportC
type. Command
6. To close the Collection Type Configuration
dialog, click the close button in the upper right Managing the Export to PDF Collection
corner. Command
The dialog closes.
E-Notebook can be configured to allow users to
render the contents of a collection to PDF
Managing the Standard document which is managed by associating Export
Collection Commands to PDF Collection Command with that collection
There are some standard commands that you may type.
associate with collection types in E-Notebook. The For example, users may want to export a collection
commands are used to render the contents of and save it in PDF format at some location outside
collections in various formats i.e. MS Word or PDF E-Notebook.
and the results of these renderings can be stored in
files, printed on paper, or stored in databases.
Printing and Exporting operations are configured Command Command ProgID
and executed in similar ways. Because of these
similarities, the term Render is used throughout Export to PDF ENRenderWord9.Export-
here when it refers to either Printing or Exporting, PDFCCommand
depending on a specific configuration.

Chem & BioOffice 2006 /E-Notebook Managing Commands 685


Managing Collection Commands
Managing the Print Collection 1. Right-click the section type in the Collection
Command Tree, and select Section Type Configuration
from the menu that appears.
If the Print Collection Command is associated with
a collection type, users can print collections of that
Administrator

type.

Command Command ProgID

Print Collection ENRenderWord9.PrintC-


Command
The Section Type Configuration dialog appears.
Managing Section 2. Right-click Commands and select New
Commands Command from the menu that appears:
A new command appears and you are
You can associate commands with a section type to
prompted to rename it.
render the contents of sections to MS Word, or to
print sections. 3. Type in a name for the command.
4. Enter the IENCommandProgID for the
This section describes how to set up an
Command you wish to add.
E-Notebook application to render the contents of a
section. 5. To close the Section Type Configuration
dialog, click the close button in the upper right
Adding Commands to a corner.
Section Type 6. The dialog closes.

You can associate commands with a section type if To add another command to the Section Type,
you wish the users to allow to render the contents, repeat steps 2 and 3.
either printing or exporting to MS Word.
Viewing and Editing the
To add commands to a section type:
Properties of a Section
Command
You can view and edit the custom properties that
may be associated with a section command. To do
this:
1. Right-click the section type that contains the
command in the Collection Tree, and select
Section Type Configuration from the menu that
appears.
The Section Type Configuration dialog
appears.

686 Managing Commands CambridgeSoft


Managing Section Commands
2. If necessary, click the plus sign next to 3. Right-click the command you wish to remove
Commands to view the commands that are from the section type.
associated with this collection type. Click the
command whose properties you wish to view A menu appears.
or edit. 4. Select Delete Command.
3. Click the Custom Properties button. A message appears, asking you to confirm that
4. Edit the properties, if you wish. For example, you wish to delete the command.
you may wish to add section types to be 5. Click Yes.
rendered. For this,
The command is removed from the section
Click the Set Rendered Section Types button type.
to add section types. A dialog appears
displaying the list of section types and 6. To close the Section Type Configuration
checkboxes before their names. dialog, click the close button in the upper right
corner.
Checkmark the boxes to select the section
types and click OK to close the dialog. The dialog closes.
5. Click OK to close the dialog.
Managing the Standard
6. To close the Section Type Configuration
dialog, click the close button in the upper right
Section Commands
corner. You can associate some standard commands with
The dialog closes and your changes are saved. section types in E-Notebook. These commands are
described here. The commands are used to render
the contents of sections in MS Word format and the
Removing a Command from results of these renderings can be stored in files,
a Section Type printed on paper, or stored in databases.

If you no longer want a particular command to be The term Render is used throughout here when
associated with a section type, you can remove it it refers to either Printing or Exporting, depending
from the section type. To do this: on a specific configuration. This is because of the
fact that Printing and Exporting operations are
1. Right-click the section type that contains the configured and executed in similar ways.
command in the Collection Tree, and select
Section Type Configuration from the menu that
Managing the Export to MS Word
appears.
Section Command
The Section Type Configuration dialog
appears. Export to MS Word command allows users to
render the contents of a section to an MS Word
2. If necessary, click the plus sign next to document if it is associated with the section type.
Commands to view the commands that are Thus, the results of these renderings are stored in
associated with this section type. files or databases.

Chem & BioOffice 2006 /E-Notebook Managing Commands 687


Managing Section Commands
For example, users can export a section to MS For example, users can export a section to MS
Word and store at some location outside Word and store at some location outside
E-Notebook. E-Notebook.
Administrator

Command Command ProgID Command Command ProgID

Export to MS Word ENRenderWord9.ExportS Print Section ENRenderWord9.Print-


Command SCommand

Managing the Print Section Command


If the Print Section command is associated with a
section type, users can print the contents of a
section of that type by selecting the command from
the Section menu.

688 Managing Commands CambridgeSoft


Managing Section Commands
Chapter 37: Managing Rendering in
E-Notebook
This portion of the guide describes the Configuring a Rendering
configuration of printing and exporting in
E-Notebook. Printing and Exporting operations Template
are configured and executed in similar ways.
Many rendering operations require a template in the
Because of these similarities, the term Render is
form of a Microsoft Word document that describes
used throughout to refer to either Printing or
the layout of data to be rendered. When a rendering
Exporting.
add-in requires a rendering template as part of its
An E-Notebook system can be configured to configuration, that rendering template can reside in
render the contents of a collection in several one of two places. It can either be associated
contexts, such as in response to a menu command, directly with the rendering add-in or it can be
as part of a transition, or the operation of a form located in users user configuration folders and
tool. Different rendering add-ins support different referenced by name from the add-in.
workflows. For each use of a rendering add-in, the
For rendering templates located in users user
add-in is configured with one or more rendering
configuration folders, the rendering templates must
templates that determine how the information in a
be stored in a Microsoft Word field in a section that
collection or section is laid out within the Microsoft
is contained in a configuration collection. This
Word document. For add-ins that render
configuration collection is contained within a
collections, templates are created that specify paper
configuration folder. The configuration folder and
sizes, styles, headers, footers and the layout of data
the configuration collection may be referenced
for each type of section to be rendered.
within the user configuration folder (if you want
During the rendering operation for collections, the several users to have the same rendering
rendering add-in instantiates an instance of configuration) or contained directly in the
Microsoft Word and uses a template associated with configuration folder (if you want users to be able to
the rendering add-in to lay out the document. Each customize their rendering templates).
section in the collection whose type has a rendering
To associate a rendering template for a section type
template associated with the rendering add-in is
with an Export to MS Word command:
then incorporated into the new document. For each
field in each section, a tag is located in the rendering 1. Right-click the collection type that contains the
template that contains the name of the field section for which the rendering template has to
associated with that section cell surrounded by be associated.
brackets, such as <FieldName>. This tag is
2. Select Collection Type Configuration from the
replaced by a rendition of the field's data. Once the
document is rendered, it is either printed or saved menu that appears.
to a file, depending on the behavior of the rendering The Collection Type Configuration dialog
add-in appears.

Chem & BioOffice 2006 /E-Notebook Managing Rendering in E-Notebook 689


Configuring a Rendering Template
3. Click the plus sign next to Commands to view b. Checkmark the boxes to select the section
the commands that are associated with this types and click to close the dialog.
collection type. In this example, click the 6. Click the section type, for MS Word document
command for Export to MS Word. in this case, then the From Configuration button
Administrator

4. Click the Custom Properties button. in the dialog.


7. Select the properties as shown:

The Command Properties dialog appears.


This example shows the dialog for the Export to In this example, the rendering template is
MS Word command, which is one of the located in the each users User Configuration
standard E-Notebook commands. Folder within a folder named Rendering
5. Add the section type for which the rendering Folder that contains a collection named Page
template has to be associated. For this, Section Types.
a. Click the button to add 8. Click OK to close the dialog.
section types. A dialog appears displaying 9. To close the Collection Type Configuration
the list of section types and checkboxes dialog, click the close button in the upper right
before their names as: corner.
The dialog closes and your changes are saved.
Similarly, you can configure the rendering templates
for other sections and with other commands.

Designing a Rendering
Template
Export templates allow users to print and export
from E-Notebook. You can insert various tags in
the export templates to pull different types of
information into a rendition.

690 Managing Rendering in E-Notebook CambridgeSoft


Designing a Rendering Template
Rendering Tags
Tag Replacement
The following tags can be inserted into headers,
footers and section rendering templates and <collectionType> The type of the collection
replaced with the corresponding data
Templates for Headers and
Tag Replacement
Footers
Headers and Footers are described using templates
<collectionStatus> The state of the collection. that are separate from the document settings
(Note that if you are using template used to implement page sizes and styles.
the Final Print Transition This allows multi-section Word documents to be
Listener, the state will print
included in rendered documents and the headers
as the initial state of the
and footers to be included in all sections of the
transition, and not as the
rendered documents.
target state. In this specific
case, if you would like the
The header and footer is printed on every page
name of the target state to
when a user prints the collection or a portion of the
print, simply type the text
collection. The header and footer of a collection
name of the state into the
header or footer.) type export template can contain standard
replacement tags above.
<dateCreated> The timestamp of creation The Rendering Template for a header looks as
of the collection shown below:

<dateModified> The timestamp of last


modification

<dateToday> The timestamp of the


creation of the export
document or printout

<collectionOwner> The name of the owner of


the collection

<collectionName> The name of the collection


To edit this data:

Chem & BioOffice 2006 /E-Notebook Managing Rendering in E-Notebook 691


Designing a Rendering Template
1. While viewing the export template in The Rendering Template for an Ancillary Data
E-Notebook, click the print layout view button Section looks as shown below:
in the lower left corner of the MS Word field.
It is the third button in the row.
Administrator

Managing the MS Word


The export template appears in print layout
view, and the header is visible Section Renderers
2. Double-click the header or footer. The word sections renderers can be associated with
commands (as a command listener) or transitions
(as a transition listener) to modify the behavior of
rendering commands and transitions. If more than
one Word section renderer is associated with a
rendering operation, then the Word section
Section Metadata Tags renderers insert their contents in the order they are
associated with the rendering operation.
Within the contents of a section type export
template, the following tags can be inserted. Each For example, a transition type contains three
of these tags will be replaced by the corresponding transition listeners in the following order:
information at the time of export or printout. PrintTListener, Full History Renderer and Fixed
Text After Renderer. In this case, the document
produced by the PrintTListener will contain all of
Tag Replacement
the sections to be printed, followed by the full
history of the collection being printed, followed by
the fixed text that is associated with the Fixed Text
<sectionName> The name of the section After Renderer.

<sectionIndex> The numerical position Managing the Fixed Text


of the section within its After Word Renderer
containing set of sections
The Fixed Text After Word Renderer renders some
<sectionCount> The number of sections fixed text at the end of a collection when rendering
that are contained within the collection. This renderer is configured with a
the set of sections word document whose contents are inserted into
the main story of the rendered output after all of the

692 Managing Rendering in E-Notebook CambridgeSoft


Managing the MS Word Section Renderers
sections that are rendered as part of a print or Select the custom properties as shown below:
export operation. For example, the rendered
document might contain a signature block.

Word Renderer Word Renderer


ProgID

Fixed Text After ENRenderWord9.Fixed-


TextAfterRenderer

Select the custom properties as shown below: Managing the Tracked


History Word Renderer
The Tracked History renderer is configured with a
word document that may contain other text and the
tag <History> which indicates where the history is
to be inserted. If a collection to be rendered has
visual display of changes turned on, then this
renderer inserts the collection history of the
collection since visual display of changes is turned
on

Managing the Full History Word Renderer Word Renderer


Word Renderer ProgID

The Full History Word renderer may be associated Tracked History ENRenderWord9.Tracke-
with a collection type. This renderer inserts the full dHistoryRenderer
collection history of a collection after all of the
sections that are rendered as part of a print or Select the custom properties as shown below:
export operation.

Word Renderer Word Renderer


ProgID

Full History ENRenderWord9.FullHis-


toryRenderer

Chem & BioOffice 2006 /E-Notebook Managing Rendering in E-Notebook 693


Managing the MS Word Section Renderers
Managing the Standard property list field, the label and the data are only
printed for properties that do not have blank values.
Field Renderers The label is printed with a Bold typeface.
Rendering of section cell data can be overridden by
Administrator

a Field Renderer that is associated with a particular


section type in a particular add-in command. Field Renderer Field Renderer
ProgID
Managing the Fixed Table
Field Renderer NonBlank Property ENReaction9.NonBlank-
PropertyRenderer
The Fixed Table Renderer renders the contents of a
table according to the tags in a Word table. When
The renderer has no custom properties associated
this renderer is associated with a table field, the
with it.
columns in the table are positioned using tags that
appear in the second row of a word table. The tags
are of the form <FieldName><PropertyName>.
Managing the One Property
Value Field Renderer
The One Property Value Field Renderer renders the
Field Renderer Field Renderer
value of a single property according to the tags in a
ProgID
Word table. When this renderer is associated with a
property list field, the data for one property in the
Fixed Table ENReaction9.Fixed- property list is positioned using tags that appear in
TableRenderer the Word template. The tags are of the form
<FieldName><PropertyName>.
The renderer has no custom properties associated
with it.

Managing the NonBlank Field Renderer Field Renderer


ProgID
Property Field Renderer
The NonBlank Property Renderer renders the One Property Value ENReaction9.OneProper-
name and value of a property if the property is not tyValueRenderer
blank. When this renderer is associated with a
The renderer has no custom properties associated
with it.

Managing the One Table


Value Field Renderer
The One table Value renderer renders the value of
a single table cell according to the tags in a Word
table. When this renderer is associated with a table
field, the data for one property in the first row of

694 Managing Rendering in E-Notebook CambridgeSoft


Managing the Standard Field Renderers
the table is positioned using tags that appear in the associated with a property list field, the data for
Word template. The tags are of the form each property in the property list is rendered
<FieldName><PropertyName>. without its label. This is typically used for property
lists that have only one property.

Field Renderer Field Renderer


ProgID Field Renderer Field Renderer
ProgID
One Table Value ENReaction9.OneTabl-
eValueRenderer Property Value ENReaction9.PropertyVal-
ueRenderer
The renderer has no custom properties associated
with it. The renderer has no custom properties associated
with it.
Managing the Property
Value Field Renderer
The Property Value Field renderer renders the
values of all the properties in a property list without
their corresponding names. When this renderer is

Chem & BioOffice 2006 /E-Notebook Managing Rendering in E-Notebook 695


Managing the Standard Field Renderers
Administrator

696 Managing Rendering in E-Notebook CambridgeSoft


Managing the Standard Field Renderers
Chapter 38: Managing Fields
Fields are the basis for the forms in E-Notebook. Chemical Query Fields
Each field is based on an add-in field type. Collection Query Fields
E-Notebook provides many standard field types,
Collection Type Query Fields
which you can use to configure your own data
forms, searches, and analysis tools. You may also Query Text Fields
develop addition add-in field types for your own, State Query Fields
custom data types.
Property Query Fields
The field types in E-Notebook span many, diverse Table Query Fields
types of data. They make it possible to customize
E-Notebook to match your workflow and manage Unannotated Version Query Fields
your information in the most effective way possible. Search Location Fields
The following field types are designed for use in Join Type Fields
data forms, for data entry, analysis, and display: For information about adding custom field types
Active Document Fields (MS Word fields) that you have developed, see Managing the Add-
In Configuration on page 739.
AutoText Fields
Other topics in this portion of the documentation
Chemical Structure Fields
are:
Context Sensitive Help Fields
Managing Field Listeners provides instruc-
Captured Image Fields tions for associating a field listener with a field
Database Table Fields in order to modify its behavior.
Database Value Fields Time Settings
PowerPoint Fields Managing Units in Property Lists and Tables
Excel Fields
Managing Field Listeners
Property List Fields
Spectrum Fields
Field listeners modify the behavior of various types
of E-Notebook fields. E-Notebook provides many
Stored Document Fields standard field listeners that you can use in your
Subsection Fields configuration.
Table Fields You may also develop your own listeners to further
URL Display Fields customize the behavior of fields in E-Notebook.
Several Fields Types are designed for use Adding a Field Listener
exclusively within search forms, to search for data
in E-Notebook. They are: To add a field listener to a field,

Chem & BioOffice 2006 /E-Notebook Managing Fields 697


Managing Field Listeners
1. From the Section Type Configuration If the listener has properties associate with it,
dialog, right-click the field to which you wish to they are displayed, and may be edited.
add the listener.
2. Select New Field Listener from the menu that Managing Generic Field
Administrator

appears. Listeners
The following field listeners are not limited to any
particular type of E-Notebook field. (Most
E-Notebook field listeners were created for a
specific field type).

Managing the Block User Edit Field


Listener
A dialog appears, prompting you to enter the
The Block User Edit Field Listener may be used to
ProgID for the listener.
prevent users from editing a particular field within
a section. If this listener is associated with the field,
the field will be read-only to users. This listener still
enables administrators to edit the field.

Table Listener IENTableListener


ProgID
3. Enter the ProgID and click the OK button.

The listener appears in the left frame and you Block User Edit ENStandardCtl9.Block-
are prompted to rename it. UserEditlFEListener

4. Enter a name for the listener.

To view and edit the properties of the property list Managing the Block Edit Cell Field
listener: Listener
1. Click the listener. The Block Edit Cell Field Listener may be used to
prevent users from editing a particular field within
The Prog ID and properties button appear to
a section. If this listener is associated with the field,
the right.
the field will be read-only within that section.

Table Listener IENTableListener


ProgID

Block Edit Cell ENStandardCtl9.BlockEdi


tCelllFEListener
2. Click the Custom Properties button.

698 Managing Fields CambridgeSoft


Managing Field Listeners
Managing the Copy Default Managing Active Document
Field Listener Fields
The Copy Default Field Listener removes the
Active Document Fields allow users to view and
content of a field when a user copies the collection
that contains the field. edit MS Word documents within E-Notebook
sections. If you associate the Active Document
Form Tool with an active document field, users can
Table Listener IENTableListener import MS Word documents from external sources,
ProgID or export MS Word documents and edit them in MS
Word.
Copy Default ENStandardCtl9.CopyDe-
faultFCListener To add an Active Document field:
1. In the Collection Tree, right-click the section
type to which you wish to add the property list.
Managing Data Fields
2. Select Section Type Configuration from the
The following E-Notebook field types are designed menu that appears.
for use in data forms, for data entry, analysis, and
display: The Section Type Configuration dialog
appears.
Active Document Fields (MS Word fields)
3. Right-click Fields, and select New Field.
AutoText Fields
Chemical Structure Fields
Context Sensitive Help Fields
Captured Image Fields
Database Table Fields The Add Field dialog appears.
Database Value Fields
Excel Fields
PowerPoint Fields
Property List Fields
Spectrum Fields
4. Enter a name for the field and select Active
Stored Document Fields
Document from the drop-down list of field
Subsection Fields types.
Table Fields 5. Click the Add button.
URL Display Fields The new field appears in the list of fields.
Several fields types are designed for use exclusively 6. In order for users to be able to import and
within search forms, to search for data in export the MS Word documents, you must
E-Notebook. See Managing Search Fields on associate the Active Document Form Tool
page 733 for information about these fields. with the field.

Chem & BioOffice 2006 /E-Notebook Managing Fields 699


Managing Data Fields
Once you have added a field to the section type, you Managing the Extract Links Document
may add it to the form for the section type. See Listener
Configuring a Form on page 666 for more
information. The Extract Links Document Listener may be
Administrator

associated with active document (MS Word) fields


to extract the links from the Word document into a
Managing Active Document Field property list.
Listeners
Active IENActiveDocListener
An Active Document Field Listener modifies the Document ProgID
behavior of an MS Word field in E-Notebook. Listener
E-Notebook provides an active document listener
that prevents users from adding hyperlinks to Extract Links ENStandardCtl9.ExtractLinks-
external URLs. See Managing the Prevent DListener
External Link Active Document Field Listener on
page 700.
Managing AutoText Fields
You may also develop your own Active Document
Field Listeners to further customize the behavior of With AutoText Fields, users can enter text that is
active document fields in E-Notebook. related to other data in a form. Users can add
predefined fragments of text automatically, and
See Managing Field Listeners for instructions on values from other fields in a section may be pulled
associating a field listener with a field. in as well. The E-Notebook User's Guide provides
instructions for configuring AutoText. Note that
for the AutoText features to function, the AutoText
Managing the Prevent External Link collection type name, section type name, and field
Active Document Field Listener names in the section type must not be changed.

The Prevent External Link Active Document Field If you configure the Styled Text Field to display the
Listener may be associated with active document toolbar, users may alter any of the following
fields to prevent users from adding hyperlinks to formatting options.
external URL's. If links are present in the field, they
Font
will be stripped from the document when the user
browses away. Font Size

Bold
Active IENActiveDocListener
Document ProgID Italics
Listener
Underline

Prevent External ENStandardCtl9.RequireENU Superscript


Link RLDListener
Subscript

700 Managing Fields CambridgeSoft


Managing Data Fields
An example of a Styled Text Field is shown below. 6. Right-click the styled text field, and select Field
Properties from the menu that appears.

To add a Styled Text field:


1. In the Collection tree, right-click the Section
Type to which you wish to add the field.
2. Select Section Type Configuration from the
menu that appears. 7. You may edit the following properties, if
The Section Type Configuration dialog desired:
appears.
3. Right-click Fields, and select New Field.

The Add Field dialog appears.


Default Font you may select another font
from the drop-down list to change the
default to something other than Times
Roman.
Default Font Size you may select a larger
or smaller font size from the drop-down list.
4. Enter a name, and select AutoText from the
drop-down list of field types. Show Tool Bar if you clear the
checkmark, the toolbar will not appear
5. Click Add.
above the styled text field in the form.
The new field appears in the list of fields.
Not Blank If you select this option, the
styled text field must contain text when a
user performs a specific transition on a
collection. This option must be used in
conjunction with the Required Properties
Transition Listener.
Read Only the styled text field is for
display only, and only administrators may
edit it.

Chem & BioOffice 2006 /E-Notebook Managing Fields 701


Managing Data Fields
Once you have added a field to the section type, you Users may dismiss the ChemDraw toolbar at any
may add it to the form for the section type. See time. For more information about using the
Configuring a Form on page 666 for more ChemDraw Toolbar, please see the ChemDraw
information. User's Guide.
Administrator

Managing AutoText Field It is possible to associate a listener with a chemical


Listeners structure field to perform a specialized function.
E-Notebook offers a listener that automatically
An AutoText Field Listener modifies the behavior updates the stoichiometry grid when a user
of an AutoText field in E-Notebook. modifies a reaction drawing. See Managing the
Analyze Reaction Chemical Structure Listener on
Managing the AutoText Color Field page 703 for more information.
Listener
The AutoText Color Field Listener allows you to
configure the color of AutoText items within an
AutoText field.

Table IENTableListener ProgID


Listener

AutoText Color ENStyledTextPlus9.AutoText-


ConfigFLstnr

You select the color you desire through the custom


properties of the listener. To add a chemical structure field to a section type:

Managing Chemical Struc- 1. In the Collection Tree, right-click the section


type to which you wish to add the field.
ture Fields
2. Select Section Type Configuration from the
Chemical Structure Fields make it possible for users
menu that appears.
to draw or import drawings of chemical structures
and reactions. These fields make use of the The Section Type Configuration dialog
ChemDraw ActiveX Control. An example of a appears.
Chemical Structure Field is shown below. These
fields may also be used for images. Users can paste 3. Right-click Fields, and select New Field.
in standard images, such as GIFs and JPEGs.

Users can access a ChemDraw menu by right-


clicking within the structure window. This menu
allows a user to, among other things, copy and paste
structures.

702 Managing Fields CambridgeSoft


Managing Data Fields
4. The Add Field dialog appears. a user edits a reaction drawing. For automatic
analysis to occur, you must also associate the
Analyze Reaction Table Listener with both the
reactants and products table fields.

Active Document IENActiveDocListener


Listener ProgID
5. Enter a name, and select Chemical Structure
from the drop-down list of field types.
Analyze Reaction ENStandardCtl9.Analyz-
6. Click the Add button. eRxnCSListener
The new field appears in the list of fields.
This listener has custom properties associated with
NOTE: Anything that you draw in the Chemical Structure it. You must select the reactants field and the
Field will appear with the new sections of this type that users products field in the stoichiometry grid.
create.
Managing the Chemical Property Chemical
Once you have added a field to the section type, you Structure Listener
may add it to the form for the section type. See The Chemical Property Chemical Structure
Configuring a Form on page 666 for more Listener calculates chemical structure properties of
information. molecular weight and molecular formula, and
You may also develop your own Chemical Structure inserts them into a property list when the contents
Field Listeners to further customize the behavior of of the chemical structure change.
chemical structure fields in E-Notebook.
Active Document IENActiveDocListener
Managing Chemical Structure Field Listener ProgID
Listeners
A Chemical Structure Field Listener modifies the Chemical Property ENStandardCtl9.ChemP-
behavior of a chemical structure field in ropertiesCSListener
E-Notebook.
The following are required in the section type in
Managing the Analyze Reaction Chemical
Structure Listener
order to use this listener.

The Analyze Reaction Chemical Structure Listener A chemical structure field.


may be associated with chemical structure fields to A property list with the following properties:
update a stoichiometry grid automatically when Molecular Weight and Molecular Formula.

Chem & BioOffice 2006 /E-Notebook Managing Fields 703


Managing Data Fields
Configuring E-Notebook with ISIS Draw 3. Right-click Field Listener, and the following
Tool dialog follows:
This topic provides instructions for administrators
who are adding the ISIS/Draw tool to the
Administrator

E-Notebook configuration. .

Tool Tool ProgID

ISIS Draw ENISISDraw9.ISIS- 4. Replace the Analyze Reaction field listener, with
DrawCSListener a new field listener. For this, click New Field
Listener. Enter a name and type
ENISISDraw9.ISISDrawCSListener in the
To add the form tool to a section type:
ProgID of the Reaction field listener, as shown
1. Browse to the Section type in the Collection above. This listener implements ISIS Draw
tree and right-click on it to display the editing.
following menu:

Click OK, and following dialog appears:

2. Select Reaction and right click it to select


Section Type Configuration from the menu that
appears.
The Section Type Configuration dialog
To countercheck that the configuration is done
appears as:
properly, click Custom Properties, and the
following dialog should appear:

5. Click OK, to dismiss the dialog.


6. Close the Section Type Configuration dialog.

704 Managing Fields CambridgeSoft


Managing Data Fields
Managing Database Table The Add Field dialog appears.
Fields
Database table fields display the results of a SQL
SELECT statement (represented as an ADO
record set). These fields are for display only, and
users may not edit them.
4. Enter a name, and select Database Table from
A Database Table Field may exist independently in
the drop-down list of field types.
a section. Or, you may set up the field such that its
value(s) are determined by a value in a separate 5. Click Add.
property list field that is part of the same section.
The new Field appears in the list of Fields.
See the following topics:
See Configuring a Database Table Field on page
Creating a Database Table Field on page 705. 705 for instructions on defining the data to be
displayed in the Field.
Configuring a Database Table Field on page
705. Once you have added a field to the section type, you
may add it to the form for the section type. See
Creating a Database Table Field Configuring a Form on page 666 for more
information.
Database Table Fields are used to display data that
is pulled in from an external database. Configuring a Database Table Field
To create a Database Table Field: Database Table Fields are used to display data that
is pulled in from a database.
1. In the Collection tree, right-click the Section
Type to which you wish to add the Property To configure a Database Table Field:
List.
1. Right-click the Database Table Field in the
2. Select Section Type Configuration from the
Section Type Configuration dialog, and
menu that appears.
select Field Properties from the menu that
The Section Type Configuration dialog appears.
appears.

3. Right-click Fields, and select New Field.

Chem & BioOffice 2006 /E-Notebook Managing Fields 705


Managing Data Fields
The Properties dialog appears. the E-Notebook section. The SQL String
can have the following special phrases that
are dynamically replaced based on the
location of the section cell.
Administrator

%%section_key%% The unique


identifier for the section containing the
section cell in which the record set appears.
This datum corresponds to a value in the
primary_key column for a row in the
ELN_sections table.
%%field_key%% The unique identifier
for the field that describes the section cell in
2. Enter the following information. (See below
which the record set appears. This datums
for examples). corresponds to a value in the primary_key
Connection String A string used to column for a row in the ELN_fields table.
define a connection to a database. If this
%%collection_key%% The unique
string is 0-length (Null in the database), then
identifier for the collection that contains the
it is assumed to be a connection to the
section containing the section cell in which
primary schema of the E-Notebook
the record set appears. This datum
database. If the string is a path to an MDB
corresponds to a value in the
file, then a connection is made to that file
section_set_key column for a row in the
using the Microsoft Access OLEDB
ELN_collections table.
provider. Otherwise, the string is treated as a
valid string that can be assigned to an %%session_key%% The unique
ADODB.Connection objects identifier for the database session in which
ConnectionString property. the record set is retrieved. This datum
Username An optional string used to corresponds to a value in the primary_key
specify the logon identification required to column for a row in the ELN_sessions table.
connect to the specified database. If the %% logged_in_user_key%% The
Username is 0-length and the Connection unique identifier for the person record for
String is 0-length, then the owner of the the user that initiated the database session in
primary schema of the E-Notebook which the record set is retrieved. This datum
database is used as the username. corresponds to a value in the primary_key
Password An optional string used to column for a row in the ELN_people table.
identify the logon ID required to connect to %%home_collection_key%% The
the specified database. If the UserName is unique identifier for the home collection of
0-length and the Connection String is the user that initiated the database session in
0-length, then the password is ignored. which the record set is retrieved. This datum
SQL String A required string that starts corresponds to a value in the
with the text SELECT . This string is used section_set_key column for a row in the
to specify the record set that appears within ELN_collections table.

706 Managing Fields CambridgeSoft


Managing Data Fields
%%access_view%% The name of the Example 2
table used to validate security privileges for In this example, the value suppliername is pulled
the logged in user. from the external database table Suppliers. The
In addition, a SQL string may contain the suppliername displayed in the database table field
name of a property that appears in a property corresponds to the value that a user has entered into
a property list. A user enters SupplierID into the
field in the same section as the DBTable
Supplier ID property, which exists in a Property
section cell. This property field is identified
List named ID Number.
using the property field name property of the
SQL section cell, below. For example, a
property could appear in the WHERE clause
of the SQL statement to determine which
records in the database table appear

Property List Field An optional name of


a property list field that contains properties
which are used to parameterize the SQL
statement, above .
suppliername value to be displayed in Data-
3. Click OK . base Lookup Table.
Several examples are given below. Note that the Suppliers name of external database table.
syntax of the query may vary depending upon the SupplierID the supplier ID field in the
type of database you are querying. external database table.
ID Number name of the E-Notebook prop-
Example 1 erty list containing the Supplier ID property.
In this example, all of the values for suppliername Supplier ID name of the E-Notebook prop-
are pulled in from the external database table erty into which a user enters the value for
Suppliers. SupplierID.

Managing Database Value


Fields
Database Value Fields are used to pull in and display
values that are the results of SQL query from an
external database.
To create a Database Value Field:
1. In the Collection tree, right-click the Section
Type to which you wish to add the Property
suppliername value to be displayed in Data-
Value.
base Lookup Table.
2. Select Section Type Configuration from the
Suppliers name of external database table. menu that appears.

Chem & BioOffice 2006 /E-Notebook Managing Fields 707


Managing Data Fields
The Section Type Configuration dialog Field is shown below. If the Active Doc Form Tool
appears. is associated with the section, a user may import or
3. Right-click Fields, and select New Field. export the document.
The Add Field dialog appears.
Administrator

4. Enter a name, and select Database Value from


the dropdown list of field types.
5. Click Add.
The new Field appears in the list of Fields.
See Configuring a Database Value Field for
instructions on defining the data to be displayed in To add an Excel Field section type:
the Field.
1. In the Collection Tree, right-click the section
Once you have added a field to the section type, you type to which you wish to add the field.
may add it to the form for the section type. See
Configuring a Form on page 666 for more 2. Select Section Type Configuration from the
information. menu that appears.
The Section Type Configuration dialog
Configuring a Database Value Field
appears.
To configure a Database Value Field:
3. Right-click Fields, and select New Field.
1. Right-click the Database Value Field in the
Section Type Configuration dialog, and
select Field Properties from the menu that
appears.
The Properties dialog appears.
2. Enter the properties. See step 2 in Creating a
The Add Field dialog appears.
Database Table Field on page 705 for details.
3. Click OK.
Note that the syntax of the query may vary
depending upon the type of database you are
querying.
Once you have added a field to the section type, you
may add it to the form for the section type. See 4. Type in a name, and select Excel Spreadsheet
Configuring a Form on page 666 for more from the drop-down list of field types.
information.
5. Click Add.

Managing Excel Fields The new field appears in the list of fields.
Excel Fields make it possible for users to embed In order for users to be able to import and export
and edit Microsoft Excel documents in the MS Excel spreadsheet, you must associate the
E-Notebook sections. An example of an Excel Active Document Form Tool with the field.

708 Managing Fields CambridgeSoft


Managing Data Fields
Once you have added a field to the section type, you 1. Click the Custom Properties button in the right
may add it to the form for the section type. See panel to configure the properties associated
Configuring a Form on page 666 for more with it:
information.

Managing Break Link Excel Listener


The Break Link Excel Listener may be associated
with the Excel fields to break the links to external
data sources in Excel documents when the
document is saved. If links are present in the field,
they will be stripped from the document when the
user browses away and the user will be warned
when saving the file that the link will be broken
once the document is saved in E-Notebook. A dialog to configure the field listener opens. It
contains a box to list the Disabled Addins, an
enabled Add button, and a disabled Remove
Listener IENListener ProgID button.
2. Click Add. A dialog opens that allows you to
Break Link ENStandardCtl9.Break- enter the name of the Add-In you want to
LinksOListener disable.

The listener has no custom properties associated


with it.

Managing Hide Addins Excel Listener


The Hide Addins Excel Listener may be associated 3. Enter name of an Add-In in the text box and
with the Excel fields and disables and enables click OK. The dialog closes. The name you
specified Excel Add-ins associated with the Excel entered is added to the Disabled Addins box,
below the text you added previously.
field.
4. Similarly, to remove a previously added Add-In
from the disabled list, select one of the items in
Listener IENListener ProgID
the Disabled Addins box. The Remove button
gets enabled.
Hide Addins ENStandardCtl9.HideAd-
5. Click Remove. The selected item is removed
dinsOListener
from the list in the Disabled Addins box.
6. Click OK. The dialog to configure the field
With the field listener selected in the tree, listener closes.

Chem & BioOffice 2006 /E-Notebook Managing Fields 709


Managing Data Fields
Managing Remove Macros Field 1. In the Collection Tree, right-click the section
Listener type to which you wish to add the field.
2. Select Section Type Configuration from the
The Remove Macros Field Listener may be
menu that appears.
Administrator

associated with the Excel fields to remove macros


from the field when a user performs a save. The The Section Type Configuration dialog
user will be presented with a message stating that appears.
the macros will be removed when the spreadsheet is
3. Right-click Fields, and select New Field.
saved.
The Add Field dialog appears.
Listener IENListener ProgID 4. Type in a name, and select PowerPoint Slide-
show from the dropdown list of field types.
Remove Macros ENStandardCtl9.Remove 5. Click Add.
MacrosFListener
The new field appears in the list of fields.
In order for users to be able to import and export
Managing PowerPoint the MS PowerPoint Slideshows, you must associate
Fields the Active Document Form Tool with the field.

PowerPoint Fields make it possible for users to Once you have added a field to the section type, you
embed and edit MS PowerPoint Slideshows in may add it to the form for the section type. See
E-Notebook sections. An example of a PowerPoint Configuring a Form on page 666 for more
Field is shown below. information.

Managing Context Sensitive


Help Fields
Context Sensitive Help Fields are used in search
forms. They create a shortcut to the E-Notebook
User's Help Guide in the search form. Thus, these
fields make it possible for users to go directly to the
Help guide to find the information regarding the
instructions for using E-Notebook quickly and
easily.

A Context Sensitive Help Field is visible in


search forms next to the text query field as shown:
If the Active Doc Form Tool is associated with the
section, a user may import or export the document.

To add a PowerPoint Field section type: To add a PowerPoint Field section type:

710 Managing Fields CambridgeSoft


Managing Data Fields
1. In the Collection Tree, right-click the section To add a Captured Image field:
type to which you wish to add the field. 1. In the Collection Tree, right-click the section
2. Select Section Type Configuration from the type to which you wish to add the Captured
Image field.
menu that appears.
2. Select Section Type Configuration from the
The Section Type Configuration dialog menu that appears.
appears. The Section Type Configuration dialog
appears.
3. Right-click Fields, and select New Field.
3. Right-click Fields, and select New Field.
The Add Field dialog appears. The Add Field dialog appears.
4. Type in a name, and select Context Sensitive 4. Type in a name, and select PDF Viewer from the
dropdown list of field types.
Help from the dropdown list of field types.
5. Click Add.
5. Click Add. The new field appears in the list of fields.
The new field appears in the list of fields. In order for users to be able to import and export
the PDF documents and to import images, you
Once you have added a field to the section type, you must associate the Active Document Form Tool
may add it to the form for the section type. See and Import Image Form Tool respectively with the
Configuring a Form on page 666 for more field.
information. Once you have added a field to the section type, you
may add it to the form for the section type. See
Managing Captured Image Configuring a Form on page 666 for more
information.
Fields
Captured Image Fields allow users to view and edit
PDF images and documents, using the same tools
as Adobe Acrobat software, thus helps manage
PDF files in E-Notebook.

If you associate the Active Document Form Tool


with a Captured image field, users can import or
export the PDF documents. Associating the Image
Importer Form Tool allows users to import images
of various types as well.

NOTE: Export to PDF is only available in Enterprise


versions of E-Notebook.

Chem & BioOffice 2006 /E-Notebook Managing Fields 711


Managing Data Fields
Managing Property Lists
Property Lists are used in forms to record various
types of data properties. Property lists allow the
following data types:
Administrator

Data type User perspective

Date A user may click the date box, and type in a date and
time.

Text A user may enter text.

Number A user may enter a number. A property may also be


configured to have units associated with it.

Enumerated Value A user may choose a value from the drop-down list.
The values may be from either a preconfigured list
or a list that is pulled from an external database.

Validated Value A user may enter a value, which is validated against


an external database.

You may configure property lists so that they are Creating a Property List on page 713.
read-only, or so that they must contain certain
values before a collection transition is performed. Managing Database Values in Property Lists
on page 716.
Another feature of property lists is the ability for
Managing Enumerated Values in Property
users to add references to them. When a user adds
Lists on page 714.
a reference to a property, he may navigate to the
collection or section he has referenced, simply by Managing Property List Listeners on page
clicking a link in the property cell. 719.
See the following topics for more information Managing Units in Property Lists and Tables
about property lists: on page 741.

712 Managing Fields CambridgeSoft


Managing Data Fields
Creating a Property List Adding a Property to the Property List
This topic provides instructions for adding a To add a Property:
Property List to a Section Type and configuring the
Property List. 1. Right-click the Property List field in the
Section Type Configuration dialog.
To add a Property List:
A menu appears.
1. In the Collection tree, right-click the Section
Type to which you wish to add the Property
List.
2. Select Section Type Configuration from the
menu that appears.
The Section Type Configuration dialog
appears.

2. Select Field Properties.

The Field Properties dialog appears.


3. Click the Properties tab.
3. Right-click Fields, and select New Field. The Properties tab appears.
The Add Field dialog appears. 4. Right-click the name of the field and select
New Property from the menu that appears.

A new property appears in the tree. It's


attributes appear to the right:

4. Enter a name for the field and select Property


List from the list of Field Types.
5. Click Add.
The new Field appears in the list of Fields.

5. Type in a Name and Nickname for the prop-


erty.
Name appears when a user selects the
property for a search.
Nickname is displayed on the screen, in
the printed copy, and in an exported Word
document.

Chem & BioOffice 2006 /E-Notebook Managing Fields 713


Managing Data Fields
6. Select the Type from the drop-down list. (See Configuring the Appearance of a Property List
Managing Units in Property Lists and Tables
on page 741 for more information). To configure the appearance of a property list:

7. Select the Units from the drop-down list (if


Administrator

1. Click the Appearance tab.


applicable for the Type you have selected)
The Appearance tab appears.
8. Click the checkboxes for the attributes you
wish to apply to the property:

Active users can add new instances of the


Property to the Sections they create.

Read-Only the property is for display


only, and users may not edit it.

Required the user may not delete the


property from the section.

Not Blank the user must enter a value for


the property before he van perform a
particular transition on the Collection. For
2. Select a Font from the drop-down list.
example, you may set up an experiment
Collection such that it is necessary to enter 3. Select a font size from the Font Size drop-
an equipment id before a user can close the down list.
experiment. If the user has not entered a
value for the property, he will be prompted 4. Select whether or not the grid lines will be
to enter it when he attempts to perform the displayed, by clicking the checkbox.
transition. The Not Blank attribute must be
used in conjunction with the Required Once you have added a field to the section type, you
Properties Transition Listener. may add it to the form for the section type. See
Configuring a Form on page 666 for more
ENTER to Create New Line if a user is information.
editing the property and presses ENTER, a
new instance of the property will appear in Managing Enumerated Values in Prop-
the property list.
erty Lists
9. If the property is type text, you may select the
following: You may configure a text property so that it will
contain a list of enumerated values. A user may then
Enumerator values displayed in a drop- select one of the values from a drop-down list that
down list for any particular property may be appears in the property cell. This list of values may
pulled from an external database, or from a be either manually entered, as described here, or
list of values you enter. See Managing pulled from an external database, as described in
Database Values in Property Lists on page the Managing Database Values in Property Lists
716. topic.

714 Managing Fields CambridgeSoft


Managing Data Fields
Associating a list of manually entered values 7. Click the Add Value button.
with a property
A blank item appears in the list.
1. In the Collection Tree, right-click the section
8. Enter a value.
type containing property you wish to
configure.
2. Select Section Type Configuration from the
menu that appears.
The Section Type Configuration dialog
appears.
3. Right-click the property list field in the list of
fields, and select Field Properties from the
menu that appears.

9. Click Add Value to add another value, or OK to


close the dialog.
The values you entered will appear in a drop-
down list in the property cell.

Editing an Enumerated Values List


The Field Properties dialog appears.
1. In the Collection Tree, right-click the section
4. Click the property for which you would like to type to you wish to configure.
add the list of enumerated values.
2. Select Section Type Configuration from the
The attributes of the property appear to the menu that appears.
right.
The Section Type Configuration dialog
5. Click the drop-down arrow for the Enumer- appears.
ator, and select Enumeration List.
3. Right-click the property list field in the list of
fields, and select Field Properties from the menu
that appears.
4. The Field Properties dialog appears. Click the
6. Click the Properties button. property whose values you wish to edit.

NOTE: The button will only be enabled for a property of The attributes of the property appear to the
data type text. right. Enumeration List is displayed as the type
of Enumerator.
The Enumerated List Properties dialog 5. Click the Properties button under the Enumer-
appears. ator.

Chem & BioOffice 2006 /E-Notebook Managing Fields 715


Managing Data Fields
The Enumerated List Properties dialog 4. Deselect the Active checkbox. This will prevent
appears: users from adding new instances of the prop-
erty to new or existing sections.
5. Add a new property (right-clicking Properties
Administrator

and selecting New Property from the menu that


appears) and give it the new name.
6. Close the Section Type Configuration dialog.

If a section of this type appears by default in one of


the collection types, you will have to remove the old
property from the collection type.

1. Click the collection type in the tree to select it.

6. Click any value to edit it, or click Remove Value 2. In the section containing the property, right-
to delete it. To move a value up or down in the click the property and select Remove Property.
list, click the Move Value Up or Move Value
3. Right-click within the field and select Add Prop-
Down button, respectively.
erty, then select the new property you created in
7. Click OK to close the dialog. step 5, above.
Note that once you have made this change, it will
Modifying Properties without Obscuring still be possible for users to view the old property in
Data the collections that contain it, and to conduct
Note that if you change the name of a property, the searches that contain the old property as well.
name will change in all collections that include the
property, even collections that are in a locked, read- Managing Database Values in Property
only state. This means that you could potentially Lists
obscure data by changing property names. So, the
This topic provides instructions for configuring
following procedure is recommended for changing
the name of a property: database lookups in property lists. Database
lookups are used to pull in and display values from
1. In the collection tree, select the section type a database. You may also validate a value that a user
containing the property you wish to modify. enters into a property list against an external
database; see Managing the Validate Value
The section type is displayed. Property List Listener on page 722 for more
2. Right-click the field containing the property, information.
and select Field Properties from the menu that
1. In the Collection tree, right-click the section
appears.
type to you wish to configure.
The properties of the field are displayed.
2. Select Section Type Configuration from the
3. Click the property you wish to change. menu that appears.
The attributes of the property are displayed in The Section Type Configuration dialog
the right frame. appears.

716 Managing Fields CambridgeSoft


Managing Data Fields
3. Right-click the property list field in the list of Example 1 Database Lookup Configuration
Fields, and select Field Properties from the
In this example, all of the values for suppliername
menu that appears.
are pulled in from the external database table
Suppliers. The values will appear in a drop-down list
in the property cell.

The Field Properties dialog appears.


4. Click the property for whose value(s) you wish
to pull from an against an external database. suppliername value(s) to be displayed in
5. Click the drop-down arrow for Enumerator, and E-Notebook property.
select Database Lookup. Suppliers name of external database table

Example 2 Database Lookup Configuration


In this example, the value suppliername is pulled
from the external database table Suppliers. The
6. Click the Properties button. suppliername displayed in the database table field
The Database Lookup Properties dialog corresponds to the value that a user has entered into
appears. a property list. A user enters SupplierID into the
Supplier ID property, which exists in a Property
List named ID Number.

7. Enter the properties. See step 2 in Creating a


Database Table Field on page 705 for details.
suppliername value to be displayed in
8. Click OK. E-Notebook property.

Several examples are given below. Note that the Suppliers name of external database table.
syntax of the query may vary depending upon the SupplierID the supplier ID field in the
type of database you are querying. external database table.

Chem & BioOffice 2006 /E-Notebook Managing Fields 717


Managing Data Fields
ID Number name of the E-Notebook 4. Click the property for which you would like to
property list containing the Supplier ID add the list of enumerated values.
property. The attributes of the property appear to the
Supplier ID name of the E-Notebook right.
Administrator

property into which a user enters the value 5. Click the dropdown arrow for the Enumerator,
for SupplierID. and select Enumeration List.

Managing Enumerated
Values in Property Lists
You may configure a text property so that it will
6. Click the Properties button.
contain a list of enumerated values. A user may then
select one of the values from a dropdown list that NOTE: the button will only be enabled for a property
appears in the property cell. This list of values may of datatype text.
be either manually entered, as described here, or
pulled from an external database, as described in The Enumerated List Properties dialog
the Managing Database Values in Property Lists appears.
topic.
7. Click the Add Value button.
Associating a list of manually entered values with a A blank item appears in the list.
property:
8. Enter a value.
1. In the Collection Tree, right-click the section
9. Click Add Value to add another value, or OK to
type containing property you wish to close the dialog.
configure.
The values you entered will appear in a
2. Select Section Type Configuration from the dropdown list in the property cell.
menu that appears.
The Section Type Configuration dialog Editing an Enumerated Values List:
appears.
1. In the Collection Tree, right-click the section
3. Right-click the property list field in the list of type to you wish to configure.
fields, and select Field Properties from the
menu that appears. 2. Select Section Type Configuration from the
menu that appears.
The Section Type Configuration dialog
appears.
3. Right-click the property list field in the list of
fields, and select Field Properties from the menu
that appears.
The Field Properties dialog appears.
4. Click the property whose values you wish to
The Field Properties dialog appears. edit.

718 Managing Fields CambridgeSoft


Managing Data Fields
The attributes of the property appear to the To add a property list listener:
right. Enumeration List is displayed as the type
of Enumerator. 1. From the Section Type Configuration
dialog, right-click the property list field to
5. Click the Properties button under the Enumer- which you wish to add the listener.
ator.
2. Select New Field Listener from the menu that
appears.

The Enumerated List Properties dialog


appears:

A dialog appears, prompting you to enter the


ProgID for the listener.
3. Enter the ProgID and click the OK button.

The listener appears in the left frame and you


are prompted to rename it.

6. Click any value to edit it, or click Remove Value 4. Enter a name for the listener.
to delete it. To move a value up or down in the
list, click the Move Value Up or Move Value To view and edit the properties of the property list
Down button, respectively. listener:

7. Click OK to close the dialog. 1. Click the listener.

The ProgID and properties button appear to


Managing Property List the right.
Listeners
A Property List Listener modifies the behavior of
an E-Notebook property list. E-Notebook
provides a number of standard property list
listeners:
2. Click the Custom Properties button.
You may also develop your own Property List
Listeners to further customize the behavior of If the listener has properties associate with it,
property lists in E-Notebook. they are displayed, and may be edited.

Chem & BioOffice 2006 /E-Notebook Managing Fields 719


Managing Data Fields
Managing the Formula Listener example, [Reaction Conditions: Reaction
Molarity] refers to the Reaction Molarity prop-
The formula listener makes it possible to perform erty in the Reaction Conditions property list.
calculations in a cell using other numerical data in
Standard symbols may be used:
the section and various functions. The listener
Administrator

allows you to specify the target property, the +, -, /, *, =, >, >=, <, <>, <=, &,!,!=,%, +/-
formula, and an optional format. Boolean operators may be used:
NOT, AND, OR, XOR
It is also possible to calculate a value in a property
list; see Managing the Formula Property List You may use functions:
Listener for more information. IF(test, trueValue, [elseTest, elseTrueValue],
falseValue): returns one of two values,
Listener IENTableListener depending upon whether the test returns
ProgID True or False.
OnError: returns the first argument if it can
Formula ENStandardCtl9.Formu- be calculated without error. If an error
laListener would occur in the calculation of the first
argument, the second argument is returned
To add a formula for a property: (in this example, a blank cell would be
returned).
1. Click the Custom Properties button for the SaltWeight(salt code): returns the molecular
field listener. weight property of the salt with this salt
The Formula Listener Properties dialog code. The Salt Codes are found in a user's
appears. The dropdown list at the top of the User Configuration folder.
dialog contains a list of all of the properties in SUM(tableproperty): returns the sum of the
the table. table cells for the property you specify.
SELECT (value, tablefield, condition): allows
you to select a value in a table based on a
condition, e.g. SELECT ([Moles]
* [Equivalents], [Reactants], [Limiting?] =
"Yes") returns the value of [Moles] *
[Equivalents] from the Reactants table for
the limiting reactant.
2. Select the target property that is to be calcu- 5. Use the format field if you wish to format the
lated from the dropdown list. numeric value.
The selected property is displayed. Operands in a formula are evaluated in the
following order:
3. Type the formula into the formula box.
Parentheses
4. To reference values in other tables or property
NOT
lists within the same section, begin and end the
reference with square brackets ([and]), and use *, /,%, &
colons to denote specific properties. For +, -, +/-

720 Managing Fields CambridgeSoft


Managing Data Fields
=, <, <=, >, >=, <>,!= Note that you may associate multiple instances of
AND this listener with a property list, if you would like to
prevent users from adding references to several
OR, XOR different collection types and/or several different
Commas are used to separate arguments within states of a collection type.
functions.
Whenever the contents of the section are
Managing the Person Property List
changed, the formula will be checked, and the Listener
target cell will be recalculated if necessary. The Person Property List Listener populates the
value of a property with the logged-on user's name
Managing the Block Reference In State whenever the value of another property is changed.
Property List Listener
The Block Reference In State property list listener Listener Listener ProgID
may be used to block users from adding a reference
to a specific type of collection that is in a particular Person Property ENStandardCtl9.Person-
state. If the listener is configured to block the PropertyPListener
reference, the user will be unable to add the
reference to the property list. For example, you may
The listener has custom properties associated with
wish to prevent users from adding references to
it:
pages/experiments that are in an archived state.

Property List IENPropertyListListe


Listener ner ProgID

Block Reference In ENStandardCtl9.Block-


State RefInStatePListener

This property list listener has custom properties Fill in the following information.
associated with it. You must select the collection Source Property the property that, when
type and state corresponding to the references that changed, will populate the target property with
will be blocked. In the example below, a user will be the logged-on user's name.
prevented from adding a reference to an Page
Target Field the field containing the prop-
collection that is in the Closed state.
erty that will display the user name or user ID.
Target Property the property that will
display the user name or user ID.
Target SQL the SQL statement that selects
the username or user ID.
In the example shown above, a change to the source
property Checksum will populate the Editor
property with the name of the logged-on user.

Chem & BioOffice 2006 /E-Notebook Managing Fields 721


Managing Data Fields
Managing the Chemical Properties from the Property drop-down list. Then, enter the
Property List Listener database connection information and the SQL
string to be used for validating the value.
The Chemical Properties Property List Listener
populates the Molecular Weight and Molecular
Administrator

Formula properties automatically as the drawing in


a chemical structure field is changed.

Listener Listener ProgID

Chemical ENStandardCtl9.ChemProper-
Properties tiesCSListener

The following is required in the section type in


order to use this listeners. Managing Spectrum Fields
A chemical structure field. Spectrum Fields allow users to view and analyze
A property list with the following properties: spectrum images, using the same tools as Galactic
Molecular Weight and Molecular Formula. GRAMS32 software.
The listener has no custom properties associated If you associate the Spectrum Form Tool with a
with it. spectrum field, users can import spectrum images
of various types. The form tool allows users to copy
Managing the Validate Value Property and export spectrum images as well.
List Listener
The Validate Value Property List Listener allows
you to validate a value in a property list against an
external database, to ensure the value entered into
E-Notebook is valid. If it is not a valid value, the
user will be presented with an error message to that
effect.

Property IENPropertyListListener
List ProgID
Listener

To add a spectrum field:


Validate ENStandardCtl9.ValidateVal-
Value uePListener 1. In the Collection Tree, right-click the section
type to which you wish to add the spectrum
Clicking the Properties button after adding the field.
listener to a property list displays the following 2. Select Section Type Configuration from the
dialog. Here, you select the property to be validated menu that appears.

722 Managing Fields CambridgeSoft


Managing Data Fields
The Section Type Configuration dialog To add a stored document field:
appears.
1. In the Collection tree, right-click the Section
3. Right-click Fields, and select New Field. Type to which you wish to add the stored
document field.
The Add Field dialog appears. 2. Select Section Type Configuration from the
4. Type in a name, and select Spectrum from the
menu that appears.
drop-down list of field types. The Section Type Configuration dialog
appears.
5. Click Add. 3. Right-click Fields, and select New Field.
The new field appears in the list of fields.

6. In order for users to be able to import and


export the spectrum images, you must asso-
ciate the Spectrum Form Tool with the field.
The Add Field dialog appears.
Once you have added a field to the section type, you
may add it to the form for the section type. See
Configuring a Form on page 666 for more
information.

Managing Stored Document


4. Type in a name and select Stored Document
Fields from the drop-down list of field types.
5. Click Add.
With Stored Documents Fields, users can associate
document files with sections in E-Notebook. For The new field appears in the list of fields.
example, a document file may be an MS Excel 6. In order for users to be able to import and
spreadsheet or a PDF. Although the file cannot be export the stored documents, you must asso-
viewed from within E-Notebook, a user can be ciate the Active Document Form Tool with the
export it to a selected location, then open it and field.
view or edit it from there. Once you have added a field to the section type, you
may add it to the form for the section type. See
An example of a Stored Document Field is shown Configuring a Form on page 666 for more
below. information.

Managing Subsection Fields


With a subsection field, users may add sections that
appear as subtabs. This is one way to keep related
sections together in E-Notebook. An example of a

Chem & BioOffice 2006 /E-Notebook Managing Fields 723


Managing Data Fields
subsection field is shown below. In this example, The Field Properties dialog appears.
the subsection field contains two spectrum
sections, which appear as subtabs.
Administrator

7. Right-click Form Tools and select New Form


Tool.
A new form tool appears.

To add a subsection field:

1. In the Collection Tree, right-click the section 8. Enter the ProgID ENStandardCtl9.NewSec-
type to which you wish to add the field. tionFormTool in the right frame.
2. Select Section Type Configuration from the 9. Import icons for the form tool (clicking the
menu that appears. Import button and selecting an icon file).
The Section Type Configuration dialog 10. Click the Custom Properties button.
appears. A dialog appears, listing all of the section types
3. Right-click Fields, and select New Field. in E-Notebook.

The Add Field dialog appears.


4. Enter a name for the field and select Subsec-
tion from the list of field types.
5. Click Add.
The new field appears in the list of fields.
11. Select the section types you would like the user
6. If you would like users to be able to add new
to be able to add as subsections and click the
subsections, you must add the New Subsection Add button.
Form Tool to the field. Right click the field and
select Field Properties from the menu that The section types appear in the right frame.
appears. 12. Click the Close button to close the dialog.

724 Managing Fields CambridgeSoft


Managing Data Fields
13. Rename the form tool, by right-clicking it and Managing the Button View Subsection
selecting Rename Form Tool. This name will Listener
appear on the button the user will click to add
new subsections. The Button View Subsection Listener forces
subsections into button view, as shown below. A
Managing Subsection Field Listeners user may then scroll through the subsections using
the arrow buttons, or right-click a subsection name
Subsection field listeners are used to modify the and select Go To in order to browse to a specific
behavior of E-Notebook subsections. E-Notebook subsection.
provides a standard subsection listener:
Subsectio IENSubsectionListener
Button View Subsection Field Listener forces n Listener ProgID
subsections into button view.

To add a subsection field listener, Button ENStandardCtl9.Button-


View ViewSSListener
1. In the Collection Tree, right-click the section
type containing the subsection field, and select The Button View Subsection Listener has no
Section Type Configuration from the menu that custom properties.
appears.
The Section Type Configuration dialog Managing the Hide Tools Subsection
appears. Listener
2. Right-click the subsection field in the list of The Hide Tools Subsection Listener hides the form
Fields, and select Field Properties from the tool area of a subsection for more efficient screen
menu that appears. usage.
The Field Properties dialog appears.
Subsectio IENSubsectionListener
3. Click the Listeners tab. n Listener ProgID
The listeners tab appears.
Hide Tools ENStandardCtl9.HideToolsSS-
4. Right-click Listeners at the top of the left frame Listener
and select New Field Listener.
The New Field Listener dialog appears: The listener has no custom properties.
5. Enter the ProgID for the Field listener and click
OK Managing Table Fields
The New Field Listener dialog closes. Tables enable users to organize data in an easily
6. If the listener has custom properties, click the
interpreted, tabular format. Tables may contain
Properties button to configure them.
several basic types of data text data, numerical
data, dates, or structures. You may set up tables in
7. Close the properties dialog. different sections in E-Notebook to contain

Chem & BioOffice 2006 /E-Notebook Managing Fields 725


Managing Data Fields
different types of information. You may also Tables allow the following types of data:
associate table listeners with tables to modify their
behavior.
Administrator

Datatype User perspective

Date A user may click the date box, and type in a date and time.

Text A user may enter text.

Number A user may enter a number. A property may also be config-


ured to have units associated with it.

Structure A user may enter a chemical structure drawing.

Enumerated Value A user may choose a value from a drop-down list. The list
may either be a preconfigured list, or pulled from an external
database.

Validated Value A user may enter a value, which is validated against an


external database.

You may also configure table properties so that they Creating a Table Field
are read-only, or so that they must contain values
This topic provides instructions for adding a table
before a collection transition is performed.
to a section type and configuring the table.
Another feature of tables is the ability for users to To add a table:
add references to them. When a user adds a
1. In the Collection Tree, right-click the section
reference to a table, he may navigate to the
type to which you wish to add the table.
collection or section he has referenced, simply by
clicking a link in the table cell. 2. Select Section Type Configuration from the
menu that appears.
See the following topics for more information The Section Type Configuration dialog
about table fields: appears.

726 Managing Fields CambridgeSoft


Managing Data Fields
3. Right-click Fields, and select New Field. 2. Select Field Properties.
The Field Properties dialog appears.
3. Right-click the name of the field and select
New Property from the menu that appears.

The Add Field dialog appears.


4. Enter a name for the field and select Table from
the list of field types.

A new property appears in the tree. It's


attributes appear to the right:

5. Click Add.

The new field appears in the list of fields.

Adding a Property to the Table:


4. Type in a Name and Nickname for the prop-
erty. See step 4 in Creating a Property List on
NOTE: Note: The Properties you add to a Table will
page 713 for details.
initially appear as its columns. Once you have added the table
to a form, however, you may pivot the table so that the
properties appear as rows. Configuring the Appearance of a Table
To configure the appearance of a table:
1. Right-click the table field in the Section Type
1. Click the Appearance tab.
Configuration dialog.
The Appearance tab appears.
2. Select a Font from the drop-down list.
3. Select a font size from the Font Size drop-
down list.
4. Select whether or not the grid lines will be
displayed, by clicking the checkbox.
Once you have added a field to the section type, you
may add it to the form for the section type. See
Configuring a Form on page 666 for more
A menu appears. information.

Chem & BioOffice 2006 /E-Notebook Managing Fields 727


Managing Data Fields
Managing Database Values in Tables 6. Click the Properties button.

This topic provides instructions for configuring


database lookups in tables. Database lookups are
Administrator

used to pull in and display values from a database.


You may also validate a value that a user enters into
a table against an external database; see Managing
the Validate Value Table Listener on page 732 for
more information.

1. In the Collection tree, right-click the Section The Database Lookup Properties dialog
Type to you wish to configure. appears.
7. Enter the properties. See step 2 in Creating a
2. Select Section Type Configuration from the Database Table Field on page 705 for details.
menu that appears.
8. Click OK.
The Section Type Configuration dialog Several examples are given below. Note that the
appears. syntax of the query may vary depending upon the
type of database you are querying.
3. Right-click the Table Field in the list of Fields,
and select Field Properties from the menu that Example 1 Database Lookup Configuration
appears. In this example, all of the values for suppliername
are pulled in from the external database table
Suppliers. The values will appear in a drop-down list
in the property cell.

The Field Properties dialog appears.


suppliername value to be displayed in the
4. Click the Property for whose value(s) you wish table
to pull from an against an external database. Suppliers name of external database table
5. Click the drop-down arrow for Enumerator, Example 2 Database Lookup Configuration
and select Database Lookup.
In this example, the value suppliername is pulled
from the external database table Suppliers. The
suppliername displayed in the table field
corresponds to the value that a user has entered into

728 Managing Fields CambridgeSoft


Managing Data Fields
a property list that exists elsewhere in the The Section Type Configuration dialog
E-Notebook section. A user enters SupplierID into appears.
the Supplier ID property, which exists in a Property 3. Right-click the table field in the list of fields,
List named ID Number. and select Field Properties from the menu that
appears.

suppliername value to be displayed in the


table.
Suppliers name of external database table. The Field Properties dialog appears.
4. Click the property for which you would like to
SupplierID the supplier ID field in the
add the list of enumerated values.
external database table.
The attributes of the property appear to the
ID Number name of the E-Notebook prop- right.
erty list containing the Supplier ID property.
5. Click the drop-down arrow for the Enumer-
Supplier ID name of the E-Notebook prop- ator, and select Enumeration List.
erty into which a user enters the value for
SupplierID.

Managing Enumerated Values in Tables


You may configure a table property so that it will
contain a list of enumerated values. A user may then 6. Click the Properties button. Note: the button
select one of the values from the list. This list of will only be enabled for a property of data type
values may be either manually entered, as described text.
here, or pulled from an external database, as
described in the Managing Database Values in The Enumerated List Properties dialog
Tables topic. appears.
7. Click the Add Value button.
Associating a list of manually entered values A blank item appears in the list.
with a property
8. Enter a value.
1. In the Collection Tree, right-click the section 9. Click Add Value to add another value, or OK to
type containing table you wish to configure. close the dialog.
2. Select Section Type Configuration from the The values you entered will appear in a drop-
menu that appears. down list in the table.

Chem & BioOffice 2006 /E-Notebook Managing Fields 729


Managing Data Fields
Editing an Enumerated Values List stoichiometry grid with a chemical structure field,
and the addition of the Reaction Form Tool creates
1. In the Collection Tree, right-click the section
a Reaction Section.
type to you wish to configure.
Administrator

2. Select Section Type Configuration from the Reaction Sections allow users to draw a reaction in
menu that appears. the chemical structure field, then analyze the
The Section Type Configuration dialog reaction, automatically populating the
appears. stoichiometry grid with information about the
reactants and products. In addition, the Next Step
3. Right-click the table field in the list of fields,
function creates a new page or experiment
and select Field Properties from the menu that
containing the products of the chemical reaction.
appears.
The Field Properties dialog appears.
Table Listener IENTableListener
4. Click the property whose values you wish to ProgID
edit.
The attributes of the property appear to the Reactants ENStandardCtl9.Reac-
right. Enumeration List is displayed as the type tantsListener
of Enumerator.
5. Click the Properties button under the Enumer-
ator. Managing the Products Table Listener
The Enumerated List Properties dialog The products table listener calculates and displays
appears: properties of products in a stoichiometry grid. The
6. Click any of the values to edit it, or click table can be combined with a reactants field (a table
Remove Value to delete it. To move a value up field with the reactants table listener) to create a
or down in the list, click the Move Value Up or stoichiometry grid. The combination of the
Move Value Down button, respectively. stoichiometry grid with a chemical structure field,
7. Click OK to close the dialog. and the addition of the Reaction Form Tool creates
a Reaction Section.
Managing Table Listeners
Reaction Sections allow users to draw a reaction in
Table listeners are used to modify the behavior of the chemical structure field, then analyze the
E-Notebook tables. E-Notebook provides several, reaction, automatically populating the
standard table listeners. stoichiometry grid with information about the
See Managing Field Listeners for instructions on reactants and products. In addition, the Next Step
associating a field listener with a field. function creates a new page containing the
products of the chemical reaction.
Managing the Reactants Table Listener
The reactants table listener calculates and displays Table IENTableListener ProgID
properties of reactants in a stoichiometry grid. The Listener
table can be combined with a products field (a table
field with the products table listener) to create a Products ENStandardCtl9.ProductsListener
stoichiometry grid. The combination of the

730 Managing Fields CambridgeSoft


Managing Data Fields
Managing the Products Fixed Limiting Table Managing the Reactants Fixed Limiting Table
Listener Listener
This listener is similar to the Products Table
Listener. The difference is that the limiting This listener is similar to the Reactants Table
equivalents cannot vary if the Products Fixed Listener. The difference is that the limiting
Limiting listener is used. . equivalents cannot vary if the Reactants Fixed
Limiting listener is used.
Table IENTableListener ProgID
Listener Table Listener IENTableListener
ProgID
Products ENStandardCtl9.FixedLimit-
Fixed ingEqProducts Reactants Fixed ENReaction9.FixedLimit-
Limiting Limiting ingEqReactants

Managing the Add Reactant Table Listener


Managing the Block Reference In State Table
The Add Reactant Table Listener makes it possible Listener
for a user to populate the stoichiometry grid with
the properties of a reactant he selects from the The Block Reference In State Table Listener may be
Collection Tree. The user does this by right-clicking used to block users from adding a reference to a
within the table and selecting Add Reactant from specific type of collection that is in a particular state.
the menu that appears. If the listener is configured to block the reference,
the user will be unable to add the reference to the
Table Listener IENTableListener table. For example, you may wish to prevent users
ProgID
from adding table references to pages/experiments
that are in an archived state.
Add Reactant ENReaction9.AddReactant-
TListener
Table IENTableListener ProgID
Listener

Block ENStandardCtl9.BlockRefIn-
Reference StateTListener
In State

This table listener has custom properties associated


with it. You must select the collection type and state
corresponding to the references that will be
blocked. In the example below, a user will be
prevented from adding a reference to an Ancillary
File Version collection that is in the Draft state.

Chem & BioOffice 2006 /E-Notebook Managing Fields 731


Managing Data Fields
Note that you may associate multiple instances of field. In addition, you must associate the Analyze
this listener with a table, if you would like to prevent Reaction Chemical Structure Listener with the
users from adding references to several different reaction field.
collection types and/or several different states of a
Administrator

collection type. Active IENActiveDocListener


Managing the Validate Value Table Listener Document ProgID
Listener
The Validate Value Table Listener allows you to
validate a values of a property in a table against an
Analyze ENStandardCtl9.AnalyzeRx-
external database, to ensure the values entered into
Reaction nTListener
E-Notebook are valid. If a user enters a value that
is not valid, he will be presented with an error
message to that effect. This listener has no custom properties associated
with it.
Table IENPropertyListListener Managing the Unique Property Table Listener
Listener ProgID
The Unique Property Table Listener prevents
adding more than one property of the same type to
Validate ENStandardCtl9.ValidateVal- a table.
Value ueTListener

Table IENPropertyListListener
Clicking the Properties button after adding the
Listener ProgID
listener to a table displays the following dialog.
Here, you select the property to be validated from
the Property drop-down list. Then, enter the Unique ENStandardCtl9.UniqueProp-
database connection information and the SQL Property ertyTListener
string to be used for validating the value.
Managing the Analyze Reaction Table Listener Managing URL Display
The Analyze Reaction Table Listener automatically Fields
updates the reactants and products tables in a
URL Displays make it possible for users to store
stoichiometry grid when a user edits a reaction
URL's within E-Notebook and to display their
drawing. This listener must be associated with both
corresponding content. You may use a URL
the Reactants table field and the Products table
Display Field for either an internal intranet site or
an external webpage.

732 Managing Fields CambridgeSoft


Managing Data Fields
To create a URL Display field: The page corresponding to the URL appears.
1. In the Collection tree, right-click the Section You may navigate from within the displayed page, if
Type to which you wish to add the field. desired. Note, however, that the URL does not
change to reflect your navigation. If you wish to
2. Select Section Type Configuration from the
change the URL that is saved with the section type,
menu that appears.
you must type in another address.
The Section Type Configuration dialog
appears. Managing Search Fields
3. Right-click Fields, and select New Field.
Several field types are designed for use exclusively
The Add Field dialog appears. within search forms, to search for data in
E-Notebook. They are:
Chemical Query Fields
Collection Query Fields
Collection Type Query Fields
Query Text Fields
4. Enter a name for the Field and select URL
Display from the list of Field Types. State Query Fields
Property Query Fields
Table Query Fields
Unannotated Version Query Fields
Search Location Fields
Join Type Fields
5. Click Add. See Managing Data Fields for information about
The new field appears in the list of fields. the other E-Notebook Fields.
Once you have added a field to the section type, you Chemical Query Fields
may add it to the form for the section type. See
Configuring a Form on page 666 for more Chemical Query Fields are used in search forms, for
information. finding chemical structures in E-Notebook tables
and chemical structure fields.
After you have added the URL Display Field to a
form, you may enter a URL and display its
corresponding page. Each time a user creates
a section of this type, the URL and its content will
appear.
To do this:
1. Enter the URL address as shown above. In this
example, http://www.cambridgesoft.com was The search is a substructure search. See the User
entered. Guide if you would like more information on
2. Click the Go button to the right of the address. structure searching.

Chem & BioOffice 2006 /E-Notebook Managing Fields 733


Managing Search Fields
To create a Chemical Query Field: Users must select each of the criteria they wish to
specify for the search.
1. In the Collection tree, right-click the section
type to which you wish to add the field. To create a Collection Query Field:
Administrator

2. Select Section Type Configuration from the 1. In the Collection tree, right-click the section
menu that appears. type to which you wish to add the field.
The Section Type Configuration dialog 2. Select Section Type Configuration from the
appears. menu that appears.
3. Right-click Fields, and select New Field. The Section Type Configuration dialog
The Add Field dialog appears. appears.
3. Right-click Fields, and select New Field.
The Add Field dialog appears.

4. Enter a name for the field and select Chemical


Query from the list of field types.
4. Enter a name for the field and select Collection
Query from the list of field types.

5. Click Add.
The new field appears in the list of fields.
Once you have added a field to the section type, you 5. Click Add.
may add it to the form for the section type. See The new field appears in the list of fields.
Configuring a Form on page 666 for more Once you have added a field to the section type, you
information. may add it to the form for the section type. See
Configuring a Form on page 666 for more
Collection Query Fields information.
Collection Query Fields are used in search forms,
for finding collections that match the metadata
criteria that a user specifies:

734 Managing Fields CambridgeSoft


Managing Search Fields
Collection Type Query Fields The new field appears in the list of fields.

Once you have added a field to the section type, you


Collection Type Query Fields are used in search
may add it to the form for the section type. See
forms, for specifying the collection type over which
Configuring a Form on page 666 for more
a search is run. For example, a user may specify a
information.
Page, or an Experiment, so that any other type of
collection will not be included in the search results.
Join Type Fields
Join Type fields are used in search forms. They
Users must select this item in the search form in make it possible for a users conduct a search that is
order to specify it for the search. a union of two searches, an intersection of two
searches, or a subtraction of one set of search
To create a Collection Type Query Field: results from another. A join field is shown below:

1. In the Collection tree, right-click the section


type to which you wish to add the field.
2. Select Section Type Configuration from the
menu that appears.
The Section Type Configuration dialog To create a join type field:
appears.
1. In the Collection tree, right-click the section
3. Right-click Fields, and select New Field.
type to which you wish to add the field.
The Add Field dialog appears.
2. Select Section Type Configuration from the
menu that appears.
The Section Type Configuration dialog
appears.
3. Right-click Fields, and select New Field.
4. Enter a name for the field and select Collection The Add Field dialog appears.
Type Query from the list of field types.
4. Enter a name for the field and select Join Type
from the list of field types.
5. Click Add.

The new field appears in the list of fields.


Once you have added a field to the section type, you
may add it to the form for the section type. See
Configuring a Form on page 666 for more
5. Click Add. information.

Chem & BioOffice 2006 /E-Notebook Managing Fields 735


Managing Search Fields
Property Query Fields The new field appears in the list of fields.
Once you have added a field to the section type, you
Property Query Fields are used in search
may add it to the form for the section type. See
forms. They make it possible for a users to search Configuring a Form on page 666 for more
Administrator

for specific properties in E-Notebook property information.


lists. (Note that Table Query Fields are used to
search for properties in E-Notebook tables).
Query Text Fields
Query Text Fields are used in search forms. The
following fields data in E-Notebook is searched
when a user runs a search that contains query text:

MS Word Fields
To create a Property Query Field: Styled Text Fields

1. In the Collection tree, right-click the section Property Lists


type to which you wish to add the field. Tables
2. Select Section Type Configuration from the Text in chemical structure fields
menu that appears.
MS Excel Fields
The Section Type Configuration dialog
Certain types of stored document files MS
appears.
Word, MS Excel, MS PowerPoint
3. Right-click Fields, and select New Field.

The Add Field dialog appears.

To create a Query Text Field:

1. In the Collection tree, right-click the Section


Type to which you wish to add the field.
2. Select Section Type Configuration from the
4. Enter a name for the field and select Property menu that appears.
Query from the list of field types.
The Section Type Configuration dialog
5. Click Add. appears.
3. Right-click Fields, and select New Field.

The Add Field dialog appears.

736 Managing Fields CambridgeSoft


Managing Search Fields
4. Enter a name for the field and select Query 4. Enter a name for the field and select State
Text from the list of field types. Query from the list of field types.

5. Click Add.
5. Click Add.
The new field appears in the list of fields.
The new field appears in the list of fields.
Once you have added a field to the section type, you
may add it to the form for the section type. See Once you have added a field to the section type, you
Configuring a Form on page 666 for more may add it to the form for the section type. See
information. Configuring a Form on page 666 for more
information.
State Query Fields
Table Query Fields
State Query Fields are used in search forms. They
make it possible for a user to specify the state of the Table Query Fields are used in search forms. They
collections over which a search is conducted. For make it possible for a users to search for specific
example, a user may only want to search for properties in E-Notebook tables. (Note that
Collections that were in the Closed state as of a Property Query Fields are used to search for
particular date. properties in E-Notebook property lists).

To create a State Query Field:


1. In the Collection Tree, right-click the section
type to which you wish to add the field.
2. Select Section Type Configuration from the
menu that appears.
To create a Table Query Field:
The Section Type Configuration dialog
appears. 1. In the Collection tree, right-click the Section
3. Right-click Fields, and select New Field. Type to which you wish to add the field.
The Add Field dialog appears. 2. Select Section Type Configuration from the
menu that appears.
The Section Type Configuration dialog
appears.
3. Right-click Fields, and select New Field.

Chem & BioOffice 2006 /E-Notebook Managing Fields 737


Managing Search Fields
The Add Field dialog appears. The Add Field dialog appears.
Administrator

4. Enter a name for the field and select Table 4. Enter a name for the field and
Query from the list of field types. select Unannotated Version Query from the list
of field types.

5. Click Add.
The new field appears in the list of fields. 5. Click Add.
Once you have added a field to the section type, you The new field appears in the list of fields.
may add it to the form for the section type. See
Configuring a Form on page 666 for more Once you have added a field to the section type, you
information. may add it to the form for the section type. See
Configuring a Form on page 666 for more
Unannotated Version Query information.
Fields Search Location Fields
Unannotated Version Query Fields are used in
Search Location Fields are used in search
search forms. They make it possible for a users to
forms. They make it possible for a users to search
search for collections in which changes that
for collections and sections that exist in a particular
required annotation have been made, but for which
branch of the Collection Tree.
no annotation has been provided.

To create an unannotated version query field:


1. In the Collection Tree, right-click the section
type to which you wish to add the field.
2. Select Section Type Configuration from the
menu that appears.
The Section Type Configuration dialog
appears.
3. Right-click Fields, and select New Field.

738 Managing Fields CambridgeSoft


Managing Search Fields
To create a search location field: Chemical Structure and Table field types, but you
can also develop custom field types to manage
1. In the Collection tree, right-click the section specialized kinds of data or perform complex tasks.
type to which you wish to add the field.
For information about each of the standard types of
2. Select Section Type Configuration from the
fields and their properties, see Managing Fields.
menu that appears.
The Section Type Configuration dialog To access the Add-In Configuration and view or
appears. edit the E-Notebook field types,
3. Right-click Fields, and select New Field. 1. Right-click any blank area of the Collection
The Add Field dialog appears. Tree.
A menu appears.

4. Enter a name for the field and select Search


Location from the list of field types.

2. Select Add-In Configuration .


The System Configuration dialog appears.
5. Click Add.
The new field appears in the list of fields.
Once you have added a field to the section type, you
may add it to the form for the section type. See
Configuring a Form on page 666 for more
information.

Managing the Add-In


Configuration
The Add-In Configuration dialog contains
information about the field types that are used as
the basis for fields in E-Notebook. E-Notebook This dialog displays the following information
provides a number of standard field types, such as about each of the Field Types:

Chem & BioOffice 2006 /E-Notebook Managing Fields 739


Managing the Add-In Configuration
Field Type the name of the field type that implements the corresponding
IENFormTool ProgID the programmatic interface. The format is:
OleServerName.ObjectName.
identifier that the Windows registry uses to
uniquely identify the object that implements IENFormToolCtl ProgID the
Administrator

the corresponding interface. The format is programmatic identifier that the Windows
OleServerName.ObjectName. registry uses to uniquely identify the object
that implements the corresponding
IENFormToolCtl ProgID the program-
interface. The format is
matic identifier that the Windows registry uses
OleServerName.ObjectName.
to uniquely identify the object that implements
the corresponding interface. The format is License Key if necessary.
OleServerName.ObjectName. Active an indication of whether new fields
License Key of this type may be used in section types. If
the checkbox is selected, the field type is
Active an indication of whether new fields of active.
this type may be added to section types
Deleting a Field Type
Changing a Field Type
You may only delete field types that are not in use
To change the information for a particular field within E-Notebook section types.
type:
To delete a field type:
1. Click the field type in that you wish to edit in 1. From the Add-In Configuration dialog, click
the list. the field type in that you wish to delete.
The field type is highlighted. The field type is highlighted.
2. Edit any of the information for the field type, 2. Click the Delete button.
changing its name, ProgID's, license key, or A message appears, asking you to confirm that
active status. you wish to delete the field Type.
3. Click the Change button. 3. Click Yes.
Your changes are saved. If the field type is not used in an E-Notebook
section type, it is deleted. Otherwise, an error
Adding a new Field Type message appears, notifying you that the field
type is in use and cannot be deleted.
To add a new field type to E-Notebook:

1. From the Add-In Configuration dialog, click


Time Settings
the New Field Type button. Whenever a date or time is displayed in
2. Fill in the following information: E-Notebook, it is displayed with a time zone bias
from UTC (Coordinated Universal Time). The
Field Type the name of the Field Type format of the time zone bias is +HHMM. The plus
IENFormTool ProgID the sign indicates time zones that are east of UTC to the
programmatic identifier that the Windows international date line by a specified number of
registry uses to uniquely identify the object hours and minutes (Paris to Auckland and beyond);

740 Managing Fields CambridgeSoft


Time Settings
a minus sign indicates time zones that are west of time to 09:00:01 AM, then the date appears in the
UTC to the international date line (Azores to property list as 06-01-2004 09:00:01 AM -0800.
Midway Island, and beyond). When user C in London views the date, it will
appear as 01-06-2004 09:00:01 AM -0800 because
Dates appear in the following locations: user Cs date settings on their client machine specify
1. The history display
that days appear before months in short dates.

2. The Collection Properties dialog box In the query table field type control, the collection
3. The Version Properties dialog box query field type control and the state query field
type control, only the date is specified, along with a
4. The Session Manager dialog box time zone. When searching, the dates are converted
5. The properties field type control to UTC using the time zone associated with the
date. The time zone appears in a popup menu next
6. The tables field type control
to the date. In the event of editing a section
7. The query table field type control containing one of these field types, if the stored
8. The collection query field type control time zone is different from the time zone of the
client machine, the popup menu will contain the
9. The state query field type control time zone of the client machine as well, so that the
10. The table of contents user can change the query to match the time zone
of the client machine.
In the history display, the Collection Properties
dialog box, the Version Properties dialog box and
Queries by date compare the 24 hour period that
the Session Manager dialog box, dates are
conforms to the date specified by time zone
displayed using the time zone of the client machine
associated with the query date. For example, if a
that generated the date. For example, the time of a
user in California searches for date properties with
version is displayed in the time zone of the user
a value of 06-01-2004 -0800 then any date
who saved the version; the time of an annotation is
property with a value between 06-01-2004 08:00:00
displayed in the time zone of the user who created
AM +0000 and 06-02-2004 07:59:59 AM +0000
the annotation.
(inclusive) matches that date, wherever it was
In the properties and tables field type controls, entered in the world.
when a user is about to edit a date, the date to be
edited is changed to the corresponding time stamp In the Table of Contents, only dates appear, with no
of the editing user's time zone. For example, User A time zone reference. The date corresponds to the
in New Jersey enters a date of June 1, 2004 12:00:00 date in the time zone of the generator of the date.
PM in a date property in a property list. After
editing, the date appears as 06-01-2004 12:00:00 Managing Units in Prop-
PM -0500. User B in New Jersey views the
property list with the saved date and the date erty Lists and Tables
appears the same. If User B decides to edit the date,
then, when the edit controls appear, the edit You may associate the following types of
controls are initialized with the date 06-01-2004 measurements with a property in a property list or
09:00:00 AM. If the user makes no changes, then table. The units may then be specified or displayed
the value does not change. If the user changes the in the several units shown. Note that in all cases, the

Chem & BioOffice 2006 /E-Notebook Managing Fields 741


Managing Units in Property Lists and Tables
standard units are the SI units for the given type,
which may not be the units commonly entered or Type of Standard Permitted
displayed. Measurement Units Units
Administrator

Type of Standard Permitted molarity mol/m3 mol/l


Measurement Units Units (quantity per molar
volume of solu- mmolar
tion) molar
density kg/m3 g/ml
g/ml
mg/ml moles mol mmol
g/l (quantity of mol
mg/l substance) mol
g/l
kg/l normality mol/m3 N
kg/m3 (ion equivalents mN
per volume of N
length m m solution)

nm pressure Pa atm
m Pa
mm kPa
cm torr
bar
mass kg g mbar
g
mg temperature K C
kg K
F
molality mol/kg mol/kg
(quantity per mass mol/g time s s
of solvent or mmol/kg ms
substrate) mmol/g s
mol/kg min
mol/g hr

molar mass kg/mol g/mol velocity m/s m/s


kg/mol km/hr
dalton mi/hr
D
kD

742 Managing Fields CambridgeSoft


Managing Units in Property Lists and Tables
Entry of data
Type of Standard Permitted
Measurement Units Units When a user enters a value for a property list entry
or table cell which has been defined as a type that
volume m3 ml has units, the text is interpreted as follows:
l Leading and trailing spaces are removed.
l A trailing period, if present, is removed.
m3
If a hyphen, dash, or minus sign is present and
not the first character of the string, the string is
Specification of Units deemed to represent a range, and divided into
the part before and the part after the first such
To specify the units for a property in a property list character. Spaces surrounding the character are
or table: discarded. Each string is further interpreted
according to the subsequent rules.
1. In the Section Type Configuration dialog, The string is tested iteratively, beginning with
right-click the field containing the property the entire string, and truncating one character
whose units you wish to set. off the end during each iteration, until a string
is found which is determined to be numeric, as
2. Select Field Properties from the menu that defined by the Visual Basic IsNumeric function.
appears. If no such leading numeric substring is found,
the string is deemed uninterpretable.
The Properties dialog appears.
The remaining part of the string after removing
3. Click the property in the tree to select it. the leading numeric substring and any
contained spaces is compared against the list of
The attributes of the property are displayed. units permitted for this type. If this string is not
empty, and a match is not found, the string is
The Units list will be disabled if the Type is
deemed uninterpretable.
text, number, date, or structure. Otherwise, its
contents will change to reflect the permitted If the string was found to consist of a range,
units for the unit type you have selected. The and a valid units designation was found only
default selection in the units list will be the first for the second element of the range, that units
designation is used for both elements.
units in the list, which will be ordered as in the
table above. If no units designation is present, then the
default units designation is applied.
4. Select the default Units from the Units drop-
Note that all measurements described in this topic
down list. are stored in an E-Notebook property lists or
These are the units that will be displayed by tables. This topic does not apply to quantities in
text fields.
default when a user enters only a numerical
value into the cell.

Chem & BioOffice 2006 /E-Notebook Managing Fields 743


Managing Units in Property Lists and Tables
Administrator

744 Managing Fields CambridgeSoft


Managing Units in Property Lists and Tables
Chapter 39: Managing Collection
Types
Information in E-Notebook is organized into Search Engines A search engine allows users to
collections, which are the items that appear in the search for information in E-Notebook. For
collection tree. When a user creates a collection, the example, the collection search engine makes it
properties and content of the collection are possible to search for collections that match certain
determined by the collection type, which you metadata criteria, such as creation date and owner.
configure as an administrator. Collection Listeners collection listeners modify
You may configure a collection type such that any behaviors of collections, such as the move or create
of the following are associated with it: behaviors. An example is the User Collection
Listener, which displays a dialog for entry of
Section Types collection types may be UserID, user name, etc., when a new user is created.
configured so that they contain section types, which
are the E-Notebook data forms. A page or Form Tools form tools perform a certain
experiment is an example of a collection type that function when a user selects themfor example,
contains section types. Alternatively, a collection creating a new collection or a new section.
typefor example, a foldermay not have section
See the following topics for more information:
types associated with it, but may simply contain
other collection types. Creating a New Collection Type on page
746.
Contained Collection Types A contained
collection is a collection that may exist within Adding a Section Type to a Collection Type
a particular collection in the collection tree. For on page 747.
example, a user group may contain users; user is a Managing Contained Collection Types on
contained collection type within the user group page 749.
collection type. Or, notebooks may contain Managing Contained Reference Types on
experiments; experiment is a contained collection page 750.
type within the notebook collection type.
Managing Collection Listeners on page 753.
Contained Reference Types A contained Managing Collection Type Form Tools on
reference is a shortcut that allows E-Notebook page 762.
users to view a collection from elsewhere in the
collection tree. Any changes made to the original Managing States and Transitions on page
are reflected in the reference. 768.
Configuring Change Control Options on
States a state is a condition that defines certain
page 776.
properties of a collection, such as whether the
collection may be edited. Multiple states may be Managing Templates on page 761.
used to define the life cycle of a collection. You may Managing Export Templates of Collection
configure change control options based on state. Types on page 779.

Chem & BioOffice 2006 /E-Notebook Managing Collection Types 745


Creating a New Collec- The entire Collection Tree appears, showing
the Configuration Folder.
tion Type
Collections organize related information in
Administrator

E-Notebook, and each collection appears as an


item in the Collection Tree. When you create a new
collection type, you create a new means of
organizing information in E-Notebook. For
example, you could create a collection type of
Project or Experiment. E-Notebook Users would
then be able to use these Projects or Experiments
to organize their information in E-Notebook.

When you create a new collection type, you define


the rules that determine which sections users can
add to collections of this type. Also, you set up the 3. If you wish, you may right-click the Configura-
rules that govern how the collection type is related tion Folder and select Browse Here, so that the
to other collection types in the Collection Tree: Configuration Folder will appear at the top of
where can a new collection of this type be created, the Collection Tree.
and what types of collections can be created within
it? You can set up the rules that are modeled after
your workflow.

To create a new collection type:

1. Right-click a blank area of the Collection Tree.

A menu appears.
2. Select Browse All.

4. Right-click the Collection Types folder and


select New, then Collection Type.
A new Collection Type appears within the
Collection Types folder, and you are prompted
to rename it.
5. Enter a name for the Collection Type.
6. Right-click the new Collection Type and select
Collection Type Configuration .

746 Managing Collection Types CambridgeSoft


Creating a New Collection Type
The Collection Type Configuration dialog Once you have created the collection type, you will
appears. want to configure it. See the related topics for
instructions.

Adding a Section Type to


a Collection Type
By adding sections types to a collection type, you
determine which sections an E-Notebook user can
add to that collection type in E-Notebook. For
example, and Experiment/Page may have several
section types associated with it, including reaction
7. Specify the following information: sections or MS Word sections. When a user creates
Plural Name the name applied to an Experiment/ Page, he may add any of these
multiple collections of this type. sections to the Experiment/Page.

Icon Name the icon to be associated with You may configure a collection type such that a
the collection type in the Collection Tree. particular section appears by default, or, you may
configure it so that the user can add the section if
8. If you would like the collection type to be used
desired.
as an organizational tool for administrators,
you may select any of the following options. To add a section type to a collection type:
Normally these options are not selected for
new collection types. In the default E-Note- 1. Right-click the collection type to which you
book setup, only Folders, such as the Collec- wish to add the section type, and select
tion Types folder, may contain collection types Collection Type Configuration from the menu
and section types. that appears.

Can Contain Collection Types a check The Collection Type Configuration dialog
mark indicating whether administrators may appears.
add collection types to this collection type. 2. Expand Form Tools, and right-click the New
Section Form Tool.
Can Contain Section Types a checkbox
indicating whether administrators may add NOTE: It may be necessary for you to add this form
section types to this collection type. tool to the collection type. See Managing the New
Can Contain Collection Type References Section Form Tool on page 661 for more information).
a checkbox indicating whether new
administrators may add references 3. In the right frame, click the Custom Properties
(shortcuts) to collection types to this button.
collection type. A dialog appears, listing all of the section types
Can Contain Section Types a checkbox in the left panel.
indicating whether administrators may add 4. Click the section type(s) you wish to add. You
references (shortcuts) to section types to may use Ctrl+click to select multiple section
this collection type. types, or Shift+click to select a range.

Chem & BioOffice 2006 /E-Notebook Managing Collection Types 747


Adding a Section Type to a Collection Type
5. Click the Add>> button. 2. Select a section type from the list.
The section type(s) are moved into the right The section appears.
panel.
3. If you wish, you can add data to the section, or
6. Click the Close button.
Administrator

change the appearance of the section. The


The Section Types dialog closes. The section alterations you make will appear only when an
type(s) are added to the collection type. When E-Notebook user creates this particular type of
a user creates the collection in E-Notebook, he collection.
will be able to add these sections to it.
Removing a Section Type
Having a Section Appear by from a Collection Type
Default
If you no longer wish to include a particular section
If you would like a section to appear automatically type in a collection type, you can remove the section
when a user creates the collection: type.
1. Click the New Default Section button in To do this:
the right frame.
1. Right-click the collection type from which you
A menu appears, listing all of the E-Notebook
section types. wish to remove the section type, and select
Collection Type Configuration from the menu
that appears.
The Collection Type Configuration dialog
appears.
2. Expand Form Tools, and right-click the New
Section Form Tool.
3. In the right frame, click the Custom Properties
button.
A dialog appears, listing of the section types in
the right panel.

748 Managing Collection Types CambridgeSoft


Removing a Section Type from a Collection Type
4. Click the section type(s) you wish to remove. Adding a Contained Collec-
You may use CONTROL+click to select
multiple section types, or SHIFT+click to
tion Type
select a range. To add a contained collection type to a collection
5. Click the Remove>> button. type.
The section types are moved to the left pane.
1. In the Collection Tree, right-click the collection
6. Click the Close button.
type that is to be the parent collection and
The dialog closes, and the section type can no select Collection Type Configuration.
longer be added to the collection type.
In this example, user group is the parent
collection type, and we are adding the ability to
NOTE: If you have added the section to the collection type,
create foldersthe contained collection
so that the section will appear automatically in
typewithin user groups.
E-Notebook when a user creates the collection, you must
delete the existing section from the collection type. The Collection Type Configuration dialog
appears.
2. Right-click Contained Collection and Page
Managing Contained Types.
Collection Types A menu appears with the option New
Contained collection types are collections that may Contained Collection or Page Type.
exist within a particular collection in the Collection 3. Select New Contained Collection or Page Type.
Tree. For example, a user group may contain users;
A dialog box appears, listing the collection
user is a contained collection type within the user
types in E-Notebook (and their corresponding
group collection type. Or, notebooks may contain
templates).
experiments; experiment is a contained collection
type within the notebook collection type. 4. Click the collection type you wish to add, and
click the Add button.
This topic covers adding and removing contained
collection types, and changing the relationship 5. The new contained collection type appears in
between a contained collection type and the parent the left pane. In the right pane, the features of
collection type. the contained collection type within the parent
(or container) collection are displayed.

For example, if the contained Collection is the


child within the parent collection:
New children can be added to parents.

Chem & BioOffice 2006 /E-Notebook Managing Collection Types 749


Managing Contained Collection Types
Copies of existing children can be added to Removing a Contained
parents. Collection Type from a
Children can be deleted from parents. Collection Type
Administrator

Children can be moved into parents. If you wish to remove a contained collection type:
Children can be removed from parents and 1. In the Collection Tree, right-click the the
moved into different collections. parent collection type and select Collection Type
Configuration.
6. Click the checkboxes to select the features you The Collection Type Configuration dialog
wish to apply to the contained collection type. appears.
2. Click the plus sign to expand the contained
Changing the Relationship collection types.
between a Contained Collec- 3. Right-click contained collection type you wish
to remove, and select Delete Relationship from
tion Type and the Parent the menu that appears.
Collection Type
To change the relationship between a contained col-
lection type and its parent collection type:

1. In the collection tree, right-click the parent


collection type and select Collection Type
Configuration.

The Collection Type Configuration dialog A message appears, asking you to confirm that
appears. you wish to delete the relationship.
4. Click Yes.
2. Click the plus sign to expand the contained
The contained collection type is deleted. Note
collection types. that this change will not affect the relationships
that users have already created. It will only
3. Click the contained collection type for which
apply going forward.
you wish to change the relationship.

The relationship features appear to the right.


Managing Contained
Reference Types
4. Select or deselect the features as desired.
You can set up a collection type to permit users to
5. Click the Close button in the upper right add references to other collection types. A
corner to close the Collection Type Configu- contained reference type differs from a contained
ration dialog. collection type, because a reference is a shortcut

750 Managing Collection Types CambridgeSoft


Managing Contained Reference Types
that allows an E-Notebook user to view an original The Collection Type Configuration dialog
from elsewhere in the Collection Tree. Any changes appears.
made to the original are reflected in the reference.

This topic covers adding and removing contained


reference types, and changing the relationship
between a contained reference type and the parent
collection type.

Adding a Contained Refer- 2. To expand the collection type to which you


wish to add a contained reference type, either
ence Type double-click it or click the plus sign next to it.
3. Right-click Contained Reference Types.
To add a contained reference type to a collection
type: A menu appears with the option New
Contained Reference Type.
1. In the Collection Tree, right-click the collection 4. Select New Contained Reference Type.
type that is to be the parent collection type and A dialog box appears, listing the collection
select Collection Type Configuration. types in E-Notebook (and their corresponding
Templates).
In this example, user group is the parent
collection type, and we are adding the ability to 5. Click the collection type you wish to add as a
contained reference type, and click the Add
create references to foldersthe contained
button.
reference typewithin user groups.
6. The new contained reference type appears in
the left pane. In the right pane, the features of
the contained reference type within the parent
collection are displayed. For example, if the
contained reference is the child within the
parent collection:
New references to children can be added to
parents.
Copies of existing references to children can
be added to parents.
References to children can be deleted from
parents.
References to children can be moved into
parents.
References to children can be removed from
parents and moved into different
collections.

Chem & BioOffice 2006 /E-Notebook Managing Collection Types 751


Managing Contained Reference Types
7. Click the checkboxes to select the features you 3. Right-click the contained reference type you
wish to apply to the contained reference type. wish to remove, and select Delete Relationship
from the menu that appears.
Changing the Relationship
A message appears, asking you to confirm that
Administrator

between a Contained Refer- you wish to delete the relationship.


ence Type and the Parent 4. Click Yes.
Collection Type
The contained reference type is deleted. Note
To change the relationship between a contained ref- that this change will not affect the relationships
erence type and its parent collection type: that users have already created. It will only
apply going forward
1. In the Collection Tree, right-click the parent
collection type and select Collection Type
Configuration.
Configuring Relation-
The Collection Type Configuration dialog ships to Unspecified
appears. Types of Collections
2. Click the plus sign to expand the contained
reference types. E-Notebook has an Unspecified Types of
Collections feature that you can use to configure
3. Click the contained reference type for which
the relationship between a container collection type
you wish to change the relationship. and any collection type for which no relationship is
The relationship features appear to the right. explicitly defined. For example, if you add
4. Select or deselect the features as desired.
Unspecified Types of Collections as a contained
collection type within a Folder collection type, the
5. Click the Close button in the upper right relationship you define will apply to all of the
corner to close the Collection Type Configu- E-Notebook collection types, excluding collection
ration dialog. types for which an individual relationship is set up.

Removing a Contained In the example below, users will be able to add or


Reference Type from a delete any type of collection from a Folder. The
features of Reactant collections within Folders may
Collection Type be different, however, because this relationship is
defined separately:
If you wish to remove a contained reference type:

1. In the Collection Tree, right-click the the


parent collection type and select Collection Type
Configuration.
The Collection Type Configuration dialog
appears.
2. Click the plus sign to expand the contained
reference types.

752 Managing Collection Types CambridgeSoft


Configuring Relationships to Unspecified Types of Collections
Unspecified Types of Collections and Adding a Collection Listener
Unspecified Types of Template appear in the list
of collection types when you add a new contained
to a Collection Type
collection type or contained reference type.
You can associate a collection listener with a
collection type if you would like a particular
function to occur when a user takes an action on a
collection. For example, if you create a new user and
the user collection listener is associated with the
user collection type, a dialog will appear prompting
you to enter a LoginID and other pertinent
information.

See Managing the Standard Collection Listeners


on page 755 for information about the various
collection listeners that E-Notebook provides.

To add a collection listener to a collection type:

1. Right-click the collection type in the Collection


Tree, and select Collection Type Configuration
Managing Collection from the menu that appears.
Listeners 2. Right-Click Collection Listeners and select
New Collection Listener from the menu that
Collection listeners modify the behaviors of appears.
collectionssuch as the creating, hiding, renaming,
duplicating, and moving behaviors. E-Notebook A new collection listener appears and you are
provides several, standard collection listeners that prompted to rename it.
you may associate with collection types. See the 3. Type in a name for the collection listener.
following topics for more information:
4. Enter the IENCollectionListener ProgID for
Adding a Collection Listener to a Collection the Listener you wish to add. (This is the
Type on page 753. programmatic identifier that the Windows
registry uses to uniquely identify the object that
Viewing and Editing the Properties of a implements the corresponding interface. The
Collection Listener on page 754. format is OleServerName.ObjectName).
Removing a Collection Listener from a The collection listener is associated with the
Collection Type on page 754. collection type.
Managing the Standard Collection Listeners 5. To close the Collection Type Configuration
on page 755. dialog, click the close button in the upper
right corner.
You may also develop your own, customized
collection listeners to perform additional functions. The dialog closes.

Chem & BioOffice 2006 /E-Notebook Managing Collection Types 753


Managing Collection Listeners
Viewing and Editing the 2. If necessary, click the plus sign next to Collec-
tion Listeners to view the collection listeners
Properties of a Collection that are associated with this collection type.
Listener Click the collection listener whose properties
Administrator

you wish to view or edit.


You can view and edit the custom properties that
you may be associated with a collection listener. To 3. Click the Custom Properties button.
do this:
1. Right-click the collection type that contains the
listener in the Collection Tree, and select
Collection Type Configuration from the menu
that appears.

The Collection Listener Properties dialog


appears. This example shows the dialog for the
Auto Number Listener, which is one of the
standard E-Notebook collection listeners.
(Note that if the collection listener has no
custom properties associated with it, a message
to that effect will appear when you click the
Custom Properties button).
4. Edit the properties, if you wish.

5. Click OK to close the dialog.

6. To close the Collection Type Configuration


dialog, click the close button in the upper right
corner.

The Collection Type Configuration dialog The dialog closes and your changes are saved.
appears.
Removing a Collection
Listener from a Collection
Type
If you no longer want a particular collection listener
to be associated with a collection type, you can
remove it from the collection type.

754 Managing Collection Types CambridgeSoft


Managing Collection Listeners
To do this: 4. Select Delete Collection Listener.

1. Right-click the collection type that contains the A message appears, asking you to confirm that
listener in the Collection Tree, and select you wish to delete the collection listener.
Collection Type Configuration from the menu 5. Click Yes.
that appears.
The collection listener is removed from the
collection type.
6. To close the Collection Type Configuration
dialog, click the close button in the upper right
corner.
The dialog closes.

Managing the Standard


Collection Listeners
E-Notebook provides several, standard collection
listeners that you may associate with collection
types. Collection listeners are used to modify the
behaviors of collectionssuch as the creating,
hiding, renaming, duplicating and moving
behaviors.

The Collection Type Configuration dialog Managing the Auto Number Collection
appears. Listener
2. If necessary, click the plus sign next to Collec- The Auto Number Listener is used to automatically
tion Listeners to view the collection listeners name newly created collections by appending a
that are associated with this collection type. serial number to the name of the collection that
3. Right-click the collection listener you wish to contains the newly created collection.
remove from the collection type.
For example, if a Notebook collection contains
A menu appears. experiments and the notebook is named NB-001,
the Auto Number Collection Listener can be
associated with the Experiment collection type to
automatically number experiments within the
collection (for example, NB-001-001).

Listener Listener ProgID

Auto Number ENStandard9.AutoNum-


berListener

Chem & BioOffice 2006 /E-Notebook Managing Collection Types 755


Managing Collection Listeners
The Auto Number Listener has three custom Managing the Change Display Collec-
properties: minimum, increment, and maximum. tion Listener
The minimum is used to specify the serial number The Change Display Collection Listener is used to
of the first newly created collection. The increment enable Visual Display of Changes when a user
Administrator

is used to specify the increment between newly creates a particular type of collection. (See
created collections. The maximum is used to limit Managing Visual Display of Changes on page
the number of collections that can be contained. 776).

Listener Listener ProgID

Change Display ENStandard9.ChangeDisplay-


Listener

The Change Display Collection Listener is used to


enable Visual Display of Changes from collection
When renaming a collection whose name was creation onward. Note that there is also a transition
generated with the Auto Number Collection listener that enables Visual Display of Changes
Listener, the collection will check to ensure that the when a particular transition is performed on a
name fits within the parameters described by the collection. See Managing the Change Display
Auto Number Listener properties. The name must Transition Listener on page 772 for more
begin with the name of the parent collection information.
followed by a dash and a serial number.
Managing the Clear Value Collection
Listener
Managing the Audit Collection Listener
The Clear Value Collection Listener is associated
The Audit Collection Listener is used to prevent with a collection type containing sections with
tables/property fields. This listener can be used to
users from deleting a collection if the collection has
clear specified properties in tables or property list
been modified since it was created. If this listener is
fields when a collection is duplicated.
associated with a collection type, then the delete
command will be disabled if the collection has been For example, you may wish to clear the table section
of a collection when a user duplicates that section.
modified.

Listener Listener ProgID


Listener Listener ProgID

Clear Value ENStandard9.ClearValue-


Audit Collection ENStandard9.AuditCollec-
CListener
tionListener

With the Custom Properties of the listener, you


This collection listener has no custom properties specify the section type, the field, and the property
associated with it. whose values are to be cleared. The top dropdown

756 Managing Collection Types CambridgeSoft


Managing Collection Listeners
list displays the Target Section Type in the changed from NB to Notebook, then the
collection type. The middle dropdown list displays Parent Prefix listener renames the contained
the Target Fields in the selected section type. The experiments so that they begin with Notebook.
bottom dropdown list displays all of the Target
properties in the field you have selected. Listener Listener ProgID

Managing the Delete Spawn


Enterprise
Parent ENStandard9.ParentPrefixListener
Collection Listener Prefix
The Delete Spawn collection listener is used in
conjunction with the batch explorer. (The batch This collection listener has no custom properties
explorer is a form tool that makes it possible for associated with it.
users to view the successors and predecessors of
reactions in a tree-like layout). When the Delete Managing the Database Procedure
Spawn Listener is associated with a collection type, Collection Listener
any batch explorer links to a collection of that type
The Database Procedure Collection Listener is used
will be deleted when the user deletes the collection.
to execute a database procedure during an
operation on a collection.
Listener Listener ProgID
For example, you may wish to clear the table section
of a collection when a user duplicates that section.
Delete Spawn ENStandard9.DelSpawn-
LinkLstnr
Listener Listener ProgID
This collection listener has no custom properties
associated with it. Database ENStandard9.DBProcCollection-
Procedure Listener
Managing the Parent Prefix Collection
Listener With the Custom Properties of the listener, you
The Parent Prefix listener is used to ensure that specify the name of the procedure and when it
when a user renames a collection, any contained should be called: for example, after create, before,
collection that has a name generated by the Auto create, etc.
Number Listener is renamed with the new prefix.
Managing the Fixed Name Collection
For example, consider a Notebook collection that Listener
contains Experiments. The Auto Number listener is
associated with the Experiment collection type and The Fixed Name Listener is used to prevent the
the Parent Prefix listener is associated with the user from renaming collections. If the Fixed Name
Notebook collection Type. If a notebook name is Listener is associated with a collection type, then

Chem & BioOffice 2006 /E-Notebook Managing Collection Types 757


Managing Collection Listeners
the Rename command in the collection menu is notebook collection type, then the user who creates
made inactive when collections of that type are a notebook will automatically be able to assign and
selected. remove access permissions for the notebook.
Administrator

Listener Listener ProgID Listener Listener ProgID

Fixed Name ENStandard9.FixedNameListener Owner Full Control ENStandard9.OwnerFull-


ControlCListener

The Fixed Name Collection Listener has no custom


properties associated with it. This Collection Listener has no custom properties
associated with it.

Managing the Offline Collec-


Enterprise
Managing the No Create
Enterprise

tion Listener
Offline Collection Listener
The Offline Collection Listener is associated with
The No Create Offline Collection Listener prevents
Offline Collection type. This listener automatically the creation of this type of collection when the user
creates a reference to a newly created collection in is working offline..
the offline folder.
Listener Listener ProgID
Listener Listener ProgID
No Create Offline ENStandard9.NoCre-
Offline ENStandard9.UniqueChild- ateOfflineCListener
OfTypeCListener

This collection listener has no custom properties


This collection listener has custom properties associated with it
associated with it to configure. The dropdown list
displays all of the collection types in the Container Managing the Parent Prefix Collection
Collection type and you can select the container Listener
collection type to which you wish to add the Offline
Collection. The Parent Prefix listener is used to ensure that
when a user renames a collection, any contained
collection that has a name generated by the Auto
Managing the Owner Full Control
Number Listener is renamed with the new prefix.
Collection Listener
For example, consider a Notebook collection that
The Owner Full Control collection listener contains Experiments. The Auto Number listener is
provides the user with Full Control permission for associated with the Experiment collection type and
this type of collection when he/she is the owner. the Parent Prefix listener is associated with the
For example, if this listener is associated with the Notebook collection Type. If a notebook name is

758 Managing Collection Types CambridgeSoft


Managing Collection Listeners
changed from NB to Notebook, then the Target Collection Type the collection type
Parent Prefix listener renames the contained that is referenced.
experiments so that they begin with Notebook. Target State the state of the target collection
that would prevent a user from copying a
Listener Listener ProgID collection that has this listener associated with
it.
Parent Prefix ENStandard9.ParentPre-
fixListener
Managing the Prevent Delete when
Referenced Collection Listener
This collection listener has no custom properties The Prevent Delete when Referenced Collection
associated with it. Listener prevents users from deleting a collection if
the collection is referenced from another collection
in E-Notebook. The reference may occur in a
Managing the Prevent Reference Copy
property list, a table, or an active document field.
Collection Listener
You associate the listener with the collection type
The Prevent Reference Copy collection listener that should not be deleted when it is referenced. For
prevents users from copying collections that example, if you want to prevent users from deleting
contain references to specific types of collections an Experiment/Page collection when that
that are in specific states. For example, if this Experiment Page is referenced, you would associate
listener is associated with an experiment/page the listener with the Experiment/Page collection
collection type, it may be configured to prevent type.
users from copying pages/experiments that contain
references to folders that are in a Closed state.
Listener Listener ProgID

Listener Listener ProgID


Prevent Delete ENStandard9.NoDeleteRef-
when Referenced CListener
Prevent Reference ENStandard9.NoCopyRef-
Copy StateCListener The Prevent Delete when Referenced Collection
Listener has no custom properties associated with
Select the custom properties as shown below: it.

Managing the Refresh Database Table


Privilege Change Collection Listener
The Refresh Database Table Privilege Change
listener is used to refresh the contents of a database
table when the privileges associated with a

Chem & BioOffice 2006 /E-Notebook Managing Collection Types 759


Managing Collection Listeners
collection change. The listener has properties that This collection listener has no custom properties
describe the field that is refreshed when a privilege associated with it.
is added or removed from a collection.
Managing the Security Collection
Administrator

Listener Listener ProgID Listener

Refresh Database ENStandard9.Refresh- The Security Collection Listener allows you to


Table Privilege DBTablePCListener assign security privileges to a collection when it is
Change created. For example, you may define a collection
type that allows users to record their ideas and
concepts. For IP reasons, you may want this type of
With the Custom Properties of the listener, you collection to be visible only to the owner and, for
specify the target section type and target field. The example, a legal group in the company. This listener
Target Section Type popup list contains a list of all allows you to limit access to certain groups and
of the section types the currently logged in user can individuals automatically, when the collection is
read. The Target collection type should be set to the created.
section type that contains the field to be refreshed.
The Target Field popup list contains a list of all of The owner of the collection is given Full Control
the database table fields in the Target section type. privilege by default.
The Target field should be set to the field which
displays the data that is changed when the privileges
change. Listener Listener ProgID

Managing the Section List Collection Security ENStandard9.SecurityCLis-


Listener tener

When the Section List Collection Listener is


associated with a collection type, a list of the With the Custom Properties of the listener, you
sections in each collection of that type is cached on specify individual users and groups who will be able
the E-Notebook client. This makes it possible for to access collections of this type.
E-Notebook add-ins and field controls to use the
list. For example, in the default configuration, the Managing the Sequence Collection
Section List Collection Listener is associated with Listener
the Acronym collection type. A list of the sections
in an Acronym collection is cached on the client, The Sequence Collection Listener names a new
and the reaction toolbar accesses this list and collection based on a global sequence that you
displays it in the Quick Add dropdown. specify.

Listener Listener ProgID Listener Listener ProgID

Section List ENStandard9.SectionList- Sequence ENStandard9.Sequence-


CListener NumberCListener

760 Managing Collection Types CambridgeSoft


Managing Collection Listeners
With the Custom Properties of the listener, you
specify the prefix, format, suffix, and database
EnterpriseManaging the User Collec-
sequence names. tion Listener

Managing the Unduplicatable Collec- The User Collection Listener is designed for those
tion Listener systems that use the Standard Oracle Authenticator
to authenticate users with E-Notebook.
If the Unduplicatable Collection Listener is
associated with a collection type, contents of that The User Collection Listener is associated with the
type will not be copied when a user copies the User collection type to automatically set up users
selected collection. For example, there may be a correctly for authentication. When a new user is
Page/Experiment collection. If the Unduplicatable created, the User Collection Listener displays the
Collection Listener is associated with the User Properties dialog:
Page/Experiment collection type, these
experiments will not be copied when a user copies
the Experiment collection.

Listener Listener ProgID

Unduplicatable ENStandard9.Unduplicat-
Collection ableCListener
Once the user is specified, a new user collection is
created with the same name as the account. The
This collection listener has no custom properties
name of the user collection can be modified to any
associated with it.
valid version of the name.
Managing the Unique Child Collection
Listener Listener Listener ProgID
The Unique Child Collection Listener ensures the
uniqueness of a collection of this type within its User ENStandard9.UserListener
container collection. For example, if you associate
the listener with the User Configuration collection Note that the User collection listener can only be
type, then specify User as the container collection, added to the User collection type, as E-Notebook
it will only be possible to create a single User does not support multiple user collection types.
Configuration within each user collection.
The User Collection Listener has no custom
properties associated with it.
Listener Listener ProgID

Managing Templates
Unique Child ENStandard9.UniqueChild-
OfTypeCListener Templates make it possible for E-Notebook users
to avoid reentering information unnecessarily. For
With the Custom Properties of the listener, you example, a user may create a template for a
specify the container collection. particular experiment/page. It may contain data

Chem & BioOffice 2006 /E-Notebook Managing Collection Types 761


Managing Templates
and notes that he often uses, or typical values for described here. E-Notebook also provides a
various properties. The user can use the template as number of standard form tools that you may only
the basis for new experiments/page collections. associate with section types. See Managing the
Standard Form Tools for more information.
Each time a collection type is created in
Administrator

E-Notebook, a template of that type is created


automatically. As an administrator, you configure Managing the Duplicate Collection
the rules that determine which types of templates Form Tool
an E-Notebook user can create, and which
collection types can contain or reference the The Duplicate Collection Form Tool allows users
templates. You set up these rules the same way you to create a copy of the selected collection. For
would set them up for any, other collection type: by example, if a user clicks the Duplicate Collection
adding templates to collection types as contained Form Tool on a Page/Experiment collection, the
collection or reference types. Page/Experiment collection will be copied. The
new copy will appear within the same container
The template collection type should be added as a collection in the Collection Tree.
contained collection type to a collection type that is
not the container into which users will drag the
templates to create new collections. For example, if Form Tool Form Tool Control
Notebooks contain Experiments, the Experiment ProgID
Template collection type should be added as a
contained collection type within, for example, a Duplicate Collec- ENStandardCtl9.DuplicateC-
Folder or a User. If Experiment Template is a tion FormTool
contained collection type within Notebook, then a
user will simply create a new template when he
drags a template into a Notebook. Managing the Structure Form Tool
See the following topics for information about The Structure Form Tool is used to perform the
adding templates to your E-Notebook Analyze Structure command. The Analyze
configuration: Structure command populates a property list with
Managing Contained Collection Types on the chemical formula and molecular weight of the
page 749. associated chemical structure.
Managing Contained Reference Types on
In order to use the Structure Form Tool in an
page 750.
E-Notebook form, one of each of the following
Managing Collection Type types of fields must be present in the form:

Form Tools Chemical Structure Field


There are several form tools that may only be Property List - containing
associated with collection types, for example, the
New Section Form Tool. These form tools are a Molecular Weight property and

762 Managing Collection Types CambridgeSoft


Managing Templates
a Molecular Formula property. Managing the New Section Form Tool
.i.Managing the New Section Form Tool;
Form Tool Form Tool Control
ProgID The New Section Form Tool allows users to add
new sections to a collection, for example, to a page
Structure ENStandardCtl9.Structure- or an experiment. When the user clicks the form
FormToolCtl tool he will be presented with a list of the types of
sections he may add.
When you add a Structure Form Tool to a Form,
you must configure the following custom Form Tool Form Tool Control
properties. ProgID

Managing the Next Step Form Tool New Section ENStandardCtl9.NewSection-


The Next Step Form Tool is used to create a new FormTool
page or experiment containing the products of the
associated chemical reaction.
Managing the New Child Collection
In order to use the Next Step Form Tool in an
Form Tool
E-Notebook form, one of each of the following
types of fields must be present in the form: The New Section Form Tool allows users to add
Chemical Structure Field new contained collections to the selected collection.
For example, a user could click this form tool on a
Table Field with Reactants Listener
notebook in order to create a new page/experiment
Table Field with Products Listener within the notebook.

Form Tool Form Tool Control Form Tool Form Tool Control
ProgID ProgID

Next Step ENStandardCtl9.Reaction- New Section ENStandardCtl9.NewChild-


FormTool CFormTool

When you add a Reaction Form Tool to a form, you


must configure the following custom properties.
Managing the New Sibling
Enterprise

The E-Notebook User Guide provides more Collection Form Tool


information about the tool and the calculations in
the stoichiometry grid. The Stoichiometry grid is The New Sibling Collection Form Tool allows users
the combination of the Reactants and Products to create a new collection of the same type. For
Fields. example, if a user clicks the New Sibling Form Tool

Chem & BioOffice 2006 /E-Notebook Managing Collection Types 763


Managing Templates
on a notebook, a new notebook will be created. The 2. Select Browse All.
new sibling will appear within the same container
collection in the Collection Tree.
Administrator

Form Tool Form Tool Control


ProgID

New Sibling ENStandardCtl9.NewSib-


Collection lingCFormTool

The entire Collection tree appears, showing the


Managing Search Types Configuration Folder.
3. If you wish, you may right-click the Configura-
Search types allow users to search for information tion Folder and select Browse Here, so that the
in E-Notebook. Users can run searches, then save Configuration Folder will appear at the top of
their queries and results in the Collection Tree. the Collection tree.
In E-Notebook, search types are simply collection
types that have search engines and search forms
associated with them. E-Notebook provides
several, standard search engines. You may also
develop your own, custom search engines. For
example, you could use the tool to perform various
types of calculations and put the results into a
manageable format within an E-Notebook
collection.

You can configure your own search forms to


contain the fields you require.

Creating a Search Type


You can define your own search types for finding
and managing E-Notebook information that is
important to your users. In E-Notebook, search
types are simply collection types that have search
engines and search forms associated with them. 4. Right-click the Search Types folder (or another
folder) and select New, then Collection Type.
To create a search type, A new collection type appears in the Collection
Tree, and you are prompted to rename it.
1. Right-click a blank area of the Collection Tree.
5. Enter a name for the collection type (i.e., the
A menu appears. search type).

764 Managing Collection Types CambridgeSoft


Managing Search Types
6. Right-click the search type, and select Collec- search engine is the name that will appear in the
tion Type Configuration from the menu that Search For: drop-down list when an
appears. E-Notebook user is in Search mode.

The Collection Type Configuration dialog


appears.
7. Specify the following information:

Plural Name enter the name applied to


multiple collections of this type.
Icon Name select Search as the icon to be 9. Enter the following information. (See
associated with the search type in the Managing the Standard Search Engines on
Collection tree. page 765 for more information about the stan-
dard, E-Notebook Search Engines).
8. Right-click Search Engines, and select New
Search Engine from the menu that appears. IENSearchEngineProgID

IENResultsCtlProgID

IENResultsCtl License Key

Once you have created the search type, you


configure it as you would any other collection
type. The section type you associate with it
should be a search form. See Creating a
Search Form on page 766.

Managing the Standard


Search Engines
A new search engine appears and you are
prompted to rename it. Its attributes appear to E-Notebook provides a several standard search
the right. The name that you enter for the engines:

Chem & BioOffice 2006 /E-Notebook Managing Collection Types 765


Managing Search Types
Collection Search Engine Chemical Structure Search Engine
The Collection Search Engine is used to perform The Chemical Structure Search Engine is used to
searches for collections and match criteria specified perform searches for chemical structures. The
Administrator

in the following fields: results are organized by substructure. For each


chemical structure that matches a specified query, a
Collection Query field
set of references is created that contain that
Collection Type Query field chemical structure.
State Query Field
See Managing Chemical Query Fields.
Search Location
Search ProgID Search Engine
Search Search Engine Search Engine Engine Control ProgID
Engine ProgID Control ProgID
Chem- ENChemSearch9.C ENChemSearch9
Collection ENSearchEngine9 ENSearchEngine9 ical hemSearchEngine .Chem-
.CollectionSearch- .CollectionRe- Structure SearchResults Ctl
Engine sultsResultsCtl

Creating a Search Form


Section Search Engine
A search form is simply a section type that contains
The Section Search Engine is used to perform search fields. The search fields make it possible for
searches for sections and match criteria specified in users to search for the following information within
the a variety of field types:
E-Notebook. For information about each of the
Property Query search fields and its usage, please see Managing
Search Fields.
Table Query
Query Text
When you configure a search form, the information
that a user can search for is determined by 1) the
Chemical Query search fields in the form and 2) the search engine
associated with the search type.
In addition, any of the field types listed for the
Collection Search Engine, above, may be used.
To create a new search form,

Search Search Engine Search Engine


Engine ProgID Control ProgID
1. In the Collection Tree, right-click the folder or
Section ENSearchEngine9 ENSearchEngine9 collection into which you are adding the search
.SectionSearch- .CollectionRe- form.
Engine sultsResultsCtl
The collection menu appears.

766 Managing Collection Types CambridgeSoft


Managing Search Types
2. Select New, then Section Type. 1. Right-click the search type in the Collection
Tree, and select Collection Type Configuration
from the menu that appears.

A new section type appears in the Collection


Tree; its blank form appears to the right. You
are prompted to enter a name for the section
type.
3. Type in a name for the section type.
4. Right-click the new section type in the Collec-
tion Tree and select Section Type Configuration
from the menu that appears.
The Section Type Configuration dialog
appears. This is the dialog through which you The Collection Type Configuration dialog
add and configure the components that make appears.
up the Form
Fields 2. Double-click Search Engines to expand the
category.
Form Tools
Section Listeners 3. Click the search engine.

When you add Fields to the Section Type, you must Its ProgID's appear to the right.
add search fields.
For information about how to configure the section
type, see Managing Section Types and Forms.

Viewing and Editing the


Properties of a Search
Engine
4. Click the Custom Properties button.
In some cases, a search engine may have custom
properties associated with it. You can view and/or If the search engine has custom properties
edit the properties that are associated with a search associated with it, the Properties dialog is
engine. displayed. You may edit the properties at this point.

Chem & BioOffice 2006 /E-Notebook Managing Collection Types 767


Managing Search Types
If the search engine has no custom properties, a To add states to a collection type:
dialog box appears, stating that the search engine
has no properties associated with it. 1. Right-click the collection type in the Collection
Tree, and select Collection Type Configuration
from the menu that appears.
Administrator

NOTE: None of the standard, E-Notebook search engines


have custom properties associated with them.

Managing States and


Transitions
You can associate states with a collection type to
define properties of a collection at certain phases or
points in its life cycle. Transitions are the actions a
user takes to move collections from one state to
another. For example, a page/experiment may have
several stateseach of which has different
annotation rules associated with it.

Transition listeners perform certain functions as


the collection moves from one state to another. For
example, a user may be prompted to enter values The Collection Type Configuration dialog
for certain fields, or a visual display of the changes appears.
a user makes to a collection may be enabled. Right-click States and select New State from the
menu that appears:
See the following topics for more information:

Adding States to a Collection Type

Configuring a Transition between States

Managing Transition Listeners

Managing the Standard Transition Listeners


A new state appears and you are prompted to
Adding States to a Collection rename it.
Type 2. Enter a name for the State. Also, specify the
annotation rules that will apply to the State.
The states of a collection type define properties, There are four annotation rules from which
such as change control options, that vary you may choose. The rules appear in the drop-
throughout its life cycle. down lists.

768 Managing Collection Types CambridgeSoft


Managing States and Transitions
The options are: To configure a transition between states:

Writable with Optional Annotation the 1. Right-click the collection type in the Collection
user may supply annotation for changes if he Tree, and select Collection Type Configuration
wishes. He will not be prompted to supply it. from the menu that appears.

Read-Only the collection cannot be The Collection Type Configuration dialog


edited in this state. appears.
2. Click the plus sign next to States to expand the
Writable with Prompted Optional
category and see the states that are associated
Annotation the user is prompted to
with the collection type.
supply annotation for changes, but is not
required to supply it. 3. Click the plus sign next to the state that is to be
the initial state in the transition. In this
Writable with Required Annotation the example, we are setting up a transition from the
user must supply annotation for changes. Open state to the Closed state.
The user will be prompted to enter
The Transition Types category appears.
annotation whenever a version of the
collection is saved. 4. Right-click Transition Types and select New
Transition Type from the menu that appears.
To add another state to the Collection Type, repeat
steps 2 and 3.

Once you have defined the states, you must


configure the transitions from one state to another.
To set up a transition between states, see
Configuring a Transition between States.

Configuring a Transition
between States A dialog appears, listing the possible target
States for the Transition,
A transition is the action a user takes to move a
collection from one state to another. For example,
a Close transition may allow a user to move a
collection from an Open state in which edits are
permitted to a Closed state in which the collection
is read-only.

You may also associated transition listeners with a


transition, so that the effect of the transition is
modified, usually by performing an operation that is
associated with the transition. 5. Click a target state and click the Add button.

Chem & BioOffice 2006 /E-Notebook Managing Collection Types 769


Managing States and Transitions
The target state appears within the list of Removing a Transition Listener from a Transi-
Transition Types. To the right, a checkbox tion
appears, with which you may specify whether Managing the Standard Transition Listeners
the owner of the collection can perform the
Administrator

Transition. By default, the owner of the Associating a Transition Listener with a


collection can perform the transition, but in Transition
some cases, you may set up a transition that can
only be performed by administrators or certain Transition Listeners modify the effects of
users. transitions, usually by performing an operation that
is associated with the transition.
To associate a transition listener with a transition:
1. Right-click the collection type in the Collection
tree, and select Collection Type Configuration
from the menu that appears.
The Collection Type Configuration dialog
6. Select whether the owner may perform the appears.
transition. 2. Click the plus sign next to states to expand the
To associate a transition Listener with the category and see the states that are associated
transition, see Managing Transition Listeners. with the collection type.
3. Click the plus sign next to the state that is the
Managing Transition initial state in the transition. In this example,
the transition is from the Open state to the
Listeners Closed state.
Transition listeners are used to perform a certain The Transition Types category appears.
function with the transition of a collection from 4. Click the plus sign next to Transition Types to
one state to another. For example, a transition may expand it and see the transitions.
be from an open state that permits edits to a closed,
5. Right-click the transition with which you wish
read-only state. One of the standard transition
to associate the transition listener
listeners checks that required properties have been
entered before the transition can be completed. A menu appears:

E-Notebook provides several, standard transition


listeners that you may associate with transitions.
You may also develop your own, customized
transition listeners to perform additional functions.
See the following topics for more information:
Associating a Transition Listener with a Transi-
tion
Viewing and Editing the Properties of a Tran-
sition Listener 6. Select New Transition Listener .

770 Managing Collection Types CambridgeSoft


Managing States and Transitions
A new transition listener appears, and you are 5. Click the transition listener whose properties
prompted to rename it. you wish to view or change.

7. Enter a name for the Transition Listener, and


6. Click the Custom Properties button.
fill in its IENTransitionListener ProgID.
If the transition listener has custom properties
The transition listener is associated with the
associated with it, a Properties dialog appears, and
transition. The function it performs will occur each
you may view and/or edit the properties. If the
time a a user conducts this type of transition on this
transition listener has no custom properties
type of collection.
associated with it, a message appears to that effect.
See Managing the Standard Transition Listeners for
Note that none of the standard transition listeners
descriptions of the standard, transition listeners
have custom properties associated with them.
that E-Notebook provides.
Removing a Transition Listener from a
Viewing and Editing the Properties of a
Transition
Transition Listener
In some cases, you may no longer want to have a
A transition listener may have custom properties particular transition listener associated with the
associated with it. transition for a collection type.
To view and/or edit the custom properties: To remove a transition listener from a transition:
1. Right-click the relevant collection type in the 1. Right-click the relevant collection type in the
Collection tree, and select Collection Type Collection Tree, and select Collection Type
Configuration from the menu that appears. Configuration from the menu that appears.
The Collection Type Configuration dialog The Collection Type Configuration dialog
appears. appears.
2. Click the plus sign next to states to expand the 2. Click the plus sign next to states to expand the
category and see the states that are associated category and see the states that are associated
with the collection type. with the collection type.
3. Click the plus sign next to the state that is the 3. Click the plus sign next to the state that is the
initial state in the transition. In this example, initial state in the transition. In this example,
the transition is from Open State to the Closed the transition is from Open state to the Closed
State. state.
The Transition Types category appears. The Transition Types category appears.
4. Click the plus sign next to Transition Types to 4. Click the plus sign next to Transition Types to
expand it and see the transitions. expand it and see the transitions.

Chem & BioOffice 2006 /E-Notebook Managing Collection Types 771


Managing States and Transitions
5. Right-click the transition listener you wish to If you would like to make the annotation required,
remove. you can configure the custom properties.

A menu appears:
Administrator

Click the Annotation Required checkbox to select


it. Then, click OK to close the dialog.

Managing the Change Display Transi-


tion Listener
6. Select Delete Transition Listener. The Change Display Transition Listener is used to
enable Visual Display of Changes when a user
A message appears, asking you to confirm that
performs a particular transition. (See Managing
you wish to delete the Transition Listener.
Visual Display of Changes).
7. Click Yes.
Listener Listener ProgID
The transition listener is removed from the
transition.
Change Display ENStandard9.ChangeDis-
playTListener
Managing the Standard
Transition Listeners The Change Display Transition Listener has no
custom properties associated with it.
Transition listeners are used to perform a certain
Note that there is also a collection listener that can
function that is associated with a transition from be used to enable Visual Display of Changes as
one state of a collection to another. E-Notebook soon as a collection is created. See Managing the
provides several, standard transition listeners that Change Display Collection Listener for more
you may associate with transitions. information

Managing the Annotate Transition


Listener

When a user performs the transition, the Annotate


listener prompts the user for an annotation that is
associated with the transition.

Listener Listener ProgID

Comment ENStandard9.AnnotateTListener

772 Managing Collection Types CambridgeSoft


Managing States and Transitions
Managing Change Security Transition The Confirm Transition Listener has no custom
Listener properties associated with it.
The Change Security Transition Listener enables
Inherits Security for a collection during a transition.
Managing the Export Transition Listener
This may be used, for example, to limit access to an The Export Transition Listener supports the
experiment before it is in a Closed state. printing workflow. It makes it possible to export the
contents of a collection as part of a transition.
Listener Listener ProgID
Listener Listener ProgID
Change Security ENStandard9.ChangeSecu-
Transition TransLstnr Export Transi- ENStandard9.ExportTLis-
tion tener
With the custom properties of the transition
listener, you have the option to specify whether, if a The rendering sections and their corresponding
particular property in the collection is filled in, the templates must be set as properties of this listener.
Inherits Security option should remain off even
after the transition is completed. Specifically, you
Managing the Final Print Transition
can specify:
Listener
Whether the property is in the collection or an
associated indexing collection. The final print transition listener can be added to a
transition to force the printout of the entire
Section type containing the property
collection before the transition continues. The
Property list containing the Property name of the export template used for the final print
Whether inherits security should be set or not is <Region> Final Print where <Region> is
if the property is filled in. replaced by the name of the region of the currently
logged-on user.
Managing Confirm Transition Listener
When this transition listener is associated with a
The Confirm Transition Listener prompts a user to transition type, transitions will be interrupted with
confirm a specific transition prior to the transition a message box as follows:
occurring and displays a message to the user
whenever he goes for any transition, asking him to Click OK to print the final print of <Collec-
confirm that he is sure he wants to proceed with a tion> using the printer <PrinterName>.
transition. If the user clicks Yes, then the transition
proceeds. If the user clicks No, then the transition where <Collection> is replaced with a description
is canceled. of a collection, such as experiment CS-00005 and
<PrinterName> is replaced with the name of the
default printer.
Listener Listener ProgID
If the user clicks OK, then the transition proceeds
Confirm Transi- ENStandard9.ConfirmTLis- by printing all of the pages of the collection to the
tion tener default printer. If the user clicks Cancel, then the
transition is canceled.

Chem & BioOffice 2006 /E-Notebook Managing Collection Types 773


Managing States and Transitions
After the printout is completed, another message users will be prevented from reopening an
box appears as follows: Experiment within a Notebook that is in the Closed
(locked) state.
Did the final print of <Collection> succeed?
Administrator

Yes Continue with this transition Listener Listener ProgID


No Print again
Locked Contents ENStandard9.LockedContain-
Cancel Abort this transition erListener
where <Collection> is replaced with a description
of a collection. The Locked Container Transition Listener has no
If the user clicks Yes, then the transition proceeds. custom properties associated with it.
If the user clicks No, then the pages are printed
again and the message box re-appears. If the user Managing the Print Transition Listener
clicks Cancel, then the transition is canceled.
The Print Transition Listener supports the printing
If the user wants to change the default printer, they workflow. It makes it possible to print the contents
should choose print setup prior to performing the
of a collection as part of a transition.
transition.

Listener Listener ProgID


Listener Listener ProgID

Print Transi- ENStandard9.PrintTListener


Final Print ENStandard9.FinalPrintTListener
tion

The Final Print Transition Listener has no custom


properties associated with it. The rendering sections and their corresponding
templates must be set as properties of this listener.
Managing the Locked Container Transi-
tion Listener Managing the Required Non-Blank
Properties Transition Listener
The Locked Container listener checks to ensure
that the container of the collection is in a state The Required Non-blank Properties Transition
which permits full control over the contents of the Listener prevents a transition from occurring if
container. specific properties are not filled in.
For example, consider an Experiment collection
contained within a Notebook collection. Closed is a Listener Listener ProgID
read-only (locked) state; the Reopen transition
moves a collection from the Closed, read-only state Required Non- ENStandard9.RequiredNon-
to a state in which edits are permitted. If the Locked blank Proper- BlankTListener
Container Listener is associated with the Reopen ties Transition
transition of the Experiment collection type, then

774 Managing Collection Types CambridgeSoft


Managing States and Transitions
Managing the Required Rows Transition
Managing the Sign Version
Enterprise
Listener
Transition Listener
The Required Rows Transition Listener prevents a The Sign Version Transition Listener invokes E-
transition from occurring if specific rows are Signatures with a particular transition.
missing from a table.
Listener Listener ProgID
Listener Listener ProgID
Sign Version ENStandard9.SignVersionTL
Required Rows ENStandard9.RequiredRow- Transition
Transition sTListener
The Configuration of this listener includes:

Managing the Required Properties Tran- Whether or not a countersignature is required


sition Listener The transition that should occur upon
successful completion of the signature process
The Required Properties listener checks to ensure (e.g., to Closed)
that the contents of the property list and table The transition that should occur upon failure
section cells within the specified collection of the signature process (e.g., to Open)
conform to the Required and Not Blank options
associated with the properties of the property list Managing the Unlocked Contents Tran-
and table fields. If a property in a property list or a sition Listener
table property does not conform with the The Unlocked Contents listener checks to ensure
corresponding Required or Not Blank option, then that the collections contained within a collection are
the transition will not be completed. all locked before the container collection can
transition into a locked state (meaning that the
change and annotation rules for the state are Read-
Listener Listener ProgID
Only).

Required ENStandard9.RequiredProper- For example, consider an Experiment collection


Properties tiesListener contained within a Notebook collection. Closed is a
read-only state, and the Close transition moves a
collection from an unlocked, editable state to the
The Required Properties Transition Listener has no Closed, read-only state. If the Unlocked Contents
custom properties associated with it. Listener is associated with the Close transition of

Chem & BioOffice 2006 /E-Notebook Managing Collection Types 775


Managing States and Transitions
the Notebook collection type, then users will be In addition, you may configure E-Notebook such
prevented from closing a Notebook if it contains that users must annotate the changes they make to
experiments that are not Closed. collections. You may also enable Visual Display of
Changes at some point in the life cycle of a
Administrator

collection.
Listener Listener ProgID
See the following topics:
Unlocked ENStandard9.UnlockedCon-
Contents tentsListener Managing Visual Display of Changes

Configuring Annotation Options


The Unlocked Contents Transition Listener has no
Configuring Autosave
custom properties associated with it.

Managing Visual Display of


Managing the View Signed
Enterprise
Changes
Versions Transition Listener
Depending the collection type and its state, it is
The View Signed Versions Transition Listener possible for users to view a Visual Display of
allows a user to view all of the electronically-signed Changes that have been made to data in the
renditions of a collection. This listener is used with collection. If Visual Display of Changes is enabled,
the E-Signatures feature. the changes that have been made to a collection can
be viewed in E-Notebook, and the changes will be
Listener Listener ProgID
shown in the printed collection.

Visual Display of Changes may be enabled from the


View Signed ENStandard9.DisplaySignedVer- very beginning of the collection life cycle, when the
Versions Tran- sionTL collection is first created. Alternatively, you may
sition enable Visual Display of Changes when a user
performs a particular collection transition; a
common example is the transition from a closed,
This listener has no custom properties.
read-only state to a reopened state in which edits are
permitted.
Configuring Change
The version of the collection that existed when the
Control Options Visual Display of Changes began is called the
Baseline Version of the collection. (Note: a version
E-Notebook provides auditing and change control is created each time the collection is saved). Users
features. For every change that a user makes, an will see this version highlighted in the History Pane.
audit trail records the logged in identity of the user, If Visual Display of Changes is enabled, there are
the date, and the time. This is done automatically visual indicators next to the data that was changed
when users add, delete, or update data. The audit after the Baseline Version was saved. See the User
trail information is stored in the E-Notebook Guide for further description of the ways changes
database. are presented to the user.

776 Managing Collection Types CambridgeSoft


Configuring Change Control Options
When Visual Display of Changes is enabled for a 5. To close the Collection Type Configuration
collection, the printed output will include 1) the dialog, click the close button in the upper right
baseline version that existed at the time that Visual corner.
Display of Changes began and 2) all subsequent The dialog closes. New collections of this type
changes. will have Visual Display of Changes enabled
Note that once Visual Display of Changes is for their entire life cycles.
enabled for a collection, it remains enabled for the
life of the collection. Enabling Visual Display of Changes
with a Transition
Enabling Visual Display of Changes
To enable Visual Display of Changes when a user
from Collection Creation Onward performs a particular collection transition:
To begin the Visual Display of Changes at collec- 1. Right-click the collection type in the Collection
tion creation, tree, and select Collection Type Configuration
1. Right-click the Collection Type in the from the menu that appears.
Collection tree, and select Collection Type The Collection Type Configuration dialog
Configuration from the menu that appears. appears.
2. Right-Click Collection Listeners and select 2. Click the plus sign next to States to expand the
New Collection Listener from the menu that category and see the states that are associated
appears. with the collection type.
3. Click the plus sign next to the state that is the
initial state in the transition. For example, the
transition is from Closed state to the Reopened
state.
The Transition Types category appears.
4. Click the plus sign next to Transition Types to
expand it and see the transitions.
A new collection listener appears and you are
5. Right-click the transition with which you would
prompted to rename it.
like the Visual Display of Changes to begin.
A menu appears:

3. Type in a name for the collection listener.


4. Enter the ENStandard8.ChangeDisplayListener
as the IENCollectionListener ProgID for the
listener you wish to add.
The collection listener is associated with the
collection type.

Chem & BioOffice 2006 /E-Notebook Managing Collection Types 777


Configuring Change Control Options
6. Select New Transition Listener. 3. Click the state for which you are configuring
the annotation options.
A new Transition Listener appears, and you are
prompted to rename it.
Administrator

You may select an annotation rule for 1)


7. Enter a name for the transition listener, and Existing Sections and 2) New Sections.
enter ENStandard8.ChangeDisplayTListener
as its IENTransitionListener ProgID. There are four annotation rules from which
you may choose. The rules appear in the drop-
Visual Display of Changes will be enabled when a down lists.
user performs this transition on a collection of this
type. The options are:

Note that even when Visual Display of Changes is Writable with Optional Annotation the
not enabled, the audit trail still captures the history, user may supply annotation for changes if he
and the history pane displays a list of the saved wishes. He will not be prompted to supply it.
versions and transitions for a collection. Read-Only the collection cannot be
edited in this state.
Configuring Annotation Options
Writable with Prompted Optional
You may configure E-Notebook such that users can Annotation when the collection is saved,
annotate the changes they make to collections. the user is prompted to supply annotation
E-Notebook provides four options for annotation. for changes, but is not required to supply it.
You configure these options on a per collection
type, per state basis. This allows you to configure Writable with Required Annotation
different annotation rules for the different phases when the collection is saved, the user must
of a collection life cycle. supply annotation for changes. The user will
be prompted to enter annotation whenever
To configure the annotation rules for a state: a version of the collection is saved.

1. Right-click the collection type in the Collection 4. Select the annotation rules you wish to apply to
tree, and select Collection Type Configuration the state.
from the menu that appears. When a collection of this type is in this state,
The Collection Type Configuration dialog the annotation option you have selected will
appears. apply.

2. Click the plus sign next to states to expand the If you would like users to provide annotation when
category and see the states that are associated they perform a particular transition, you can
with the collection type. associate the Annotate Listener with the transition.

778 Managing Collection Types CambridgeSoft


Configuring Change Control Options
Configuring Autosave The autosave interval appears in the
Collection Properties dialog.
The Autosave feature allows changes to be saved
automatically to the database after a specified time
interval following a change made to the contents of
a section. The autosave interval for a particular
collection can either by specified by a user that has
full control over the collection or can be inherited
from the parent collection.

To specify the autosave interval for a collection

1. In the collection tree, right-click the collection


and choose the Collection Properties from the
menu that appears.

The autosave interval appears, in units of


minutes. If no autosave interval has been
specified for the collection or its containing
collection, then the autosave interval is None
(as shown above) and no autosave will occur
for the collection.

2. Click the Edit Autosave Interval button.


If the autosave interval you have specified is
greater than the autosave interval of the
The Edit Autosave Interval dialog box container of the collection, then the autosave
appears. A dialog box appears in which the user interval of the container will override the
can specify the autosave interval for the autosave interval specified for the collection.
collection. The top portion of the dialog box
displays the autosave interval for the parent Managing Export
collection.
Templates of Collection
Types
Collection type export templates allow users to
print E-Notebook sections in a collection, or to
export sections to Microsoft Word. You create
export templates in MS Word sections, using tags to
refer to E-Notebook fields.

3. Enter the autosave interval for the collection An export template must be set up for each, new
and click OK . collection type you create.

Chem & BioOffice 2006 /E-Notebook Managing Collection Types 779


Managing Export Templates of Collection Types
To view the export template of a collection type: 2. Select Show, then Export Templates.

1. Right-click the collection type in the Collection The right frame is blank if there is no export
Tree. template associated with the collection type. If
you wish to edit an existing export template,
Administrator

A menu appears.
see Editing the Export Template for a
2. Select Show, then Export Templates. Collection Type below.
3. Right-click the section icon in the right frame.
The section menu appears.

If the collection type has an export template,


the template appears in the right frame. If not,
the right frame is blank, and you must create a
new template.
See the following topic:
Creating and Editing the Export Template for
a Collection Type 4. Select Section Types.
The Section Types dialog box appears.
Creating and Editing the
Export Templates for a
Collection Type
The export template for a collection type allows
users to print the E-Notebook sections in a
particular collection, and to export sections to
Microsoft Word. The headers and footers from the
collection type export template are used in the
printout.

Creating the Export Templates for a


Collection Type 5. Select Export Template and click the Add button.

To create an export template: 6. Click the Close button.


The Section Types dialog closes.
1. Right-click the collection type in the Collection
Tree. 7. Right-click the section menu icon again.
A menu appears. The section menu appears.

780 Managing Collection Types CambridgeSoft


Managing Export Templates of Collection Types
8. Select New then Export Template. Editing the Header and Footer Informa-
tion

The header and footer is printed on every page


when a user prints the collection or a portion of the
collection. The header and footer of a collection
type export template can contain standard
replacement tags with the following data:
An MS Word section appears in the right
frame.
Tag Replacement
9. Right-click the section menu icon and select
Rename.
<collectionStatus> The state of the collection.
10. Type in the name of one of the regions. (The (Note that if you are using
region names are found in the Region tab of the Final Print Transition
the Collection Properties dialog for a user Listener, the state will print
collection), for example, United States. as the initial state of the tran-
11. Create an additional export template for each sition, and not as the target
of the other regions to which your system users state. In this specific case, if
are assigned. Name each template after the you would like the name of
regione.g., Europe and Asia/Pacific. the target state to print,
12. Add the text <Contents> into each of the simply type the text name of
templates. An example is shown below: the state into the header or
footer.)

<dateCreated> The timestamp of creation


of the collection

<dateModified> The timestamp of last modi-


fication

<datetoday> The timestamp of the


creation of the export docu-
ment or printout

<collectionOwner> The name of the owner of


the collection

<collectionName> The name of the collection

<collectionType> The type of the collection

Chem & BioOffice 2006 /E-Notebook Managing Collection Types 781


Managing Export Templates of Collection Types
To edit this data, 2. Double-click the header or footer.

1. While viewing the export template in 3. Edit as desired.


E-Notebook, click the print layout view button
in the lower left corner of the MS Word field.
Administrator

It is the third button in the row.


The export template appears in print layout
view, and the header is visible

782 Managing Collection Types CambridgeSoft


Managing Export Templates of Collection Types
Chapter 40: User Administration
You can create new users and associate logon IDs, 3. Select User.
passwords, and security properties with
them. Security properties determine who
has access to a user and the collections that fall
under the user in the collection tree.
To streamline user administration, you can create
user groups, then create users who inherit the
access privileges that you have assigned to the user
groups.
Users and user groups are types of collections and
they appear in the Collection Tree. You can manage A User is created within the collection you
users and user groupscopying them, referencing selected. You are prompted to enter a Login ID
them, moving them, etc.as you would other and select whether the User is a system
collections. administrator. (Note: with some systems, you
See the following topics for more information may be prompted to enter a password for the
about users and groups: user as well).

Creating a User
Setting the Region for a User
Creating a User Group
Changing a User's Properties

Creating a User Once you have created the User, you must assign a
You create a User just as you would create any other geographical region. See Setting the Region for a
collection. Users are often created within User User.
Groups. See Creating a User Group for more The User automatically inherits the security
information. privileges of the User Group (or other container
1. Right-click the collection (which may be a User
collection) to which he was added. You may disable
Group) to which you wish to add the User. inherited security and set the access permissions for
the User independently. In addition, you may add
A menu appears. additional security permissions to the User
2. Select. Collection.
A list of the types of collections you may add See Managing Collection Security for more
appears. information.

Chem & BioOffice 2006 /E-Notebook User Administration 783


Creating a User
Creating a User Group You may then assign security permissions to the
User Group, so that all members of the group have
You create a User Group just as you would create access to the collections you specify. See Managing
another collection. You can then add Users to the Collection Security for more information.
Administrator

group, and the Users automatically inherit the


security profile of the group. It is possible to add Changing a User's Prop-
additional permissions to a User's individual
security profile as well.
erties
If you are a system administrator, you can change a
To create a User Group: users security and logon properties.
1. Right-click the collection to which you wish to To change the logon ID and/or administrator sta-
add the User Group. This is often the root tus of a user:
collection of E-Notebook.
1. Right-click the user in the Collection Tree.
A menu appears.
A menu appears.
2. Select New.
2. Select User Info.
A list of the collections you may add appears.
The User Properties dialog box appears.
3. Select User Group:
3. You may edit the logon ID and password, and
select whether or not the user has administra-
tive privileges.

NOTE: The Administrator checkbox is only visible if


you are a full system administrator, and the password
field may not be present with your specific configuration
of E-Notebook.

A User Group is created and you are prompted


to give it a name.

Changing the Security Prop-


erties of a User Collection
Depending upon your configuration, you may add
Users to the group by either 1) adding references to You may change the security properties for a User
the Users, or 2) adding User collections to the User Collection as well, to determine who may view or
Group directly. edit the collections that the user creates. You

784 User Administration CambridgeSoft


Creating a User Group
change the security properties for a user just as you
would change the security properties of any other
collection. See Managing Collection Security.

Chem & BioOffice 2006 /E-Notebook User Administration 785


Changing a User's Properties
Administrator

786 User Administration CambridgeSoft


Changing a User's Properties
Chapter 41: Managing E-Notebook
Security
Security in E-Notebook is set up on a collection See the following topics for more information:
basis. Security properties may be set up for any
Managing Collection Security
collection in the Collection Treewhether it be a
User, a Notebook, a Folder, etc. The security Managing the Security Properties of a Collec-
properties of a collection determine who has read, tion Type
write, or full control access to that collection. These Managing the Security Properties of a Section
access privileges may be assigned to individual users Type
or to user groups.
Using the Session Manager
By default, each collection inherits the security
properties of its parent in the Collection Tree. The Managing Collection
inherited security option may be disabled, however,
so that the security properties of a collection can be Security
configured independently of its parent. As an Administrator, you may change the access
In addition to security at the collection level, you privileges that E-Notebook Users have to specific
may also set up security for collection transitions, collections.
specifying which users may or may not perform
The default security for a new collection is Inherits
certain transitions on collections.
Security, meaning that a collection has the same
In order for you to see who is logged into security profile as its parent collection in the
E-Notebook, there is a Session Management tool. collection tree. You may disable inherited security if
This tool also provides the ability to end the you would like the security profile of a collection to
E-Notebook session for a particular user. be independent of the security profile of its parent.

Chem & BioOffice 2006 /E-Notebook Managing E-Notebook Security 787


Managing Collection Security
To disable inherited security: Collection Security
1. Right-click the collection for which you wish to
To configure or change the security properties of a
disable inherited security.
collection:
Administrator

A menu appears.
1. Right-click the collection whose security
properties you wish to change.
A menu appears.
2. Select Collection Properties.

The Collection Properties dialog box


appears.

2. If Inherits Security is checked, select it to clear


the checkmark.
Inherits Security is disabled.

NOTE: If you disable Inherits Security, the


permissions that the collection had inherited will become
assigned permissions. You must remove these
permissions explicitly if you do not wish these users or
groups to have access to the collection.
3. Click the Collection Security tab.

788 Managing E-Notebook Security CambridgeSoft


Managing Collection Security
The Security tab appears. The Groups and Inherited Permissions are permissions
Users who have permission to access this item inherited from the parent collection in the
appear in one of the two lists: Inherited collection tree. (These permissions can only be
Permissions, Assigned Permissions. changed by disabling inherited security, as
discussed above, or by changing the security
profile of the parent collection). Only the
Assigned Permissions can be changed from
this dialog.

Chem & BioOffice 2006 /E-Notebook Managing E-Notebook Security 789


Managing Collection Security
4. Take the appropriate action:
Desired Result Action to take

Add a User or Group 1. Click Add...


Administrator

to the list of Assigned


Permissions. The Choose User or
Group dialog
appears.

2. Select the appropriate


user or group from the
tree. (You may either 1)
right-click within a
blank portion of the
tree and select Browse
All to see all of the
Users, or 2) click the
Search button and
perform a search for a
User or group of
Users).

3. Click Add.

4. Select the appropriate


access from the
listbox:

Read permits a user


to view the
Collection, but not
edit it.

Read and Write


permits a user to view
and edit the
Collection.

Full Control
permits a user to view
the Collection, edit it,
and assign or remove
security permissions
for it.

790 Managing E-Notebook Security CambridgeSoft


Managing Collection Security
2. Select Collection Properties.
Desired Result Action to take The Collection Properties dialog box
appears.
Remove a User or 1. Highlight the user or
3. Click the Transition Security tab.
Group from the list group in the list.
The Security tab appears. The groups and users
2. Click Remove. who have permission to apply a transition to
this item appear in one of the two lists:
Change the type of 1. Highlight the user or Inherited Permissions, Assigned Permissions.
access for a user or group in the list of
group currently in the Assigned Permissions.
list.
2. Select the appropriate
access from the listbox:

Read

Read and Write

Full Control

NOTE: Note that a user


with Full Control permission
over his home collection (his
user collection) is also able to
end his own sessions by using
the Session Manager.

Transition Security Inherited Permissions are permissions inherited


from the parent collection in the Collection Tree.
Transition Security is the security applied to the
(These permissions can only be changed by
collection transitions. For example, some users may disabling inherited security, as discussed above, or
be allowed to close a collection while others can by changing the security profile of the parent
also reopen the collection. collection). Only the Assigned Permissions can be
changed from this dialog.
To change the Transition Security Properties of a
collection:

1. Right-click the collection whose Security


Properties you wish to change.

A menu appears.

Chem & BioOffice 2006 /E-Notebook Managing E-Notebook Security 791


Managing Collection Security
4. Take the appropriate action: Managing the Security
Desired Result Action to take
Properties of a Collection
Type
Administrator

Add a User or 1. Click Add...


The access privileges that you set up for a collection
Group to the list
The Choose User or type determine which users may create new
of Assigned
Group dialog appears. collections of this type in the Collection Tree, and
Permissions.
which users may modify the configuration of the
2. Select the appropriate user collection type.
or group from the tree.
(You may either 1) right- As with other collections, the default security for a
click within a blank portion collection type is Inherits Security, meaning that a
of the tree and select collection type has the same security profile as its
Browse All to see all of the parent collection in the Collection Tree. You may
Users, or 2) click the disable inherited security if you would like the
Search button and perform security profile of a collection type to be
a search for a User or group independent of the security profile of its parent.
of Users).
To disable inherited security:
3. Click Add.
1. Right-click the collection type for which you
The Choose Transition wish to disable inherited security.
Types dialog appears. The Collection menu appears.
4. Select the appropriate
transition type(s).

5. Click Add.

The User or Group


appears in the Assigned
Permissions list, along
with the transition type(s)
you selected.

Remove a User or Click Remove.


Group from the
list.

792 Managing E-Notebook Security CambridgeSoft


Managing the Security Properties of a Collection Type
2. If Inherits Security is checked, select it to clear 3. Click the Collection Security tab.
the checkmark. The Security tab appears. The groups and users
Inherits Security is disabled. who have permission to access this item appear
in one of the two lists: Inherited Permissions,
NOTE: If you disable Inherits Security, the Assigned Permissions.
permissions that the collection had inherited will become
assigned permissions. You must remove these
permissions explicitly if you do not wish these users or
groups to have access to the collection.

Collection Type Security


To set up or change the security properties of a col-
lection type:

1. Right-click the collection type whose security


properties you wish to change.
A menu appears.
2. Select Collection Properties.

The Collection Properties dialog box


appears.

Inherited Permissions are permissions


inherited from the parent collection in the
collection tree. (These permissions can only be
changed by disabling inherited security, as
discussed above, or by changing the security
profile of the parent collection). Only the
Assigned Permissions can be changed from
this dialog.

Chem & BioOffice 2006 /E-Notebook Managing E-Notebook Security 793


Managing the Security Properties of a Collection Type
4. Take the appropriate action
Administrator

794 Managing E-Notebook Security CambridgeSoft


Managing the Security Properties of a Collection Type
Desired Action to take Desired Action to take
Result Result

Add a User 1. Click Add... Remove a 1. Highlight the user or group


or Group to User or in the list.
the list of The Choose User or Group from
Assigned Group dialog appears. the list 2. Click Remove.
Permissions
2. Select the appropriate user
or group from the tree. (You Change the 1. Highlight the user or group
may either 1) right-click type of in the list of Assigned
within a blank portion of access for a Permissions.
the tree and select Browse user or
group 2. Select the appropriate
All to see all of the users, or
2) click the Search button currently in access from the listbox:
and perform a search for a the list Read permits a user to
user or group of users).
create new collections of
3. Click Add. this type in the Collection
Tree. (Note: If a user also
4. Select the appropriate has read access to the
access from the listbox: parent collection of this
collection type, he will be
Read permits a user to able to view the collection
create new collections of type in the Collection
this type in the Collection Tree).
Tree. (Note: If a user also
has read access to the Read and Write permits
parent collection of this a user make changes to the
collection type, he will be to the configuration and
able to view the collection content of the collection
type in the collection tree). type itself. These users may
also create new collections
Read and Write permits of this type in the
a user make changes to the Collection Tree.
configuration and content
of the collection type itself. Full Control permits a
These users may also user to view the collection
create new collections of type, modify it, and assign
this type in the collection or remove security
tree. permissions for it.

Full Control permits a


user to view the collection
type, modify it, and assign
or remove security
permissions
Chem & BioOffice 2006 for it.
/E-Notebook Managing E-Notebook Security 795
Managing the Security Properties of a Collection Type
Managing the Security To disable inherited security:

Properties of a Section 1. Right-click the section type for which you wish
to disable inherited security.
Type
Administrator

A menu appears.
The access privileges that you set up for a section
type determine which users may create view or
configure modify the section type.
This topic applies only to the security of the section
type itself. If a user has access to a particular
collection type that contains the section type, it is
not necessary for the user to have access to the
section type in order to view/create sections within
a collection. That is, the privileges you set up for a
collection type apply to all of its sections.
As with other collections, the default security for a
section type is Inherits Security, meaning that a
section type has the same security profile as its
parent collection in the Collection Tree. You may
disable inherited security if you would like the
security profile of a section type to be independent
of the security profile of its parent.

2. If Inherits Security is checked, select it to clear


the checkmark.
Inherits Security is disabled.

NOTE: If you disable Inherits Security, the


permissions that the collection had inherited will become
assigned permissions. You must remove these
permissions explicitly if you do not wish these users or
groups to have access to the collection.

Section Type Security


To set up or change the security properties of a
section type:
1. In the Collection Tree, right-click the section
type whose properties you wish to change.
A menu appears.
2. Select Collection Properties.

796 Managing E-Notebook Security CambridgeSoft


Managing the Security Properties of a Section Type
The Collection Properties dialog box The Security tab appears. The groups and users
appears. who have permission to access this item appear
in one of the two lists: Inherited Permissions,
Assigned Permissions.

3. Click the Collection Security tab.

Inherited Permissions are permissions


inherited from the parent collection in the
Collection Tree. (These permissions can only
be changed by disabling inherited security, as
discussed above, or by changing the security
profile of the parent collection). Only the
Assigned Permissions can be changed from
this dialog.

Chem & BioOffice 2006 /E-Notebook Managing E-Notebook Security 797


Managing the Security Properties of a Section Type
4. Take the appropriate action:
Desired Action to take
Result
Desired Action to take
Result
Administrator

Remove a 1. Highlight the user or group


User or in the list.
Add a User 1. Click Add...
Group from
or Group to 2. Click Remove.
The Choose User or the list
the list of
Assigned Group dialog appears.
Permissions Change the 1. Highlight the user or group
2. Select the appropriate user type of in the list of Assigned
or group from the tree. (You access for a Permissions.
may either 1) right-click user or
within a blank portion of group 2. Select the appropriate
the tree and select Browse access from the listbox:
currently in
All to see all of the users, or
the list Read permits a user to
2) click the Search button
and perform a search for a view the section type in the
user or group of users). Collection Tree. (Note that
the user must also have
3. Click Add. Read access to the parent
collection of a section type
4. Select the appropriate
in order to view it in the
access from the listbox:
tree).
Read permits a user to
Read and Write permits
view the section type in the
a user make changes to the
Collection Tree. (Note that
to the configuration of the
the user must also have
section type.
Read access to the parent
collection of a section type Full Control permits a
in order to view it in the user to view the section
tree). type, modify it, and assign
or remove security
Read and Write permits
permissions for it.
a user make changes to the
to the configuration of the
section type. Using the Session
Full Control permits a Manager
user to view the section
type, modify it, and assign The Session Manager makes it possible for you to
or remove security see who is logged in to E-Notebook at any given
permissions for it. time. This tool also provides the ability to end the
E-Notebook session for a particular user. You may

798 Managing E-Notebook Security CambridgeSoft


Using the Session Manager
want to end a user's session if the user has locked a The Session Manager appears.
collection for editing and another user must access
the collection.
To access the Session Manager:
1. Right-click within a blank portion of the
Collection Tree.
A menu appears:

This dialog shows the Users, Session numbers, and


Start Times for each current session.

Ending a Session
If you wish to end a particular user's session, you
may do so. To end a session:
1. Click the session in the list.
The session is highlighted.
2. Select Session Manager....
2. Click End Session.
A message appears, asking you to confirm that
you wish to end the session.
3. Click Yes.
The session is ended. The user must log on to
E-Notebook again.

NOTE: A user with Full Control permission over his


home collection (his user collection) may use the Session
Manager to end his own sessions.

Chem & BioOffice 2006 /E-Notebook Managing E-Notebook Security 799


Using the Session Manager
Administrator

800 Managing E-Notebook Security CambridgeSoft


Using the Session Manager
Chapter 42: Summary of the Standard
Add-Ins
This topic summarizes the functions of all the
standard E-Notebook add-inslisteners, field Enterprise Offline Collection Listener
types, and form toolsthat you may use to automatically creates a reference to a newly
configure E-Notebook. created collection in the offline folder.
Owner Full Control Collection Listener
Collection Listeners provides the user with Full Control permission
for this type of collection when he/she is the
Collection listeners are used to modify the
owner.
behaviors of collectionssuch as the creating,
hiding, renaming, duplicating and moving
behaviors. Enterprise No Create Offline Collection
Listener prevents the creation of this type of
Auto Number Collection Listener allows the collection when the user is working offline.
administrator to specify a customized
numbering scheme for a Collection Type. Parent Prefix Collection Listener ensures that
when the collection is renamed, any contained
Audit Collection Listener prevents the user collection that has a name generated by the
from deleting a collection if the collection has Auto Number listener has the correct prefix if
been modified since it was created. the name of the parent collection changes.
Change Display Collection Listener enables Prevent Delete when Referenced Collection
Visual Display of Changes when a user creates Listener prevents users from deleting this
a particular type of collection. type of collection when it is referenced from
Clear Value Collection Listener clears speci- another collection.
fied properties in tables or property list fields Prevent Reference Copy Collection Listener
when a collection is duplicated. prevents users from copying collections that
contain references to specific types of collec-
Enterprise Delete Spawn Collection tions that are in specific states.
Listener deletes any batch explorer links to a
Refresh Database Table Privilege Change
collection when the collection is deleted.
Collection Listener used to refresh the
Database Procedure Collection Listener contents of a database table when the privileges
executes a database procedure during an oper- associated with a collection change.
ation on a collection.
Section List Collection Listener caches a list
Fixed Name Collection Listener prevents the of sections in a collection on the E-Notebook
user from renaming collections. client.

Chem & BioOffice 2006 /E-Notebook Summary of the Standard Add-Ins 801
Collection Listeners
Security Collection Listener allows you to Required Non-blank Properties Transition
assign security privileges to a collection when it Listener prevents a transition from occurring
is created. if specific properties are not filled in.
Sequence Collection Listener names a new Required Rows Transition Listener prevents
Administrator

collection based on a global sequence that you a transition from occurring if specific rows are
specify. missing from a table.
Unduplicatable Collection Listener blocks Required Properties Transition Listener
the duplication of a specific type of collection. checks to ensure that the contents of the prop-
Unique Child Collection Listener ensures the erty list and tables meet the configured
uniqueness of a collection of this type within its Required or Not Blank option. If they do not,
container collection. then the transition will not be completed
User Collection Listener when a User is Unlocked Contents Transition Listener
created, this listener displays a dialog box for checks to ensure that the collections contained
key information that must be entered, such as within a collection are all locked before the
logon ID. container collection can transition into a locked
state.
Transition Listeners
Section Listeners
Transition listeners are used to perform a certain
function that is associated with a transition from E-Notebook provides a number of standard
one state of a collection to another. Section Listeners, which may be used to modify the
behavior of sections:
Annotate Transition Listener prompts the
user for an annotation that is associated with Audit Section Listener prevents a user from
the transition. deleting the section only if it has been modified
since it was created.
Change Display Transition Listener enables
Visual Display of Changes when the transition Clear Value Section Listener clears specified
is performed. values when a user duplicates a section.
Change Security Transition Listener enables Fixed Section Name Listener prevents the
Inherits Security for a collection during a tran- user from renaming the section.
sition. New Name Section Listener prompts a user
Confirm Transition Transition Listener a to enter a name for a section when it is created.
user to confirm a specific transition prior to the Required Section Listener prevents the user
transition occurring. from deleting the section at any time.
Export Transition Listener exports the Unduplicatable Section Listener prevents
contents of a collection as part of a transition. certain sections from being copied when a user
Locked Container Transition Listener checks copies the collection that contains them.
to ensure that the container of the collection is
in a state which permits full control over the Form Tools
contents of the container. E-Notebook provides a number of standard form
Print Transition Listener prints the contents tools, which may be associated with section types to
of a collection as part of a transition. perform certain functions:

802 Summary of the Standard Add-Ins CambridgeSoft


Transition Listeners
Section Type Form Tools New Child Collection Form Tool creates a
new collection within the selected collection.
Active Document (Import/Export) Form
For example, the tool may be used to created a
Tool allows the import and export of MS
new page within a notebook.
Word documents and stored document Fields.
New Section Form Tool allows a user to
Enterprise Batch Explorer Form Tool associate a new section with a collection.
allows a user to view a tree diagram of the
Enterprise New Sibling Collection Form
predecessors and successors of a batch or
compound. Tool allows a user to create a new collection
of the same type.
Character Map Form Tool allows a user to
enter Unicode characters into a text field, prop- Search Engines
erty list, or table.
Three, standard search engines may be used:
Import Image Form Tool allows a user
import a standard image file as a PDF. Collection Search Engine used to search for
collections, based on their metadata.
Insert/Export Form Tool to insert and
export MS Word documents. Section Search Engine used to perform
searches for sections and match criteria speci-
Insert Reference Form Tool allows a user
fied in the a variety of field types.
to reference to a specific collection type in a
target property of a property list. Chemical Structure Search Engine used to
perform searches for chemical structures. The
Load Query Form Tool allows the user to
results are organized by substructure.
copy the contents of the currently selected
query into the query panel, to conduct a search. Field Types
Mail Section Form Tool allows a user to send
The following field types are designed for use in
a section to the inbox of another collection,
data forms, for data entry, analysis, and display:
such as an experiment or a user collection.
New Subsection Form Tool creates a new Active Document Fields (MS Word fields)
subsection when clicked. AutoText Fields
Next Step Form Tool creates a new collec- Chemical Structure Fields
tion with a reaction section containing the Context Sensitive Help Fields
products of the selected reaction. Captured Image Fields
Spectrum Form Tool enables the import of Database Table Fields
various spectra files, and allows users to copy,
paste, import, and export those files. Database Value Fields

Word Link Form Tool allows a user to create Excel Fields


a link from an MS Word document to a section PowerPoint Fields
or collection in E-Notebook. Property List Fields
Collection Type Form Tools Spectrum Fields
Duplicate Collection Form Tool allows a user Stored Document Fields
to create a copy of the collection. Subsection Fields

Chem & BioOffice 2006 /E-Notebook Summary of the Standard Add-Ins 803
Search Engines
Table Fields Block Edit Cell Field Listener makes a partic-
URL Display Fields ular field read-only to users and administrators.
Several fields types are designed for use exclusively Copy Default Field Listener removes the
within search forms, to search for data in content of a field when a user copies the collec-
Administrator

E-Notebook. They are: tion that contains the field.


Chemical Query Fields used for finding Active Document Field Listeners:
chemical structures in E-Notebook tables and Analyze Reaction Chemical Structure
chemical structure fields. Listener automatically updates reactants
Collection Query Fields used for and products tables in a stoichiometry grid
finding collections that match the metadata when a user modifies the reaction drawing.
criteria that a user specifies. Prevent External Link Active Document
Collection Type Query Fields used for speci- Listener may be associated with an Active
fying the collection type over which a search is Document field to prevent users from
run. linking to external URLs.
Query Text Fields used for finding text that Chemical Structure Field Listeners:
occurs in several types of E-Notebook fields. Analyze Reaction Chemical Structure
State Query Fields used to specify the state of Listener updates a stoichiometry grid
the collections over which a search is when a user edits a reaction
conducted. Chemical Property Chemical Structure
Property Query Fields used for finding Listener Calculates chemical structure
specific properties in E-Notebook property properties of molecular weight and
lists. molecular formula, and inserts them into a
Table Query Fields used for finding specific property list when the contents of the
properties in E-Notebook tables. chemical structure change.
Unannotated Version Query Fields used for MS Excel Field Listeners:
finding collections in which changes that Break External Links Listener notifies the
required annotation have been made, but for user the external link in MS Excel files
which no annotation has been provided stored in E-Notebook will be broken.
Search Location Fields used to specify the Hide Add-Ins Listener allows the user to
branch of the collection tree over which the disable add-ins associated with MS Excel in
search is to be run. E-Notebook.
Remove Macros Listener allows the user
Field Listeners to disable add-ins associated with MS Excel
Field listeners may be associated with fields to in E-Notebook.
modify their behavior. Property List Listeners
Generic Field Listeners can be applied to any Block Reference In State Property List
field type: Listener prevents a user from adding a
Block User Edit Field Listener makes a reference to a particular type of collection
particular field read-only to users. that is in a particular state

804 Summary of the Standard Add-Ins CambridgeSoft


Field Listeners
Person Property List Listener populates Validate Value Table Listener validates a
the value of a property with the logged-on value in an E-Notebook table against an
user's name whenever the value of another external database.
property is changed.
Unique Property Table Listener prevents
Chemical Properties Property List Listener adding more than one property of the same
populates the Molecular Weight and type to a table.
Molecular Formula properties automatically
Subsection Listeners:
as the drawing in a chemical structure field is
changed Button View Subsection Field Listener
forces subsections into button view (as
Validate Value Property List Listener
opposed to the standard tab view).
validates a value in an E-Notebook property
list against an external database. Hide Tools Subsection Listener hides the
form tool area of a subsection for more
Formula listener allows you to associate a
efficient screen usage.
formula with a cell in a property list, and
display the returned value in the cell.
Commands
Table Listeners:
Commands can be associated with a collection
Analyze Reaction Table Listener types and sections types to render content in:
automatically updates reactants and exporting to MS Word, PDF, or printing.
products tables in a stoichiometry grid when
a user modifies a reaction drawing. Collection Commands
Block Reference table listener prevents a Export to MS Word Collection Command
user from adding a reference to a specific this command allows you to render the
type of collection that is in a particular state. contents of a collection to an MS Word
Formula listener allows you to associate a
document type.
formula with a table cell, and display the Enterprise Export to PDF Collection
returned value in the cell. Command allows to render and save the
contents of a collection to a PDF document.
Products table listener is associated with
the products table field in the stoichiometry Print Collection Command prints the
grid of a reaction section. contents of a collection using an MS Word
document.
Products Fixed Limiting table listener
same as the Products listener, but the Section Commands
limiting equivalents cannot vary.
Export to MS Word Section Command
Reactants table listener is associated with this command allows you to render the
the reactants table field in the stoichiometry contents of a section to an MS Word
grid of a reaction section. document type.
Reactants Fixed Limiting table listener Print Section Command prints the
same as the Reactants listener, but the contents of a section using an MS Word
limiting equivalents cannot vary. document.

Chem & BioOffice 2006 /E-Notebook Summary of the Standard Add-Ins 805
Commands
Rendering Add-ins Fixed Table Field Renderer renders the
contents of a table according to the tags in a
Rendering add-ins may be used to modify the Word table.
behavior of rendering printing and exporting to NonBlank Property Field Renderer renders
Administrator

Word. the name and value of a property if the prop-


Fixed Text After Word Renderer This erty is not blank.
renderer renders some fixed text at the end of One Property Value Field Renderer renders
a collection when rendering the collection. the value of a single property according to the
Full History Word Renderer This renderer tags in a Word table.
renders the entire history of a collection when One Table Value Field Renderer renders the
rendering the collection. value of a single table cell according to the tags
Tracked History Word Renderer This in a Word table.
renderer renders the history of a collection Property Value Field Renderer renders the
since change display was turned on for the values of all the properties in a property list
collection. without their corresponding names.

806 Summary of the Standard Add-Ins CambridgeSoft


Rendering Add-ins
Chapter 43: Using the Batch Import
Facility
The batch import facility in E-Notebook provides import element. Each import element may contain
for a means to import a partial or complete a target element, if none is specified, the target is the
configuration in a single menu command. This parent collection. Each import element must
process is controlled by an import script called the contain a source element.
Batch File, which is an xml file adhering to the
schema described in this document. The Batch File <target>
typically refers to additional files, either
E-Notebook content files created with the Export The target element describes where in the
command (called Content Files) or subsidiary batch E-Notebook collection hierarchy the imported
files. This process is initiated by selecting a content is to be placed. This element must contain
collection in the E-Notebook collection tree (which one of the following elements, depending on what
will be referred to as the Parent Collection) and sort of content is being imported:
choosing the Import command.
collectionType
<batch> childReference

The root element must be a <batch>. There are no <collectionType>


attributes defined for the batch element. A batch
may contain zero or more of any of the following A collectionType element indicates that the
elements, interspersed in any order, except as relationships for a previously imported collection
dictated by the dependencies between the imported type are to be imported. The name attribute
collection and section types. specifies the name of the collection type for which
relationships are to be imported, and the
log collectionType element must include a collection
alert element which specifies by position the first (and
only) collection which defines that collection type.
refresh For example:
import <import>

<target><collectionType name="Binder">
<import> <collection position="1"/></collectionType>
</target>
The import element causes a single file to be
imported. This file may contain any content, <source>Collection Types/Binder.xml
</source>
including section types, collection types, collections,
or sections. There are no attributes defined for the </import>

Chem & BioOffice 2006 /E-Notebook Chapter 43: Using the Batch Import Facility 807
<batch>
<childReference> <childReference name="Some Folder">
<targetCollection>
A <childReference> indicates a reference to a
collection contained within the Parent Collection. <childReference name="Another Folder"/>
Administrator

This element must contain a name or position </targetCollection>


attribute, but is invariably used with a name. For </childReference>
example, this may be used to create a grandchild of
</target>
the Parent Collection, as follows:
<source>Deeper Folder.xml</source>
<import>
</import>
<source>Section Types.xml</source>
</import> <source>
<import>
The source element contains text which specifies
<target><childReference name="Section Types"/>
the path of the file to be imported. This is
</target>
interpreted relative to the batch file.
<source>General Information.xml</source>
</import> <log>
Assuming Section Types.xml describes a The log element contains text which is written to
collection named Section Types and that
the client log file, if logging is enabled. If logging is
General Information.xml describes a section
not enabled, this element is ignored. Example:
type, this <import> will create a Section Types
collection, and within that, a General Information <log>General Information section type created
section type. </log>

The E-Notebook collection hierarchy distinguishes <alert>


between the nodes, called collections, and the
links between the nodes, called references. Every The alert element causes a message to be displayed.
reference has one container collection and one This element must contain the text to be displayed,
target collection, and a collection may be referred to and may have a title attribute which specifies the
as the target of any number of references. Thus, the title of the message box, and may have a buttons
<childReference> describes a reference, but if a attribute which may be 0 or 1. If the buttons
<target> specifies a reference, it is assumed that the attribute is 0 or not specified, the message box will
target is the reference's target collection. A have an OK button only. If the buttons attribute is
<childReference> may contain a <targetCollection> 1, the message box will have OK and Cancel, and if
element explicitly to indicate that the target is the Cancel is pressed, the import process will stop.
collection, not the reference, but this is optional
unless one wishes to further specify a collection <refresh>
contained within this collection. For example, to
specify deeper levels in the collection hierarchy, one The refresh element causes the client to refresh the
might use: display of section and collection type information
to show the effect of any imported objects. One
<import> commonly uses a refresh element at the end of the
<target> import script.

808 Chapter 43: Using the Batch Import Facility CambridgeSoft


<childReference>
Appendix O: Technical Support
Overview You can deliver your CS Software Problem Report
Form to Technical Support by the following
CambridgeSoft Corporation (CS) provides methods:
technical support to all registered users of this Internet:
software through the internet, and through our http://www.cambridgesoft.com/services/mail
Technical Support department.
Email: support@camsoft.com
Our Technical Support webpages contain answers Fax: 617 588-9360
to frequently asked questions (FAQs) and general Mail: CambridgeSoft Corporation
information about our software. You can access our
ATTN: Technical Support
Technical Support page using the following
address: http://www.cambridgesoft.com/services/ 100 CambridgePark Drive
Cambridge, MA 02140 USA
If you dont find the answers you need on our
website, please do the following before contacting Serial Numbers
Technical Support.
When contacting Technical Support, you must
1. Check the ReadMe file for known limitations always provide your serial number. This serial
or conflicts. number was on the outside of the original
2. Check the system requirements for the soft- application box, and is the number that you entered
ware at the beginning of this Users Guide. when you launched your CambridgeSoft
application for the first time. If you have thrown
3. Read the Troubleshooting section of this
away your box and lost your installation
appendix and follow the possible resolution
instructions, you can find the serial number in the
tactics outlined there.
following way:
4. If all your attempts to resolve a problem fail, fill
Choose About CS <application name> from the
out a copy of the CS Software Problem Report
Help menu. The serial number appears at the
Form at the back of this Users Guide. This
bottom left of the About box.
form is also available on-line at:
http://www.cambridgesoft.com/services/mail For more information on obtaining serial numbers
and registration codes see:
Try to reproduce the problem before http://www.cambridgesoft.com/services/codes.cfm
contacting us. If you can reproduce the
problem, please record the exact steps that Troubleshooting
you took to do so.
This section describes steps you can take that affect
Record the exact wording of any error
the overall performance of CambridgeSoft
messages that appear. Desktop Applications, as well as steps to follow if
Record anything that you have tried to your computer crashes when using a CS software
correct the problem. product.

Chem & BioOffice 2006 /Appendix Technical Support 809


Serial Numbers
Performance Video Driver related problems: If you are
having problems with the display of any
Below are some ways you can optimize the
performance of CambridgeSoft Desktop CambridgeSoft Desktop Application, try
Applications: switching to the VGA video driver in the
Administrator

display Control Panel (or System Setup, then


In the Performance tab in the System control
panel, allocate more processor time to the retest the problems. If using a different driver
application. helps, your original driver may need to be
Install more physical RAM. The more you updatedcontact the maker of the driver and
have, the less ChemOffice Desktop Applica- obtain the most up-to-date driver. If you still
tions will have to access your hard disk to use have trouble contact us with the relevant
Virtual Memory. details about the original driver and the
Increase the Virtual Memory (VM). Virtual resulting problem.
memory extends RAM by allowing space on
your hard disk to be used as RAM. However, Printer Driver related problems: Try using
the time for swapping between the application a different printer driver. If using a different
and the hard disk is slower than swapping with driver helps, your original driver may need to
physical RAM.
be updatedcontact the maker of the driver
Change the VM as follows: and obtain the most up-to-date driver. If you
System control panel, Performance tab. still have trouble contact us with the relevant
details about the original driver and the
System Crashes
resulting problem.
CambridgeSoft Desktop Applications should never
crash, but below are the steps you should go 3. Try reinstalling the software. Before you rein-
through to try to resolve issues that cause computer stall, uninstall the software and disable all back-
crashes while using a CS software product. ground applications, including screen savers
1. Restart Windows and try to reproduce the and virus protection. See the complete unin-
problem. If the problem recurs, continue with stall instructions on the CambridgeSoft Tech-
the following steps. nical Support web page.
2. The most common conflicts concern Video
4. If the problem still occurs, use our contact
Drivers, Printer Drivers, screen savers, and
virus protection. If you do need to contact us, form at: http://www.cambridge-
be sure to determine what type and version of soft.com/services/mail and provide the details
drivers you are using. of the problem to Technical Support.

810 Technical Support CambridgeSoft


Troubleshooting
Appendix P: Accessing the Cambridge-
Soft Web Site
Online Menu CambridgeSoft website to receive a registration
code. Upon filling out a registration form, the
Overview registration code is sent to you by email. This
registration scheme does not apply to site licenses.
The ChemOffice Online menu gives you quick
access to the CambridgeSoft web site from within If your serial number is invalid for any reason, or if
ChemOffice. With the Online menu, you can: you do not have an internet connection, you will
have to contact CambridgeSoft Support to receive
Register your software. a registration code.
Search for compounds by name or ACX You may use your ChemOffice application a limited
number and insert the structure in a worksheet number of times while waiting for the registration
Use ACX numbers, or names or structures in process to be completed. Once the application
the worksheet, to search for chemical informa- times out, you must register to activate the software.
tion
In addition to registering your software, you can
Browse the CambridgeSoft website for tech- request literature, or register for limited free access
nical support, documentation, software to ChemFinder.com, ChemACX.com,
updates, and more ChemClub.com, and the email edition of
To use the Online menu, you must have internet ChemNews from the Register Online link of the
access. Online menu. This link connects you to the
Cambridgesoft Professional Services page. From
this page you can link to a registration form.
To register online:
1. From the Online menu, choose Register
Online.
The Cambridgesoft Professional Services page
opens in your browser.

Register tab

Registering Online
Chem & BioOffice 2006 applications utilize a new
security scheme. In order to activate any
ChemOffice application, you must register with the 2. Select the Register tab.

Chem & BioOffice 2006 /Appendix Accessing the CambridgeSoft Web Site 811
Registering Online
Accessing the Online Accessing Cambridge-
ChemDraw Users Guide Soft Technical Support
The Online menu link Browse CS Appendix
Administrator

The Online menu link Browse CS ChemDraw


Technical Support also opens the Cambridgesoft
Documentation opens the Cambridgesoft Desktop
Professional Services page. There are a number of
Manuals page, where you can access current and links on this page for Troubleshooting, Downloads,
previous versions of the Appendix Users Guide. Q&A (the ChemOffice FAQ), Contact, and so
forth.
To access the CambridgeSoft Manuals page:
Finding Information on
1. From the Online menu, choose Browse
CS ChemDraw Documentation.
ChemFinder.com
The Find Information on ChemFinder.com menu item
links your browser to the ChemFinder database
record of the compound you have selected.
ChemFinder is the public-access database on the
ChemFinder.com website. It contains physical,
regulatory, and reference data for organic and
inorganic compounds.

To access ChemFinder.com:
1. In Appendix, select a structure you want to
look up.
The Desktop Manuals page appears. PDF 2. From the Online menu, choose Find Informa-
versions of the CambridgeSoft manuals can be tion on ChemFinder.com.
accessed from this page. The ChemFinder.com page opens in your
browser with information on the selected
NOTE: If you do not have a CambridgeSoft User structure.
account, you will be directed to a sign-up page first. In ChemFinder.com you can search for chemical
information by name (including trade names), CAS
2. Click version of the manual to view. number, molecular formula, or molecular weight.

812 Accessing the CambridgeSoft Web Site CambridgeSoft


Accessing the Online ChemDraw Users Guide
Follow the links to do substructure queries.The To use Find Suppliers on ChemStore.Com menu
following illustration shows part of the page for access:
Benzene.
1. In Appendix, select a structure you want to
look up.

2. From the Online menu, choose Find Suppliers


on ChemStore.com.

The ChemACX.Com page opens in your


browser with information on the selected
structure.

For example the ChemACX.com page for Benzene


is shown below.

Finding Chemical
Suppliers on ACX.com For more information on using the ChemACX
website, see the ChemOffice Enterprise
The Find Suppliers on ChemStore.Com menu item
Workgroup & Databases Manual.
links your browser to the chemacx.com database
record of suppliers of the compound you have
selected. Finding ACX Structures
and Numbers
ChemACX (Available Chemicals Exchange) is a
Webserver application that accesses a database of Appendix searches ACX and returns information
commercially available chemicals. The database about related structures and numbers. You can
contains catalogs from research and industrial place the returned information in your document.
chemical vendors.
ACX Structures
ChemACX allows the user to search for particular
chemicals and view a list of vendors providing those There are two ways to find ACX structures: by ACX
chemicals. number or by name.

Chem & BioOffice 2006 /Appendix Accessing the CambridgeSoft Web Site 813
Finding Chemical Suppliers on ACX.com
To find a structure that corresponds to an ACX ACX Numbers
number:
To Find an ACX number for a structure:
1. From the Online menu, choose Find Structure
1. In a Appendix document, select the structure
Administrator

from ACX Number.


for which you want to find an ACX number.
The Find Structure from ACX number 2. From the Online menu, choose Find ACX
dialog box appears. Numbers from Structure.
The ACX number appears in the Find ACX
Numbers from Structure dialog box.

2. Type the ACX registry number.

3. Click OK.
Browsing Chem-
The Structure appears in your document.
Store.com
To find a structure from a name Browse ChemStore.com opens the ChemStore
page of the CambridgeSoft web site.
1. From the Online menu, choose Find Structure
from Name at ChemACX.com. To access Browse ChemStore.com:
From the Online menu, choose Browse Chem-
The Find Structure from Name dialog box
Store.com.
appears.
The ChemStore.Com page opens in your
browser.

2. Type in a name. As with ChemFinder.com, you


can use a chemical name or a trade name.

3. Click OK.

The Structure appears in your document.

814 Accessing the CambridgeSoft Web Site CambridgeSoft


Browsing ChemStore.com
You can search ChemStore.Com for chemicals, lab Check the CambridgeSoft web site for new product
supplies, chemistry-related software, and other information. You can also get to ChemStore.Com,
items you want to buy. You can access ChemNews.Com, and other pages through
ChemACX.Com, LabEqwip.Com, and other pages CambridgeSoft.Com.
from ChemStore.Com.
Using the ChemOffice
Browsing Cambridge- SDK
Soft.com The ChemOffice Software Developers Kit (SDK)
Browse CambridgeSoft.com opens the Home page enables you to customize your applications.
of the CambridgeSoft web site. To browse the ChemOffice SDK:
To access the CambridgeSoft Home Page: From the Online menu, choose Browse
ChemOffice SDK.
From the Online menu, choose Browse
The CS ChemOffice SDK page opens in your
CambridgeSoft.com.
browser.
The CambridgeSoft web site in your browser.

The ChemOffice SDK page contains


documentation, sample code, and other resources
for the Application Programming Interfaces
(APIs).

Chem & BioOffice 2006 /Appendix Accessing the CambridgeSoft Web Site 815
Browsing CambridgeSoft.com
Administrator

816 Accessing the CambridgeSoft Web Site CambridgeSoft


Using the ChemOffice SDK
Index
Symbols Access database, opening 337
% wildcard character 403 Accessing relational data using subforms 361
(, in query 405 Activating the select tool 58
(-CHR-) bending force parameters 262 ActiveX control 460
* wildcard character 403 Actual field editing 132
-, in query 405 Actual field measurements 49
<, in query 405 ACX information, finding 813
= symbol, in query 403 ADD indicator 378
=, in query 405 ADD indicator, description 305
>, in query 405 ADD indicator, when displayed 307
\, in query 413 Add New Record command 378
Adding
Numerics buttons 343
2D programs, using with Chem3D 97 checkboxes 343
2D to 3D conversion 219 data 378
3D enhancement data box menu 348
depth fading 80 fields 374, 439
hardware 83 formal charges 99
red-blue 80 fragments 106
stereo pairs 83 information to the stoichiometry table 536
3D properties 408 items from the autotext pane 544
3D searching 408 menu to a data box 348
3D structure display 347 new collections 514
3DM file format 147 new reactant collections 519
3RINGANG.TBL, see Angle bending table new reactants 518
4-Membered Ring Torsionals 251 parameters to MOPAC 294
4RINGANG.TBL, see Angle bending table pictures 343
plain text 342
A properties to the field 625
A (any), special atom type 469 reaction templates to the reaction worksheet
About the E-Notebook Guide 508 498
Access records 307, 320, 378
attaching tables from 373 reference within the user collection 514
manipulating .mdbfiles 439 references to the folder 517
multi-user 367 scroll bars 349
read-only 367 serial numbers, tutorial example 55
secured 368 spectra 567
using with ChemFinder 439 structures 378, 533

Chem & BioOffice 2006/Index i


Adding, continued Aligning
tables 365, 384, 439 objects 354
to groups 138 parallel to an axis 123
Adding a Collection Listener to a Collection Type parallel to plane 123
Administrator

753 to center 124


Adding a Contained Collection Type 749 Aligning and distributing objects 354
Adding a Contained Reference Type 751 Allingers force field 290
Adding a Field to a Section Type 656 Alternate Groups
Adding a Field to an ExistingForm 669 searching with 408
Adding a Form Tool to a Section Type 658 Alternative Groups
Adding a link attachment point symbol 409
from a property list to a collection 564 defining 409
from a property list to a section 565 description 408
from a property list to an external URL 565 Anchored substring text queries 403
from a table to a collection 575 AND operator, hit lists 424
from a table to a section 576 AND operator, queries 403, 405, 412
Adding a new Field Type 740 Angle bending force constant field 259
Adding a Property to the Property List 713 Angle bending table 251, 259
Adding a Property to the Table Angle defining atom 125
727 Angle type field 259
Adding a Section Listener to a Section Type 664 Angles and measurements 211
Adding a Section Type to a Collection Type 747 Animations 139
Adding multiple structures to forms 376 Annotation of changes 603
Adding States to a Collection Type 768 Annotations, showing 430
Adding structures to non-chemical databases 377 Anti-aromaticity 469
Advanced text searching 627 Applying a filter 534
Advanced text searching options Aromaticity 469
ABOUT 628 ASCII file, exporting 401
AND (&) 628 Assigning atom types 217
Backslash 628 Assigning fields to data boxes 318
Curly Brackets {} 627 Associating a list of manually entered values with a
EQUIValence (= ) 629 property 715, 729
Fuzzy (?) 629 Associating a Transition Listener with a Transition
MINUS (-) 630 770
NEAR 630 Atom
NOT (~) 631 label colors, see Customizing fonts
OR (|) 632 labels 81, 99
Soundex (!) 632 lists 426, 618
Stem ($) 633 movement, when setting measurements 108
ALC file format 144, 147 not-lists 618
Alchemy 221 pairs, creating 65
Alchemy file format 147, 221 pairs, setting 108
Alchemy, FORTRAN format 222 properties 617

ii CambridgeSoft
Atom, continued Atom-to-Atom mapping 411
replacing with a substructure 103 Atom-to-Atom mapping, reaction queries 411
size by control 78 Attaching
size% control 78 files from a file-based database 373
spheres, hiding and showing 77 tables from other applications 373
to-Atom Mapping 622 Attaching files from a non file-based database 373
type characteristics 217 Attachment point rules 211
type field 260, 263 Attachment Points
type number 263 defining 409
type number field 252, 255 tool 409
Atom Lists 469 Automatic Labels 342
Atom Not-Lists 470 Autosave, saving changes with 602
Atom Properties 469 Autotext
Atom types based on other fields in the section 547
A (any) 469 inserting custom 546
and bond types 426 inserting links with 545
assigning automatically 47 working with 543
creating 218 AVI file formats 147
in cartesian coordinate files 223
link node 427 B
M (metal) 469 Background color 81
overview 426 Background effects 156
pop-up information 129 Backing-up databases 377
Q (heteroatom) 469 Ball & stick display 76
table 254 Basic text searching 626
X (halogen) 469 Batch import commands
Atomic Weight field 264 807, 808
Atoms 465, 615 Bending constants 262
aligning to plane 123 Bin, definition 388
changing atom types 105 Binding sites, highlighting 116
coloring by element 79 BioViz
coloring by group 79 changing fields 385
coloring individually 81 curve fitting 389
displaying element symbols 81 details window 386
displaying serial numbers 81 empty points 386
mapping colors onto surfaces 92 filter sliders 391
moving 118 histogram plots 386
moving to an axis 123 selecting points 385
positioned by three other atoms 125 setting display range 391
removing 98 statistical analysis 389
selecting 113 BioViz, tutorial 330
setting formal charges 109 Bitmap file format 146
size 78 Bitscreen 477

Chem & BioOffice 2006/Index iii


BMP file format 146 Boxes
Bond changing styles 346
angles 48 creating 340
angles, setting 108 deleting 353
Administrator

dipole field 258 font 349


length 48 hiding or showing 349
length and bond order, tutorial example 53 moving 352
length, pop-up information 129 properties 345
length, setting 108 resizing 352
length, uniform 430 selecting 352
order matrix 295 style 345
order, changing 105 Break Bond command 106
order, pop-up information 129 Bring to Front command 353
proximate addition command 106 Browsing
stretching force constant field 258 at a higher level 529
stretching parameters 257 databases 369
stretching table 252, 257 from home 529
tools, building with 97 limiting collection 528
tools, tutorial example 51 plates 502
type field 258, 261, 267 the entire collection tree 530
types, overview 426 up to the user group 515
Bond properties 472, 620 Browsing search results 453
in queries 472 Browsing with the record tool 369
ring/chain 472 Btrieve 373
Bond types Building
double either 466 controls, see Model building controls
in queries 465 modes 95
special 472 toolbar 40
Bonds 228, 465, 616 with bond tools 97
creating between nearby atoms 106 with other 2D programs 97
creating uncoordinated 98 with substructures 101
moving 118 with substructures, examples 101, 102, 103
removing 98 with the ChemDraw panel 96
selecting 113 with the text building tool 99
BONDS keyword 295 Building models 44, 95
Boolean operations, in queries 403 from Cartesian or Z-Matrix tables 103
Boolean operations, on hit lists 424 order of attachment 100
Bound-to order 256 rings 100
Bound-to type 256 with bond tools 51
Box Creation commands 480 with ChemDraw 59
Box creation commands, CAL 480 with the text building tool 56
Box Manipulation commands 481 Buttons, creating 343
Box Manipulation commands, CAL 481

iv CambridgeSoft
C Changing, continued
C3DTABLE 254 Z-matrix 125
CAL Changing a Field Type 740
commands 479?? Changing a section 583
execute with button 343 Changing a User's Properties 784
help 435, 479 Changing Box Orientation 676
overview 435 Changing collection security properties 593
Calculating the dipole moment of meta-nitro- Changing colors 393
toluene 184 Changing the Dimensions of a Box Manually 674
Calculation toolbar 42 Changing the display 393
Cambridge Crystal Data Bank files 226 Changing the Relationship between a Contained
CambridgeSoft.com 815 Collection Type and the Parent Collection Type
Canonicalization 308 750
Cart Coords 1, see Cartesian coordinate file format Changing the Relationship between a Contained
Cart Coords 2, see Cartesian coordinate file format Reference Type and the Parent Collection Type
Cartesian coordinate 49, 144, 148 752
displaying 133 Changing the Security Properties of a User Collec
file format 148, 223 tion 784
FORTRAN file format 226 Changing the Weight of a Box 673
pop-up information 129 Charge field 255
positioning 123 Charge property 178
CC1, see Cartesian coordinate file format Charge, adding formal 99
CC2, see Cartesian coordinate file format Charge-Dipole interaction term 291
CCD, see Cambridge Crystal Data Bank file format Charges 178
CCITT Group 3 and 4 147 Charges and Radicals 466
CDX file format 144 Charges and radicals 617
Centering a selection 124 Charges, adding 102
CFS file format 438 Charges, from an electrostatic potential 178
CFW file format 340, 439 Charges, in queries 466
Chain bonds 472 Charges, pop-up information 129
Changes and audit trail 601 Check valences 431
Changes menu 602 Checkboxes 343
Changing Chem3D
atom to another atom type 105 changes to Allingers force field 290
atom to another element 104 synchronizing with ChemDraw 96
bond order 105 viewing models 383
box style 346 Chem3D 9, comparison with (table) 28
database scheme 384 Chem3D, about 27
elements 99 Chem3D, whats new in 10.0? 28
layout of an existing form 354 ChemClub.com 811
layout of an existing subform 364 ChemDraw
orientation 122 editing structures 382
stereochemistry 110 panel 42

Chem & BioOffice 2006/Index v


ChemDraw, continued Close Contacts command 255
synchronizing with Chem3D 96 Closed shell system 297
transferring models to 154 Closing and reopening pages and experiments 516
ChemDraw ActiveX control 460 CMYK Contiguous 147
Administrator

ChemDraw format, viewing in 346 COEA, see ChemOffice Extension Architecture


ChemDraw panel 96 Collection
ChemFinder changing security properties 593
automation language, see CAL deleting a 591
basics 303 duplicating within a container 590
GUI 303 E-Notebook
opening options 431 adding from a property list 564
starting 309 adding from a table 575
toolbars 306 exporting 593
ChemFinder.com 813 exporting to MS Word 597
ChemFinder/Office importing 593
customizing 459 limiting browsing 528
GUI 449 moving bewteen containers 589
Look In tab 450 moving within containers 588
overview 449 organizing 588
preferences 460 printing 597
Search Options tab 457 printing multiple 597
Send To menu 455 reactant
settings 459 adding a new 519
ChemFinder/Office, using CombiChem with 503 adding a new reactant to existing 518
Chemical Structure Search Engine 766 renaming 591
Chemicals, purchasing online 814 saving and hiding 528
ChemNews.Com 815 saving changes 601
ChemOffice Extension Architecture 27 security 594
ChemOffice SDK, accessing 815 transition, performing 597
ChemStore.com 814 tree, browsing the entire 530
Chromatek stereo viewers 80 tree, hiding 528
CI, microstates used 295 user
CIS 295 adding a new collection to 514
Cleaning structures 381 adding a reference within 514
Cleaning up a model 112 viewing properties 592
Clear Molecular Surfaces command 88 Collection Listeners 801
Clearing Fields when Configuring a Form 675 Collection Search Engine 766
Clearing forms 378, 416 Collection Security 788
Clicking the changes icon 602 Collection Type Security 793
Clipboard Color
exporting with 154 applying to individual atoms 81
Clipboard, copying to 154
Clipboard, importing with 97

vi CambridgeSoft
Color, continued Commands, continued
background 81 file 484
by depth 80 find 417
by depth for Chromatek stereo viewers 80 find current molecule 418
by element 79 find list 405
by group 79 find text 375
by partial charge 79 first record 369
displays 79 go to record 369
field 254 import file 35
preferences 430 intersect with current list 424
settings 79 last record 369
Color, setting 351 menu 479
Coloring groups 139 next record 369
Coloring the background window 81 previous record 369
Columns program execution 482
adding in 439 read file 344
changing formats 439 read structure 399
structure 500 redo 384
use (Y/N) 500 replace current list 424
Combi experiments 501 restore list 424
creating 500 save list 424
product sheet 501 save structure 401
reactant sheets 501 script-only 487
CombiChem 461 search over list 330
creating a workbook 497 select fragment 36
engine 461, 495 send to back 353
help 496 undo changes 379
using with ChemFinder/Office 503 variable 485
Combined searches, see Searching, combined Comments panel 44
Commands Commit Changes command 381, 382
add new record 378 Commit changes command 379
box creation 480 Committing changes vs. saving 339
box manipulation 481 Committing new data 379
bring to front 353 Communicating with other applications 437
clear molecular surfaces 88 Communicating with other applications using
close contacts 255 DDE 437
commit changes 379, 381, 382 Communicating with other applications using OLE
compute properties 176 automation 438
current record 305, 307 Communicating with other applications using
data source 335, 373 scripts 437
database 484 Commutative principle 477
delete record 384
enter query 416, 417

Chem & BioOffice 2006/Index vii


Comparing Conventions, documentation 24
cation stabilities in a homologous series of Copy As Bitmap command 154
molecules 182 Copy As ChemDraw Structure command 154
models by overlay 63 Copy as InChI 308
Administrator

the stability of glycine zwitterion in water and Copy as name 308


gas phase 185 Copy command 154
Complete Structure Similarity, see Tanimoto similar- Copy Measurements to Messages control
ity GAMESS 204
Compression 147 COSMO solvation 180
Compute Properties Counterions 382
Gaussian 200 Covalent radius field 254
MOPAC 176 Create Database button 371
Compute Properties command 176 Create table dialog box 372
Computing partial charges 71 Creating
Computing properties 200 and editing tabs 344
Computing properties for a movie 63 and playing movies 139
Computing steric energy, tutorial example 60 atom pairs 65
CON file format 148 atom types 218
Concurrent access 367 bonds by bond proximate addition 106
Configuring boxes 340
plates 501 boxes with frames 341
Configuring a Form 666 button 343
Configuring a New Form 667 CombiChem workbook 497
Configuring a Transition between States 769 data box menu 348
Configuring a Database Table Field 705 data boxes 314, 341
Configuring Annotation Options 778 databases 337, 371
Configuring Autosave 779 Experiments 500
Configuring Change Control Options 776 fields 374
Configuring Relationships to Unspecified Types of folders 517
Collections 752 forms 340
Configuring the Appearance of a Property List 714 forms automatically 338
Configuring the Appearance of a Table 727 forms with the database tree 344
Conformations, examining 59 forms, manually 340
Conformations, searching 63 forms, overview 335
Conjugated pi-system bonds table 252 forms, tutorial 313
Connection table file format 148, 395 frames 341
Connection tables 148 groups 138
Connolly molecular surface 91 MOPAC input files 189
displaying 91 movies 139
overview 91 multiple tables 365, 384
Constraining movement 118 new autotext definitions 546
Constraints, setting 109 notebooks 515
Context menus, saving and closing 34 pages or experiments 516

viii CambridgeSoft
Creating, continued Current Record command 305, 307
pages or experiments from a template 516 Curve fitting, see BioViz
parameters 253 Customizing
picture boxes 343 ChemFinder 429
portal databases 377 dihedral graphs 63
references within a table cell 575 favorites tree 432
references within the collection tree 589 fonts 349
scripts 435 numbers 350
sections 583 text 349
structures from ARC files 190 toolbars 433
subforms 332, 361, 363 user interface 34
substructures 211 Cutoff distances 263
tables 372 Cutting and pasting a section 584
tabs 344 Cylindrical bonds display 76
text 342
uncoordinated bonds 98 D
Creating a Database Table Field 705 DAT file format 150
Creating a database, tutorial 319 Data
Creating a New Collection Type 746 adding 378
Creating a New Section Type 655 committing 379, 384
Creating a plot 387 deleting 384
Creating a Property List 713 displaying 340
Creating a Search Form 766 editing 380
Creating a Search Type 764 entering 378, 384
Creating a Table Field 726 exporting 400
Creating a User 783 items 310
Creating a User Group 784 labels 46
Creating and editing forms 335 sorting 380
Creating and Editing the Export Templates for a Data Box tool 341
Collection Type 780 Data boxes
Creating and saving forms 316 deleting 316
Creating the Export Template for a Section Type editing 315
678 Data boxes, creating 341
Creating the Export Templates for a Collection Data boxes, hiding or showing 349
Type 780 Data Source
CT file format 144, 148 command 335, 373
CUB file format 149 ODBC 373
Cubic and quartic stretch constants 262 selecting 335, 373
Current list Data Source - Find Chemical Structures window
counter 307 449
description 304 Data Table
size 307 sorting 380
Current Mol, as query command 418 subforms 365

Chem & BioOffice 2006/Index ix


Data table Defining
displaying 369 atom types 218
moving columns 369 groups 115
resizing columns 370 substructures 211, 212
Administrator

resizing rows 370 Delete a structure 574


Data tables 369 Delete Record command 384
Data, importing 395 Deleting
Database boxes 353
commands 484 contents of fields 384
commands, CAL 484 data 384
creating 337 data boxes 316
Database Lookup Configuration 717, 728 fields 376
Database Model, description 310 groups 138
Database tree, using 344 measurement table data 50
Database, connecting to a form 317 objects 353
Databases records 384
adding structures 377 tables 372
cells 310 Deleting a Box from a Form 670
compressing 439 Deleting a collection 591
creating 371 Deleting a Field Type 740
data items 310 Delimited text files 401
flat-file 371 Delocalized bonds field 256
logon 368 Demo database 322
model 310 Demo toolbar 42
moving 377 Depth fading 80
multiple tables 373 Deselecting atoms and bonds 114
non-chemical 373, 377 Deselecting, changes in rectification 114
opening 335, 367 Deselecting, description 114
read-only 307 Details window, see BioViz
resetting 381 Deviation from plane 132
searching 499 dForce field 261
selecting 335 DFORCE keyword 295
size 306, 307 Dialog boxes
vs. forms 311 Preferences 34
Date fields 375 Dielectric constants 263
Date queries, see Searching, for dates Dihedral angles
Dates, display preferences 405 rotating 120
dBASE 373 Dihedral angles, setting 108
DDE, to communicate with other applications 437 Dihedral Driver 62
Debugging scripts 436 Dihedral type field 265
Default minimizer 173 Dimension, definition 388
Define Group command 115 Dipole moment 178
Dipole moment, example 182

x CambridgeSoft
Disabling security 360 Editing
Display control panel 75 atom labels 99
Display Every Iteration control Cartesian coordinates 49
GAMESS 204 data 380
Display preferences 429 data boxes 315
Display types 75 display type 75
Displaying fields 380
atom labels 81 file format atom types 221
coordinates tables 133 form layout 354
dot surfaces 78 forms 352
hydrogen bonding 117 forms, overview 335
hydrogens and lone pairs 48, 118 internal coordinates 48
labels atom by atom 82 labels 342
models 46 measurements 131
molecular surfaces 85 models 95
polar hydrogens 117 movies 140
solid spheres 77 parameters 290
Distance-defining atom 125 redo 353
Distributing objects 354 selections 114
dLength field 261 structures 381
Docking models 65 structures with ChemDraw 382
Documentation web page 812 tabs 344
Domains 423 undo 353
Dot density 79 Z-matrix 125
Dot surfaces 79 Editing a structure or image 574
Dots surface type 87 Editing an Enumerated Values List 730
Double bond tool, tutorial example 54 Editing the Export Template for a Section Type
Double bonds field 256 678
Double either bond type 466 Editing the Header and Footer Information 781
Drag and drop 399 Editing an Enumerated Values List 715
Drawing a structure or reaction 531 EF keyword 173
Drawing and analyzing reactions 532 Eigenvector following 173
Dummy atoms 98 Eigenvectors 295
Duplicating Electron field 260
records 379 Electronegativity adjustments 261
Duplicating a collection within a container collec- Electrostatic
tion 590 and van der Waals cutoff parameters 263
Duplicating a section between collections 585 and van der Waals cutoff terms 291
Duplicating a section within a collection 585 cutoff distance 263
cutoff term 291
E potential 179
Edit menu 35 potential, derived charges 178
potential, overview 179

Chem & BioOffice 2006/Index xi


Element editor 434 EPS file format 146
Element ranges in queries 405 Eraser tool 98
Element symbols, see Atom labels Escape characters 627
Elements ESR spectra simulation 180
Administrator

color 79, 434 Estimating parameters 253


physical data 434 Even-electron systems 297
selecting 434 Exact phrase matching 627
Elements table 252, 254 Exact searching see also Normal searching, Similar-
EMF file format 146 ity searching 406
Empty points, see BioViz Exact text match queries 403
Enabling Visual Display of Changes from Collec- Examining
tion Creation Onward 777 bond length and bond order, tutorial example
Enabling Visual Display of Changes with a Transi- 53
tion 777 conformations 59
Enantiomers, creating using reflection 111 Excel
Encapsulated postscript file 146 communicating with, using CAL 435
Ending a Session 799 communicating with, using DDE 437
Ending a session 653 data limit 501
Energy components, MOPAC 295 security setting when importing 358
Energy correction table 251, 261 Excited state, RHF 298, 299
Enhanced metafile format 146 Excited state, UHF 298, 299
E-Notebook 505 Expanding the drawing window 531
getting started 508 Exporting
introducing 505 ASCII files 401
refreshing 654 current hit list 424
User's Guide 513 data files 400
ENPART keyword 295 delimited text files 401
Enter label dialog box 343 graphic formats 154
Enter Query command 416, 417 InChI 154
Enter Script command dialog box 435 models using different file formats 144
Entering security settings 359
and submitting a query 416 SMILES 154
data 384 subform fields 402
data into a database 378 tables 439
queries 307, 413, 416 with the clipboard 154
reaction queries 418 Word files 401
structural queries 417 Exporting a collection 593
structures 378 Exporting a collection or section to MS Word 597
Entering a template 461 Exporting sections to MS Word 585
Enumeration 462 Exporting to another application 455
Environment Variables 487 Extended Hckel method 85
Environment Variables, CAL 487 Extended Hckel surfaces, tutorial example 68
EPS field 264

xii CambridgeSoft
Extended Hckel, molecular surface types available File formats, continued
86 .EMF (Enhanced Metafile) 146
External tables 44 .EPS (Encapsulated postscript) 146
External tables, overview 251 .GJC (Gaussian Input) 144
Extraneous fragments, permitting in full structure .INT (Internal coordinates) 144
searches 415 .MCM (MacroModel) 144
.MOL (MDL) 144
F .MOP 144
FAQ, online, accessing 812 .MSM (MSI ChemNote) 144
FAQ, technical support 809 .PDB (Protein Data Bank) 144
Fast overlay, tutorial 63 .RDL (ROSDAL) 144
FCH file format 149 .SM2 (SYBYL) 144
Field Listeners 804 .SMD (Standard Molecular Data, STN Ex-
Field Types 803 press) 144
Fields .SML (SYBYL) 144
adding 439 3DM 147
changing formats 439 ALC (Alchemy) 147
date 375 Alchemy 147
deleting 376 AVI (Movie) 147
deleting contents 384 Bitmap 146
editing 380 Cambridge Crystal Data Bank 226
formula 371 Cartesian coordinates file 223
integer 374 CON (connection table) 148
memo 375 CT (connection table) 148
Mol_ID 371 CUB (Gaussian Cube) 149
molecular weight 371 DAT (MacroModel) 150
picture 374 editing atom types 221
real 374 examples 221
sorting 380 FCH (Gaussian Checkpoint) 149
structure 371 Gaussian Input 149
text 374 GIF (Graphics Interchange Format) 147
Fields, assigning to data boxes 318 GJC (Gaussian Input) 149
File commands 484 GJF (Gaussian Input) 149
File Commands, CAL 484 GPT (MOPAC graph) 153
File formats 242 INT (Internal coordinates) 149, 227
.alc (Alchemy) 144, 221 JDF (Job description file) 153
.BMP (Bitmap) 146 JDT (Job Description Stationery) 153
.CC1 (Cartesian coordinates) 144 MacroModel 229
.cc1 (Cartesian coordinates) 148 MCM (MacroModel) 150
.CC2 (Cartesian coordinates) 144 MOL (MDL MolFile) 150, 231, 468
.cc2 (Cartesian coordinates) 148 MOPAC (MOP,MPC) 150, 237
.CDX 144 MSI MolFile 233
.CT (connection table) 144 MSM (MSI ChemNote) 150

Chem & BioOffice 2006/Index xiii


File formats, continued Formats for chemistry modeling applications 147
PDB (Protein Data Bank) 153 Formatting graphic files 145
PNG 147 Forms
Postscript 146 adding multiple structures 376
Administrator

Protein Data Bank file 239 clearing 416


QuickTime 147 creating automatically 338
RDL (ROSDAL) 153, 242 creating manually 340
SMD (Standard Molecular Data, STN Express) editing 352
153 layout, changing 354
SML (SYBYL) 153 moving 377
SYBYL MOL2 247 saving 339
SYBYL MOLFile 245 setting security 356
TIFF 146 style 338
ZMT (MOPAC) 150 vs. databases 311
File formats, supported 395 Forms, creating and saving 316
File menu 35 Formula field 371
File-based databases, attaching tables 373 Formula input rules 475
Files Formula queries, see Searching, for formulas
dsd 454, 455 Formula searching, see Searching, for formulas
log 398 Formula, searching by 453
sdf 454 Formulas
selecting with Look In tab 450 input rules 475
selecting with Open File menu 450 sorting 380
Filtering 390 FORTRAN Formats 222, 226, 229, 230, 233, 237,
Filtering acronyms with the reaction toolbar 534 238, 240, 247
Find and replace 308 FoxPro 373
Find command 417 Fragments
Find Current Molecule command 418 creating 106
Find List command 405 in full structure searches 415
Find Text command 375 rotating 120
First Record command 369 searching 407
Fit to box 430 selecting 115
Fixed labels 341, 348 Fragments, rotating 64
Flat-file databases 371 Fragments, separating 63
Fonts, customizing 349 Frame tool 341
Force constant field 267 Framed box tool 341
Form Framed boxes 341
permissions, change from earlier versions of Framed boxes, creating 342
ChemFinder 358 Framed boxes, description 305
tool 340 Frames 341
toolbar 305, 340 Frames, creating 341
Form Tools 802 Framing pictures 430
Formal charge, definition 71 Free sites, in queries 471

xiv CambridgeSoft
Freehand rotation 120 editing 88
Fujitsu, Ltd. 293 setting spacing 338
Full structure searching 408, see also Substructure settings dialog 88
searching, Similarity searching spacing 430
tool 340
G Ground state 297
G Groups, see Alternative Groups Ground state, RHF 298
GAMESS Ground state, UHF 298
minimize energy command 203 Groups
overview 203 colors 79
specifying methods 204 defining 115
Gaussian labeling, in proteins 82
about 27 mapping colors onto surfaces 92
checkpoint file format 149 table 115
compute properties command 200 Guessing parameters 253
cube file format 149 GUI, see User interface
file formats 149
molecular surface types available 86 H
properties tab 200 Hardware stereo graphic enhancement 83
tutorial example 69 Having a Section Appear by Default 748
Unix, visualizing surfaces 93 Headers, delimited text files 401
General Heat of formation, definition 177
CAL commands 483 Heat of formation, DHF 177
commands Help, CAL 435
Commands Help, Windows 25
general 483 Hiding
properties 465 annotations 430
tab, GAMESS 205 atoms or groups 116
General preferences 431 data boxes 349
General tab 174 hydrogens, tutorial example 54
Generic Groups, see Alternative Groups serial numbers 109
Generics, hitting in queries 415 Hiding a Box 675
Geometry field 256 Hiding Fields and Boxes when Configuring a Form
Getting started in E-Notebook 508 675
GIF file format 147 Hiding Fields in a Form 676
GIF, animated, see Save As command Hiding the Box Name 672
GJC file format 144, 149 Hiding the collection tree 528
GJF file format 149 Hiding the Max Button 671
Go To Record command 369 Highest Occupied Molecular Orbital, overview 93
GPT file format 153 Highest Occupied Molecular Orbital, viewing 68
Gradient norm 177 Highlighting, in substructure searches 327
Grid 340 Hit any charge on carbon 415
density 88 Hit any charge on heteroatom 415

Chem & BioOffice 2006/Index xv


Hit List results 453 log files 398
Hit lists RDFiles 397
Boolean operations 424 SDFiles 397
current 307 security settings 359
Administrator

intersecting 424 structure data and reaction data files 397


joining 425 structures 395
merging 424 tables 439
replacing 424 text files 399
restoring 424 Importing and exporting data 395402
saving 424 InChI strings, exporting 154
saving as text files 424 InChI, copy as 308
Home page, CambridgeSoft 815 InChI strings, exporting 154
HOMO see Highest Occupied Molecular Orbital Inserting
Hooke's law equation 262 custom Autotext 546
Hotkeys links with Autotext 545
select tool 58 new reactants and products 544
Hckel, see Extended Hckel method reactants and products from the stoichiometry
Hydrogens grid 544
in queries 466 Int Coords, see Internal coordinates file
Hydrogens, added to structures 382 INT, see Internal coordinates file
Hydrophobicity, mapping onto surfaces 92 Integer fields 374
Hydrophobicity, scale 89 Integrated products 23
Hyperfine coupling constants 180 Intermediates, in queries 412
Hyperfine coupling constants, example 186 Internal coordinates 48
Hyperpolarizability 180 changing 125
Hyrogen bonding 117 file 227
file format 144, 149
I FORTRAN file format 229
ID queries 405 pop-up information 129
Identity searching, see Exact searching table 133
Implicit hydrogens 471 Internal coordinates file 227
in queries 471 Internal rotations, see Dihedral angles, rotating
on metals 431 Internal tables 44
Implicit hydrogens, added to structures 382 Internet, CambridgeSoft web site 815
Import file command 35 Intersect With Current List command 424
Importing Inverting a model 110
and exporting collections 593 Inverting cis, trans isomers 58
Cartesian coordinates files 189 Ionization field 260
collections 593 ISIS/Draw 97
data 395 ISIS/Graphic files 395
from a specified location 398 ISIS/Sketch files 395
hit lists 424 Isocharge 92
ISIS/Draw structures 97 Isopotential 92

xvi CambridgeSoft
Isospin 92 Keywords, continued
Isotopes 467, 617 TS 173
Isovalues, editing 87 VECTORS 295
Iterations, recording 136 Keywords, automatic 294
Keywords, MOPAC 294
J KS field 258
JDF file format 153
JDF Format 199 L
JDT file format 153 Lab supplies, purchasing online 814
JDT Format 199 Labels 220
Job description file format 153, 199 editing 342
Job description stationery file format 153 fixed 341, 348
Job Type tab fonts 349
GAMESS 204 live 348
Job type tab 204 using 99
using for substructures 58
K using to create models 57
KB field 259 Languages other than English, sorting 381
Keyboard modifiers, table of 213214 Last Record command 369
Keywords Launching ChemFinder 309
BFGS 173 Layout tool 340
BOND 295 Layout, changing 354
DFORCE 295 LDB file format 439
EF 173 Length field 258
ENPART 295 LET keyword 175, 294
LBFGS 173 Limitations 233
LET 175, 294 Limiting collection browsing 528
LOCALIZE 295 Link node 427
NOMM 295 Linking subforms to main forms 361
PI 295 Live labels 348
POLAR 185 LN (link node), special atom type 427, 469
PRECISE 175, 294, 296 LOCALIZE keyword 295
RECALC 175, 295 Localized orbitals 295
RMAX 294 Locating the eclipsed transition state of ethane 175
RMIN 294 Locking plots 388
Log files 398
Logging In 508
Logging in with Internet Explorer 509
Logon, database 368
Lone pairs field 264
Lowest Unoccupied Molecular Orbital, overview
93
Lowest Unoccupied Molecular Orbital, viewing 68

Chem & BioOffice 2006/Index xvii


LUMO, see Lowest Unoccupied Molecular Orbital Managing Spectrum Fields 722
Managing States and Transitions 768
M Managing Stored Document Fields 723
M (metal), special atom type 469 Managing Subsection Field Listeners 725
Administrator

MacroModel 229 Managing Subsection Fields 723


FORTRAN format 230 Managing Summary Fields in a Table of Contents
MacroModel file format 150 657
Main form 305 Managing Table Fields 725
Main toolbar 305 Managing Table Listeners 730
Managing Managing Templates 761
queries 421 Managing the Active Document Form Tool 662
Managing Active Document Field Listeners 700 Managing the Add Reactant Table Listener 731
Managing Active Document Fields 699 Managing the Add-In Configuration 739
Managing AutoText Fields 700 Managing the Analyze Reaction Table Listener 732
Managing Chemical Query Fields 733 Managing the Annotate Transition Listener 772
Managing Chemical Structure Field Listeners 703 Managing the Audit Section Listener 666
Managing Chemical Structure Fields 702 Managing the Auto Number Collection Listener
Managing Collection Listeners 753 755
Managing Collection Security 787 Managing the Block Reference In State Property
Managing Collection Type Form Tools 762 List Listener 721
Managing Collection Types 745 Managing the Block Reference In State Table Lis-
Managing Contained Collection Types 749 tener 731
Managing Contained Reference Types 750 Managing the Button View Subsection Listener 725
Managing Data Fields 699 Managing the Change Display Collection Listener
Managing Database Table Fields 705 756
Managing Database Values in Property Lists 716 Managing the Change Display Transition Listener
Managing Database Values in Tables 728 772
Managing E-Notebook Security 787 Managing the Chemical Properties Property List
Managing Enumerated Values in Tables 729 Listener 722
Managing Enumerated Values in Property Lists 714 Managing the Final Print Transition Listener 773
Managing Excel Fields 708 Managing the Fixed Name Collection Listener 757
Managing Export Templates for Section Types 677 Managing the Fixed Section Name Listener 666
Managing Export Templates of Collection Type Managing the Insert Reference Form Tool 663
s 779 Managing the Locked Container Transition
Managing Fields 697 Listener 774
Managing Fields within a Section Type 656 Managing the New Child Collection Form Tool 763
Managing Form Tools 658 Managing the New Section Form Tool 661
Managing Property List Listeners 719 Managing the New Subsection Section Form Tool
Managing Property Lists 712 661
Managing Search Fields 733 Managing the Next Step Form Tool 661
Managing Search Types 764 Managing the Owner Full Control Collection
Managing Section Listeners 663 Listener 758
Managing Section Types and Forms 655 Managing the Parent Prefix Collection Listener 757

xviii CambridgeSoft
Managing the Person Property List Listener 721 Matching stereochemistry 415
Managing the Prevent Delete when Referenced Mathematical operators, in CAL command 486
Collection Listener 759 Maximum Ring Size field 255
Managing the Prevent External Link Active MCM file format 144, 150
Document Field Listener 700 MDB file format 439
Managing the Prevent Reference Copy Collection MDL file format 468
Listener 759 MDL MolFile 231
Managing the Print Multiple Form Tool 663 MDL MolFile format 150
Managing the Products Table Listener 730 MDL MolFile, FORTRAN format 233
Managing the Reactants Table Listener 730 MDL Molfiles 395
Managing the Required Properties Transition MDL RXNFiles 395
Listener 775 Measurement table 131
Managing the Required Section Listener 666 Measurements
Managing the Security Properties of a Collection actual field 49
Type 792 deleting 132
Managing the Security Properties of a Section Type displaying graphically 82
796 editing 131
Managing the Spectrum Form Tool 662 non-bonded distances 130, 132
Managing the Standard Collection Listeners 755 optimal field 50
Managing the Standard Form Tools 660 setting 107
Managing the Standard Search Engines 765 table 49, 59, 131
Managing the Standard Section Listeners 666 Measuring coplanarity 132
Managing the Standard Transition Listeners 772 Memo fields 375
Managing the Unlocked Contents Transition Menu bar 305
Listener 775 Menu commands 479
Managing the User Collection Listener 761 Menu commands, CAL 479
Managing the Validate Value Property List Menu, adding to data box 348
Listener 722 Menus
Managing the Validate Value Table Listener 732 edit 35
Managing the Analyze Reaction Chemical file 35
Structure Listener 703 structure 38
Managing Transition Listeners 770 view 36
Managing Units in Property Lists and Tables 741 Minimize Energy 203
Managing URL Display Fields 732 MOPAC 172
Managing Visual Display of Changes 776 Minimize Energy command
Managing Property Query Fields 736 GAMESS 203, 204
Managing Search Location Fields 738 Minimize Energy dialog
Managing State Query Fields 737 GAMESS 204
Managing Table Query Fields 737 Minimizer 173
Managing Unannotated Version Query Fields 738 Minimum RMS Gradient
Map Property control 92 MOPAC 172
Mapping atoms in reaction queries 411 MM2
Mapping properties onto surfaces 69, 92 applying constraints 50

Chem & BioOffice 2006/Index xix


MM2, continued mulas
atom types table 252, 263 Molecular formula searches, see Searching, for for-
constants table 252, 262 mulas
editing parameters 289 Molecular orbitals 93
Administrator

overview 157 Molecular orbitals, calculation types required 86


parameters 289 Molecular orbitals, definition 93
references 289 Molecular shape 92
tutorial example 60 Molecular surface displays 84
MM2 force field in Chem3D 290 Molecular surfaces 179
Model, see also Internal coordinates, Cartesian coor- calculation types 85
dinates, Z-Matrix clearing all 88
data 129 definition 179
display 46 dots surface type 87
display control panel 79 grid 88
display toolbar 36, 41 overview 84
settings control panels 75 smoothness 88
settings, changing 75 solid surface type 87
settings, dialog box 45 translucent surface type 87
types 75 types available from extended Hckel 86
Model area 34 types available from Gaussian 86
Model building basics 44 types available from MOPAC 86
Model building controls, setting 95 viewing 68
Model Explorer 48 wire mesh surface type 87
Model Explorer, stacking windows 59 Molecular Weight field 371
Model information panel, see Model Explorer, Mea- Molecular weight, searching by 453
surements table, Cartesian Coordinates table, Z- Monochrome 146
Matrix table MOP file format 144, 150
Model window 33 MOPAC 237
Models AAA file 188
building 95 about 27
docking 65 background 293
editing 95 compute properties command 176
viewing with Chem3D 383 create input file command 189
Modifying data 380 file formats 150
MOL file format 144, 150 FORTRAN format 238
Mol_ID field 371 general tab 174
Molecular Design Limited MolFile (MOL) 150 graph file format 153
Molecular electrostatic potential 92 history 293
Molecular electrostatic potential surface Hyperfine Coupling Constants 173
calculation types required 86 minimizing energy 172
definition 92 minimum RMS gradient 172
dialog 92 molecular surface types available 86
Molecular formula querie,s see Searching, for for- optimize to transition state 174

xx CambridgeSoft
MOPAC, continued MSI ChemNote file format 150
OUT file 188 MSI file format 439
overview 171 MSI MolFile 233
parameters, editing 294 MSI Molfile 395
properties 177 MSM file format 144, 150
references 293 MST file format 439
repeating jobs 190 Mulliken charges 178
RHF 173 Multiple models 106
running input files 189 Multiple structures, adding to forms 376
specifying electronic state 296 Multi-step reactions 410
specifying keywords 174, 294 Multi-user access 367
troubleshooting 188
UHF 173 N
Move Name field 254
to X-Y plane command 123 Name searching 325
to X-Z plane command 123 Name=Struct 97
to Y-Z plane command 123 Naming a selection 115
Move a column 572 Navigation overview 509
Move a row 572 New features 505
Movie control panel 140 New form, creating 340
Movie controller, speed control 141 New in ChemFinder 479
Movie file format 147 New Record indicator 305
Movie toolbar 42 Next Record command 369
Movies NOMM keyword 295
computing properties 63 Non file-based databases, attaching 373
editing 140 Non-bonded distances, displaying 130
overview 139 Non-bonded distances, displaying in tables 132
Moving Normal Searching 406, see also Exact searching,
atoms 118 Similarity searching
atoms to an axis 63 Normalization 469
boxes 352 Normalization, in queries 469
models see Translate Numbers, customizing 350
objects 352 Numeric format 350
Moving a section within a collection 584 Numeric searches 325, 404
Moving collections between container collections
589 O
Moving collections within a container collection Objects
588 aligning 354
Moving forms and databases 377 deleting 353
MOZYME 172 distributing 354
MPC file format 150 spacing 354
MS Access, see Access ODBC, adding structures to existing sources 377
MS Access, workgroup information 356 ODBC, selecting data sources 373

Chem & BioOffice 2006/Index xxi


Odd-electron systems 298 Oracle, continued
OLE automation, communicating with other using CAL with 447
applications 438 Oracle Cartridge
OLE automation, overview 438 configuration via CF_SETTINGS table 492
Administrator

Online Help, see Help fast-move caching scheme 491


Online Menu pre-setup procedures 491
browse ChemStore.com 814 Order of attachment, specifying 100
CambridgeSoft homepage 815 Ordering objects 353
ChemOffice SDK 815 Organizing collections 588
CS Chem3D technical support 812 Origin atoms, Z-matrix 125
lookup suppliers on ChemStore.com 813 Other applications
register online 811, 815 attaching tables from 373
Open Database button 335 Other applications, communicating with using
Open last form on startup 432 DDE 437
Open shell 298 Other applications, communicating with using
Opening OLE Automation 438
databases 335, 367 Other applications, communicating with using
existing chemical databases 335 scripts 437
hit lists 424 Other fields in a spectrum section 567
options, see Preferences Out-of-plane bending 267
pictures 344 Output panel 44
secured MS Access databases 337 Overlays 63
specific databases 327 Overlays, hiding fragments 65
Opening a database, tutorial 317 Overriding security 360
Opening ChemFinder, see Launching ChemFinder Overview 510
Operators, in CAL commands 486
Optimal field 50, 132 P
Optimal measurements 131 Packbits, compression 147
Optimizing to a transition state 174 Page Breaks 681
Options 388 Page size 143
OR operator, hit lists 425 Pan, see Translate
OR operator, queries 403 Paradox 373
Oracle Parameter table fields 252
attaching tables 373 Parameter tables, overview 251
handling lists in 443 Parameters
indexing 446 creating 253
loading 445 estimating 253
opening a database 442 MM2 289
overview 441 MOPAC 294
searching in 443 Partial charge
setting preferences 444 atom size control 78
setup 441 definition 71
updating and adding data 444 pop-up information 129, 130

xxii CambridgeSoft
Password, for secured forms 368 Precision, in numerical queries 404
Paste command 154 Pre-defined substructures 58
Paste special 35 Preferences
PDB file format 144, 153 color 430
Performing a collection transition 597 date display 405
Periodic Table 466 display 429
Periodic table 434 general 431
Perspective rendering 80 grid spacing 430
Pi atoms table 260 opening 431
Pi bonds table 251, 261 picture display 430
PI keyword 295 recent file list size 432
Pi orbital SCF computation 291 registration 431
PIATOMS.TBL, see Pi atoms table search details 414
PIBONDS.TBL, see Pi bonds table search type 413
Picture boxes, creating 343 setting 429
Picture fields 374 stereochemistry 415
Picture tool 343 structure display 429
Pictures 343 Preferences in ChemFinder/Office 460
framing 430 Previous Record command 369
of structures 383 Previous Users, help for 31
preferences 430 Print command 144
reading 344 Printing 144
saving 344 background color 81
saving ChemDraw drawings as 383 collections 597
searching 383 multiple collections at once 597
updating 344 sections 585
Plain text tool 342 Processing the reaction template 498
Planarity 132 Product sheets 501
Plates, browsing 502 Products
Plates, configuring 501 in queries 412
Plotting searches 392 searching for 410
PNG file format 147 Products Only option 501
POLAR keyword 185 Program Execution commands 482
Polarizability 179, 180 Program Execution commands, CAL 482
Pop-up information 129 Properties
Portal database 377 dialog box, opening 358
Positioning by bond angles 127 tab, GAMESS 205
Positioning by dihedral angle 127 tab, Gaussian 200
Positioning example 126 Property lists 547
PostScript files, background color 81 Pro-R 126
Potential functions parameters 293 Pro-S 126
PowerPoint, embedding models in 155 Protein Data Bank File
PRECISE keyword 175, 294, 296 FORTRAN format 240

Chem & BioOffice 2006/Index xxiii


Protein Data Bank file 239 Queries, continued
Protein Data Bank file format 153 multiple fragments 407
Protein Data Bank Files 239 multiple substructures 427
Protein residues, labeling 82 no highlighting 418
Administrator

Proteins, highlighting binding sites 116 normalization 469


Providing required annotation 603 numbers in 404
Providing unprompted, optional annotation 604 overlapping fragments 415
Publishing formats 145 overview 403
precision 404
Q products 412
Q (heteroatom), special atom type 469 progress display 417
QRY indicator 305, 307 radicals 466
Quality field 252 ranges 404, 405
Quartic stretching term 291 reactants 412
Queries reactions 410
anchored substring 403 red highlighting 417
atom lists 426, 469 refining 417
atom not-lists 470 similarity 407
atom properties 465 similarity rules 477
atom properties in 469 special atom types in 469
atom types 426, 465 special bond types 472
bond properties 472 SQL 403, 413
bond types 426, 465 stereochemistry 408, 467
Booleans 403 stopping 417
charges 466 structural similarity 407
context menu 422 structures 406
dates 405 subforms 365
entering 307, 413, 416 submitting 416
exact structure 408 substituents 466, 470
exact text match 403 text 403
finding current structure 418 unsaturation 471
formulas in 404 using current structure 418
free sites 471 wildcards 403
full structure 408 Query operators
hydrogens in 466 - 405
ID 405 ( 405
identity 407 < 405
implicit AND between fields 403, 412 = 403, 405
implicit hydrogens 471 > 405
inequalities 405 \ 413
intermediates 412 Query properties
isotopes 467 conflicting 465
multiple fields 412 overview 465

xxiv CambridgeSoft
Questel F1D files 395 Reaction worksheet, adding a template 498
Questel F1Q files 395 Reactions
Quick Reference Card, description 25 multiple-step 410
QuickTime file format 147 Reactions, MS Word, MS Excel, and other sections
527
R Read File command 344
R Groups, see Alternative Groups READ indicator 305, 307
R* field 264 Read Structure command 399
R, special atom type 469 Reading a Structure 398
Radicals, in queries 466 Read-only access 367
Ranges, in queries 404 Real fields 374
RDFiles 359, 397, 400 Rearranging Boxes in a Form 670
RDL file format 144, 153 RECALC keyword 175, 295
Reactant lists 499 Recent file list size, setting 432
Reactant sheets 501 Reconfiguring an Existing Form 669
Reactants, in queries 412 Record number dialog box 369
Reactants, searching for 410 Record order 258, 260, 261, 267, 268
Reaction Record tool 369
center 620, 621 Record toolbar
drawing 531 browsing with 369
drawing and analyzing 532 description 305
searching 621 illustration 367
Reaction Centers 472 Records
bond type 477 adding 307, 378
bond types 472 current 305, 307
Reaction centers 410 deleting 384
bond types 475 duplicating 379
display preferences 429 moving between 369
overview 410 Rectification 48
Reaction queries 410 Rectification type field 255
atom-atom mapping 411 Rectification, when deselecting 114
creating 418 Rectifying atoms 112
hitting reaction centers 411, 415 Red-blue anaglyphs 80
intermediates 412 Redo command 353, 384
products 412 Redoing changes 384
reactants 412 Reduct field 264
Reaction queries, tutorial 327 Reference description field 257
Reaction searches 410 Reference field 253
Reaction template Reference number field 257
adding to a worksheet 498 References table 252, 257
basics 495 References, MM2 289
processing 498 References, MOPAC 293
Reaction template basics 461 Refining a model 111

Chem & BioOffice 2006/Index xxv


Refining queries 417 Replacing
Refining your search atoms 56
overview 457 atoms with substructures 103
Refining your search, search options 457 Replacing a spectrum 567
Administrator

Refining your search, search tools 457 Repulsion field 260


Reflecting a model through a plane 111 Reserializing a model 109
Refreshing E-Notebook 654 Resetting defaults 139
Registration preferences 431 Resetting the database 381
Registration, online 811 Resizing
Relational data and subforms 361 boxes 352
Relational databases 361, 373 models 124
Relative Tetrahedral Stereochemistry 468 objects 352
Relative tetrahedral stereochemistry 416 Resizing Boxes in a Form 673
Removing Resizing models 213
bonds and atoms 98 Resolve density matrix 295
filters 535 Resonance, forms 469
measurements from a table 132 Restore List command 424
properties from the field 625 Restoring a hit list 424
reactants and products from the stoichiometry Restoring changes 353
table 537 Reversing and restoring changes 353
sections 584 RGB indexed color 146
Removing a Collection Listener from a Collection R-group tables 370
Type 754 RHF spin density 181
Removing a Contained Collection Type from a RHF spin density, example 188
Collection Type 750 Ribbons display 77
Removing a Contained Reference Type from a Ring bonds 472
Collection Type 752 Ring closure 100
Removing a Form Tool from a Section Type 660 RMAX keyword 294
Removing a Section Listener from a Section Type RMIN keyword 294
665 ROSDAL 242
Removing a Section Type from a Collection Type ROSDAL file format 153
748 Rotating
Removing a Transition Listener from a Transition around a bond 122
771 around a specific axis 122
Renaming dihedral angles 120, 122
tabs 344 fragments 120
Renaming a collection 591 models 119
Renaming a section 584 two dihedrals 62
Rendering types 75 using trackball 120
Reorienting a model 63 with mouse buttons 213
Repeating a GAMESS Job 206 X/Y-axis rotation 120
Repeating MOPAC Jobs 190 Z-axis rotation 120
Replace Current List command 424 Rotating fragments 64

xxvi CambridgeSoft
Rotation bars 34 Scripts, continued
Rotation dial 61 executing 436
Rules 475 in subforms 365
Run GAMESS Input File command 206 writing 435
Running Scroll bars, adding 349
GAMESS jobs 206 SDFiles
MOPAC input files 189 exporting 400, 402
MOPAC jobs 190 SDFiles, importing 359, 397
SDK Online, accessing 815
S Search
Sample code, SDK web site 815 examples 425
Sample databases 313 toolbar 305, 413
Save All Frames checkbox 151 type 406
Save As command 145 type preferences 413
Save command 379 Search Details preferences 414
Save command, effect on changes 339 Search Engines 803
Save dialog box 339 Search options 457, 625
Save List command 424 Search Over List command 330
Save Structure command 401 Search results 453
Saving Searching 609, see also Queries
and restoring lists 423 a database, tutorial 321
changes through backup and restore 602 .dsd files 455
changes to a collection 601 by chemical formula 452
changes, by browsing to another collection 602 by chemical structure 451
changes, through Autosave 602 by molecular weight 452
customized job descriptions 205 by multiple properties 452
data sources 454 by reaction type 329
directory paths to search 454 by selected files 453
files 454 combined
forms 339 databases 499
hit lists 424 directory paths 454
pictures 344 enter query 457
search results 454 for conformations 63
structures 401 for dates
subforms 339 for formulas 323, 404
vs. committing 339 for intermediates 412
Scaling a model 124 for names 325
Scaling structures 430 for numbers, 325404
Script-only commands 487 for products, 328412, 623
Script-only commands, CAL 487 for reactants 328, 412, 622
Scripts for substructures 326
communicating with other applications 437 for text, with the query text field 626
debugging 436 formula element ranges 405

Chem & BioOffice 2006/Index xxvii


Searching, continued Security, continued
formula query rules 404 overriding 360
Fullerenes 426 setting options 356
link nodes and multivalent Rs (MVRs) 426 Security overview 509
Administrator

more than one substructure 427 Select Fragment command 115


online for chemical information 812 Select fragment command 36
overview 403 Select tool 113
parentheses in formulas 405 Select tool, hotkey 58
procedures 413 Selecting
refining 457 adding atoms to a selection 114
restore previous query 457 all children 117
save results 454 atoms 113
search options 457 atoms and bonds 113
search tools 457 bonds 113
start 457 boxes 352
subforms 365 by clicking 113
with collection attributes 623 by distance 116
with the property query and table query fields by double click 115
624 by dragging 114
with the search location field 623 by radius 116
with wildcards 627 data to display 336
Section databases 335
changing a 583 defining a group 115
cutting and pasting 584 fragments 115
duplicating between collections 585 moving 118
duplicating within a collection 585 multiple atoms or bonds 114
exporting to MS Word 585 objects on a form 352
moving within a collection 584 selection rectangle 114
names as categories 548 Selection rectangle 114
printing 585 Selection tool 352
reactions, MS Word, MS Excel 527 Send to Back command 353
removing 584 Sending to another application 455
renaming 584 Separating fragments 63
spectrum, other fields in 567 Serial numbers, displaying 81
Section Listeners 802 Serial numbers, tutorial example 55
Section Metadata Tags 679 Set Z-Matrix commands 127
Section Search Engine 766 Setting
Section Type Security 796 alerts 431
Secured access 368 bond angles 108
Securing forms 356 bond lengths 108
Security bond order 105
disabling 360 box properties 345
MS Access workgroup information 356, 357 changing structural display 75

xxviii CambridgeSoft
Setting, continued Showing and hiding collections 528
charges 109 Showing and Hiding the Max Button for a Box 671
color 351 Showing and Hiding the Name of a Box 672
constraints 109 Showing the Max Button 671
data box styles 345 Showing the Name of a Box 673
default atom label display options 81 Similarity rules 477
dihedral angles 108 Similarity searching 407, see also Exact searching,
fixed and live data 348 Normal searching
measurements 107 Single point calculations, MOPAC 176
measurements, atom movement 108 SM2 file format 144
model building controls 95 SM2, see SYBYL MOL2 File
molecular surface colors 88 SMD 242
molecular surface isovalues 87 SMD file format 144, 153
molecular surface types 86 SMD files 242, 395
non-bonded distances 108 SMILES notation, exporting 154
numeric format 350 SML file format 144, 153
origin atoms 127 Solid spheres, size by control 78
preferences 429 Solid spheres, size% 78
recent file list size 432 Solid surface type 87
search details preferences 414 Solution effects 180
search type preferences 413 Solvent accessible surface
security options 356 calculation types required 86
serial numbers 109 definition 91
solid sphere size 78 dialog 91
solvent radius 88 map property 92
stereochemistry search preferences 415 mapping atom colors 92
surface mapping 89 mapping group colors 92
surface resolution 88 mapping hydrophobicity 92
Setting the Fields in Boxes 668 solvent radius 89
Sextic bending constant 263 Sort data by a property 572
Shift+selecting 114 Sorting 390
Show Internal Coordinates command 125 data 380
Show Surface button 86 data tables 380
Show Used Parameters command 253 fields 380
Showing formulas 380
all atoms 117 from the data table 380
annotations 430 in reverse order 380
atoms or groups 116 languages other than English 381
data boxes 349 permanently 439
Hs and Lps 117 structures 380
opening dialog 432 text 380
reaction centers 429 Space filling display 77
serial numbers 109 Special atom types 617

Chem & BioOffice 2006/Index xxix


Special atom types, list of 469 Stereochemistry, continued
Special bond types 472, 620 stereochemical relationships 219
Special structure searches 419 tetrahedral 467
Specification of Units 743 trigonal bipyrimidal 467
Administrator

Specifying Steric energy


electronic configuration 296 tutorial example 60
general settings 205 Sticks display 76
print options 143 STN Express 153
properties to compute 205 Stopping
Specifying an annotation through the history pane queries 417
605 Stretch-bend parameters 263
Spectra, replacing 567 Struct=Name 308
Spectrum viewer 193 Structural query features 465
Speed control 141 Structure
Spin about selected axis 140 columns 376
Spin density 181 deleting a 574
Spin density, tutorial example 69 display preferences 429
Spinning models 140 displays, changing 75
SQL 413 displays, overview 75
SQL searches 413 drawing 531
Standard Field Types 679 editing 574
Standard measurement 251 registration options 431
Standard measurements, applying 48 searches 406
Standard measurements, bond angle 258 Structure field 371
Standard measurements, bond length 257 Structure menu 38
Standard Molecular Data file format 153 Structures
Start menu login 508 adding 378
Starting ChemFinder 309 adding to non-chemical database 377
Statistical analysis, see BioViz as pictures 383
Status bar 305, 307 checking chemistry 382
Stereo pairs 83 chemically-significant text 382
Stereochemistr cleaning 381
, inversion 110 editing 381, 382
Stereochemistry 408, 467 entering 382, 431
allenic 467 file formats 395
changing 110 importing 395
cis/trans double bonds 467 queries 406
octahedral 467 query properties 465
overview 408 red highlighting in queries 417
queries 467 scaling 430
relative tetrahedral 416, 468 sorting 380
search preferences 415 viewing related 502
square planar 467 Style, box, changing 346

xxx CambridgeSoft
Style, definition 388 T
Styled text 383 Tabbed windows 308
Subform fields, exporting 402 Table
Subforms editor 100
changes in ChemFinder 9 362 numerical units, working with 575
creating 363 Tables 547
data table 365 adding 365, 384, 439
linking fields 361 changing names 439
overview 361 creating 372
searching 365 deleting 372
switching between forms and data tables 365 exporting 439
tutorial 332 headers 306
using scripts 365 importing 439
Subforms, tutorial 332 internal and external 44
Submitting queries 416 Tabs, creating and editing 344
Substituents 466, 616 Tabs, renaming 344
exactly 470, 618 Tanimoto similarity 477
free sites 471, 619 Technical support 809
in queries 466, 470 Templates, entering 461
up to 470, 618 Temporary database 377
Substructure searching 326, 407 Terminology 506
Substructure similarity 478 Tetrahedral stereo center hits 416
Substructures 211 Text
Substructures table 58, 257 as structures 382
Substructures, adding to model 103 building tool 99
Summary file, see MOPAC out file building tool, tutorial example 56
Summary of the Standard Add-Ins 801 creating 342
Suppliers, finding online 813 customizing 349
Supported file formats 395 fields 374
Surface types 85 format toolbar 349, 383
Surfaces toolbar 41 number (atom type) 255
Surfaces, mapping properties onto 69 queries 403
SYBYL file format 153 searches 323, 403
SYBYL MOL File 245 sorting 380
SYBYL MOL2 File 247 styled 383
FORTRAN format 250 tool, specifying order of attachment 100
SYBYL MOLFile 245 Text files, importing 399
FORTRAN format 247 Theory tab 204
SYBYL2, see SYBYL MOL2 File TIF file format 146
Symbol 254 Time Settings 740
Synchronization 392 Title bar 306
Synchronizing ChemDraw and Chem3D 96 Toolbars
building 40

Chem & BioOffice 2006/Index xxxi


calculation 42 tutorial example 51
customizing 433 Z-axis rotation 120
description 305 Transferring information
form 306 to ChemDraw 154
Administrator

main 306 to other computers 377


model display 36, 41 Transferring information to other applications, see
movie 42 Exporting
record 307 Transition Listeners 802
search 307 Transition Security 791
standard 40 Transition security 595
surfaces 41 Translate 119, 213
text 307, 383 Translate tool 119
Toolbars, Demo 42 Translucent surface type 87
Tools Trigger scripts 437
Alternative Group 409 Triple bonds field 256
attachment point 409 Troubleshooting
data box 341 atoms shift on MOPAC input 189
eraser 98 background color 81
frame 341 Chem3D 809
framed box 341 MOPAC quits 188
grid 340 online 812
layout 340 Type 2 (-CHR-) bending force parameters for C-C-
picture 343 C angles 262
plain text 342
record 369 U
select 113 UHF spin density 181
select, hotkey 58 UHF spin density, example 187
Tools palette, see Building toolbar Uncoordinated bonds, creating 98
Topology 472, 620 Understanding forms and databases 311
Torsional parameters table 265 Undo 353
Torsional parameters table, 4-membered ring 265 Undoing changes 384
Torsionals table 252 Undoing data entry 379
Total charge density 92 Uniform bond length 430
Total charge density surface, calculation types Union with current list 425
required 86 Unix, Gaussian files 93
Total charge density surface, definition 92 Unsaturation 471, 619
Total spin Unsaturation, in queries 471
calculation types required 86 Use Current Z-Matrix button 149
definition 92 Use tight convergence criteria 204
density 92 User Administration 783
density surface dialog 92 User collection
Trackball tool adding a new collection to 514
overview 120 adding a reference within 514

xxxii CambridgeSoft
User collection, continued Using the zoom control 124
working with 514 UV energies 295
User guide, online 812
User interface 33 V
Username, for secured forms 368 V1 field 265
Using V2 field 265
atom lists 426 V3 field 266
bond tools, tutorial example 51 Valence
ChemDraw to create models 59 charged atoms 466
ChemFinder with databases 309 checking 431
current molecule as a query 418 non-standard state 431
display mode 139 unfilled 466
double bond tool, tutorial example 54 van der Waals
form tools 340 cutoff distance 263
grids 340 cutoff term 291
hardware stereo graphic enhancement 83 radius field 255
keyboard shortcuts 430 surface, definition 91
labels 99 Van der Waals radii
labels for substructures 58 atom size control 78
labels to create models 57 dot surfaces display 78
log files 398 Variable Commands 485
measurements table, tutorial example 59 Variable Commands, CAL 485
MM2, tutorial example 60 VDW interactions 268
MOPAC keywords 294 VDW interactions table 252
MS Access with ChemFinder 439 VECTORS keyword 295
Name=Struct 97 Vibrational energies 295
periodic table 434 View focus 107
rotation dial 61, 120 View format for structures, selecting 346
scripts 437 View menu 36
scripts in subforms 365 Viewing
selection rectangle 114 collection properties 592
stereo pairs 83 Highest Occupied Molecular Orbitals 68
substructures 100 Lowest Unoccupied Molecular Orbitals 68
table editor to enter text 100 models with Chem3D 383
text building tool 99 molecular surfaces 68
text building tool, tutorial example 56 parameters 289
trackball tool, tutorial example 51 related structures 502
Visual Basic 438 results 417
Using quick add to add a structure 533 structures 346
Using the add dialog to add a structure 533 structures in Chem3D format 347
Using the Batch Import Facility 807 user information 654
Using the Session Manager 798 Viewing and Editing the Properties of a Collection
Using the session manager 653 Listener 754

Chem & BioOffice 2006/Index xxxiii


Viewing and Editing the Properties of a Form Working with, continued
Tool 659 the inbox 517
Viewing and Editing the Properties of a Search the reaction toolbar 532
Engine 767 the stoichiometry table 535
Administrator

Viewing and Editing the Properties of a Section the user collection 514
Listener 664 the user configuration folder 518
Viewing and Editing the Properties of a Transition Working with reaction templates 461
Listener 771 Working with structures using ChemDraw 382
Viewing subform data in a table 365 Working with subforms 365
Visual Basic 438
Visual display of changes 606 X
Visualizing surfaces from other sources 93 X (halogen), special atom type 469
X- Y- or Z-axis rotations 120
W XH2 field 260
Wang-Ford charges 179 XR2 field 259
Web pages, embedding models in 155 XRH field 259
Web site, CambridgeSoft, accessing 815
Whats New in ChemFinder 10? 301 Z
Wildcard Zero point energy 295
% 403 Z-matrix 48
* 403 changing 125
Wildcard searching 627 overview 133
Windows help 25 pop-up information 129
Windows metafiles 341, 343, 344 ZMT file format 150
Wire frame display 76 Zoom 393
Wire mesh surface type 87 Zoom on drag 389
WMF and EMF 146 Zooming in on a spectrum peak 567
WMF file format 344 Zwitterion, creating a 102
Word files, exporting 401
Word, embedding models in 155
Working with
Autotext 543
experiments 501
folders 517
multiple hit lists 425
numerical units in tables 575
pages and experiments 516
reactant lists 499
reactants collections 518
reaction templates 495
subforms, tutorial 332
the changes icon 601
the history pane 604

xxxiv CambridgeSoft
CambridgeSoft
Solutions

D ESKTOP S OFTWARE
E NTERPRISE S OLUTIONS

C HEMICAL I NFORMATICS
B IOLOGICAL I NFORMATICS

K NOWLEDGE M ANAGEMENT
S CIENTIFIC D ATABASES
CAMBRIDGESOFT

ChemOffice Desktop to
KNOWLEDGE CHEMICAL
MANAGEMENT INFORMATICS

Desktop

E-Notebook CombiChem Inventory Registration


Enterprise Enterprise Enterprise Enterprise

E-Signatures 21CFR11 GxP


IP Protection Compliance Validation

Enterprise
WebServer

DESKTOP TO ENTERPRISE
Chem & Bio Office Just as Chem & Bio Office supports the daily work of the individual scientist,
ChemOffice Workgroup ChemOffice Enterprise, with Oracle Cartridge, and ChemOffice Workgroup, based
on SQL Server, help organizations from small workgroups to large enterprises
ChemOffice Enterprise
collaborate and share information more effectively.

KNOWLEDGE MANAGEMENT
E-Notebook Enterprise Research organizations thrive when information is easily captured, well organized, and
Reaction Explorer readily available. E-Notebook Enterprise streamlines record keeping with rigorous
security and efficient archiving, and facilitates text and structure searching. Reaction
CombiChem Enterprise
Explorer can display the ancestors and descendants of a particular batch in seconds,
E-Signatures while CombiChem Enterprise provides the power of combinatorial chemistry.
21CFR11 Compliance E-Signatures provides intellectual property protection and 21CFR11 Compliance
implements an organizations regulatory compliance process.

CHEMICAL INFORMATICS
Inventory Enterprise Managing huge data streams is a key challenge. Registration Enterprise organizes
GxP Validation information about new compounds according to an organization's business rules,
while Inventory Enterprise provides complete management of chemical and biological
Registration Enterprise
inventories, including GxP validation. DocManager Enterprise is an important part
DocManager Enterprise of collaborative research data management. Oracle Cartridge adds chemically
Oracle Cartridge intelligent searching to Oracle, integrating with ChemOffice Enterprise applications.
SOLUTIONS

Enterprise Solutions
BIOLOGICAL SCIENTIFIC
INFORMATICS DATABASES

DocManager BioAssay ChemACX The Merck


Enterprise & BioViz Database Index

BioSAR Sigma-Aldrich Scientific


Oracle Cartridge Enterprise MSDS Databases
or SQL DB

BIOLOGICAL INFORMATICS
BioAssay Enterprise Finding structural determinants of biological activity requires processing masses of
biological assay data. Scientists use BioAssay Enterprise and BioSAR Enterprise to set
BioViz
up biological models and visualize information, to generate spreadsheets correlating
BioSAR Enterprise structure and activity, and to search by structure. The BioViz application allows you to
BioDraw create graphical representations of data.

DESKTOP SOFTWARE
ChemDraw & Chem3D Success begins at the desktop, where scientists use ChemDraw, ChemOffice, and
ChemFinder & ChemInfo BioOffice to pursue ideas and communicate with the natural language of chemical
structures, biological pathways, and models. Scientists organize information and
BioAssay & BioViz
manage data with E-Notebook and Inventory. Chem3D provides modeling, ChemFinder
BioDraw aids searching, while BioOffice adds BioAssay, BioViz and BioDraw. Integrated with
Inventory & E-Notebook Microsoft Office to speed research tasks.

SCIENTIFIC DATABASES
The Merck Index Good research depends on reference information, starting with the structure-
Scientific Databases searchable ChemACX Database of commercially available chemicals and Sigma-
Aldrich MSDS. The Merck Index and other scientific databases provide necessary
ChemACX Database
background about chemicals, their properties, and reactions.
Sigma-Aldrich MSDS
PROFESSIONAL SERVICES
Development CambridgeSoft's scientific staff has the industry experience, and chemical and
Training & Support biological knowledge to maximize the effectiveness of your information systems.
Av Ch C E- Th
em Che hem Ch Bi Bi Bi In N e Ch
ai e Ch o o o v ot M em
la O m D m e O D A Bi en eb e
m
bl
e
ffi
ce
O
ffi raw Dr
a 3D ffice raw ssa oV
i
to
ry
oo
k
rc
k
AC
X
Su ce w U y z In
ite Ul U ltr Ultr l Ultr U U U ltr Ul d Ul
Includes tra Pr Pr tra ltr ltr t r e tra
s o a o a a a a a a x
*ChemDraw Ultra Win/Mac
*ChemDraw Pro Win/Mac
*ChemDraw Std Win/Mac
*ChemDraw ActiveX/Plugin Pro Win/Mac
*Chem3D Ultra Win
*Chem3D ActiveX Pro Win
Software

*Chem3D & E-Notebook Pro Win


Chem3D & E-Notebook Std Win
ChemFinder Pro Win
ChemFinder Std Win
*BioDraw Pro (Pathworks) Win
*BioAssay Pro Win
*Inventory Pro Win
*E-Notebook Ultra Win

BioViz/Chem & Bio Finder Win


CombiChem/Excel Win
ChemFinder/Oracle Win
ChemFinder/Office Win
ChemDraw/Excel Win
Struct<=>Name Win/Mac
Applications & Features

ChemNMR & ClogP Win/Mac


Stoichiometry Grid Win/Mac
TLC PLate Tool Win/Mac
Mass Fragmentation Tool Win/Mac
Structure Clean Up Win/Mac
Polymer Draw Win/Mac
LabArt & BioArt Win/Mac
Tinker/Chem3D Win
MOPAC Client Win
GAMESS Client Win
Gaussian Client Win
Jaguar Client Win

The Merck Index Win/Mac


Databases

*ChemACX Ultra (1 Year) Win


*ChemINDEX Ultra Win
ChemRXN, NCI & AIDS Win
*Available Separately
Chem & Bio Office
Software Standard for Scientists
the ultimate ChemOffice is a powerful suite of software, consisting of ChemDraw, Chem3D, ChemFinder
software suite and ChemACX for chemists, BioOffice, BioAssay, BioViz, and BioDraw for biologists, and
for scientists Inventory, E-Notebook and The Merck Index for scientists. ChemOffice and BioOffice are available
for Microsoft Windows.
the standard ChemDraw includes Struct <=> Name, ChemDraw/Excel and ChemNMR. Create stereo-
achieves the chemically correct structures from chemical names, and get accurate IUPAC names for structures.
ultimate Estimate NMR spectra from a ChemDraw structure with direct atom to spectral correlation.
The ChemDraw ActiveX/ Plugin adds chemical intelligence to your browser for querying databases
and displaying information.
computational Chem3D provides visualization and display of molecular surfaces, orbitals, electrostatic potentials,
chemistry charge densities and spin densities. Chem3D utilizes MOPAC, Gaussian, GAMESS and extended
made easy Hckel to compute molecular properties. ChemProp computes Connolly surface areas, molecular
volumes and properties, including Tinker, ClogP, molar refractivity, critical temperature & pressure.
desktop to ChemFinder is a chemically intelligent database manager and search engine. ChemDraw/Excel
enterprise creates searchable spreadsheets. ChemFinder/Word searches documents, spreadsheets, and files for
searching chemical structures and references. ChemFinder includes CombiChem/Excel for combinatorial library
generation in chemical spreadsheets. ChemFinder/Oracle provides enterprise solution integration.
ultimate suite BioOffice is the ultimate suite for management, analysis and visualization of biological data
for biologists using BioAssay and BioViz. Use BioDraw for drawing pathways. Includes Chem3D, Inventory
and E-Notebook.
draw BioDraw, formerly called Pathworks, makes drawing and annotating your biological path-
pathways ways straight-forward and quick, adding a level of uniformity and detail which is unmatched.
screening BioAssay manages both high and low throughput biological screening data. Designed for
data complex lead optimization experiments, the software supports the quick set-up of biological models.
visualize BioViz offers automated calculations, curve fitting, and customized structure activity reports,
data including a user friendly interface for importing, viewing, validating & plotting biological assay data.
handle Inventory manages your reagent and biological tracking needs. Using MSDE as the desktop
reagent database, you organize, store and search over your inventory. Inventory integrates with the
tracking ChemACX database of available chemicals and ChemMSDX safety data providing chemical
sourcing and purchasing.
efficient E-Notebook is the efficient, accurate way to write lab notebooks. It stores MS Office docu-
notebook ments, ChemDraw structures and reaction drawings, and related data in a notebook searchable
keeping by text or chemical structure. Organize pages by project, experiment, or in your own style. Use
CombiChem/Excel to build libraries.
access info Databases include The Merck Index and ChemINDEX, including the NCI and AIDS databases.
with ease The ChemACX Database contains nearly 400 catalogs from leading suppliers and ChemMSDX
Database contains over 20,000 material safety data sheets for commonly used laboratory chemicals.
ENTERPRISE &

Chem & Bio Office Workgroup


Integrated Research, Discovery, Development,
Research & Discovery - Search for Products and use them from Inventory, record newly made
Since the companys founding, CambridgeSofts compounds within a proprietary Registration system,
desktop software, starting with its industry-leading record the results from biological testing in BioAssay,
ChemDraw, has been the cornerstone application for analyze the results with BioViz, and generate reports
scientists who draw and annotate molecules, reactions, linking activity and structure with BioSAR.
and pathways. The suite of applications has devel- Virtually every aspect of discoveryfrom synthesis
oped and CambridgeSoft now provides solutions in planning, library enumeration, reagent selection,
virtually all areas of discovery. Researchers can record primary and secondary screening, in vivo testing,
and share their experimental information using through to analysis of results and reporting is covered
E-Notebook, while protecting intellectual property by this integrated application suite.
with digital signatures and 21CFR11 compliance.
They can design both single experiments or design Development - Converting Leads into Testing
combinatorial libraries of compounds. They find Building on productivity software, CambridgeSoft
and purchase reagents in ChemACX database, store created enterprise applications to meet the needs of an

En En En W W W
ChemOffice ter ter ter or or or
pr pr pr kgr kgr kg
ise ro
Ul ise is ou ou up
tra Pr e Std Ultr p Pr p
Std
Includes
o a o

E-Notebook Enterprise or Workgroup


BioAssay Enterprise or Workgroup
BioSAR Enterprise
BioViz Desktop

Registration Enterprise
Inventory Enterprise or Workgroup
ChemACX Database

ChemINDEX Database
Oracle Cartridge
SQL Server Compatible
ChemFinder Ultra

All specifications subject to change without notice.


US 1 800 3157300 INTL 1 617 5889300 FAX 1 617 5889390 EMAIL info@cambridgesoft.com
EU 00 800 875 20000 UK +44 1223 464900 JP 0120 731 800 WWW www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA

ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
WORKGROUP

and Enterprise Solutions


Trials and Manufacturing Workflow
ever expanding research and development community The handling of materials, including chain of custody
that relies on data sharing across scientific disciplines, requirements, material documentation, material
research campuses, and even oceans as globalization workflow, such as availability states and recertification
has increased demands. Since it is web-based, the dates, are tracked and handling by the system. The
software is deployed readily throughout a research systems meet these requirements and provide the
and development organization. Using Registration, E- basis to manage materials and records during clinical
Notebook, BioAssay, and BioViz, in conjunction with trials. Clinicians can design and record results from
DocManager and DrugDeg, scientific teams are well protocols, and all of these web based software systems
armed to solve the daily challenges of development. provide the access required by clinicians who are
These teams include scientists who scale up and removed from the sponsoring company.
design manufacturing procedures, toxicologists who ChemOffice Enterprise is a comprehensive
determine the metabolic fate of drug candidates, for- knowledge management and informatics solution,
mulation scientists who determine drug dosing and covering electronic notebooks, biological screening,
delivery systems, as well as many others. chemical registration and more over your intranet.
Trials & Manufacturing - Last Steps to Success
Enterprise Ultra includes E-Notebook for record keep-
ing, BioAssay for low and high throughput screening
A suitable drug candidate is one that has the desired with integrated plate inventory, BioSAR for SAR
activity to provide disease therapy while still meeting reports, Registration system, Inventory for reagents
drug safety requirements, can be manufactured in a and ChemACX database of available chemicals.
cost effective and reproducible fashion under Technologies include ChemDraw ActiveX and Oracle
21CFR11 and GMP guidelines, and is stable under Cartridge.
normal formulation and storage conditions. With a
drug candidate in hand, the final challenge is to deter- ChemOffice Workgroup is a comprehensive
mine safety and efficacy, beyond the laboratory, in a knowledge management and informatics solution,
patient population. covering electronic notebooks, biological screening
and more over your intranet. Workgroup Ultra
Manufacturing requires the hand off of data and includes E-Notebook for record keeping, BioAssay for
batch process records from the pilot plant studies low and high-throughput screening, BioViz for
using Inventory, E-Notebook, and Registration systems visualization, Inventory for reagents and ChemACX
under Good Laboratory and Manufacturing database of available chemicals. Technologies include
Processes (GxP). SQL Server for affordability and ease of administration.

All specifications subject to change without notice.


US 1 800 3157300 INTL 1 617 5889300 FAX 1 617 5889390 EMAIL info@cambridgesoft.com
EU 00 800 875 20000 UK +44 1223 464900 JP 0120 731 800 WWW www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA

ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
KNOWLEDGE

E-Notebook, Reaction Explorer,


Electronic Journal and Record Keeping
E-Notebook
E-Notebook offers custom organization of
E-Notebook provides a smooth web-based interface notebook pages at personal or enterprise levels
designed to replace paper laboratory notebooks, with
Quick access to important data by searching
a fully configurable, secure system for organizing the on keywords, dates, chemical structures and
flow of information generated by your organization. more
You can enter reactions, Microsoft Word documents,
spectra and other types of data, and search this data Reaction Explorer can display the ancestors
and descendants of a batch in seconds
by text, substructure or meta data. You can organize
your electronic pages by projects, experiments or any
other classification that conforms to your workflow.
E-Notebook Ultra
E-Notebook Enterprise
E-Notebook Ultra is the efficient, accurate way to
E-Notebook Enterprise edition integrates notebook write lab notebooks entries as you work. It stores
keeping at group and enterprise levels to promote lab Microsoft Office documents, ChemDraw structures
productivity and information sharing. Oracle and reaction drawings, and related data in an elec-
Cartridge manages chemical structures in a common tronic notebook you can search by text or chemical
data repository with detailed security and 21CFR11 structure. Organize pages by project, experiment or
Compliance. The enterprise edition also works with your own style with the MSDE database.
procurement and inventory management systems to CombiChem/Excel builds combinatorial libraries.
save time locating chemicals and entering structures.
Reaction Explorer
E-Notebook Workgroup Reaction Explorer is a powerful application that
E-Notebook Workgroup, intended for use with a assembles a vast amount of information into a lucid
medium number of users, offers much of the func- synthesis map. The map provides reaction informa-
tionality delivered in E-Notebook Enterprise while tion, as well as quick access to experiments. Reaction
using SQL Server as the database. Learning to use Explorer displays two types of relationships between
and administer the application is quick and straight- compounds: relationships grouped by batch and
forward. E-Notebook applies various data types to those grouped by compound. Both types of displays
suit different disciplines with an unlimited number are configurable, allowing scientists to create a look
of workflows. and feel that they are comfortable with.

All specifications subject to change without notice.


US 1 800 3157300 INTL 1 617 5889300 FAX 1 617 5889390 EMAIL info@cambridgesoft.com
EU 00 800 875 20000 UK +44 1223 464900 JP 0120 731 800 WWW www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA

ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
MANAGEMENT

E-Signatures & 21CFR11 Compliance


Property Protection and Regulatory Compliance
The batch display tracks the history of a particular E-Notebook also provides the capability to scale reac-
entity through several subsequent reactions and tions by virtually any parameter from reagent
experiments. This might be of interest to a chemical amount to vessel size. Individual reactions may be
auditor or patent attorney needing to track down the scaled as well as total syntheses. Batch procedures cre-
original source of material. ated with E-Notebook can be used to produce auto-
matically batch record worksheets.
The compound display is more general, and shows all
possible pathways to and from a compound. This is
ideal for chemists working to optimize a process, or a
patent attorney trying to link a product to discovery,
or a scientist trying to compile work done by several
other scientists.

Process Chemistry
The objective of process research is
to identify efficient processes for the
synthesis of active pharmaceutical
agents at the scale required for
clinical trials and commercial use. It
is necessary to provide precise Display Ancestors
descriptions of these processes so
that they can be executed by differ-
ent groups in different locations.
E-Notebooks process chemistry mod-
ules are designed to support these
dual workflow and regulatory-
compliance needs of process Authenticate Work
chemists. After the steps in a synthe-
sis have been optimized, either indi-
vidual steps or the entire synthesis
must be scaled.

All specifications subject to change without notice.


US 1 800 3157300 INTL 1 617 5889300 FAX 1 617 5889390 EMAIL info@cambridgesoft.com
EU 00 800 875 20000 UK +44 1223 464900 JP 0120 731 800 WWW www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA

ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
KNOWLEDGE

E-Notebook, Reaction Explorer,


Electronic Journal and Record Keeping
CombiChem Enterprise
Highly flexible and configurable to match
Combinatorial chemistry, in particular the technique
an organizations workflow
of parallel synthesis, has become an essential element
of the drug discovery process. By using parallel Consulting teams analyze and adapt
synthesis techniques, chemists are able to multiply existing procedures to comply with new
their productivity by a factor of between 5 and 100. regulations
CombiChem Enterprise has been developed to provide
Systems include authentication and digital
the tools required by the combinatorial chemist
signatures and adapt to changing
to manage and document parallel synthesis regulations and demands for intellectual
experiments. property protection
Flexibility is the key when dealing with databases of
chemical compounds. CombiChem Enterprise can use
reagent lists from a variety of different sources: SD associated metadata. Managers, patent attorneys,
files, ChemFinder databases, ChemFinder hit lists, and scientists can retrieve records based on searches
ChemACX Database, or directly from the user via over the metadata.
ChemDraw. Regardless of the source, CombiChem
produces a list of reagents which match a particular E-Signatures also manages the signature workflow for
generic reactant. electronic records and documents in process. Digital
signatures are captured at the time of record
E-Signatures IP Protection
creation, which can later serve to prove the authen-
E-Signatures provides data storage and access func- ticity of the stored electronic records. Reviewers,
tions for electronic records. It is used in conjunction
witnesses, and other individuals can countersign
with E-Notebook as a long-term storage system.
records for various business purposes, including wit-
While E-Notebook is intended to capture and record
ness records necessary to meet the needs of 37 CFR
data as the experiments are carried out, E-Signatures
and similar regulations worldwide.
serves as the repository for finished experiments and
other documents. Electronic records must be 21CFR11 Compliance
available indefinitely, and their authenticity must be
Large and growing enterprises are facing a challenge
verifiable independently of the E-Notebook system. In
to their core missions of developing and producing
addition to the record, E-Signatures long-term
archive includes a digital signature, a timestamp, and new products including food, therapeutic pharma-
ceuticals, medical devices, cosmetics or other health

All specifications subject to change without notice.


US 1 800 3157300 INTL 1 617 5889300 FAX 1 617 5889390 EMAIL info@cambridgesoft.com
EU 00 800 875 20000 UK +44 1223 464900 JP 0120 731 800 WWW www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA

ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
MANAGEMENT

E-Signatures & 21CFR11 Compliance


Property Protection and Regulatory Compliance
enhancing items. The complexity lies in complying
with government regulations designed to protect
public health and safety. The most notable of these
is Title 21 of the Code of Federal Regulations
governing Electronic Records and Signatures
(21CFR11).
Once you have determined how your enterprise will
comply with these new regulations, implementing
those decisions needs to be done quickly, efficiently
and with the understanding that the rules for
compliance are in flux. In order to succeed, you must
be able to respond to change. CambridgeSofts
21CFR11 Compliance consulting has both the tools
and the expertise to provide complete solutions, carry
out integration with existing systems, and help exe-
cute the process as quickly as your organization
demands.

All specifications subject to change without notice.


US 1 800 3157300 INTL 1 617 5889300 FAX 1 617 5889390 EMAIL info@cambridgesoft.com
EU 00 800 875 20000 UK +44 1223 464900 JP 0120 731 800 WWW www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA

ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
CHEMICAL

Inventory, Registration,
Chem and Bio Inventory and Registration
Chem & Bio Inventory
Inventory offers plate handling for high-
Inventory is an application designed to manage the throughput experimentation
chemical and reagent tracking needs of laboratories
and research centers. The system manages data Inventory is GxP Compliant with validated
audit trails
associated with both commercially procured and
internally produced chemical substances from Registration has flexible business rules for
procurement or initial production through depletion registration, salt handling, and batch fields
and disposal. To meet the needs of institutions with chemical intelligence that includes
of all sizes, Inventory comes in an Enterprise edition, advanced stereochemistry
a Workgroup edition and two Desktop editions.
Inventory Enterprise is an Oracle-based, ChemOffice
Inventory Pro is an all-inclusive desktop product. It
Enterprise product. Designed for large organizations,
includes Microsoft SQL Server Desktop Edition
it comprises a number of features not included in the
(MSDE ), the re-distributable database for SQL
desktop or workgroup versions. Inventory Enterprise
Server. No additional licensing is required.
conveniently manages plate information. In addition
to storing, moving, and deleting plates, the applica- Registration Enterprise
tion allows users to create daughter plates and Registration Enterprise includes a robust data model
reformat plates. Inventory Enterprise can be tightly for pure compounds, batches, salt management,
integrated with Registration Enterprise and ChemACX automatic duplicate checking and unique ID assign-
Database. ments. Compounds may be entered individually or
through the use of a batch loader. The data model
Inventory Workgroup is a thick-client SQL Server-
resides entirely in Oracle and uses Oracles security
based product. This version is suitable for larger
and transaction framework. Registration is easily
organizations that do not have the interest or desire to
adapted to any workflow.
maintain an Oracle server.
New compound chemical and non-chemical data is
Inventory Ultra is the same MSDE based product, entered into a temporary storage area through a web
while also including the ChemACX Database, form. When the compound is registered, it is
CambridgeSofts collection of nearly 400 catalogs compared for uniqueness via a configurable, stereo-
from suppliers of chemical reagents. selective duplicate check, and assigned a registry

All specifications subject to change without notice.


US 1 800 3157300 INTL 1 617 5889300 FAX 1 617 5889390 EMAIL info@cambridgesoft.com
EU 00 800 875 20000 UK +44 1223 464900 JP 0120 731 800 WWW www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA

ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
I N F O R M AT I C S

DocManager & Oracle Cartridge


Document Searching and Enterprise Infrastructure
number. All information about the compound, systems are designed for registration of single mole-
including its test data and other syntheses, is tracked cules, with little thought for the world of formulations
by the registry number. When a compound is regis- and mixtures. CambridgeSoft has developed a system
tered, the structure is checked for novelty. If a dupli- specifically designed for this registration need called
cate already exists in the database, the user can elect Formulations & Mixtures.
to register the information as a new batch of the
existing compound, or assign it a unique registry
number.
Registration Enterprise is the only true n-tiered appli-
cation of its kind that is designed around thin clients
and thin servers. This translates into ultimate flexibil-
ity on both the client and server side. Oracle is
supported on a variety of platforms and operating
systems. Using Oracle keeps your proprietary data
secure through the use of Oracles
role based security and allows all
chemical and non-chemical data to
be stored directly in the Oracle Index Documents
tables.
Formulations & Mixtures
Formulation scientists face different
challenges from those working with
individual molecules, yet many of
the tools they are forced to use
emerge from the drug-discovery Manage your Inventory
world, where single-molecule
research is the norm. Take an essen-
tial task such as compound registra-
tion and you will find that most

All specifications subject to change without notice.


US 1 800 3157300 INTL 1 617 5889300 FAX 1 617 5889390 EMAIL info@cambridgesoft.com
EU 00 800 875 20000 UK +44 1223 464900 JP 0120 731 800 WWW www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA

ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
CHEMICAL

Inventory, Registration,
Chem and Bio Inventory and Registration
DocManager Enterprise
DocManager parses Word, Excel and
Web browser based, DocManager Enterprise extends PowerPoint documents, including free text
the capability of standard search engines to include
full free text searching and chemically intelligent DocManager has a web based interface and
a file drop folder for quick submissions
structure searching of electronic documents includ-
ing Text, Microsoft Word, Excel, PowerPoint, and Oracle Cartridge is compatible with Linux,
Adobe PDF. Solaris, AIX and Windows and includes
structure searching, property predictions
The DocManager Enterprise interface allows users to and nomenclature
easily submit documents through a series of simple to
navigate web forms. When a new document is
submitted, DocManager builds a free-text index of
Oracle Cartridge
the document, and extracts chemical information
into a chemically-aware, substructure searchable The CambridgeSoft Oracle Cartridge is used by all
ChemOffice Enterprise applications for storing, search-
database. Chemical information can originate from
ing over, and analyzing chemical data. It can also be
either ChemDraw or ISIS Draw.
used in the development of your custom Oracle
DocManager Enterprise includes a batch loading applications. Chemical structure information is
utility for administration level users to load multiple difficult to manipulate without utilizing special
documents at one time. The system can be software. Oracle data cartridges define new, recognized
configured to submit a batch of documents as one datatypes. CambridgeSofts Oracle Cartridge utilizes
event, or as a reoccurring submission to be executed this technology making it possible to manipulate
daily. The administrator simply specifies a time chemical structure and reaction data from within
for the submission to take place and the location of Oracle, improving portability and consistency in
the files. applications. Since the Oracle Cartridge is accessed
through Oracle, this allows the programmer to interact
DocManager Enterprise utilizes the searching intelli- with chemical structure data directly in Oracle. The
gence of the ChemOffice Enterprise suite. In addition CambridgeSoft Oracle Cartridge supports CDX ,
to standard textual and numerical searching, CDXML , MolFile, RXN , and SMILES formats
DocManager searches the submitted documents for making it flexible enough to be included with both
chemical structure or reaction. new and legacy data, without the need for conversion.

All specifications subject to change without notice.


US 1 800 3157300 INTL 1 617 5889300 FAX 1 617 5889390 EMAIL info@cambridgesoft.com
EU 00 800 875 20000 UK +44 1223 464900 JP 0120 731 800 WWW www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA

ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
I N F O R M AT I C S

DocManager & Oracle Cartridge


Document Searching and Enterprise Infrastructure
ChemFinder Enterprise
ChemFinder Enterprise is a multiple-user system
designed for sites with heavy-duty chemical and
biological data needs. ChemFinder Enterprise contains
its own engine for working with local and shared
databases and it is also delivered with the
CambridgeSoft Oracle Cartridge, the powerful
Oracle-hosted structure engine based on ChemFinder
search technology. So, the face of ChemFinder
Enterprise is the same friendly form-oriented interface
as the desktop version, but underneath is a fast direct
connection to Oracle and the robust, scalable Oracle
Cartridge running on the server.

All specifications subject to change without notice.


US 1 800 3157300 INTL 1 617 5889300 FAX 1 617 5889390 EMAIL info@cambridgesoft.com
EU 00 800 875 20000 UK +44 1223 464900 JP 0120 731 800 WWW www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA

ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
BIOLOGICAL

BioAssay, BioViz,
Assay Screening and Visualization
BioAssay
BioAssay effectively manages data from com-
Biological assay data comes in many forms, from a plex biological assays involved with lead
scientists observations to output from a plate reader. optimization
Software designed to store and analyze this data must
BioViz provides a flexible reporting and plot-
provide a solution for both the ultra-high volume
ting engine for your scientific data
laboratories, including laboratory automation,
calculation, and statistics, as well as the very compli- BioViz integrates with BioSAR for one step in-
cated low and medium throughput assays such as depth data analysis from a BioSAR report
animal models and in vivo experiments. Organizing,
analyzing, and sharing data can be a challenge for
screening biologists, regardless of the amount of
automation or manual data manipulation employed.
BioAssay was designed to tackle the needs of high and
low throughput screening biologists alike by provid- BioAssay Workgroup, intended for single site deploy-
ing an application flexible enough to model any ment, uses SQL Server as a database, instead of
assay, regardless of complexity, while robust enough Oracle. This solution offers affordability and ease of
to provide an easy to use interface for importing,
maintenance, but still remains a robust solution suit-
storing and analyzing the data. The software supports
the quick set-up of biological models, automated cal- able for a smaller groups needs. Organize and share
culations and curve fitting, data validation, and the your biological screening data with minimal admin-
creation of customized structure activity reports. istrative costs.

BioAssay Enterprise offers a scalable, flexible biological BioAssay Ultra is designed to deliver much of the func-
screening solution utilizing Oracles role based securi- tionality of our enterprise level applications, without
ty and the Oracle Cartridge. As part of ChemOffice a widespread roll out. MSDE database compatible,
Enterprise, BioAssay is easily integrated with Inventory
BioAssay Ultra, coupled with BioViz, offers a user
Enterprise for plate tracking and management,
Registration Enterprise for the registration of new friendly interface for importing, viewing, validating,
compounds and BioSAR Enterprise for customized and plotting your biological assay data from your
reporting. desktop.

All specifications subject to change without notice.


US 1 800 3157300 INTL 1 617 5889300 FAX 1 617 5889390 EMAIL info@cambridgesoft.com
EU 00 800 875 20000 UK +44 1223 464900 JP 0120 731 800 WWW www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA

ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
I N F O R M AT I C S

BioSAR & BioDraw


Data Mining and Pathway Drawing
BioViz
BioViz, with ChemFinder, transforms the numbers in
your database into graphics on your screen. Retrieve
or search for a set of compounds, choose the data you
want to see, whether it is biological test results in
Oracle tables, physical property values calculated
automatically or prices in a catalog, and BioViz will
generate an interactive window showing a scatterplot,
histogram, or other useful data graphic.
The Plot Window, the key to data visualization in
BioViz, shows two variables plotted against each
other in a scatterplot with each point representing a
structure from the current hit list.
If you modify the list, for example
Draw Biological Pathways
by performing a search, the plot
updates to show the new set of
points. You can drag a rectangle
around a set of points to select
them, or zoom in to see them
more closely.

Plot Assay Data

All specifications subject to change without notice.


US 1 800 3157300 INTL 1 617 5889300 FAX 1 617 5889390 EMAIL info@cambridgesoft.com
EU 00 800 875 20000 UK +44 1223 464900 JP 0120 731 800 WWW www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA

ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
BIOLOGICAL

BioAssay, BioViz,
Assay Screening and Visualization
BioSAR
BioSAR Enterprise, a strategic must for any discovery BioSAR is a catalog driven data mining and
organization interested in serious data mining, is a structure- activity analysis program
data-dictionary driven structure-activity analysis
program. Users may choose among assays registered BioSAR provides both form and table views
in the dictionary or search for assays of interest. The within a simple and powerful web interface
power of BioSAR lies in the researchers freedom from BioDraw makes it easy to draw and annotate
dependence on IT support. Once an assay is biological pathways including common
registered into the data-dictionary, it is automatically elements such as membranes, enzymes,
included in the powerful analysis framework. By receptors and DNA
reducing the time between question and answer,
BioSAR gives researchers the ability to explore new
ideas, the bottom line for discovery information sys-
tems. Systems that provide answers after questions
have become irrelevant are of no use. BioSAR avoids working closely with users. The result is a SAR
this issue by placing application development in the application that is as intuitive as it is powerful.
researchers control.
Security within BioSAR Enterprise is highly granular.
BioSAR Enterprise allows the researcher to create cus- Different roles exist for administrators, publishers,
tom reports and views of their data. You decide what and browsers. Administrators may add assays to the
is displayed, and BioSAR takes care of the rest. While
data catalog engine, publishers may create reports
most SAR tools provide only a table-based interface,
BioSAR provides a both a form view and table view. and publish them, and browsers may use data query
The form view provides highly detailed information and analysis. Most data mining tools provide a
about one compound, whereas the tabular view mechanism to store queries, but the interface for
makes viewing comparisons between compounds creating queries is too complex. With BioSAR, each
more feasible. There is often a tradeoff between set of assays is a complete report with a query form,
power and simplicity, and most SAR tools opt for the a view form, and a table view, combining the
former at the expense of the latter. BioSAR, however, convenience of a ChemFinder or ISIS application with
merges the sophistication of a powerful data catalog
the power and flexibility of a data catalog-driven
technique with knowledge gained through years of
mining program.

All specifications subject to change without notice.


US 1 800 3157300 INTL 1 617 5889300 FAX 1 617 5889390 EMAIL info@cambridgesoft.com
EU 00 800 875 20000 UK +44 1223 464900 JP 0120 731 800 WWW www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA

ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
I N F O R M AT I C S

BioSAR & BioDraw


Data Mining and Pathway Drawing
BioDraw
Reporting on and presenting findings is a task familiar The drawing and data organization offered by
to every biologist. Making this process easier and BioDraw gives any biologist an advantage. Sharing
more effective benefits everyone involved. BioDraw, this advantage assists the community as a whole.
formerly called Pathworks, is doing for biologists BioDraw offers many ways to share your drawings
what ChemDraw has done for chemists for years and accompanying data. Users can export data to
saving time, and resulting in a more professional Microsoft Office applications for inclusion in
presentations and grant proposals or save data as an
representation of the science at hand.
image file for use in journal article submission.
BioDraw makes drawing and annotating biological
pathways quick and easy, adding a level of uniformi-
ty and detail which is unmatched. Typical drawings
of biological pathways include many elements that
are difficult to draw with the standard presentation
and word processing software that is on the market.
Common pathway elements such as membranes,
enzymes, receptors, DNA and reaction arrows are
built into the BioDraw toolbar. BioDraw also allows
users to import images in GIF, PNG or JPEG format.

Keeping data organized is of utmost importance in


any lab. BioDraw reflects that importance by allow-
ing users to store annotations for each element in a
drawing. Annotation data ranges from manually
entered text to attached documents, restriction maps,
microarrays, sequence information, literature refer-
ences, or links. Any data, regardless of format, is
stored side-by-side with the drawing for future
retrieval.

All specifications subject to change without notice.


US 1 800 3157300 INTL 1 617 5889300 FAX 1 617 5889390 EMAIL info@cambridgesoft.com
EU 00 800 875 20000 UK +44 1223 464900 JP 0120 731 800 WWW www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA

ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
DESKTOP

ChemDraw, Chem3D,
Structure Drawing and Molecular Modeling
ChemDraw Ultra adds Struct<=>Name,
ChemDraw/Excel, ChemNMR, CLogP, tPSA and ChemDraws improved Struct<=>Name
ChemFinder/Word to ChemDraw Pro. With rich feature produces names for more types of
polymer notation, atom numbering, BioArt templates, compounds
and modern user interface, ChemDraw is more
Live ChemDraw window embedded in
powerful than ever before. Create tables of structures, Chem3D application allows simultaneous
identify and label stereochemistry, estimate NMR 2D and 3D editing
spectra from a ChemDraw structure with structure-
to-spectrum correlation, obtain structures from Chem3D brings workstation-quality
molecular graphics and rigorous
chemical names, assign names from structures, and
computational methods to your desktop
create multi-page documents and posters.
ChemDraw Pro will boost your productivity
more than ever. Draw publication-quality structures
and reactions. Publish on the web using the
ChemDraw Plugin. Create precise database queries by
specifying atom and bond properties and include ChemDraw/Excel allows the user to create
stereochemistry. Display spectra, structures, and chemically knowledgeable spreadsheets within the
annotations on the same page. Use the Online Menu familiar Microsoft Excel environment. You can build
to query ChemACX.Com by structure and identify and manipulate chemical structures within Excel,
available vendors. compute chemical properties and perform database
Struct<=>Name contains the leading compre- searches.
hensive methods for converting chemical structures
ChemNMR can be used to accurately estimate 13C
into chemical names and names to structures. It can
and 1H (proton) chemical shifts. The molecule and
be used for many types of compounds, including
charged compounds and salts, highly symmetric the spectrum appear in a new window. The chemical
structures and many other types of inorganic and shifts are displayed on the molecule and the spectrum
organometallics. Struct<=>Name is available in two is linked to the structure so that clicking on a peak in
forms: a batch application, and an interactive version the spectrum highlights the related fragment on the
that is also available in ChemDraw Ultra. molecule.

All specifications subject to change without notice.


US 1 800 3157300 INTL 1 617 5889300 FAX 1 617 5889390 EMAIL info@cambridgesoft.com
EU 00 800 875 20000 UK +44 1223 464900 JP 0120 731 800 WWW www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA

ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
S O F T WA R E

ChemFinder & ChemInfo


Structure Searching and Scientific Databases
Chem3D Ultra includes a number of molecular It can also be used to predict a number of chemical
modeling capabilities such as molecular overlay, and physical properties. Chem3D contains an
conformational searching and dihedral driver support. interface to the MOPAC package.
It also includes interfaces for optional use of
Gaussian is a collection of semi-empirical and
MOPAC , Gaussian and GAMESS . The user can also
ab initio molecular orbital (MO) computational
compute advanced physical properties such as CLogP
methods which can be used to predict energies,
and ChemProp. These properties can be used to
molecular structures, molecular properties, as well
create SAR tables. ChemSAR/Excel can then be used
as molecular spectra. Chem3D enables the user to
to explore structure activity relationships. High
transparently create input and analyze output resulting
quality Chem3D graphics can be viewed on the web
from Gaussian.
using the Chem3D ActiveX.
Chem3D Pro brings workstation quality molecular
visualization and display to your desktop. Convert
ChemDraw and ISIS/Draw sketches into 3D models.
View molecular surfaces, orbitals, electrostatic
potentials, charge densities and
spin densities. Use built-in extended
Hckel to compute partial atomic
charges. Use MM2 to perform
rapid energy minimizations and
molecular dynamics simulations.
Molecular Modeling
ChemProp estimates physical prop-
erties such as logP, boiling point,
melting point and more. Visualize
Connolly surface areas and molec-
ular volumes.
MOPAC is a semi-empirical Estimate Spectra
quantum mechanics package which
can be applied to the study of
chemical properties and reactions.

All specifications subject to change without notice.


US 1 800 3157300 INTL 1 617 5889300 FAX 1 617 5889390 EMAIL info@cambridgesoft.com
EU 00 800 875 20000 UK +44 1223 464900 JP 0120 731 800 WWW www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA

ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
DESKTOP

ChemDraw, Chem3D,
Structure Drawing and Molecular Modeling
ChemFinder Enterprise is a multiple-user
ChemFinder offers improved searching and
system designed for chemical and biological data
hitlist management, along with new property
management. ChemFinder Enterprise contains its own
generation
engine for working with local and shared databases
and it is also delivered with the CambridgeSoft ChemFinder is tightly integrated with
Oracle Cartridge, the powerful Oracle-hosted CambridgeSofts Oracle Cartridge
structure engine based on ChemFinder search
Search ChemACX and other CambridgeSoft
technology. So, the face of ChemFinder Enterprise is
databases for important chemical information
the same friendly form-oriented interface as the desk-
top version, but underneath is a fast direct connec-
tion to Oracle and the robust, scalable Oracle
Cartridge running on the server.
BioViz, included in ChemFinder Enterprise, provides The Merck Index is an encyclopedia of chemi-
a new set of data visualization features. These features cals, drugs and biologicals, with over 10,000 mono-
allow you to plot structural and biological data in a graphs covering names, synonyms, physical proper-
variety of styles, filter plots based on your criteria, ties, preparations, patents, literature references, ther-
highlight lists and intersecting sets on plots, generate apeutic uses and more.
histograms of data distributions, and more.
ChemACX Database includes 500,000 chemi-
ChemFinder Pro is a fast, chemically intelligent, cal products from nearly 400 supplier catalogs,
relational database search engine for desktop, work- searchable with a single query by structure, substruc-
group or enterprise applications. Extended integra- ture, name, synonym, partial name, and other text
tion with Microsoft Excel and Word adds chemical and numeric criteria. ChemSCX is a compilation of
searching and database capability to spreadsheets and searchable catalogs from leading screening compound
documents. suppliers.
Today, an ever-increasing number of chemical data- ChemMSDX Database provides material safe-
bases are available in ChemFinder format. Compatibility ty data sheets for 7,000 pure compounds.
with MDL ISIS databases is provided by SDfile and
RDfile import/export. ChemFinder provides network ChemINDEX Database includes 100,000
server workgroup functionality when used with chemicals, public NCI compounds, AIDS data, and
ChemOffice Workgroup and Enterprise. more.

All specifications subject to change without notice.


US 1 800 3157300 INTL 1 617 5889300 FAX 1 617 5889390 EMAIL info@cambridgesoft.com
EU 00 800 875 20000 UK +44 1223 464900 JP 0120 731 800 WWW www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA

ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
S O F T WA R E

ChemFinder & ChemInfo


Structure Searching and Scientific Databases
NCI Database contains over 200,000 com-
pounds with anti-cancer drug dose-response data.
AIDS Database is an NCI compiled database for
AIDS anti-viral compounds.
ChemRXN Database is a collection of 30,000
fully atom-mapped reactions selected and refined from
the chemical literature. It includes reactions from
InfoChems ChemSelect database and ISIs
ChemPrep database.
ChemFinder.Com is the award-winning web site
with information and WWW links for over 100,000
chemicals. Users can search by name or partial name,
view structure drawings, or use the ChemDraw
ActiveX/Plugin for structure and substructure search-
es. In addition, users can view live ChemDraw files on
Windows and Macintosh clients.

All specifications subject to change without notice.


US 1 800 3157300 INTL 1 617 5889300 FAX 1 617 5889390 EMAIL info@cambridgesoft.com
EU 00 800 875 20000 UK +44 1223 464900 JP 0120 731 800 WWW www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA

ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
DESKTOP

BioDraw, BioAssay, BioViz


Pathways, Biological Assay and Visualization
BioAssay Ultra
BioAssay offers flexible storage, retrieval and
BioAssay Ultra, the cornerstone of BioOffice, provides analysis of biological data
flexible storage, retrieval, and analysis of biological
data. BioAssay easily manages both high and low BioViz provides a graphical representation of
throughput biological screening data. Designed for the data loaded into a ChemFinder form
complex lead optimization experiments, the software
BioDraw allows for quick and easy drawing
supports the quick set-up of biological models, auto- and annotating of biological pathways, includ-
mated calculations and curve fitting, and the creation ing importing of images in GIF , PNG or
of customized structure activity reports. BioAssay JPEG format
brings all of this functionality to your desktop.
BioAssay Ultra, compatible with MSDE database,
offers a user friendly interface for importing, viewing,
validating and plotting your biological assay data.
BioViz the standard presentation and word processing
Combining biological data with the chemical software on the market. Common pathway elements
structure is of utmost importance in any drug discovery such as membranes, enzymes, receptors, DNA and
environment. BioViz allows you to analyze structure- reaction arrows are built into the BioDraw toolbar
related data combined with biological data visually. and including them in your document is as easy as
BioViz, within ChemFinder, provides a graphical rep- including a rectangle. Click on the toolbar shortcut
resentation of the data loaded into a ChemFinder and drop the element into your document. Resize
form. Users can search over data and construct a and move elements by clicking and dragging and
scatterplot, histogram, or other useful data charts. create an accurate and concise drawing in minutes.
Plots are interactive to allow you to select subsets of
your data. BioDraw allows the import of images in GIF , PNG
or JPEG format. ChemDraw users are also able to
BioDraw
include ChemDraw structures in drawings without
BioDraw, formerly called Pathworks, makes drawing difficulty.
and annotating your biological pathways quick and
easy, adding a level of uniformity and detail which is Keeping data organized is of utmost importance in
unmatched. Typical drawings of biological pathways any lab. The BioDraw application reflects that impor-
include many elements that are difficult to draw with tance by allowing you to store annotations for each

All specifications subject to change without notice.


US 1 800 3157300 INTL 1 617 5889300 FAX 1 617 5889390 EMAIL info@cambridgesoft.com
EU 00 800 875 20000 UK +44 1223 464900 JP 0120 731 800 WWW www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA

ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
S O F T WA R E

Inventory & E-Notebook


Materials Management and Electronic Journal
element in your drawing. Annotation data ranges
from manually entered text to attached documents,
literature references, or links. Any data, regardless of
format, is stored side-by-side with the drawing for
future retrieval.
The drawing and data organization offered by
BioDraw gives any biologist an advantage. Sharing
this advantage assists the community as a whole.
BioDraw offers many ways to share your drawings
and accompanying data.

Notebook Pages

Data Visualization

All specifications subject to change without notice.


US 1 800 3157300 INTL 1 617 5889300 FAX 1 617 5889390 EMAIL info@cambridgesoft.com
EU 00 800 875 20000 UK +44 1223 464900 JP 0120 731 800 WWW www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA

ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
DESKTOP

BioDraw, BioAssay, BioViz


Pathways, Biological Assay and Visualization
Inventory Ultra
Inventory manages the chemical and reagent
Inventory is an application designed to manage the tracking needs of laboratories and research
chemical and reagent tracking needs of laboratories centers
and research centers. The system manages data
associated with both commercially procured and Inventory maintains its own internal chemical
structure database with advanced duplicate
internally produced chemical substances from their
checking
procurement or initial production through their
depletion and disposal. E-Notebook stores Microsoft Office documents,
ChemDraw structures, reaction drawings and
Inventory Ultra is an MSDE based product and related data in a convenient, searchable format
includes the ChemACX Database with nearly 400
catalogs of chemical reagents. The three primary
entities in an Inventory system are locations, containers,
and substances. Users or administrators configure able. The application includes a number of specially
a network of locations, which represent locations designed inventory search forms. Search results are
within an organization. returned in list form and can be exported into a doc-
Containers are created to represent actual containers ument (PDF , RTF , HTML ) using the report engine.
in your facility. Each container is assigned a unique The Inventory interface allows for printing labels as
barcode, which can be printed, using a customized well as generating elaborate reports. Inventory uses a
template, from the Inventory interface. Each container report application that incorporates wizards that allow
stores a substance. Additional text fields are available for the quick creation of simple report and label
to track other chemical contents such as the solvent, templates that can be shared across an organization.
and custom fields may also be defined. To keep
track of substances, the system maintains its own Inventory Pro
internal chemical structure database containing
Inventory Pro contains the same features as Inventory
unique substances that can be associated with
Ultra without the ChemACX Database.
inventory containers. Advanced duplicate checking is
incorporated in the system. E-Notebook Ultra
Every field in a record, including chemical structure, E-Notebook Ultra is the efficient, accurate way to
molecular formula and molecular weight are search- write lab notebooks entries as you work. It stores

All specifications subject to change without notice.


US 1 800 3157300 INTL 1 617 5889300 FAX 1 617 5889390 EMAIL info@cambridgesoft.com
EU 00 800 875 20000 UK +44 1223 464900 JP 0120 731 800 WWW www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA

ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
S O F T WA R E

Inventory & E-Notebook


Materials Management and Electronic Journal
Microsoft Office documents, ChemDraw structures
and reaction drawings, and related data in an elec-
tronic notebook that is searchable by text or chemi-
cal structure. You can organize pages by project,
experiment, or in your own style with the MSDE
database . CombiChem/Excel builds combinatorial
libraries.
E-Notebook is configured exactly like a chemist would
like his or her own notebook to be. Reactions can be
easily drawn into the reaction template by either
selecting from the generous list of preloaded reagents
or by entering or drawing ones own chemicals.
Commonly used reagents can be stored in a separate
folder for easy access. Another fantastic feature is the
procedural section. This section contains prewritten
procedural sentences with the ability to easily drop in
the specific names of reagent chemicals present in the
reaction. One can also easily add other data to the
notebook page such as spectra and Word or Excel
documents.

CombiChem/Excel
CambridgeSoft provides you with the tools to effec-
tively plan combinatorial chemistry experiments in
Excel. The CombiChem/Excel add-in introduces addi-
tional functionality for handling combinatorial
chemistry. Users can generate products from a reac-
tion and lists of reagents, you can view all the prod-
ucts arising from a given reagent or all the reagents of
a given product, and you can lay out reagent and
reaction plates.

All specifications subject to change without notice.


US 1 800 3157300 INTL 1 617 5889300 FAX 1 617 5889390 EMAIL info@cambridgesoft.com
EU 00 800 875 20000 UK +44 1223 464900 JP 0120 731 800 WWW www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA

ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
SCIENTIFIC

The Merck Index, NCI, AIDS,


Scientific Reference, Chemical Reactions and Patents
The Merck Index
The Merck Index offers encyclopedic reference
Among printed chemical reference works, one that for over 10,000 chemicals, drugs and
stands out for its integrity, detail and longevity is The biological agents
Merck Index. The Merck Index database is a structure-
searchable encyclopedia of chemicals, drugs, and Traditional Chinese Medicines provides
chemical information and their biological
biological agents which includes the complete
effects of complex compounds isolated from
10,250 monographs of the 13th edition, 230 new natural sources
monographs unavailable anywhere else, as well as 540
monographs retired from the 12th Edition. All electronic databases are updated,
contain information unavailable in print,
The Merck Index is available in many forms to suit the and are searchable by structure, as well
various needs of both individuals and institutions. as text and numeric range
Personal subscriptions are available in one-year and
one-month time periods. A stand-alone package,
requiring no other applications, is also available for
personal use.
of the compounds, effects and indications of the
The subjects covered include human and veterinary medicines, English, Latin, and Chinese names for the
drugs, biological agents and natural products, indus- natural sources, and over 2,000 references. This
trial and laboratory chemicals, and environmentally information is also available as an SD file to facilitate
significant compounds. In addition to the standard in silico research.
searches, compound monographs can be searched by
ChemDraw structure as well as substructure. ChemINDEX
The ability to quickly look up data such as chemical
Traditional Chinese Medicines properties, biological assay results and toxicological
Many of todays well-known drugs have their origins information is no longer a luxury item, but instead a
from natural sources. Access to this wealth of requirement. Scientists have used the award-winning
knowledge is now available with the Traditional ChemFinder.Com database since 1995. Now, the data
Chinese Medicines database. The database consists of on ChemFinder.Com is integrated into ChemOffice as
monographs for 10,458 chemicals isolated from 4,625 ChemINDEX. ChemINDEX contains data on over
natural sources used in traditional Chinese remedies. 75,000 compounds including structures, names and
The monographs feature bio-activity data for many synonyms, physical properties, and Internet links.

All specifications subject to change without notice.


US 1 800 3157300 INTL 1 617 5889300 FAX 1 617 5889390 EMAIL info@cambridgesoft.com
EU 00 800 875 20000 UK +44 1223 464900 JP 0120 731 800 WWW www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA

ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
D ATA B A S E S

ChemACX & Sigma-Aldrich MSDS


Available Chemicals and Material Safety Data Sheets
NCI, AIDS & Cancer ChemReact68
Three informative databases have been integrated ChemReact68, from InfoChem GmbH, is a database of
into one powerful application with the NCI and sample reactions comprising essential information on
AIDS database collections. The application starts 68,000 reactions. These reactions have been selected
with a collection of over 200,000 molecules collected because they have greater than 50% yield and have
by the National Cancer Institute. Searchable fields appeared in more than five example reactions.
include structure, synonym, CAS RN, formula, and The database consists of reaction information and
molecular weight. literature references.
ChemRXN
ChemPrep and ChemSelect are the two reac-
tions databases that make up ChemRXN. Scientific Databases
ChemPrep is a reaction database assembled REFERENCE DATA
by the Institute for Scientific Information
The Merck Index 11,000 monographs
(ISI). This reaction database is designed to
help organic chemists find reactions easily. Traditional Chinese Medicines 10,000 substances
It includes full literature citations. ChemINDEX Database 75,000 substances
ChemSelect, licensed from InfoChem NCI, AIDS & Cancer 270,000 substances
GmbH, is a reaction database containing
Drugs: Synonyms & Properties 8,000 drugs
13,000 important organic reactions.
Medicinal Chemistry 540,000 substances
ChemSynth SOURCING & SAFETY DATA

ChemSynth, from InfoChem GmbH, is a ChemACX Database 380 catalogs


database of sample reactions comprising ChemMSDX Database 23,000 MSDSs
essential information on 180,000 reactions.
Sigma-Aldrich MSDS 130,000 MSDSs
These reactions have been selected because REACTION & SYNTHESIS DATA
they have greater than 50% yield and have ChemRXN Database 28,000 reactions
been sited in leading journals more than
ChemSynth 178,000 reactions
once. The database consists of reaction
information and literature reference. ChemReact68 68,000 reactions

All specifications subject to change without notice.


US 1 800 3157300 INTL 1 617 5889300 FAX 1 617 5889390 EMAIL info@cambridgesoft.com
EU 00 800 875 20000 UK +44 1223 464900 JP 0120 731 800 WWW www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA

ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
PROFESSIONAL

Development, Deployment,
Custom Development and System Deployment
In order to provide our customers with a total
solution for scientific informatics, CambridgeSoft With custom development, CambridgeSoft
works collaboratively with your team to create
offers the following services to assist our clients in
a system that meets your needs while executing
maximizing the productivity of their research and our quality driven software development
discovery organizations. process. We deliver what you need, on time
Informatics Planning and within budget, without surprises.
Strategic and Operational Planning
A formal analysis is conducted to provide a roadmap
for successful technology utilization. This process
includes:
Project Readiness Assessment
An analysis of the current state of the science
Is your project set up for success? Is it well defined
technology environment, including architecture and
into measurable deliverables? Are the roles of project
operational processes
members clearly defined? CambridgeSofts Project
A view of the strategic goals and the barriers to Readiness Assessment has one goal in mind
achievement to create or assess current plans and make recommen-
The delivery of a phased technology transition plan dations to ensure that results are achieved.
Requirements Analysis & Proof of Concept 21CFR11 Compliance
CambridgeSoft consultants can create or refine Successfully implemented, a traceable and usable
requirements to produce an environment that will system is essential to any organization involved in the
ensure success. With years of experience meeting the creation and management of data in a regulated
needs of the scientific community, CambridgeSoft environment. As an integral part in creating 21CFR11
understands the user. The prototyping process and GxP validated applications, CambridgeSoft offers
allows definition and testing of the functional and services to:
technical feasibility of potential technology solutions. Audit the software and process
The process provides a baseline for the future
Create conforming systems design specifications
development and deployment of a tailored solution.
Users gain valuable first hand knowledge in Generate test plans and validation matrices
experiencing how the system can help achieve Insure systems compliance with functional guide-
individual and workgroup goals. lines

All specifications subject to change without notice.


US 1 800 3157300 INTL 1 617 5889300 FAX 1 617 5889390 EMAIL info@cambridgesoft.com
EU 00 800 875 20000 UK +44 1223 464900 JP 0120 731 800 WWW www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA

ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
SERVICES

Training & Support


Educational Training and Technical Support
Product Development but would like to customize it for a unique environ-
Data Conversion and Integration ment. Our professional services teams can provide
those specific features by making custom modifica-
When developing a new system, the process of tions that will be supported in the future.
converting existing data and creating interfaces with
Systems Deployment
other data systems is an essential part of the process.
Installation and Configuration
CambridgeSofts professional services staff is equipped
to seamlessly incorporate existing data into the devel- CambridgeSoft will install and configure applications
opment of a new enterprise system. Organizations to meet the needs of your user community. For
unique environments, we build custom installers that
will be able to capitalize on historical scientific data
allow us to productively deploy software across an
while setting the platform for future success.
enterprise.
Custom Development
You have discovered a unique application
need in your organization, but cannot find a PLANNING DEVELOPMENT DEPLOYMENT MANAGEMENT
solution that will meet your functionality or
cost requirements. With custom development, Strategic/Op Data Installation & Managed
CambridgeSoft works collaboratively with Planning Integration Configuration Informatics
your team to create a system that meets your
needs, while executing our quality driven Requirements Systems
software development process. We deliver Analysis Custom Optimization Ultra
Application Services
what you need, on time and within budget,
Development Plans
without surprises. Proof of Pre-Release
Systems Integration Concept Programs

The ability to integrate core applications Systems Technical


with other systems in the technology envi- Project Integration Software Support
Readiness Evaluations
ronment is a competency required to deliver
the functionality of a new application.
Product Tailoring 21CFR11 Product Training Remote DBA
Compliance Tailoring Services Services
Your organization can see the benefit from
implementing a CambridgeSoft application,

All specifications subject to change without notice.


US 1 800 3157300 INTL 1 617 5889300 FAX 1 617 5889390 EMAIL info@cambridgesoft.com
EU 00 800 875 20000 UK +44 1223 464900 JP 0120 731 800 WWW www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA

ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
PROFESSIONAL

Development, Deployment,
Custom Development and System Deployment
Systems Optimization
Managed Informatics allows your organization
CambridgeSofts systems deployment team will work to focus on science, allowing CambridgeSoft to
with you to make sure that your computing environ- plan, implement and manage your technology
ment has been optimized for high performance. environment.
Your systems, networks, applications and databases
are assessed and designed to deliver maximum
achievement.
Beta and Pre-Release Programs
sional services staff supporting your systems
CambridgeSoft is committed to maximizing your
environment
productivity through the use of our products, as well
as exposing you to the newest technologies. Our beta On-site formal classroom training
and pre-release programs provide you with that Webinars for multi-location instruction
knowledge, allowing CambridgeSoft to improve Off-site at CambridgeSoft facilities
applications with your customer feedback. Systems Management
Pilot Software Evaluations Managed Informatics
It often makes sense to pilot an application before a There is no longer a need to worry about licensing
major commitment for an enterprise wide implemen- fees, maintenance contracts, systems administration
tation is made. CambridgeSoft will work closely with work or database support. Informatics Outsourcing
you to plan the evaluation, deploy the application, provides the people, processes and technology to
and gather critical feedback regarding systems design, develop a unique level of service for your organization.
APIs and technology specifications. For a monthly fee, CambridgeSoft will deliver the
Training informatics applications and the technology staff
Effective user, administrator and help desk training is required to maximize productivity. This service
often an afterthought in many systems deployments. allows your organization to focus on science, while
However, the productivity returns generated by CambridgeSoft plans, implements and manages your
technology environment.
an investment in systems training can provide
dramatic returns. CambridgeSoft offers training in Ultra Services
the following ways: The Ultra Services program is CambridgeSofts
On-site real time training through our profes- personalized, premium service for supporting our

All specifications subject to change without notice.


US 1 800 3157300 INTL 1 617 5889300 FAX 1 617 5889390 EMAIL info@cambridgesoft.com
EU 00 800 875 20000 UK +44 1223 464900 JP 0120 731 800 WWW www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA

ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
SERVICES

Training & Support


Educational Training and Technical Support
customers. Organizations can take advantage of both
telephone and electronic access to CambridgeSofts
support scientists who can address:
Usage and installation questions
Product compatibility and interoperability
questions
Diagnostic review to help isolate the cause of a
problem
Configuration assistance
Planning information for software updates and
upgrades
Assistance with problem resolution
Technical Support & Remote DBA Services
To complete our Management Services offerings,
Technical Support and Remote DBA Services, for
Oracle and SQL Server, are also available.

All specifications subject to change without notice.


US 1 800 3157300 INTL 1 617 5889300 FAX 1 617 5889390 EMAIL info@cambridgesoft.com
EU 00 800 875 20000 UK +44 1223 464900 JP 0120 731 800 WWW www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA

ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
Chem & Bio Office
Desktop Software to Enterprise Solutions

KNOWLEDGE CHEMICAL BIOLOGICAL SCIENTIFIC


MANAGEMENT INFORMATICS INFORMATICS DATABASES

Desktop

E-Notebook CombiChem Inventory Registration DocManager BioAssay ChemACX The Merck


Enterprise Enterprise Enterprise Enterprise Enterprise & BioViz Database Index

E-Signatures 21CFR11 GxP Oracle Cartridge BioSAR Sigma-Aldrich Scientific


IP Protection Compliance Validation or SQL DB Enterprise MSDS Databases

Enterprise Enterprise

Research, Discovery, Development, Trials & Manufacturing


Enterprise Solutions include ChemOffice, with Oracle Cartridge, and ChemOffice Workgroup, based on SQL Server to help
organizations from small workgroups to large enterprises collaborate and share information more effectively.
Desktop Software includes ChemOffice, a powerful suite of software, consisting of ChemDraw, Chem3D, ChemFinder and
ChemACX for chemists, BioDraw, BioAssay and BioViz for biologists, and Inventory and E-Notebook.
Knowledge Management with E-Notebook, including Reaction Explorer, CombiChem, E-Signatures for intellectual property
protection and 21CFR11 Compliance, streamlines daily record-keeping with rigorous security and efficient archiving.
Chemical Informatics, including Registration, organizes new compound information. Inventory provides complete management
of chemical and biological inventories including GxP Validation. DocManager indexes chemical structures in documents.
BioIogical Informatics scientists use BioAssay, BioViz, BioSAR and BioDraw to set up biological models and visualize
information, generate spreadsheets correlating structure and activity, search by structure, and draw and annotate pathways.
Scientific Databases include the ChemACX Database of commercially available chemicals and Sigma-Aldrich MSDS.
The Merck Index and other scientific databases provide information about chemicals, their properties, and reactions.
Professional Services includes custom development, system deployment, educational training, and technical support for
pharmaceutical, biotechnology, and chemical customers, including government and academia, by experienced staff.

Web www.cambridgesoft.com Email info@cambridgesoft.com


America 1 800 3157300 UK +44 1223 464900
Europe 00 800 875 20000 Germany +49 69 2222 2280
Japan 0120 731 800 France +33 1 70 71 98 80
ChemBioOffice.Com
CS Chem3D

for Windows Quick Reference


SCREEN ELEMENTS
Model Display Demo
Toolbar Toolbar

Computation
Tools Palette Toolbar
Model
Explorer

ChemDraw
Model Window
Window

Spectrum
Viewer

Dihedral
Driver

TOOLBARS

Building Toolbar Demo Toolbar


Single Triple Build
Translate Zoom Bond Bond From Text Rock Speed Stop

Select Spin

Rotate Move Double Dummy Eraser Select Amplitude


Objects Bond Bond Axis

Model Display Toolbar Calculation Toolbar


Background Depth View Serial Full Screen
Effect Stereo Fading Axes Numbers Display Start Stop

Display
Mode

Background RedBlue Perspective Model Atom Residue Run MM2


Color Axes Label Labels Minimization
WORKING WITH SELECTIONS
If you want to Heres how
Select an atom or bond Click an atom in the Model Explorer. SHIFT+CLICK the adjacent atom

add atoms and bonds to the selects Use SHIFT+CLICK or CTRL+CLICK in the Model Explorer

remove atoms and bonds from the selection SHIFT+CLICK or CTRL+CLICK selected atoms

select several atoms and bonds Drag in the Model Explorer next to the atoms

deselect all atoms and bonds Click in an empty space in the Model Explorer

BUILDING TECHNIQUES
Change a bond type Drag over the bond using a different bond tool

Change an atom type using the Replacement Text box With Text Tool, click atom, type atom type (e.g. H Enol), press ENTER

Change an element using the Replacement Text box With Text Tool, click atom, type an element (e.g. N), press ENTER

Reserialize atoms using the Replacement Text box With Text Tool, click atom, type a starting number, press ENTER

Add a substructure using the Replacement Text box With Text Tool, click atom, type a substructure (e.g. OEt), press ENTER

Create a dummy atom using a bond tool Click and drag using the Uncoordinated Bond Tool

Move an atom Drag the atom with the Move tool

Move the model in the window Drag the model with the Transform tool

Pull atoms toward you Drag the atom with the Move tool

Push atoms away from you Drag the atom with the Move tool

Convert a ChemDraw structure to a model Draw structure in ChemDraw window

Place a picture of a model in ChemDraw Select the entire model (CTRL+A) then Copy As from Edit Menu

Convert a model into a ChemDraw structure Select the entire model(CTRL+A) then Copy As from Edit Menu

ROTATING TECHNIQUES
Open the rotation dial Click the arrow on the right of the rotation icon

Rotate a specified amount Select axis to be rotated; drag rotation dial hand to desired position

Rotate selected fragments Select a dihedral rotation on the rotation dial; drag rotation dial hand

Rotate all fragments, regardless of selection Drag a rotation bar

Save rotation frames as a movie Select a Spin... command from the Movie menu

Stop recording frames Click the stop button on Movie menu or Computation toolbar

Replay recorded frames Click the start button on the Movie menu(or toolbar)

Create a rotating demo Use the Demo toolbar

We b w w w. c a m b r i d g e s o f t . c o m Email info@cambridgesoft.com
America 1 800 3157300 UK +44 1223 464900
Europe 00 800 875 20000 Germany +49 69 2222 2280
Japan 0120 731 800 France +33 1 70 71 98 80
IWE 07381 0512
ChemBioOffice.Com
CS ChemFinder

for Windows Quick Reference


SCREEN ELEMENTS
Title Bar Record Toolbar

Menu Bar
Search Toolbar
Main Toolbar
Text Toolbar
Main Form
Form Toolbar Framed Data Box

Structure Window
Subform

Explorer Window

Favorites Tab
Table Header
Queries Tab

New Record
Indicator

Status Bar Total DB Size

Data Read-only Query Current Current List Size


Table Indicator Indicator Record

TOOLBARS
New Save BIOVIZ
Form Form Paste Redo Print Print

Database
Wizard
Open Cut Copy Undo Layout Switch to
Form Mode Table

Enter Retrieve Previous Restore


Query All Query List
Right-click in the plot,
and choose Properties
Find to modify the plot
List
Find Find Save Restore Over
Selection
Current List Previous Current
Tool Frame Text Button Subform
Molecule List List

Previous Next Add Commit


Grid
Omit Data Picture Boolean
First Framed
Record Box Box
Go To Last Undo Delete
QUICK START
The following instructions are intended to give you a quick start using CS ChemFinder. For more detailed instructions, see the
CS ChemFinder Users Guide.

Creating a Database Searching


1. Create an empty form by selecting New from the File 1. On the Search toolbar, click the Enter Query button. The
menu. form is cleared.
2. Right-click in the form and choose Data Source. 2. To enter a structural query, double-click in the Structure
3. Click Create Database. Data Box. If the Structure Data Box is set to ChemFinder
style, ChemDraw will open. Create a structure in
4. Name your database (.MDB file), and click OK, then click ChemDraw and use Ctrl+W to return to ChemFinder. If
OK in the Form Properties dialog box. the Structure Data Box is set to ChemDraw style, a
Four fields are created automatically: MolID, Structure, ChemDraw toolbar will appear. Create a structure directly
Formula, and MolWeight. in the Structure Data Box, then click outside the box to
To create other fields, see Creating New Fields below. continue.
3. To enter an alphanumeric query: click the data box you
want to search and type the query in the data box.
Creating New Fields
4. Choose the type of search you want from the Search menu.
1. Right-click in the form and choose Properties.
5. Click the Search button on the Search toolbar.
2. On the Field tab of the Form Properties dialog box, click
Create Field. 6. Click the Retrieve All button on the Search toolbar to
browse the full database.
3. Type a field name, type, and width. Click OK.
7. Use the Queries panel in the Explorer window to manage
4. To assign the new field: right-click on the appropriate data
your searches.
box and choose the field.

Importing Data from SDFiles


Creating a Form
1. Open an existing or blank form.
1. Double-click a field in the Database panel of the Explorer
window. The field is added to the form. 2. Point to Import on the File menu, and choose SDFile.
2. Use the selection tool to select and drag the field boxes to 3. Choose your .SDF file. Click OK.
where you want them in the form. 4. Select your import options (Overwrite, Append, or Merge).
3. Choose Save from the File menu to save your form as a 5. To edit a field, double-click its name in the left pane.
CFW file.
6. Click OK.

Adding Records and Entering Data


Using Your Form with an Existing Database
1. On the Record toolbar, click the Add Record button. The
form is cleared. 1. Right-click in a field box, and choose Data Source.

2. To enter structures: double-click in the Structure Box acti- 2. Choose Open Database in the Box Properties dialog box.
vate the ChemDraw toolbar. Click outside the Structure 3. Choose a database (.MDB file) and click Open.
Box when you have completed drawing your structure.
4. In the left pane of the Database tab, click the field you
3. To enter alphanumeric data: click in the data box and type want to assign to the data box you selected in Step 1.
the new data.
5. Click OK.
4. When you are finished, click Commit Changes or Undo
6. To assign fields to other data boxes: right-click on a data
Changes. If you have more than two records, you can
box and choose a field.
Commit Changes by moving to another record using the
Record tools.
We b w w w. c a m b r i d g e s o f t . c o m Email info@cambridgesoft.com
America 1 800 3157300 UK +44 1223 464900
Europe 00 800 875 20000 Germany +49 69 2222 2280
Japan 0120 731 800 France +33 1 70 71 98 80
IWE 05061 0512
ChemBioOffice.Com
CS E-Notebook
for Windows Quick Reference
SCREEN ELEMENTS

Title Bar Menu Bar Navigation Toolbar Search Button


Close Page Help Button

New Page
Section
Collection Tree Tabs
Save Button

New Section
Button
Next Step
Button Pages in
Reaction
Tab

History
Pane

COLLECTION MENU

Browsing Options
SECTION MENU
Import XML File
Export XML File Open annotation
dialog Copy & Paste
Section
Paste a Copy Move
Paste a of Original Section
Shortcut
Duplicate
Delete
Rename
Alter Location Export
in Collection Tree Print
Refresh

View Previous
Versions
View Properties
such as Creation
Date
QUICK START

Creating an Electronic Notebook


1. From the Start menu select ChemOffice and then click on E-Notebook
2. Enter your username and password if prompted.
3. To create a Notebook, right-click your user at the top of the collection tree on the left. Select New,
then Notebook.

Closing and Printing Notebook Entries


1. To close a Page so that it can no longer be modified, right-click the Page and the tree, and select
Close from the menu.
2. To Print, right-click the Page, and select Print from the menu. Then follow the print dialog box.

Using a Reaction Section


1. Make sure that the reaction tab is selected. (Click the reaction tab to select it).
2. To draw a reaction, click in the reaction box and use the ChemDraw tools.
3. The stoichiometry table is updated as you draw the reaction. To edit the table, type new values into
the cells, and the table will update automatically.
4. To add a reaction property, right-click the table and select Add Property.
5. Right-click in the procedure text to access the AutoText menu.

Creating new Pages and Sections


1. To create a new Page, right-click the Notebook in the collection tree and select New, then Page.
2. To add a new section to a Page, click the Page in the collection tree. Then click the New Section but-
ton, and select the type of section you wish to add.

Using a Spectra Section


1. Make sure that the Spectra tab is selected.
2. Click the New Section button to add a new subtab for a Spectrum
3. Click the Import/Export button, and follow the dialog to select the spectrum to import.

Searching Notebook Entries


1. To perform a search, click the Search button at the top of the screen.
2. From the Search for list, select the type of search you wish to perform.
3. Enter your search criteria, and click Search Now.

We b w w w. c a m b r i d g e s o f t . c o m Email info@cambridgesoft.com
America 1 800 3157300 UK +44 1223 464900
Europe 00 800 875 20000 Germany +49 69 2222 2280
Japan 0120 731 800 France +33 1 70 71 98 80
IWE 09203 0512
CS Software Problem Report
For faster response and accuracy, use the Web:
www.cambridgesoft.com/services/mail
USER INFORMATION (Please Print Legibly) Submit this form via
Name WWW www.cambridgesoft.com/services/mail
Title EMAIL support@cambridgesoft.com
Firm FAX 1 617 5889360
Street MAIL CambridgeSoft, 100 CambridgePark Dr.
City State Zip Cambridge, MA 02140 USA
Country
Tel Fax
Email

DETAILS OF THE PROBLEM

SYSTEM CONFIGURATION
SOFTWARE
Application Name
Please cut here or photocopy page.

Version Number
Serial Number

SYSTEM
Windows (version)
MacOs (version)
Web Browser(s) (version)
!

US 1 617 588-9300 FAX 1 617 5889390 WWW www.cambridgesoft.com


EU 00 800 875 20000 FAX +44 1223 464990 EMAIL info@cambridgesoft.com
MAIL 100 CambridgePark Drive Cambridge, MA 02140 USA
CS ChemOffice

Desktop to Enterprise Solutions

ChemOffice Ultra, desktop


edition, includes it all, with
ChemDraw Ultra, Chem3D Ultra,
BioOffice Ultra, Inventory Ultra,
E-Notebook Ultra and ChemInfo Ultra for
a seamlessly integrated suite. Draw reaction
mechanisms for publication and visualize
3D molecular surfaces, orbitals and
molecular properties. Features include
The Merck Index, ChemACX Database,
CombiChem/Excel, ChemDraw/Excel, and BioViz.
Bring your work to the web or query online
databases with the ChemDraw ActiveX/Plugin.
C h e m O f f i c e E n t e r p r i s e is a comprehensive
knowledge management and informatics solution,
covering elextronic notebooks, biological screening,
chemical registration and more over your intranet.
Enterprise Ultra includes E-Notebook for record
keeping, BioAssay for low and high-throughput
screening, integrated plate inventory, Inventory for
reagents, BioSAR for SAR reports , Registration
system and ChemACX Database of available chemicals.
Technologies include ChemDraw ActiveX and Oracle Cartridge.

US 1 617 588-9300 FAX 1 617 5889390 WWW www.cambridgesoft.com


EU 00 800 875 20000 FAX +44 1223 464990 EMAIL info@cambridgesoft.com
MAIL 100 CambridgePark Drive Cambridge, MA 02140 USA
MAE 04980 0408

Вам также может понравиться