myogen.simulator.Muscle.resulting_innervation_areas__mm2#
- property Muscle.resulting_innervation_areas__mm2: ndarray#
Calculate the actual innervation areas for each motor unit based on assigned fibers.
The innervation area is computed as the area of a circle that encompasses all muscle fibers assigned to a motor unit, centered on the motor unit’s innervation center. This provides a measure of the spatial extent of each motor unit territory.
- Returns:
Array of length n_motor_units containing the innervation area (in mm²) for each motor unit. Areas are calculated as π × r², where r is the maximum distance from the innervation center to any assigned fiber.
- Return type:
- Raises:
ValueError – If innervation_center_positions is None or assignment has not been completed.
Examples
>>> actual_areas = muscle.resulting_innervation_areas__mm2 >>> desired_areas = muscle.desired_innervation_areas__mm2 >>> for i, (actual, desired) in enumerate(zip(actual_areas, desired_areas)): ... print(f"MU {i}: desired {desired:.2f} mm², actual {actual:.2f} mm²")
Notes
The resulting areas may differ from desired areas due to the discrete nature of fiber assignment and the constraint of the circular muscle boundary. Motor units near the muscle periphery may have smaller actual areas than desired due to boundary effects.