diff --git a/.doctrees/develop/scripts/index.doctree b/.doctrees/develop/scripts/index.doctree
index ae2cd006..dc0d3256 100644
Binary files a/.doctrees/develop/scripts/index.doctree and b/.doctrees/develop/scripts/index.doctree differ
diff --git a/.doctrees/docs/SUMMARY.doctree b/.doctrees/docs/SUMMARY.doctree
index 8fe93fb8..44e765c6 100644
Binary files a/.doctrees/docs/SUMMARY.doctree and b/.doctrees/docs/SUMMARY.doctree differ
diff --git a/.doctrees/docs/display-types/coloring-molecules.doctree b/.doctrees/docs/display-types/coloring-part-of-a-molecule.doctree
similarity index 94%
rename from .doctrees/docs/display-types/coloring-molecules.doctree
rename to .doctrees/docs/display-types/coloring-part-of-a-molecule.doctree
index c486ab1f..8a06d4f1 100644
Binary files a/.doctrees/docs/display-types/coloring-molecules.doctree and b/.doctrees/docs/display-types/coloring-part-of-a-molecule.doctree differ
diff --git a/.doctrees/docs/display-types/index.doctree b/.doctrees/docs/display-types/index.doctree
index 9ee2abc7..439035c2 100644
Binary files a/.doctrees/docs/display-types/index.doctree and b/.doctrees/docs/display-types/index.doctree differ
diff --git a/.doctrees/docs/getting-started/drawing-molecules.doctree b/.doctrees/docs/getting-started/drawing-molecules.doctree
index 2ccd4924..95d31a6b 100644
Binary files a/.doctrees/docs/getting-started/drawing-molecules.doctree and b/.doctrees/docs/getting-started/drawing-molecules.doctree differ
diff --git a/.doctrees/docs/getting-started/index.doctree b/.doctrees/docs/getting-started/index.doctree
index 298bae89..90a278d9 100644
Binary files a/.doctrees/docs/getting-started/index.doctree and b/.doctrees/docs/getting-started/index.doctree differ
diff --git a/.doctrees/docs/getting-started/introduction.doctree b/.doctrees/docs/getting-started/introduction.doctree
index d4f1c4fc..7f3125f0 100644
Binary files a/.doctrees/docs/getting-started/introduction.doctree and b/.doctrees/docs/getting-started/introduction.doctree differ
diff --git a/.doctrees/docs/getting-started/making-selections.doctree b/.doctrees/docs/getting-started/making-selections.doctree
index d32249bc..06a4af13 100644
Binary files a/.doctrees/docs/getting-started/making-selections.doctree and b/.doctrees/docs/getting-started/making-selections.doctree differ
diff --git a/.doctrees/docs/optimizing-geometry/index.doctree b/.doctrees/docs/optimizing-geometry/index.doctree
index aaae703f..8ef85c3b 100644
Binary files a/.doctrees/docs/optimizing-geometry/index.doctree and b/.doctrees/docs/optimizing-geometry/index.doctree differ
diff --git a/.doctrees/docs/optimizing-geometry/force-fields.doctree b/.doctrees/docs/optimizing-geometry/molecular-mechanics.doctree
similarity index 82%
rename from .doctrees/docs/optimizing-geometry/force-fields.doctree
rename to .doctrees/docs/optimizing-geometry/molecular-mechanics.doctree
index c0dfe05d..4f7d2891 100644
Binary files a/.doctrees/docs/optimizing-geometry/force-fields.doctree and b/.doctrees/docs/optimizing-geometry/molecular-mechanics.doctree differ
diff --git a/.doctrees/docs/tools/draw-tool.doctree b/.doctrees/docs/tools/draw-tool.doctree
index db963417..a9a842d0 100644
Binary files a/.doctrees/docs/tools/draw-tool.doctree and b/.doctrees/docs/tools/draw-tool.doctree differ
diff --git a/.doctrees/environment.pickle b/.doctrees/environment.pickle
index 762f1a5a..4a8a7628 100644
Binary files a/.doctrees/environment.pickle and b/.doctrees/environment.pickle differ
diff --git a/.doctrees/install/versions/v198.doctree b/.doctrees/install/versions/v198.doctree
index f5038ab2..642b7626 100644
Binary files a/.doctrees/install/versions/v198.doctree and b/.doctrees/install/versions/v198.doctree differ
diff --git a/_images/Ethanol.png b/_images/Ethanol.png
new file mode 100644
index 00000000..9c5d6465
Binary files /dev/null and b/_images/Ethanol.png differ
diff --git a/_images/FileImportByName.png b/_images/FileImportByName.png
new file mode 100644
index 00000000..ddc06311
Binary files /dev/null and b/_images/FileImportByName.png differ
diff --git a/_images/FileOpen.png b/_images/FileOpen.png
new file mode 100644
index 00000000..3799c3b5
Binary files /dev/null and b/_images/FileOpen.png differ
diff --git a/_images/IntroToAvogadro.png b/_images/IntroToAvogadro.png
new file mode 100644
index 00000000..85c04eb4
Binary files /dev/null and b/_images/IntroToAvogadro.png differ
diff --git a/_images/install-script.png b/_images/install-script.png
new file mode 100644
index 00000000..d93769dd
Binary files /dev/null and b/_images/install-script.png differ
diff --git a/_images/plugin-download.png b/_images/plugin-download.png
new file mode 100644
index 00000000..a417ac6a
Binary files /dev/null and b/_images/plugin-download.png differ
diff --git a/_sources/develop/scripts/index.md.txt b/_sources/develop/scripts/index.md.txt
index 0da48113..d0b3b36f 100644
--- a/_sources/develop/scripts/index.md.txt
+++ b/_sources/develop/scripts/index.md.txt
@@ -19,11 +19,11 @@ Suggestions either for new types of scripts or new functions are always welcome.
Scripts can either be installed manually, by dragging to the Avogadro window:
-![installing script](../_static/install-script.png)
+![installing script](../../_static/install-script.png)
Scripts can also be installed from GitHub repositories through the "Download Plugins…" command:
-![plugin download](../_static/plugin-download.png)
+![plugin download](../../_static/plugin-download.png)
```{toctree}
---
@@ -32,8 +32,8 @@ hidden: true
---
install
interface
-commands
charges
+commands
energy
formats
generators
diff --git a/_sources/docs/display-types/coloring-molecules.md.txt b/_sources/docs/display-types/coloring-part-of-a-molecule.md.txt
similarity index 100%
rename from _sources/docs/display-types/coloring-molecules.md.txt
rename to _sources/docs/display-types/coloring-part-of-a-molecule.md.txt
diff --git a/_sources/docs/getting-started/drawing-molecules.md.txt b/_sources/docs/getting-started/drawing-molecules.md.txt
index 7c138f20..119b3ec1 100644
--- a/_sources/docs/getting-started/drawing-molecules.md.txt
+++ b/_sources/docs/getting-started/drawing-molecules.md.txt
@@ -1,34 +1,39 @@
# Drawing Molecules
-Molecules are built and edited with the draw tool.
+Molecules are built and edited with the [draw tool](draw-tool), which allows a "free-hand" sketch of new molecules.
-
+```{tip} **New in 2.0**
+You can also use the new [template tool](template-tool) which makes it easier
+to attach functional groups or assemble inorganic / organometallic complexes.
+```
+
+![Screenshot of the draw tool](../../_static/draw-tool.png")
Left clicking on the display will allow you to begin your journey into molecule creation. A left click will generate a carbon atom. A right click will delete the atom.
-
+![](../../_static/first-carbon.png")
Left clicking the initial atom and dragging your mouse will generate a bond to another carbon atom.
-
+![](../../_static/drag-to-build.png")
Avogadro uses carbon as the default element. A different element can be selected through the "Element" drop down menu. Typing the atomic symbol (e.g., "O" for Oxygen, "A-s" for Arsenic) is a shortcut for changing the selected element.
-
+![](../../_static/pick-an-element.png")
Let's say you wanted to create water. You can either type in "O", or select "Oxygen (8)" from the drop down menu, and then click on the black display.
Left clicking on an atom that has already been generated will also change the element. In this case, clicking on the initial carbon atom changed it into an oxygen atom.
-
+![](../../_static/tutorial-water.png")
If the "Adjust Hydrogens" box is checked, hydrogen atoms in the molecule will be automatically adjusted to satisfy valency (as shown above).
-
+![](../../_static/tutorial-adjust-hydrogens.png")
-Bond order is changed through the "Bond Order" drop down menu, or by typing the numbers "1", "2", or "3". Bonds are added by left clicking on a bond that has already been created. Right clicking on a bond deletes the bond, and the atom it's bonded to.
+Bond order is changed through the "Bond Order" drop down menu, or by typing the numbers "1", "2", or "3". Bonds are added by left clicking on a bond that has already been created. Right clicking on a bond deletes the bond.
-
+![](../../_static/tutorial-bond-order.png")
```{tip} **New in 2.0**
The default bond order is "Automatic," and will adjust with the length of the bond.
@@ -36,12 +41,14 @@ The default bond order is "Automatic," and will adjust with the length of the bo
### Creating Carbon Dioxide
-Begin drawing the "O-C-O" structure. After the structure is drawn, all you need to do is left click on the bonds. Left clicking on the bonds will create a double bond (shown below).
+Begin drawing the "O-C-O" structure. After the structure is drawn, all you need to do is left click on the bonds. Left clicking on the bonds will create a double bond (shown below).
-
+![](../../_static/tutorial-co2-step1.png")
+![](../../_static/tutorial-co2-step2.png")
+![](../../_static/tutorial-co2-step3.png")
Once you've created your molecule, you can optimize it's geometry through the extensions menu. Selecting the "Extensions" menu, and clicking "Optimize Geometry" will provide your molecule with proper bond lengths and angles.
-
+![](../../_static/ada26872-ede7-4601-bd4e-d790c10ad614.png")
You now know the basics of drawing a molecule in Avogadro!
diff --git a/_sources/docs/getting-started/index.md.txt b/_sources/docs/getting-started/index.md.txt
index 849274b2..d03159d3 100644
--- a/_sources/docs/getting-started/index.md.txt
+++ b/_sources/docs/getting-started/index.md.txt
@@ -1,11 +1,16 @@
# Getting Started
+* [Introduction](introduction)
+* [Drawing Molecules](drawing-molecules)
+* [Making Selections](making-selections)
+
```{toctree}
---
caption: Getting Started
+hidden: true
---
introduction
drawing-molecules
making-selections
-```
\ No newline at end of file
+```
diff --git a/_sources/docs/getting-started/introduction.md.txt b/_sources/docs/getting-started/introduction.md.txt
index d044ec46..d582dea0 100644
--- a/_sources/docs/getting-started/introduction.md.txt
+++ b/_sources/docs/getting-started/introduction.md.txt
@@ -6,23 +6,28 @@ This manual was largely made on a Mac, but the interface should be very similar
When you initially open Avogadro you will be presented with a screen such as the one shown below.
-
+![Screenshot of main Avogadro window indicating tools, display options, and drawing area](../../_static/IntroToAvogadro.png)
## Opening a File
-The first thing you will probably want to do is open a file and navigate around the molecule. To do this click on the `File` menu and select `Open...`.
+The first thing you will probably want to do is open a file and navigate around the molecule. To do this click on the `File` menu and select `Open...`
-
+![Screenshot of File menu indicating Open menu item](../../_static/FileOpen.png)
-You can then look through the files on your disk and find an appropriate chemical file. Thanks to Open Babel, a large number of file types are supported including CML, XYZ, SDF, Mol2, PDB etc. Several example molecules are supplied with Avogadro.
+You can then look through the files on your disk and find an appropriate chemical file. Thanks to [Open Babel](https://openbabel.org/), a large number of file types are supported including CML, XYZ, SDF, Mol2, PDB etc.
-
+## Importing by Name
-The screen shot above shows the ethanol.cml file opened up and displayed using the default Ball and Stick display type. Notice that when a new file is opened Avogadro switches from the Draw Tool to the Navigate Tool, which allows you to view the molecule without editing it.
+Avogadro also offers support to download molecules from online sources. One of the most useful is the "Import" then "Download by Name..." which uses the [NIH Chemical Resolver](https://cactus.nci.nih.gov/chemical/structure).
+
+![Screenshot of the File menu indicating Import => Download By Name](../../_static/FileImportByName.png)
+
+The screen shot shows the an ethanol file opened up and displayed using the default Ball and Stick display type. Notice that when a new file is opened Avogadro switches from the Draw Tool to the Navigate Tool, which allows you to view the molecule without editing it.
+
+![Screenshot of Avogadro window after opening or importing ethanol molecule](../../_static/Ethanol.png)
## Navigation
You can zoom in/out using the scroll wheel on your mouse or holding down the middle mouse button and moving the mouse cursor up/down. You can rotate the view by holding down the left mouse button and moving the mouse cursor. You can also translate the view by holding down the right mouse button and moving the mouse cursor.
Note: if your mouse only has one or two buttons you can also use the modifier keys \(shift and control\) along with the left mouse button to perform actions where you would normally use the middle or right mouse buttons respectively.
-
diff --git a/_sources/docs/getting-started/making-selections.md.txt b/_sources/docs/getting-started/making-selections.md.txt
index 0b293ab6..c9819de0 100644
--- a/_sources/docs/getting-started/making-selections.md.txt
+++ b/_sources/docs/getting-started/making-selections.md.txt
@@ -24,5 +24,4 @@ Clicking and dragging your cursor is another way molecules, or fragments of mole
![](../../_static/300264d3-31a2-4380-8c24-205fe639ae4d.png)
-More information on selections can be found in the "Tools" section.
-
+More information on selections can be found in the ["Tools" section](tools).
diff --git a/_sources/docs/optimizing-geometry/force-fields.md.txt b/_sources/docs/optimizing-geometry/molecular-mechanics.md.txt
similarity index 100%
rename from _sources/docs/optimizing-geometry/force-fields.md.txt
rename to _sources/docs/optimizing-geometry/molecular-mechanics.md.txt
diff --git a/_sources/docs/tools/draw-tool.md.txt b/_sources/docs/tools/draw-tool.md.txt
index 9610a5ed..a20cd18f 100644
--- a/_sources/docs/tools/draw-tool.md.txt
+++ b/_sources/docs/tools/draw-tool.md.txt
@@ -1,3 +1,5 @@
+(draw-tool)=
+
# Draw Tool
## 1. Creating a Molecule
diff --git a/_sources/install/versions/v198.md.txt b/_sources/install/versions/v198.md.txt
index ba07a756..9979b73d 100644
--- a/_sources/install/versions/v198.md.txt
+++ b/_sources/install/versions/v198.md.txt
@@ -2,15 +2,16 @@
# Release Notes v1.98.0
-## Highlights (tldr)
+## 🌟 Highlights (tldr)
+- Integration with 3Dconnexion input devices on Mac and Windows
+ - Many thanks to 3Dconnexion and Patryk Skowroński (@pskowronskiTDx)
- Improved rendering including ambient occlusion and real-time shadows
- New template tool for assembly of inorganic complexes and ligands or attaching functional groups (e.g, "click to add phenyl group") (#1075)
- [New forcefield framework](https://discuss.avogadro.cc/t/new-force-field-framework/4921?u=ghutchis) supporting external Python scripts (e.g., XTB, ASE, ANI-2x, etc.) (#1370)
- Better perception of bond orders
-- Align tool #1364
+- Align tool (#1364)
- Manual translate / rotate dialog
-- Integration with 3Dconnexion input devices on Mac and Windows
- Fetch molecule names from PubChem, including markup
- Commands to create centroid and center-of-mass points
- Improved “fill unit cell” (#1375)
@@ -18,13 +19,13 @@
- Build improvements, including initial support for Qt6 and VTK9 fixes @cryos
- Integrated Orca ouputfile support (from Orca-enhanced Avogadro) (#1326)
- Add a generic compchem output reader (i.e., should automatically handle `.out` and `.log` files) (#1347)
-- Initial scripting support (e.g., used to generate preview images) (#1344)
+- Initial scripting support (e.g., used to generate preview images through a directory) (#1344)
- Several updated toolbar icons
## ✨ Features
- Reading Gaussian fchk vibrations when present @ghutchis (#1380)
-- Add support for atom labels (e.g., C1, C2, H1…) in the coordinate editor @ghutchis (#1362)
+- Add support for atom labels (e.g., C1, C2, H1…) in the coordinate editor using "L" symbol @ghutchis (#1362)
- More pybind methods and properties @ghutchis (#1342)
- Perceive bond orders when requested by Python scripts @ghutchis (#1211)
- Support for color PLY format @spotenza2016 (#1177)
@@ -61,6 +62,10 @@
## 🐛 Bug Fixes
+- Add molden as a possible reader for generic `.out` files @ghutchis (#1409)
+- Fix a few UI / UX issues in the surface dialog @ghutchis (#1404)
+- Fix spurious "change layer" crash with the selection tool (#1406) (#1408)
+- Fix for reading imaginary vibrational frequencies in ORCA outputs. @dtelsing (#1398)
- Ensure the VTK plot widget has a minimum size @cryos (#1231)
- Add uncommon "ent" extension for PDB entries @ghutchis (#1144)
- Put charge / spin in one line with two labels @ghutchis (#1143)
@@ -146,4 +151,4 @@
## Credits
-Thanks to many contributors, including: @DDinghoya, @DasJott, @Lisapple, @M3CG, @NorwayFun, @OfficerBrasidas, @SantosSi, @StefanBruens, @Surajjalpun2002, @WilliamBeltranC, @Xav83, @aerkiaga, @ahenao, @anmorgunov, @awvwgk, @balducci, @berquist, @comradekingu, @cryos, @dependabot, @dependabot[bot], @dominikflorjan, @dtelsing, @e-kwsm, @ghutchis, @github-actions, @grsousajunior, @hgokhanb, @koenr, @matterhorn103, @mck89, @milotype, @nbehrnd, @nicolazanna, @ovari, @pskowronskiTDx, @salif, @simmon-nplob, @spotenza2016, @tacitcoast, @tictactoe101, @trollixx, @vamsibarnala, @weblate, @yurivict, Ajith, Alejandro Díaz-Moscoso, Alex B, Eisuke Kawashima, FAN JI, Hugel, Jörg S, Kateryna Golovanvoa, Patryk Skowroński, Shusong Zhang, Translator, gallegonovato and victor dargallo
+Thanks to many contributors, including: @DDinghoya, @DasJott, @Lisapple, @M3CG, @NorwayFun, @OfficerBrasidas, @SantosSi, @StefanBruens, @Surajjalpun2002, @WilliamBeltranC, @Xav83, @adityaomar3, @aerkiaga, @ahenao, @anmorgunov, @awvwgk, @balducci, @berquist, @comradekingu, @cryos, @dependabot, @dominikflorjan, @dtelsing, @e-kwsm, @ghutchis, @github-actions, @grsousajunior, @hgokhanb, @koenr, @matterhorn103, @mck89, @milotype, @nbehrnd, @nicolazanna, @ovari, @pskowronskiTDx, @salif, @simmon-nplob, @spotenza2016, @tacitcoast, @tictactoe101, @trollixx, @vamsibarnala, @weblate, @yurivict, Ajith, Alejandro Díaz-Moscoso, Alex B, Eisuke Kawashima, FAN JI, Hugel, Jörg S, Kateryna Golovanvoa, Patryk Skowroński, Shusong Zhang, Weblate Translators, gallegonovato and victor dargallo
diff --git a/_static/Ethanol.png b/_static/Ethanol.png
new file mode 100644
index 00000000..9c5d6465
Binary files /dev/null and b/_static/Ethanol.png differ
diff --git a/_static/FileImportByName.png b/_static/FileImportByName.png
new file mode 100644
index 00000000..ddc06311
Binary files /dev/null and b/_static/FileImportByName.png differ
diff --git a/_static/FileOpen.png b/_static/FileOpen.png
new file mode 100644
index 00000000..3799c3b5
Binary files /dev/null and b/_static/FileOpen.png differ
diff --git a/_static/IntroToAvogadro.png b/_static/IntroToAvogadro.png
new file mode 100644
index 00000000..85c04eb4
Binary files /dev/null and b/_static/IntroToAvogadro.png differ
diff --git a/_static/drag-to-build.png b/_static/drag-to-build.png
new file mode 100644
index 00000000..853e4929
Binary files /dev/null and b/_static/drag-to-build.png differ
diff --git a/_static/draw-tool.png b/_static/draw-tool.png
new file mode 100644
index 00000000..ba0e1092
Binary files /dev/null and b/_static/draw-tool.png differ
diff --git a/_static/first-carbon.png b/_static/first-carbon.png
new file mode 100644
index 00000000..b17e901e
Binary files /dev/null and b/_static/first-carbon.png differ
diff --git a/_static/pick-an-element.png b/_static/pick-an-element.png
new file mode 100644
index 00000000..626b7385
Binary files /dev/null and b/_static/pick-an-element.png differ
diff --git a/_static/tutoria-co2-step2.png b/_static/tutoria-co2-step2.png
new file mode 100644
index 00000000..a37f75d0
Binary files /dev/null and b/_static/tutoria-co2-step2.png differ
diff --git a/_static/tutorial-adjust-hydrogens.png b/_static/tutorial-adjust-hydrogens.png
new file mode 100644
index 00000000..73406d8e
Binary files /dev/null and b/_static/tutorial-adjust-hydrogens.png differ
diff --git a/_static/tutorial-bond-order.png b/_static/tutorial-bond-order.png
new file mode 100644
index 00000000..5b0f4742
Binary files /dev/null and b/_static/tutorial-bond-order.png differ
diff --git a/_static/tutorial-co2-step1.png b/_static/tutorial-co2-step1.png
new file mode 100644
index 00000000..ee4d7ad4
Binary files /dev/null and b/_static/tutorial-co2-step1.png differ
diff --git a/_static/tutorial-co2-step3.png b/_static/tutorial-co2-step3.png
new file mode 100644
index 00000000..c7840d3c
Binary files /dev/null and b/_static/tutorial-co2-step3.png differ
diff --git a/_static/tutorial-water.png b/_static/tutorial-water.png
new file mode 100644
index 00000000..01539b14
Binary files /dev/null and b/_static/tutorial-water.png differ
diff --git a/develop/scripts/charges.html b/develop/scripts/charges.html
index d62064cd..bdbb8680 100644
--- a/develop/scripts/charges.html
+++ b/develop/scripts/charges.html
@@ -48,8 +48,8 @@
-
-
+
+
@@ -433,8 +433,8 @@
Molecules are built and edited with the draw tool.
-
+
Molecules are built and edited with the draw tool, which allows a “free-hand” sketch of new molecules.
+
+
Tip
+
New in 2.0
+You can also use the new template tool which makes it easier
+to attach functional groups or assemble inorganic / organometallic complexes.
+
+
Left clicking on the display will allow you to begin your journey into molecule creation. A left click will generate a carbon atom. A right click will delete the atom.
-
+
Left clicking the initial atom and dragging your mouse will generate a bond to another carbon atom.
-
+
Avogadro uses carbon as the default element. A different element can be selected through the “Element” drop down menu. Typing the atomic symbol (e.g., “O” for Oxygen, “A-s” for Arsenic) is a shortcut for changing the selected element.
-
+
Let’s say you wanted to create water. You can either type in “O”, or select “Oxygen (8)” from the drop down menu, and then click on the black display.
Left clicking on an atom that has already been generated will also change the element. In this case, clicking on the initial carbon atom changed it into an oxygen atom.
-
+
If the “Adjust Hydrogens” box is checked, hydrogen atoms in the molecule will be automatically adjusted to satisfy valency (as shown above).
-
-
Bond order is changed through the “Bond Order” drop down menu, or by typing the numbers “1”, “2”, or “3”. Bonds are added by left clicking on a bond that has already been created. Right clicking on a bond deletes the bond, and the atom it’s bonded to.
-
+
+
Bond order is changed through the “Bond Order” drop down menu, or by typing the numbers “1”, “2”, or “3”. Bonds are added by left clicking on a bond that has already been created. Right clicking on a bond deletes the bond.
Begin drawing the “O-C-O” structure. After the structure is drawn, all you need to do is left click on the bonds. Left clicking on the bonds will create a double bond (shown below).
-
+
+
+
Once you’ve created your molecule, you can optimize it’s geometry through the extensions menu. Selecting the “Extensions” menu, and clicking “Optimize Geometry” will provide your molecule with proper bond lengths and angles.
-
+
You now know the basics of drawing a molecule in Avogadro!
The first thing you will probably want to do is open a file and navigate around the molecule. To do this click on the File menu and select Open....
-
-
You can then look through the files on your disk and find an appropriate chemical file. Thanks to Open Babel, a large number of file types are supported including CML, XYZ, SDF, Mol2, PDB etc. Several example molecules are supplied with Avogadro.
-
-
The screen shot above shows the ethanol.cml file opened up and displayed using the default Ball and Stick display type. Notice that when a new file is opened Avogadro switches from the Draw Tool to the Navigate Tool, which allows you to view the molecule without editing it.
+
The first thing you will probably want to do is open a file and navigate around the molecule. To do this click on the File menu and select Open...
+
+
You can then look through the files on your disk and find an appropriate chemical file. Thanks to Open Babel, a large number of file types are supported including CML, XYZ, SDF, Mol2, PDB etc.
Avogadro also offers support to download molecules from online sources. One of the most useful is the “Import” then “Download by Name…” which uses the NIH Chemical Resolver.
+
+
The screen shot shows the an ethanol file opened up and displayed using the default Ball and Stick display type. Notice that when a new file is opened Avogadro switches from the Draw Tool to the Navigate Tool, which allows you to view the molecule without editing it.
Avogadro2 comes equipped with a Lennard-Jones (LJ) force field, but you may wish to use a different force field that is more suitable for your chemical system. These force fields are only enabled through interfaces to other programs. This includes:
+
Avogadro2 comes equipped with a Lennard-Jones (LJ) force field, but you may wish to use a different force field that is more suitable for your chemical system. These force fields are only enabled through interfaces to other programs. This includes:
Avogadro uses carbon as the default element. A different element can be selected through the “Element” drop down menu. Typing the atomic symbol (e.g., “A-s” for Arsenic) is a shortcut for changing the selected element.
Let’s say you wanted to create water. You can either type in “O”, or select “Oxygen (8)” from the drop down menu, and then click on the black display.
Left clicking on an atom that has already been generated will also change the element. In this case, clicking on the initial carbon atom changed it into an oxygen atom.
Bond order is changed through the “Bond Order” drop down menu, or by typing the numbers “1”, “2”, or “3”. Bonds are added by left clicking on a bond that has already been created. Right clicking on a bond deletes the bond, and the atom it’s bonded to.
Begin drawing the “O-C-O” structure. After the structure is drawn, all you need to do is left click on the bonds. Left clicking on the bonds will create a double bond (shown below).
Once you’ve created your molecule, you can optimize it’s geometry through the extensions menu. Selecting the “Extensions” menu, and clicking “Optimize Geometry” will provide your molecule with proper bond lengths and angles.