Derived Fields
An extensible, catalog-driven library for computing derived fields from multi-component engineering data arrays
Overview
vcti.derived turns multi-component engineering result arrays — vectors,
6-DOF, symmetric stress/strain tensors — into derived fields such as
magnitude, von Mises, principal values and directions, and traction vectors.
It is pure numpy: plain arrays in, plain arrays out, with output dtype
following the input. Two faces sit over one implementation — bulk-first
kernels you call directly, and a catalog that enumerates which derived
fields exist per data family (with stable ids, display names, and parameters)
for driving menus and pipelines. Component order is handled explicitly, so
data from any solver (Abaqus, Nastran, Ansys, LS-Dyna) computes correctly
without reshuffling.
Installation
pip install vcti-derived
In requirements.txt
vcti-derived>=1.0.0
In pyproject.toml dependencies
dependencies = [
"vcti-derived>=1.0.0",
]
Quick Start
import numpy as np
from vcti.derived import CATALOG, ComponentOrder, DataFamily, symtensor
stress = np.array([[100.0, 20.0, 5.0, 15.0, 0.0, 0.0]]) # (N, 6): xx yy zz xy yz xz
# Kernels directly:
vm = symtensor.von_mises(stress) # (N,) von Mises stress
s1 = symtensor.principals(stress)[:, -1] # (N,) max principal
# Data from a solver with a different component order (zero-copy):
vm = symtensor.von_mises(stress, order=ComponentOrder.ABAQUS)
# Or through the catalog:
entry = CATALOG.get("symtensor3d.von_mises")
vm = entry.compute(stress)
for entry in CATALOG.by_family(DataFamily.SYMTENSOR3D):
print(entry.id, entry.display_name)
Dependencies
numpy only.
Documentation
| If you want to… | Read |
|---|---|
| Understand the architecture and design decisions | docs/design.md |
| Navigate and understand the source | docs/source-guide.md |
| See practical, real-world usage | docs/patterns.md |
| Extend the library | docs/extending.md |
| Look up a specific function or type | docs/api.md |
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file vcti_derived-1.0.0.tar.gz.
File metadata
- Download URL: vcti_derived-1.0.0.tar.gz
- Upload date:
- Size: 26.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e1f10590d910ef6fe03dc6864214e3b1de2601ddb52e4aea44148192b1e89b80
|
|
| MD5 |
ca3a02fa7f3643d0b982842020da4c18
|
|
| BLAKE2b-256 |
17620eee56e79d1454d0635d2119d1eb5d5f8402ae3922d996b2d243c5bbe941
|
Provenance
The following attestation bundles were made for vcti_derived-1.0.0.tar.gz:
Publisher:
release.yml on vcollab/vcti-python-derived
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
vcti_derived-1.0.0.tar.gz -
Subject digest:
e1f10590d910ef6fe03dc6864214e3b1de2601ddb52e4aea44148192b1e89b80 - Sigstore transparency entry: 2209786501
- Sigstore integration time:
-
Permalink:
vcollab/vcti-python-derived@6ce9fef6e0245075934181dff71f2c6cc554382a -
Branch / Tag:
refs/tags/v1.0.0 - Owner: https://github.com/vcollab
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@6ce9fef6e0245075934181dff71f2c6cc554382a -
Trigger Event:
push
-
Statement type:
File details
Details for the file vcti_derived-1.0.0-py3-none-any.whl.
File metadata
- Download URL: vcti_derived-1.0.0-py3-none-any.whl
- Upload date:
- Size: 22.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
95ac0a0062baf94b17eeed4203ddc8012554e91fe5f352750a9a3d13234fc03d
|
|
| MD5 |
ba4e7b4ac3409fbd5833ffe0e404aed2
|
|
| BLAKE2b-256 |
2139ec69706b1fc8584562a5eafc52f81c703d248de49d5e5c1b79c4db4e355b
|
Provenance
The following attestation bundles were made for vcti_derived-1.0.0-py3-none-any.whl:
Publisher:
release.yml on vcollab/vcti-python-derived
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
vcti_derived-1.0.0-py3-none-any.whl -
Subject digest:
95ac0a0062baf94b17eeed4203ddc8012554e91fe5f352750a9a3d13234fc03d - Sigstore transparency entry: 2209786564
- Sigstore integration time:
-
Permalink:
vcollab/vcti-python-derived@6ce9fef6e0245075934181dff71f2c6cc554382a -
Branch / Tag:
refs/tags/v1.0.0 - Owner: https://github.com/vcollab
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@6ce9fef6e0245075934181dff71f2c6cc554382a -
Trigger Event:
push
-
Statement type:
