pub struct SkeletalDensityProfile {Show 23 fields
pub compartment_label: String,
pub cortical_apparent_density_g_cm3: f64,
pub cortical_thickness_mm: f64,
pub cortical_porosity_ratio: f64,
pub trabecular_apparent_density_g_cm3: f64,
pub trabecular_bv_tv: f64,
pub trabecular_thickness_um: f64,
pub trabecular_separation_um: f64,
pub trabecular_number_per_mm: f64,
pub trabecular_smi: f64,
pub fabric_eigenvalues: [f64; 3],
pub mineralization_degree_mu: f64,
pub ash_fraction: f64,
pub qct_volumetric_bmd_mg_ha_cm3: Option<f64>,
pub dexa_areal_bmd_g_cm2: Option<f64>,
pub dexa_t_score: Option<f64>,
pub dexa_z_score: Option<f64>,
pub trabecular_bone_score_tbs: Option<f64>,
pub has_fragility_fracture: bool,
pub physeal_fusion: PhysealFusionStatus,
pub fracture_callus: FractureCallusState,
pub has_orthopedic_implant: bool,
pub epistemic_status: EpistemicStatus,
}Expand description
Multi-scale cortical and trabecular skeletal densitometry profile (Spec §5.1–5.3).
Fields§
§compartment_label: String§cortical_apparent_density_g_cm3: f64Cortical apparent wet density rho_app in g/cm^3.
cortical_thickness_mm: f64Cortical shell thickness t_cort in mm.
cortical_porosity_ratio: f64Intracortical Haversian porosity phi_cort in [0.0, 1.0].
trabecular_apparent_density_g_cm3: f64Trabecular apparent density rho_app in g/cm^3.
trabecular_bv_tv: f64Trabecular Bone Volume Fraction BV/TV in [0.0, 1.0].
trabecular_thickness_um: f64Trabecular thickness Tb.Th in micrometers.
trabecular_separation_um: f64Trabecular separation Tb.Sp in micrometers.
trabecular_number_per_mm: f64Trabecular number Tb.N in mm^-1.
trabecular_smi: f64Structure Model Index SMI (0 = plate-like, 3 = rod-like).
fabric_eigenvalues: [f64; 3]Principal eigenvalues [m1, m2, m3] of the trabecular fabric tensor (tr(M) = 3.0).
mineralization_degree_mu: f64Matrix mineralization degree mu_min (1.0 = healthy mineralized human bone;
< 0.75 = osteomalacic/rachitic hypomineralization).
ash_fraction: f64Mineral ash fraction alpha_ash in [0.0, 1.0].
qct_volumetric_bmd_mg_ha_cm3: Option<f64>QCT / HR-pQCT volumetric BMD in mg HA/cm^3, if observed.
dexa_areal_bmd_g_cm2: Option<f64>DEXA areal BMD in g/cm^2, if observed.
dexa_t_score: Option<f64>DEXA T-score (SD vs young-adult peak), if observed/computed.
dexa_z_score: Option<f64>DEXA Z-score (SD vs age/sex/cohort reference), if observed/computed.
trabecular_bone_score_tbs: Option<f64>Trabecular Bone Score (TBS), if available.
has_fragility_fracture: bool§physeal_fusion: PhysealFusionStatus§fracture_callus: FractureCallusState§has_orthopedic_implant: bool§epistemic_status: EpistemicStatusImplementations§
Source§impl SkeletalDensityProfile
impl SkeletalDensityProfile
Sourcepub fn from_preset(preset: SpeciesDensitometryPreset) -> Self
pub fn from_preset(preset: SpeciesDensitometryPreset) -> Self
Construct a profile from one of the curated human clinical or comparative species presets.
Sourcepub fn validate(&self) -> Result<(), String>
pub fn validate(&self) -> Result<(), String>
Fail-closed validation of physical bounds and finite numbers.
Sourcepub fn who_category(&self) -> Option<WhoDensityCategory>
pub fn who_category(&self) -> Option<WhoDensityCategory>
WHO (1994) classification from dexa_t_score + has_fragility_fracture.
Returns None if no T-score was measured/provided (never fabricates a score).
Sourcepub fn effective_cortical_modulus_gpa(
&self,
strain_rate_per_s: f64,
) -> Result<f64, String>
pub fn effective_cortical_modulus_gpa( &self, strain_rate_per_s: f64, ) -> Result<f64, String>
Carter & Hayes (1977) / Zysset (2003) effective cortical elastic modulus in GPa,
attenuated by fracture-callus stage when fracture_callus.stage > 0.
Sourcepub fn effective_trabecular_yield_mpa(&self) -> Result<f64, String>
pub fn effective_trabecular_yield_mpa(&self) -> Result<f64, String>
Gibson & Ashby (1997) effective trabecular yield strength in MPa, scaled by
mineralization mu_min and fracture-callus strength recovery ratio.