How sorao0921/biaxial-cpfem works
This repository supports a crystal-plasticity research workflow: prepare LS-DYNA models from mesh and orientation inputs, run external analyses, extract and normalize result data, then investigate roughness mechanisms and evaluate height/valley predictions. Separate branches calculate physical indicators and graph-frequency height bands; a catalog and dashboards support comparison and readiness review. The README documents the broad pipeline and capabilities, while excerpts show selected calls; links for unsampled subsystems are included only where the README establishes them.
Main entry points: write_keyword.py Model assembly · case_data.py Case data resolution · taylor_factor.py Crystal-plasticity metrics · app.py Comparison dashboard
Components 23
Model preparation
- Mesh processing
src/pre_process/mesh.py - Keyword formatting
src/pre_process/keyword_format.py - Model assembly
src/make_model_process/write_keyword.py - Spatial model
src/mapping/spatial_model.py
Extraction and indicators
- Result extraction
tools/superdyna4/extract_surface_coords.py - Edge and ID processing
src/extract_process/pipeline.py - Case data resolution
src/postprocess/case_data.py - Crystal-plasticity metrics
src/crystal_plasticity/taylor_factor.py - State Taylor workflow
src/crystal_plasticity/taylor_pipeline.py - Slip activity workflow
src/crystal_plasticity/slip_activity_pipeline.py - Height bands
src/postprocess/graph_spectral.py
Mechanism and prediction
- Mechanism analysis
src/theme1/contribution.py - Initial Taylor prediction
src/theme1/initial_taylor_prediction.py - Height prediction models
src/theme2/initial_height.py - Valley evaluation
src/theme2/valley_evaluation.py
Catalog and visualization
- Output catalog
src/dashboard/catalog.py - Comparison dashboard
tools/UI/app.py - Plot rendering
src/dashboard/plots.py - Readiness dashboard
tools/UI/readiness_app.py
Other components
- Researcher
- Mesh and orientations
- LS-DYNA
- Processed results
Connections 23
- Researcher → Model assembly: prepares cases
README.md - Mesh and orientations → Mesh processing: provides mesh
README.md - Mesh processing → Model assembly: formats geometry
src/pre_process/mesh.py - Keyword formatting → Model assembly: formats keywords
- Model assembly → LS-DYNA: runs externally
README.md - Model assembly → Spatial model: exports geometry
README.md - LS-DYNA → Result extraction: produces results
README.md - Result extraction → Edge and ID processing: supplies CSVs
README.md - Edge and ID processing → Processed results: writes results
src/extract_process/pipeline.py - Processed results → Case data resolution: provides artifacts
README.md - Processed results → Crystal-plasticity metrics: supplies orientations
README.md - Crystal-plasticity metrics → State Taylor workflow: solves factors
src/crystal_plasticity/taylor_pipeline.py - Processed results → Slip activity workflow: supplies shear data
src/crystal_plasticity/slip_activity_pipeline.py - Case data resolution → Height bands: provides height cases
src/postprocess/graph_spectral.py - Case data resolution → Mechanism analysis: supports analysis
- Crystal-plasticity metrics → Initial Taylor prediction: solves slip response
src/theme1/initial_taylor_prediction.py - Processed results → Height prediction models: provides reference data
README.md - Height prediction models → Valley evaluation: evaluates predictions
src/theme2/valley_evaluation.py - Processed results → Output catalog: scans artifacts
src/dashboard/catalog.py - Researcher → Comparison dashboard: compares results
README.md - Comparison dashboard → Output catalog: selects cases
tools/UI/app.py - Comparison dashboard → Plot rendering: renders comparisons
tools/UI/app.py - Researcher → Readiness dashboard: checks preparation
README.md