The cape module¶
██████╗ █████╗ ██████╗ ███████╗
██╔════╝ ██╔══██╗ ██╔══██╗ ██╔════╝
██║ ███████║ ██████╔╝ █████╗
██║ ██╔══██║ ██╔═══╝ ██╔══╝
╚██████╗ ██║ ██║ ██║ ███████╗
╚═════╝ ╚═╝ ╚═╝ ╚═╝ ╚══════╝
The cape module contains the top-level interface setup of various
solvers. It loads the most important methods from the various submodules
so that they are easier to access. Most tasks using the Cape API can be
accessed by loading this module.
import cape
For example the following will read in a global settings instance assuming that the present working directory contains the correct files. (If not, various defaults will be used, but it is unlikely that the resulting setup will be what you intended.)
from cape.cfdx.cntl import Cntl cntl = Cntl()
Most of the pyCart submodules essentially contain a single class
definition, and many of these classes are accessible directly from the
cape module. The list of classes loaded directly in cape.
A categorized list of modules available to the API are listed below.
- Primary supporting modules
Notices
Copyright © 2022 United States Government as represented by the Administrator of the National Aeronautics and Space Administration. All Rights Reserved.
Disclaimers
No Warranty: THE SUBJECT SOFTWARE IS PROVIDED “AS IS” WITHOUT ANY WARRANTY OF ANY KIND, EITHER EXPRESSED, IMPLIED, OR STATUTORY, INCLUDING, BUT NOT LIMITED TO, ANY WARRANTY THAT THE SUBJECT SOFTWARE WILL CONFORM TO SPECIFICATIONS, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR FREEDOM FROM INFRINGEMENT, ANY WARRANTY THAT THE SUBJECT SOFTWARE WILL BE ERROR FREE, OR ANY WARRANTY THAT DOCUMENTATION, IF PROVIDED, WILL CONFORM TO THE SUBJECT SOFTWARE. THIS AGREEMENT DOES NOT, IN ANY MANNER, CONSTITUTE AN ENDORSEMENT BY GOVERNMENT AGENCY OR ANY PRIOR RECIPIENT OF ANY RESULTS, RESULTING DESIGNS, HARDWARE, SOFTWARE PRODUCTS OR ANY OTHER APPLICATIONS RESULTING FROM USE OF THE SUBJECT SOFTWARE. FURTHER, GOVERNMENT AGENCY DISCLAIMS ALL WARRANTIES AND LIABILITIES REGARDING THIRD-PARTY SOFTWARE, IF PRESENT IN THE ORIGINAL SOFTWARE, AND DISTRIBUTES IT “AS IS.”
Waiver and Indemnity: RECIPIENT AGREES TO WAIVE ANY AND ALL CLAIMS AGAINST THE UNITED STATES GOVERNMENT, ITS CONTRACTORS AND SUBCONTRACTORS, AS WELL AS ANY PRIOR RECIPIENT. IF RECIPIENT’S USE OF THE SUBJECT SOFTWARE RESULTS IN ANY LIABILITIES, DEMANDS, DAMAGES, EXPENSES OR LOSSES ARISING FROM SUCH USE, INCLUDING ANY DAMAGES FROM PRODUCTS BASED ON, OR RESULTING FROM, RECIPIENT’S USE OF THE SUBJECT SOFTWARE, RECIPIENT SHALL INDEMNIFY AND HOLD HARMLESS THE UNITED STATES GOVERNMENT, ITS CONTRACTORS AND SUBCONTRACTORS, AS WELL AS ANY PRIOR RECIPIENT, TO THE EXTENT PERMITTED BY LAW. RECIPIENT’S SOLE REMEDY FOR ANY SUCH MATTER SHALL BE THE IMMEDIATE, UNILATERAL TERMINATION OF THIS AGREEMENT.
cape.filecntl: Interfaces for text control filescape.agent: Agentic interface to CAPEcape.uiReadline-based user interface to CAPEcape.promptutils: Useful tools for interactive CLI promptsargread: Parse command-line arguments and optionscape.atm: Atmosphere Modelscapeio: Binary file input/output toolscape.capeconfig: Interface to user-specific CAPE configurationcape.cgns: CGNS file interfacecape.cli: Othercapecommand-line interface functionscape.color: Color conversion toolscape.config: Surface configuration modulecape.convert: Unit and angle conversion utilitiescape.convert1to2: Utilities to modify CAPE 1.x scripts to 2.0cape.errors: Customized exceptions for CAPEcape.geom: Generic geometry utilitiescape.gruvoc: Grid and visualization file interfacescape.fileutils: Pure-Python file information utilitiescape.msh: FLUENT mesh modulenmlfile: Interface to Fortran namelistcape.nmlfile.nmlerr: Errors forNmlFiledataoptdict: Advanceddict-based options interfaceopterror: Errors forOptionsDicttoolsoptdict.optitem: Tools to access items from option listscape.plot3d: Python interface to Plot3D filescape.plt: Interface to Tecplot data filescape.promptutils: Simple tools for interactive CLI promptscape.pvutils: Utilities for using PyVista with CAPEcape.sequtils: Tools to analyze 1D iterative historiescape.splitzones: Mesh zone splitting utilitiescape.statutils: Statistics toolscape.step: Python interface to STEP Filescape.sysutils: System utilities for using CAPEcape.teccli: Command-line interfaces to Tecplot(R)cape.text: Text utilities re-exportcape.textutils: Text modification utils for CAPEcape.tri: Triangulated surface mesh interfacecape.tricli: Interfaces to.triand related filescape.triqfm: Command-line interface totriqfmtoolcape.tuiTextual-based user interface to CAPEcape.units: Unit Conversion Modulecape.util: Cape utilitiescape.writell: Collect CAPE line load databookscape.xmlfile: Extended interface to XML files_cape: Compiled CAPE extension