1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
|
/// \file mainpage.dox
/// \brief Top-level page for MADNESS documentation.
/// \defgroup configuration MADNESS installation and configuration
/// \defgroup contribution Contributing to MADNESS
/// \defgroup style MADNESS coding style
/// \ingroup contribution
/// \defgroup getting_started Getting started with MADNESS
/// \defgroup gstart_basics MADNESS basics
/// \ingroup getting_started
/// \defgroup gstart_comp_run Compiling and running MADNESS programs
/// \ingroup getting_started
/// \defgroup gstart_functions MADNESS functions
/// \ingroup getting_started
/// \defgroup gstart_io Input/Output
/// \ingroup getting_started
/// \defgroup gstart_load_balance Load and memory balancing
/// \ingroup getting_started
/// \defgroup gstart_think_madness Thinking in MADNESS
/// \ingroup getting_started
/// \defgroup gstart_env_var MADNESS environment variables
/// \ingroup getting_started
/// \defgroup libraries MADNESS libraries
/// \defgroup containers Containers
/// \ingroup libraries
/// \defgroup parallel_runtime Parallel programming environment
/// \ingroup libraries
/// \defgroup chemistry Chemistry
/// \ingroup libraries
/// \defgroup world Distributed computing environment (World and its relations)
/// \ingroup parallel_runtime
// \defgroup rmi Remote method invocation
// \ingroup parallel_runtime
/// \defgroup mpi Interfaces from World to MPI
/// \ingroup parallel_runtime
/// \defgroup world_object Globally addressable objects (WorldObject)
/// \ingroup parallel_runtime
// \defgroup worlddc Distributed containers (WorldContainer)
// \ingroup parallel_runtime
/// \defgroup futures Futures
/// \ingroup parallel_runtime
/// \defgroup serialization Serialization
/// \ingroup parallel_runtime
// \defgroup hashing Hashing
// \ingroup parallel_runtime
/// \defgroup threading Multi-threading
/// \ingroup parallel_runtime
// \defgroup mutexes Mutexes
// \ingroup threading
/// \defgroup atomics Atomic operations
/// \ingroup threading
/// \defgroup threads Threads
/// \ingroup threading
// \defgroup threadpool Thread pool
// \ingroup threading
/// \defgroup taskq Task queue
/// \ingroup threading
// \defgroup conhash Concurrent hash table
// \ingroup threading
// \defgroup mra Multiresolution analysis
// \ingroup libraries
// \defgroup funcplot Function plotting routines
// \ingroup mra
// \defgroup mrabcext Exterior boundary conditions
// \ingroup mra
// \defgroup mrabcint Preliminary support for interior boundary conditions
// \ingroup mra
// \defgroup tensor Tensors or multidimension arrays
// \ingroup libraries
// \defgroup linalg Linear algebra (interface to LAPACK)
// \ingroup libraries
// \defgroup solvers Iterative solvers for linear/non-linear equations and optimizers
// \ingroup libraries
// \defgroup misc Miscellany
// \ingroup libraries
// use tempexamples instead of examples to keep a bunch of the examples (that I haven't gone througuh yet)
/// \defgroup tempexamples Examples
/// \defgroup gettingstarted Getting Started
/// \ingroup tempexamples
/// \defgroup miscexamples Miscellaneous
/// \ingroup tempexamples
/// \defgroup applications MADNESS applications
/**
\mainpage
These pages serve as the main programmer's reference manual for MADNESS and
were automatically generated from the source using Doxygen.
A good place to start is the <a href="modules.html">modules page</a>,
which provides access to documentation for libraries, examples, and
applications. The examples are intended to meet the needs of those
starting to develop new applications.
Additional technical documentation can be found in the MADNESS \c doc directory.
- The getting started guide introduces use of the numerical functionality.
- The implementation notes document the internal numerical workings
as a resource for both users and MADNESS developers.
- The parallel runtime and API documents document the operation and
interface for the parallel programming environment.
The <a href="\website">project home</a>
contains information on configuring, building, etc.
\section status Status and supported platforms
MADNESS is roughly in beta release. Most things work well enough for
several applications to be in production mode, but on the other hand there
are still lots of "rough" spots and the documentation in particular does not
yet meet our expectations.
Currently, we intend that MADNESS work correctly and efficiently
on the following platforms
- Cray,
- IBM BGQ,
- Linux workstations with 64-bit multi-core processors, and
clusters thereof
- Apple Macintosh (Intel processors) with recent versions of OS X.
To build on any of these you will need a recent software stack.
\subsection used_by Software used by MADNESS
Our deep gratitude to these other projects whose software we employ
- <a href="http://sourceforge.net/projects/tinyxml">TinyXML</a>
- <a href="http://www.librow.com/articles/article-10/appendix-a-2">CFFT</a>
- <a href="http://muparser.sourceforge.net">muParser</a>
- <a href="http://www.tddft.org/programs/octopus/wiki/index.php/Libxc">libxc</a>
- <a href="http://www.doxygen.org">Doxygen</a>
- <a href="http://www.graphviz.org">Graphviz</a>
- <a href="http://www.mcs.anl.gov/research/projects/mpich2">MPICH</a>
- <a href="http://www.open-mpi.org">Open-MPI</a>
- <a href="http://www.netlib.org/lapack">LAPACK</a>
- <a href="http://gcc.gnu.org">GCC</a>
- <a href="http://code.google.com/p/googletest">Google test</a>
- <a href="http://code.google.com/p/google-perftools">Google performance tools</a>
- <a href="http://www.tddft.org/programs/octopus/wiki/index.php/Libxc">Libxc</a>
\section license License
\verbatim
Copyright (C) 2007,2010 Oak Ridge National Laboratory
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
For more information please contact:
Robert J. Harrison
Oak Ridge National Laboratory
One Bethel Valley Road
P.O. Box 2008, MS-6367
email: harrisonrj@ornl.gov
tel: 865-241-3937
fax: 865-572-0680
\endverbatim
\todo Turn all of the doxygen modules into a PDF users' manual.
*/
|
