Skip to content

Morphospaces

TraitBlender currently includes three morphospaces:

  • Shell (Default) – a 3D shell model based on Contreras-Figueroa & Aragón (2023)
  • Circle Grid – a white cube with a 4×4 grid of black circles on top
  • MorphoWeave – PCA + local RBF deformation of a template mesh from a MorphoWeave Model Library export

Each morphospace has a name (e.g. "Shell (Default)", "Circle Grid", "MorphoWeave") used in the GUI and in config files, and:

  • traits – columns in the dataset (per-specimen values)
  • hyperparameters – extra settings that affect how the model is generated (set in the Configuration panel)
  • orientations – named poses for the specimen on the table (built-in per morphospace, plus optional custom Eulers)

Orientations

Built-in orientation functions live with each morphospace (always including Default). In the Orientations panel you can also add custom orientations: a name plus Euler (rx, ry, rz) in radians. For any morphospace, a custom orientation:

  1. Runs Default
  2. Applies the Euler in the specimen’s local frame (relative to the post-Default pose, before bake)
  3. Recenters at geometry bounds

Customs show up in the Apply dropdown and Imaging checkboxes, and persist via YAML (imaging.custom_orientations). Built-in names win if a custom name would collide—the UI and YAML load reject duplicates and non-identifier names (letters, digits, _, - only). See the configuration reference and API.

Follow the links above for the full list of parameters, default values, and ranges that make sense in practice.