[bcf653] | 1 | /*
|
---|
| 2 | * Project: MoleCuilder
|
---|
| 3 | * Description: creates and alters molecular systems
|
---|
| 4 | * Copyright (C) 2010 University of Bonn. All rights reserved.
|
---|
| 5 | * Please see the LICENSE file or "Copyright notice" in builder.cpp for details.
|
---|
| 6 | */
|
---|
| 7 |
|
---|
| 8 | /** \file builder.cpp
|
---|
[a8bcea6] | 9 | *
|
---|
[a356f2] | 10 | * date: Jan 1, 2007
|
---|
| 11 | * author: heber
|
---|
[a8bcea6] | 12 | *
|
---|
[14de469] | 13 | */
|
---|
| 14 |
|
---|
[bcf653] | 15 | /*! \page Copyright notice
|
---|
| 16 | *
|
---|
| 17 | * MoleCuilder - to create and alter molecular systems
|
---|
[490038] | 18 | * Copyright (C) 2010 University Bonn. All rights reserved.
|
---|
[bcf653] | 19 | *
|
---|
| 20 | */
|
---|
| 21 |
|
---|
[a356f2] | 22 | /*! \mainpage MoleCuilder - a molecular set builder
|
---|
[a8bcea6] | 23 | *
|
---|
[a356f2] | 24 | * This introductory shall briefly make acquainted with the program, helping in installing and a first run.
|
---|
[a8bcea6] | 25 | *
|
---|
[14de469] | 26 | * \section about About the Program
|
---|
[a8bcea6] | 27 | *
|
---|
[a356f2] | 28 | * MoleCuilder is a program, written entirely in C++, that enables the construction of a coordinate set for the
|
---|
| 29 | * atoms making up an molecule. It allows for both building of simple molecules by adding atom-wise giving bond
|
---|
| 30 | * angles and distances or absolute coordinates, but also using them as templates. Regions can be specified and
|
---|
| 31 | * ordered to be filled with a molecule in a certain manner. Greater conglomerations of molecules can be tesselated
|
---|
| 32 | * and recognized as a region themselves to be subsequently surrounded by other (surface solvated) molecules.
|
---|
| 33 | * In the end, MoleCuilder allows the construction of arbitrary nano structures, whether they be crystalline or
|
---|
| 34 | * amorphic in nature.
|
---|
[a8bcea6] | 35 | *
|
---|
| 36 | *
|
---|
[14de469] | 37 | * \section install Installation
|
---|
[a8bcea6] | 38 | *
|
---|
[042f82] | 39 | * Installation should without problems succeed as follows:
|
---|
| 40 | * -# ./configure (or: mkdir build;mkdir run;cd build; ../configure --bindir=../run)
|
---|
| 41 | * -# make
|
---|
| 42 | * -# make install
|
---|
[a8bcea6] | 43 | *
|
---|
[042f82] | 44 | * Further useful commands are
|
---|
| 45 | * -# make clean uninstall: deletes .o-files and removes executable from the given binary directory\n
|
---|
| 46 | * -# make doxygen-doc: Creates these html pages out of the documented source
|
---|
[a356f2] | 47 | * -# make check: Runs an extensive set of unit tests and a testsuite which also gives a good overview on the set of
|
---|
| 48 | * functions.
|
---|
[a8bcea6] | 49 | *
|
---|
[14de469] | 50 | * \section run Running
|
---|
[a8bcea6] | 51 | *
|
---|
[042f82] | 52 | * The program can be executed by running: ./molecuilder
|
---|
[a8bcea6] | 53 | *
|
---|
[a356f2] | 54 | * MoleCuilder has three interfaces at your disposal:
|
---|
| 55 | * -# Textmenu: A simple interactive console-based menu, where awaits your choices and inputs in order to set atoms
|
---|
| 56 | * as you like
|
---|
| 57 | * -# CommandLineUI: Every command can also be chained up as a sequence of actions on the command line to be executed
|
---|
| 58 | * with any user interaction.
|
---|
| 59 | * -# GraphicalUI: A graphical user interface that also display the molecular structure being built and lots of other
|
---|
| 60 | * informations to ease the construction of bigger geometries.
|
---|
[a8bcea6] | 61 | *
|
---|
[a356f2] | 62 | * The supported output formats right now are:
|
---|
| 63 | * -# mpqc: Configuration files of the Massively Parallel Quantum Chemistry package (Sandia labs)
|
---|
| 64 | * -# pcp: Configuration files of the Parallel Car-Parrinello program (Institute for Numerical Simulation)
|
---|
| 65 | * -# tremolo: Configuration files of TREMOLO (Institute for Numerical Simulation)
|
---|
| 66 | * -# xyz: the most basic format for the 3d arrangement of atoms consisting of a list of element and 3 coordinates.
|
---|
[a8bcea6] | 67 | *
|
---|
[14de469] | 68 | */
|
---|
| 69 |
|
---|
[bf3817] | 70 | // include config.h
|
---|
| 71 | #ifdef HAVE_CONFIG_H
|
---|
| 72 | #include <config.h>
|
---|
| 73 | #endif
|
---|
| 74 |
|
---|
[f4d063] | 75 | #include "builder_init.hpp"
|
---|
[ca2b83] | 76 |
|
---|
| 77 | /********************************************** Main routine **************************************/
|
---|
[14de469] | 78 |
|
---|
[ca2b83] | 79 | int main(int argc, char **argv)
|
---|
| 80 | {
|
---|
[f4d063] | 81 | initGeneral();
|
---|
[6ac7ee] | 82 |
|
---|
[f4d063] | 83 | initUI(argc,argv);
|
---|
[042f82] | 84 |
|
---|
[f4d063] | 85 | doUI();
|
---|
[632bc3] | 86 |
|
---|
[f4d063] | 87 | return saveAll();
|
---|
[14de469] | 88 | }
|
---|
| 89 |
|
---|
| 90 | /********************************************** E N D **************************************************/
|
---|