-
Notifications
You must be signed in to change notification settings - Fork 7
/
claw46to50.html
235 lines (222 loc) · 11.1 KB
/
claw46to50.html
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
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />
<title>Converting from Clawpack 4.6 to 5.0 — Clawpack 5.11.x documentation</title>
<link rel="stylesheet" href="_static/base.css" type="text/css" />
<link rel="stylesheet" href="_static/layout.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
<link rel="stylesheet" type="text/css" href="_static/flasky.css" />
<link rel="stylesheet" type="text/css" href="_static/graphviz.css" />
<script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
<script src="_static/jquery.js"></script>
<script src="_static/underscore.js"></script>
<script src="_static/_sphinx_javascript_frameworks_compat.js"></script>
<script src="_static/doctools.js"></script>
<script src="_static/sphinx_highlight.js"></script>
<link rel="shortcut icon" href="_static/clawicon.ico"/>
<link rel="author" title="About these documents" href="about.html" />
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="Clawpack Community" href="community.html" />
<link rel="prev" title="Converting from Clawpack 4.3 to 4.6" href="claw43to46.html" />
</head><body>
<div id="main-wrapper" class="sphinx">
<div id="header-wrapper">
<section id="header">
<!-- <h1><a href="http://clawpack.org/">Clawpack</a></h1> -->
<h1><a href="http://clawpack.org/">Clawpack-5</a></h1>
<nav>
<ul>
<li>
<a href="contents.html">Docs</a>
</li>
<li>
<a href="installing.html">Install</a>
</li>
<li>
<a class="" href="http://clawpack.org/gallery/index.html">Gallery</a>
</li>
<li>
<a href="about.html">Citation</a>
</li>
<li>
<a class="active" href="http://github.com/clawpack">GitHub</a>
</li>
<li>
<a class="" href="community.html">Community</a>
</li>
<li>
<a class="" href="developers.html">Contribute</a>
</li>
</ul>
</nav>
</section>
<div class="decoration"></div>
</div>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="community.html" title="Clawpack Community"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="claw43to46.html" title="Converting from Clawpack 4.3 to 4.6"
accesskey="P">previous</a> |</li>
<li class="nav-item nav-item-0"><a href="contents.html">Clawpack 5.11.x documentation</a> »</li>
<li class="nav-item nav-item-this"><a href="">Converting from Clawpack 4.6 to 5.0</a></li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<section id="converting-from-clawpack-4-6-to-5-0">
<span id="claw46to50"></span><h1>Converting from Clawpack 4.6 to 5.0<a class="headerlink" href="#converting-from-clawpack-4-6-to-5-0" title="Permalink to this heading">¶</a></h1>
<p>(If you are converting code from Clawpack 4.3, see <a class="reference internal" href="claw43to46.html#claw43to46"><span class="std std-ref">Converting from Clawpack 4.3 to 4.6</span></a>.)</p>
<p>Many input parameters have been renamed and some new options have been
added in Clawpack 5.0. See <a class="reference internal" href="clawpack5.html#setrun-changes"><span class="std std-ref">Changes to input parameters in setrun.py from 4.x to 5.0</span></a>.</p>
<section id="python-conversion-tool">
<h2>Python conversion tool<a class="headerlink" href="#python-conversion-tool" title="Permalink to this heading">¶</a></h2>
<p>A first pass at the conversion of <em>setrun.py</em>, <em>setplot.py</em> and the
<em>Makefile</em> can often be achieved by typing:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ python $CLAW/clawutil/src/python/clawutil/conversion/convert46to50.py
</pre></div>
</div>
<p>in your application directory. You should then inspect the files generated
and fix any broken links, etc.</p>
<p>The original versions of various files will have <cite>_4.x</cite> appended to the file
name for reference. When conversion is complete, these files can be
deleted.</p>
<p><strong>Notes:</strong></p>
<p>This does not yet work for all variants of the code.</p>
<p>Old AMRClaw codes are often in a subdirectory <em>amr</em> of an application
directory, and the directory above may contain Fortran files or other files
used by the AMR code. Typically you will want to combine these in one
directory.</p>
<p>The <cite>Makefile</cite> is currently not converted properly – a generic <cite>Makefile</cite>
is added to the directory but must be customized to point to any local
Fortran codes, for example. In particular, make sure the Makefile points to
the correct Riemann solver(s), either a local file or a library routine from
the <cite>$CLAW/riemann/src</cite> directory.</p>
<p>The indices in <cite>q</cite> and <cite>aux</cite> arrays were permuted in Clawpack 5.0 relative
to early versions, e.g. the <cite>m`th component of `q</cite> in grid cell <cite>(i,j)</cite> is
now <cite>q(m,i,j)</cite> rather than <cite>q(i,j,m)</cite>. The conversion script attempts to do
this reordering if it sees a pattern of a suitable form, but you should
carefully check your own local routines such as <cite>qinit</cite> or <cite>setaux</cite> to make
sure this has been done properly.</p>
<p>Calling sequences of several routines have also been changed and will need
to be adjusted by hand for any Fortran routines in your application directory.
See <a class="reference internal" href="user_routines.html#user-routines"><span class="std std-ref">User files required for the Fortran code</span></a> for calling sequences of the routines that
most frequently are provided by users. If you specify your own
Riemann solver, see also <a class="reference internal" href="riemann.html#riemann"><span class="std std-ref">Riemann solvers</span></a>, and if you have custom
boundary conditions, see <a class="reference internal" href="bc.html#bc"><span class="std std-ref">Boundary conditions</span></a>.</p>
<p>Note in particular that parameter <cite>maxmx</cite> (and <cite>maxmy</cite>, <cite>maxmz</cite> in more
dimensions) is no longer in the calling sequence. In earlier versions of
Clawpack this indicated the declared dimension of the <cite>q</cite> and <cite>aux</cite> arrays.
It is now assumed the arrays are dimensioned properly since dynamic memory
allocation is generally used at run time based on <cite>mx</cite> (resp. <cite>my</cite>, <cite>mz</cite>).
You should remove these from the calling sequence and also modify the
declaration of input parameters to use <cite>mx</cite> in place of <cite>maxmx</cite>, etc.</p>
<p>The classic code no longer requires a driver routine <cite>driver.f</cite>. In earlier
versions of Clawpack this was used to declare the <cite>q</cite> and <cite>aux</cite> arrays to be
sufficiently large for the size of the problem to be solved. (And
specifying a larger value for <cite>mx</cite> led to a run-time error.) In Clawpack-5,
a library routine <cite>driver.f90</cite> is provided that calls the Clawpack routines,
which now use dynamic memory allocation to allocate the required arrays at
run time.</p>
</section>
</section>
<div class="clearer"></div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<p><a href="http://clawpack.org/">
<img class="logo" src= "_static/clawlogo.jpg" alt="Logo"/>
</a>
<h2>Version 5.11.x</h2>
</p>
<div>
<h3><a href="contents.html">Table of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">Converting from Clawpack 4.6 to 5.0</a><ul>
<li><a class="reference internal" href="#python-conversion-tool">Python conversion tool</a></li>
</ul>
</li>
</ul>
</div><h3>Related Topics</h3>
<ul>
<li><a href="contents.html">Documentation overview</a><ul>
<li>Previous: <a href="claw43to46.html" title="previous chapter">Converting from Clawpack 4.3 to 4.6</a></li>
<li>Next: <a href="community.html" title="next chapter">Clawpack Community</a></li>
</ul></li>
</ul>
<div class="widget navlinks">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/claw46to50.rst.txt"
rel="nofollow"
target="_blank">Source .rst</a></li>
<li><a href="https://github.com/clawpack/doc/blob/dev/doc/claw46to50.rst"
rel="nofollow"
target="_blank">Source on GitHub</a></li>
<li><a href="https://github.com/clawpack/doc/commits/dev/doc/claw46to50.rst"
rel="nofollow"
target="_blank">History</a></li>
<li><a href="https://github.com/clawpack/doc/edit/dev/doc/claw46to50.rst"
rel="nofollow"
target="_blank">Suggest Edits</a></li>
<li><a href="https://github.com/clawpack/doc/issues/new/choose"
rel="nofollow"
target="_blank">Raise an Issue</a></li>
</ul>
</div>
<div id="searchbox" style="display: none" role="search">
<h3 id="searchlabel">Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="search.html" method="get">
<input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
<input type="submit" value="Go" />
</form>
</div>
</div>
<script>document.getElementById('searchbox').style.display = "block"</script>
<h4>Latest Version</h4>
<ul>
<li><a href="./dev/claw46to50.html">dev</a></li>
<li><a href="claw46to50.html">v5.11.x</a></li>
</ul>
<h4>Older Versions</h4>
<ul>
<li><a href="./v5.10.x/claw46to50.html">v5.10.x</a></li>
<li><a href="./v5.7.x/claw46to50.html">v5.7.x</a></li>
<li><a href="./v5.8.x/claw46to50.html">v5.8.x</a></li>
<li><a href="./v5.9.x/claw46to50.html">v5.9.x</a></li>
</ul>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="footer">
© Copyright CC-BY 2024, The Clawpack Development Team.
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a>.
</div>
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-44811544-1', 'auto');
ga('send', 'pageview');
</script>
</body>
</html>