Skip to content

Commit 746b383

Browse files
myurkinmyurkin
committed
Moving directory tree one level higher.
1 parent 57f1079 commit 746b383

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

65 files changed

+8568
-12262
lines changed

‎doc/README‎

Lines changed: 71 additions & 82 deletions
Original file line numberDiff line numberDiff line change
@@ -1,73 +1,72 @@
1-
## ##### ## ##### ## ##
2-
/#### /##### /## /##### /## /####
3-
/ ### // / / ### // / / ### / ###
4-
/## / / / ### / / / ### /##
5-
/ ## / / ### / / ### / ##
6-
/ ## ## ## ## ## ## ## / ##
7-
/ ## ## ## ## ## ## ## / ##
8-
/ ## ## ## ## ## ## ## / ##
9-
/ ## ## ## ## ## ## ## / ##
10-
/######## ## ## ## ## ## ## /########
11-
/ ## # ## ## # ## ## / ##
12-
# ## / / / / # ##
13-
/#### ## /###/ / /###/ / /#### ##
14-
/ #### ## / / ########/ / ########/ / #### ## /
15-
/ ## #/ / #### / #### / ## #/
16-
# # # #
17-
## ## ## ##
18-
19-
20-
21-
Maxim A. Yurkin
22-
23-
Institute of Chemical Kinetics and Combustion,
24-
Siberian Branch of the Russian Academy of Sciences,
25-
Institutskaya 3, Novosibirsk, 630090, Russia,
26-
tel: +7-383-333-3240, fax: +7-383-334-2350
27-
28-
Alfons G. Hoekstra
29-
30-
Faculty of Science, Section Computational Science,
31-
of the University of Amsterdam,
1+
ADDA 0.74.2
2+
***********
3+
"Amsterdam DDA"
4+
5+
Maxim A. Yurkin(1,2) and Alfons G. Hoekstra(1)
6+
7+
(1) Faculty of Science, Section Computational Science,
8+
of the University of Amsterdam,
329
Kruislaan 403, 1098 SJ, Amsterdam, The Netherlands,
3310
tel: +31-20-525-7530, fax: +31-20-525-7490
3411

35-
36-
email: [email protected]
37-
38-
$Date:: $
39-
40-
Copyright (C) 2006-2008 University of Amsterdam
12+
(2) Institute of Chemical Kinetics and Combustion,
13+
Siberian Branch of the Russian Academy of Sciences,
14+
Institutskaya 3, Novosibirsk 630090 Russia,
15+
tel: +7-3832-333240, fax: +7-3832-342350
16+
17+
email: [email protected], [email protected]
18+
19+
last revised: 28 March 2006
20+
21+
Copyright (C) 2006 M.A. Yurkin and A.G. Hoekstra
4122
This software package is covered by the GNU General Public License.
4223

4324

44-
45-
1. INTRODUCTION
46-
***************
47-
48-
ADDA is a C software package to calculate scattering and absorption of
49-
electromagnetic waves by particles of arbitrary geometry using the Discrete
50-
Dipole Approximation (DDA). In this approximation the volume of the scatterer
25+
## ##### ## ##### ## ##
26+
/#### /##### /## /##### /## /####
27+
/ ### // / / ### // / / ### / ###
28+
/## / / / ### / / / ### /##
29+
/ ## / / ### / / ### / ##
30+
/ ## ## ## ## ## ## ## / ##
31+
/ ## ## ## ## ## ## ## / ##
32+
/ ## ## ## ## ## ## ## / ##
33+
/ ## ## ## ## ## ## ## / ##
34+
/######## ## ## ## ## ## ## /########
35+
/ ## # ## ## # ## ## / ##
36+
# ## / / / / # ##
37+
/#### ## /###/ / /###/ / /#### ##
38+
/ #### ## / / ########/ / ########/ / #### ## /
39+
/ ## #/ / #### / #### / ## #/
40+
# # # #
41+
## ## ## ##
42+
43+
44+
1. INTRODUCTION
45+
***************
46+
47+
ADDA is a C software package to calculate scattering and absorption of
48+
electromagnetic waves by particles of arbitrary geometry using the Discrete
49+
Dipole Approximation (DDA). In this approximation the volume of the scatterer
5150
is divided into small cubical subvolumes ("dipoles"), interaction of which is
5251
considered approximately based on the integral equation for the electric field.
5352
Initially DDA (sometimes referred to as the "coupled dipole approximation") was
5453
proposed replacing the scatterer by a set of point dipoles (hence the name of
55-
the technique).
54+
the technique).
5655

5756
ADDA is a C implementation of the DDA developed by the authors. The
58-
development has been conducted by Hoekstra and coworkers for more than 10 years
59-
at the University of Amsterdam. From the very beginning the code was intended to
60-
run on a multiprocessor system (parallelizing a single DDA simulation). Recently
61-
the code was significantly rewritten and improved by Yurkin. ADDA is intended to
62-
be a versatile tool, suitable for a wide variety of applications ranging from
57+
development was conducted by Hoekstra and coworkers for more than 10 years in
58+
University of Amsterdam. From the very beginning the code was intended to run on
59+
a multiprocessor system (parallelizing a single DDA simulation). Recently the
60+
code was significantly rewritten and improved by Yurkin. ADDA is intended to be
61+
a versatile tool, suitable for a wide variety of applications ranging from
6362
interstellar dust and atmospheric aerosols to biological particles; its
6463
applicability is limited only by available computer resources. As provided, ADDA
6564
should be usable for many applications without modification, but the program is
6665
written in a modular form, so that modifications, if required, should be fairly
67-
straightforward.
66+
straightforward.
6867

69-
Detailed instructions for using ADDA and all relevant issues are contained in
70-
the User Manual for ADDA. The User Manual is in the file "manual.pdf" in PDF
68+
Detailed instructions for using ADDA and all relevant issuse are contained in
69+
the User Manual for ADDA. The User Manual is in the file "manual.pdf" in PDF
7170
format. It contains instructions for:
7271
* compiling and linking the code;
7372
* running a sample simulation;
@@ -77,7 +76,6 @@ format. It contains instructions for:
7776
* specifying what scattering quantities should be calculated;
7877
* understanding the computational aspects and timing of the code;
7978
* understanding the command line options and formats of input and output files.
80-
* modifying the source code for added functionality
8179

8280

8381
2. AVAILABILITY
@@ -86,11 +84,8 @@ format. It contains instructions for:
8684
The authors make this code openly available to others, in the hope that
8785
it will prove to be a useful tool. We ask only that:
8886

89-
* If you publish results obtained using ADDA, you should acknowledge the source
90-
of the code. We recommend the following general reference:
91-
M. A. Yurkin, V. P. Maltsev, and A.G. Hoekstra, "The discrete dipole
92-
approximation for simulation of light scattering by particles much larger than
93-
the wavelength", J. Quant. Spectros. Radiat. Transf. 106, 546-557 (2007).
87+
* If you publish results obtained using ADDA, please consider acknowledging the
88+
source of the code.
9489

9590
* If you discover any errors in the code, please promptly communicate them to
9691
the authors.
@@ -99,7 +94,7 @@ it will prove to be a useful tool. We ask only that:
9994
Public License) of the Free Software Foundation: you may copy, distribute,
10095
and/or modify the software identified as coming under this agreement. If
10196
you distribute copies of this software, you must give the recipients all the
102-
rights which you have. See the file "copyleft" distributed with the ADDA
97+
rights which you have. See the file "copyleft" distributed with the ADDA
10398
software.
10499

105100
We also strongly encourage you to send email to the authors identifying
@@ -110,50 +105,44 @@ bugs, corrections, or improvements in ADDA.
110105
3. OBTAINING THE SOURCE CODE
111106
****************************
112107

113-
The recent version can be downloaded from:
114-
http://www.science.uva.nl/research/scs/Software/adda/
115-
The package contains the following:
108+
We are currently working to make a www page for ADDA, where it will be
109+
possible to download it. Currently, the latest version of ADDA can be obtained
110+
by sending a request to the authors: [email protected]. The package contains
111+
the following:
116112

117113
doc/ - documentation
118114
copyleft - GNU General Public License
119115
history - complete history of ADDA development
120-
faq - frequently asked questions
121-
manual.doc - source of User Manual in MS Word format
122-
manual.pdf - user Manual for ADDA in PDF format
116+
manual.pdf - User Manual for ADDA in PDF format.
123117
README - this file
124-
todo.xls - source of the todo list in MS Excel format
125-
todo.pdf - todo list in PDF format
126118
input/ - default input files
127119
tables/ - 10 auxiliary files with tables of integrals
128120
alldir_params.dat - parameters for integral scattering quantities
129121
avg_params.dat - parameters for orientation averaging
130122
scat_params.dat - parameters for grid of scattering angles
131-
misc/ - additional files, not supported by the authors.
132123
sample/ - sample output and other files
133124
run000_sphere_g16m1_5/ - sample output directory, contains "log", "mueller",
134125
and "CrossSec-Y".
135-
test.pbs - sample PBS script for MPI system
136-
test.sge - sample SGE script for MPI system
126+
batch - sample PBS script for MPI system
137127
stdout - stdout of a sample simulation
138128
src/
139129
Makefile, make_seq, make_mpi - makefiles
140-
ADDAmain.c, CalculateE.c, calculator.c, cmplx.h, const.h, crosssec.c/h,
141-
comm.c/h, debug.c/h, fft.c, function.h, GenerateB.c, io.c/h, iterative.c,
142-
make_particle.c, matvec.c, memory.c/h, os.h, param.c/h, parbas.h,
143-
prec_time.c/h, Romberg.c/h, sinint.c, timing.c/h, types.h, vars.c/h
130+
ADDAmain.c, CalculateE.c, calculator.c, cmplx.h, const.h, crosssec.c/h,
131+
comm.c/h, debug.c/h, fft.c, GenerateB.c, io.c/h, iterative.c, make_particle.c,
132+
matvec.c, memory.c/h, param.c/h, prec_time.c/h, Romberg.c/h, timing.c,
133+
types.h, vars.c/h
144134
- source and header files of ADDA
145-
cfft99D.f - source file for Temperton FFT
146-
mt19937ar.c/h - source and header files for Mersenne Twister random generator.
135+
cfft99D.f - source file for Temperton FFT
147136

148137

149-
4. COMPILING AND LINKING
150-
************************
138+
4. COMPILING AND LINKING
139+
************************
151140

152-
On Unix systems, while positioned in src/, type
141+
On Unix systems, while positioned in src/, type
153142
> make seq
154-
or
143+
or
155144
> make mpi
156-
for sequential and MPI versions respectively. By default you need FFTW to be
145+
for sequential and MPI versions respectively. By default you need FFTW to be
157146
installed (www.fftw.org) on your system.
158147

159148
Please read the User Manual (manual.pdf).

0 commit comments

Comments
 (0)