Difference between revisions of "Avogadro 0.8.1"

Revision as of 11:09, 4 June 2008

Avogadro version 0.8.1 was released on June ??, 2008.

What's New

The following list includes some of the changes since Avogadro 0.8.0.

Rendering

• New dipole moment display type (from Gaussian, GAMESS and Q-Chem output).
• Orbitals are cleared with the rest of the molecule.

Editing Tools

• Several bug fixes for the "Insert Fragment..." dialog. Insert smiles available again.
• More robust adjust hydrogens feature, still not perfect.

Commands / Extensions

• Improved unit cell dialog.
• Conformer energies are now displayed.

Interface

• Add here

Windows

• Improved installer (thanks to Uwe Stöhr).
• Many windows specific bug fixes.

General

• Add here
• Fixed several possible crashes and added additional "defensive programming."
• Many, many bug fixes and small enhancements.

Dependencies

1. Eigen http://eigen.tuxfamily.org/ -- for compiling. Not required for running Avogadro.
2. OpenBabel 2.2.0b5 or later http://openbabel.org
   1. NOTE This is available as a snapshot
3. CMake 2.4.8 or later http://www.cmake.org
4. Qt 4.3.x or later http://www.trolltech.com

Building

untar the source

tar xvjf avogadro-0.8.1.tar.bz2

make the build directory

cd avogadro-0.8.1
mkdir build

configure

cd build
cmake ..

CMake takes a few optional parameters:

• -DCMAKE_INSTALL_PREFIX= : specify the installation prefix (default /usr)
• -DOPENBABEL2_LIBRARIES= : specify the OpenBabel2 libraries
• -DOPENBABEL2_INCLUDE_DIR : specify the OpenBabel2 include directory
• -DEIGEN_INCLUDE_DIR : specify the Eigen include directory

For more information see the CMake website; http://www.cmake.org/

build

make

install

make install

Known Issues & Limitations

This release is an early beta release and is intended to gain feedback and interest in the project.

The code currently expects to be editing one 3D molecule per file with one coordinate set. This means:

• Editing a multi-molecule file will only edit the first molecule. Saving will overwrite all records except the first.
• Opening a 2D file will not result in 3D coordinates. Opening a SMILES file will not create 3D coordinates either.
• Saving to a 2D format will not necessarily produce correct 2D stereochemistry.

Rendering

• Only one color scheme is currently available, although the code allows different types to be implemented. Suggestions are welcome.

Tools / Building

• Several builder features are not implemented, including:
  • Protein and biomolecule builders (Geoff?)
  • Crystal structure builder
  • Carbon Nanotube builder
  • Z-matrix editor

Interface

• Views cannot yet be removed into separate windows. In future releases, you will be able to have separate views of the same molecule in separate windows.
• Export graphics will only save the current resolution in the window in bitmap form. Vector formats (SVG, PS, PDF) and other formats are intended to be implemented in the future.

Commands

A select list of commands is currently available, mostly as examples of what can be done using the Avogadro framework.

• Only the GAMESS and Gaussian input generation is complete (as an example). Other programs are intended for support in future releases.

Windows Build

• The H2Methyl extension causes crashes and was excluded from this build.

Troubleshooting

Problem: OpenBabel2 / Eigen libraries are not found.

Solution: Most likely the cause of this problem is due to non-standard install locations. Additionally, the detection system for finding libraries and includes is not flawless. The most likely remedy is manually specify the library location and include directory for the package using the cmake arguments specified above.