cape.pycart.bin: Cart3D executable interface module

This module provides an interface to the various executables of the Cart3D package. The functions in this module have names that match the command-line names of those Cart3D executables.

In addition, all the more universal executable interfaces provided in cape.bin, including the Cart3D utilities intersect and verify, are also imported. These are imported directly

from cape.bin import *

so no extra syntax is needed in order to access them from cape.pycart.bin

See also:
cape.pycart.bin.autoInputs(cart3d=None, opts=None, j=0, **kwargs)

Interface to Cart3D script autoInputs

Call:
>>> pyCart.bin.autoInputs(cart3d, j=0)
>>> pyCart.bin.autoInputs(opts=opts, j=0)
>>> pyCart.bin.autoInputs(opts=rc, j=0)
>>> pyCart.bin.autoInputs(ftri='Components.i.tri', **kw)
Inputs:
cart3d: cape.pycart.cntl.Cntl

Global pyCart settings instance

j: {0} | int

Phase number

opts: pyCart.options.Options

Options interface

rc: pyCart.options.runControl.RunControl

Options interface

r: int

Mesh radius

ftri: str

Name of surface triangulation file

maxR: int

Number of refinements to make

Versions:

  • 2014-09-02 @ddalle: First version

cape.pycart.bin.cubes(cart3d=None, opts=None, j=0, **kwargs)

Interface to Cart3D script cubes

Call:
>>> pyCart.bin.cubes(cart3d, j=0)
>>> pyCart.bin.cubes(opts=opts, j=0)
>>> pyCart.bin.cubes(opts=rc, j=0)
>>> pyCart.bin.cubes(maxR=11, reorder=True, **kwargs)
Inputs:
cart3d: cape.pycart.cntl.Cntl

Global pyCart settings instance

j: {0} | int

Phase number

opts: pyCart.options.Options

Options interface

rc: pyCart.options.runControl.RunControl

Options interface

maxR: int

Number of refinements to make

reorder: bool

Whether or not to reorder mesh

a: int

cubes angle criterion

b: int

Number of buffer layers

sf: int

Number of extra refinements around sharp edges

Versions:

  • 2014-06-30 @ddalle: First version

  • 2014-09-02 @ddalle: Rewritten with new options paradigm

  • 2014-09-10 @ddalle: Split into cmd and bin

  • 2014-12-02 @ddalle: Moved to keyword arguments and added sf

cape.pycart.bin.flowCart(cart3d=None, i=0, **kwargs)

Interface to Cart3D binary flowCart

Call:
>>> cmdi = pyCart.bin.flowCart(cart3d, i=0)
>>> cmdi = pyCart.bin.flowCart(fc=None, i=0)
>>> cmdi = pyCart.bin.flowCart(**kwargs)
Inputs:
cart3d: cape.pycart.cntl.Cntl

Global pyCart settings instance

fc: pyCart.options.flowCart.flowCart

Direct reference to cart3d.opts['flowCart']

i: int

Run index (restart if i is greater than 0)

n: int

Iteration number from which to start (affects -N setting)

clic: bool

Whether or not to create Components.i.triq file

mpi_fc: bool

Whether or not to use MPI version

it_fc: int

Number of iterations to run flowCart

mg_fc: int

Number of multigrid levels to use

it_avg: int

Iterations between averaging break; overrides it_fc

it_start: int

Startup iterations before starting averaging

fmg: bool

Whether to use full multigrid (adds -no_fmg flag if False)

pmg: bool

Whether or not to use poly multigrid

cfl: float

Nominal CFL number

cflmin: float

Minimum CFL number allowed for problem cells or iterations

tm: bool

Whether or not to use second-order cut cells

buffLim: bool

Whether or not to use buffer limiting to smear shocks

binaryIO: bool

Whether or not to use binary format for input/output files

limiter: int

Limiter index

y_is_spanwise: bool

Whether or not to consider angle of attack in z direction

nProc: int

Number of threads to use for flowCart operation

buffLim: bool

Whether or not to use buffer limits for strong off-body shocks

Versions:

  • 2014-09-07 @ddalle: First version

cape.pycart.bin.mgPrep(cart3d=None, opts=None, j=0, **kwargs)

Interface to Cart3D script mgPrep

Call:
>>> pyCart.bin.mgPrep(cart3d, j=0)
>>> pyCart.bin.mgPrep(opts=opts, j=0)
>>> pyCart.bin.mgPrep(opts=rc, j=0)
>>> pyCart.bin.mgPrep(**kw)
Inputs:
cart3d: cape.pycart.cntl.Cntl

Global pyCart settings instance

j: {0} | int

Phase number

opts: pyCart.options.Options

Options interface

rc: pyCart.options.runControl.RunControl

Options interface

mg_fc: int

Number of multigrid levels to prepare

Versions:

  • 2014-09-02 @ddalle: First version