Pyclaw Controller Class¶
The pyclaw controller object is a convenience class for running simulations based on the classic clawpack formats and output specifications. It allows for a variety of output time specifications, output styles and other ways to keep a simulation organized.
The main way to use a Controller object then is to provide it with an
appropriate Solver
and initial
Solution
object. Then specify what kind of output
you would like different than the defaults (see
Controller
for
details on what those are). Then simply call
run()
in order to run the desired
simulation.
>>> import pyclaw.controller as controller
>>> claw = controller.Controller() # Instantiate a new controller
>>> claw.solver = my_solver # Assign a solver
>>> claw.solution = my_initial_solution # Assign an initial condition
Here we would set a variety of run parameters such as tfinal
,
keep_copy
if we wanted to plot the solutions immediately, or
output_format
to specify a format other than ascii
or no output files
if we are going to use keep_copy = True
. After we are all set up we just
need to call the controller’s run()
method and off we go.
>>> claw.run()
Please see the PyClaw tutorial: Solve the acoustics equations for a detailed example of how this would work in its entirety.
pyclaw.controller.Controller
¶
- class clawpack.pyclaw.controller.Controller¶
Controller for pyclaw simulation runs and plotting
- Initialization:
Input: None
- Examples:
>>> import clawpack.pyclaw as pyclaw >>> x = pyclaw.Dimension(0.,1.,100,name='x') >>> domain = pyclaw.Domain((x)) >>> state = pyclaw.State(domain,3,2) >>> claw = pyclaw.Controller() >>> claw.solution = pyclaw.Solution(state,domain) >>> claw.solver = pyclaw.ClawSolver1D()
- check_validity()¶
Check that the controller has been properly set up and is ready to run.
Also checks validity of the solver, solution and states.
- plot()¶
Plot from memory.
- run()¶
Convenience routine that will evolve solution based on the traditional clawpack output and run parameters.
This function uses the run parameters and solver parameters to evolve the solution to the end time specified in run_data, outputting at the appropriate times.
- Input:
None
- Output:
(dict) - Return a dictionary of the status of the solver.
- F_file_name¶
(string) - Name of text file containing functionals
- property F_path¶
(string) - Full path to output file for functionals
- compute_F¶
(function) - Function that computes density of functional F
- compute_p¶
(function) - function that computes derived quantities
- file_prefix_p¶
(string) - File prefix to be prepended to derived quantity output files
- frames¶
(list) - List of saved frames if
keep_copy
is set toTrue
- keep_copy¶
(bool) - Keep a copy in memory of every output time,
default = False
- nstepout¶
(int) - Number of steps between output, only used with
output_style = 3
,default = 1
- num_output_times¶
(int) - Number of output times, only used with
output_style = 1
,default = 10
- out_times¶
(list of floats) - Output time list, only used with
output_style = 2
,default = numpy.linspace(0.0,tfinal,num_output_times)
- outdir¶
(string) - Output directory, directs output files to outdir
- property outdir_p¶
(string) - Directory to use for writing derived quantity files
- output_file_prefix¶
(string) - File prefix to be appended to output files,
default = None
- output_format¶
(list of strings) - Format or list of formats to output the data, if this is None, no output is performed. See _pyclaw_io for more info on available formats.
default = 'ascii'
- output_options¶
(dict) - Output options passed to function writing and reading data in output_format’s format.
default = {}
- output_style¶
(int) - Time output style,
default = 1
- overwrite¶
(bool) - Ok to overwrite old result in outdir,
default = True
- plotdata¶
(
ClawPlotData
) - An instance of aClawPlotData
object defining the objects plot parameters.
- rundir¶
(string) - Directory to run from (containing *.data files), uses *.data from rundir
- runmake¶
(bool) - Run make in xdir before xclawcmd
- savecode¶
(bool) - Save a copy of *.f files in outdir
- solver¶
(
Solver
) - Solver object
- tfinal¶
(float) - Final time output,
default = 1.0
- property verbosity¶
(int) - Level of output to screen;
default = 3
- viewable_attributes¶
(list) - Viewable attributes of the :class:`~pyclaw.controller.Controller
- write_aux_always¶
(bool) - Write out auxiliary array at every time step,
default = False
- write_aux_init¶
(bool) - Write out initial auxiliary array,
default = False
- xclawcmd¶
(string) - Command to execute (if using fortran), defaults to xclaw or xclaw.exe if cygwin is being used (which it checks vis sys.platform)
- xclawerr¶
(string) - Where to write error messages
- xclawout¶
(string) - Where to write timestep messages
- xdir¶
(string) - Executable path, executes xclawcmd in xdir