Complete worked examples showing dapi workflows. Each links to a runnable notebook on DesignSafe JupyterHub.
Your First dapi Job¶
One calculation, every dapi step: authenticate, stage, generate, submit, monitor, and read the result from the archive.
Solution:
File Access¶
Access files across all DesignSafe storage systems (MyData, CommunityData, NHERI-Published, NEES, MyProjects).
Projects¶
List, inspect, and access files in DesignSafe projects.
Publications¶
Search and browse published datasets on DesignSafe.
Systems¶
List HPC and storage systems, check credentials, and view queues.
Logging and Verbosity¶
Control how much dapi reports: INFO milestones, full DEBUG trace, or silence.
Application Management¶
Discover and manage applications on DesignSafe.
Database Queries¶
Access DesignSafe research databases (NGL, Earthquake Recovery, Vp).
Generic Python on HPC¶
Run any Python script (or executable) on Stampede3 with the general-purpose python-s3 app, shown here as Monte Carlo pi across all 48 cores of a node.
Full documentation · App documentation
Material Point Method (MPM)¶
Submit and monitor MPM simulations.
OpenFOAM CFD¶
Computational fluid dynamics with OpenFOAM.
OpenSees Structural Analysis¶
Earthquake engineering simulations with OpenSees.
quoFEM Sensitivity Analysis¶
Global sensitivity analysis with the SimCenter UQ engine (quoFEM) on Stampede3, with automatic input bundling and Sobol-index post-processing.
PyLauncher Parameter Sweeps¶
Sweep the forcing frequency of a damped oscillator, one task per frequency, and reassemble the resonance curve from the archive.
Exercise:
PyLauncher: OpenSees Cantilever Sweep¶
Fifteen pushover analyses in one job, and the pushover curves plotted from the archived recorders.
Exercise:
OpenSees ML Sweep¶
Sweep an OpenSeesPy cantilever with PyLauncher, then fit a regression that recovers the physics, one job end to end.
PM4Sand Free-Field Site Response¶
Exercise and solution: a liquefiable soil column runs as an OpenSees job and the plots find the liquefying layer.
Solution:
Run Your Own Container¶
Register a container app in two calls and run a GitHub-published image on a compute node.
Parallel Fan-Out and Fan-In¶
Three Monte-Carlo jobs run at once and an aggregator combines them, the workflow shape behind most many-job studies.
Exercise:
Build Your Own Tapis App¶
Scaffold, register, and run a custom app with two dapi calls.
Project Permissions¶
Audit who can see project files and repair broken sharing with one call.
TMS Credentials¶
Manage SSH credentials on TACC execution systems.