-
Notifications
You must be signed in to change notification settings - Fork 1
/
README
127 lines (94 loc) · 3.33 KB
/
README
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
T R I A D
Copyright (C) 2000-2016 John C. Bowman (bowman@math.ualberta.ca)
INTRODUCTION
============
Triad is an object-oriented C++ kernel for integrating initial value problems.
Design priorities, in order of priority:
1. High-performance computing
2. Portability
3. Object-oriented construction (reusable code)
4. Easy user-interface for data entry and output (eg., using XDR)
COMPILATION
===========
This program has been successfully compiled and tested on i386, alpha,
rs6000, sun, sgi, and t3e UNIX platforms. To compile, simply say in the
appropriate problem-dependent directory:
make
For better optimization, one can specify compiler-dependent optimization
flags, for example:
make CFLAGS="-O3 -DNDEBUG"
EXECUTION
===========
The command line is
triad [<options>]
<options> is a list of assignments, delimited by spaces, of the form A=B.
One of the most important options is the "run" name. Consider, for example,
the command line
triad run=test dt=1
The run name is associated with the parameter file test/p, which contains
further parameters assignments, separated by whitespace. Except for the run
name itself, command line assignments override parameter file
assignments. Thus, in the above example, the run "test" is begun, using
the time step of 1, regardless of what time step may be specified in the
parameter file. The default run name is "test".
Examples:
triad itmax=10
This evolves run test 10 time steps, producing whatever output
files are specified by the problem-dependent portion of the code,
along with restart and statistics files and a parameter file in a
format suitable for a graphics program (such as sm). On each run,
the parameter file is overwritten with the current values, so that
the program effectively "remembers" previous command-line settings.
triad itmax=10 restart=1
This restarts a previous run ("test") and executes an additional 10
time steps.
triad itmax=10 init=1
This evolves run test 10 time steps, using as initial values the final
values computed the last time this case was run.
triad itmax=10 clobber=1
This evolves run test 10 time steps, overwriting a previous restart
file.
triad itmax=10 dynamic=1 tolmax=.5 tolmin=.05
A typical example of dynamic time-stepping parameters that lead
to efficient computation without numerical instability.
triad itmax=10 tmax=2.0
This evolves run test for 10 time steps or for 2.0 time units,
whichever is less. This is useful when dynamic time stepping is
enabled and it is desired to terminate computation at a fixed time.
triad itmax=10 sample=1.0
This evolves run test for 10 time steps, producing output files at
exactly at ever 1.0 time units. This is useful when dynamic time
stepping is enabled and it is desired to produce uniformly spaced
output values.
triad itmax=10 dynamic=0
This disables the dynamic time-stepping mechanism.
The complete list of kernel commands is
itmax
microsteps
tmax
dt
dynamic
tolmax
tolmin
stepfactor
stepnoninvert
dtmin
dtmax
tprecision
sample
polltime
hybrid
digits
restart
initialize
clobber
override
verbose
run
checkpoint
output
method
integrator
Each problem will generally define other commands to set various user
supplied parameters.
*** FURTHER DOCUMENTATION TO BE ADDED ***