95 lines
3.1 KiB
Python
95 lines
3.1 KiB
Python
from __future__ import annotations
|
|
|
|
from dataclasses import dataclass
|
|
from math import pi
|
|
|
|
|
|
MM_TO_M = 1.0e-3
|
|
M_TO_MM = 1.0e3
|
|
M3_TO_CM3 = 1.0e6
|
|
M3_PER_S_TO_L_PER_MIN = 60_000.0
|
|
|
|
|
|
def circular_area(diameter_m: float) -> float:
|
|
if diameter_m < 0.0:
|
|
raise ValueError("diameter_m must be non-negative.")
|
|
return pi * diameter_m * diameter_m / 4.0
|
|
|
|
|
|
def mm_to_m(value: float) -> float:
|
|
return value * MM_TO_M
|
|
|
|
|
|
def m_to_mm(value: float) -> float:
|
|
return value * M_TO_MM
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
class AmesimPistonGeometry:
|
|
"""Geometry relations used by AMESim PNRP17 pneumatic piston variables."""
|
|
|
|
piston_diameter_m: float
|
|
rod_diameter_m: float = 0.0
|
|
zero_length_m: float = 0.0
|
|
|
|
@property
|
|
def piston_area_m2(self) -> float:
|
|
return circular_area(self.piston_diameter_m)
|
|
|
|
@property
|
|
def rod_area_m2(self) -> float:
|
|
return circular_area(self.rod_diameter_m)
|
|
|
|
@property
|
|
def annulus_area_m2(self) -> float:
|
|
return self.piston_area_m2 - self.rod_area_m2
|
|
|
|
def chamber_length_m(self, port4_displacement_m: float, port5_displacement_m: float) -> float:
|
|
return self.zero_length_m + port5_displacement_m - port4_displacement_m
|
|
|
|
def chamber_length_mm(self, port4_displacement_m: float, port5_displacement_m: float) -> float:
|
|
return m_to_mm(self.chamber_length_m(port4_displacement_m, port5_displacement_m))
|
|
|
|
@property
|
|
def chamber_area_m2(self) -> float:
|
|
return self.annulus_area_m2
|
|
|
|
def chamber_volume_m3(self, port4_displacement_m: float, port5_displacement_m: float) -> float:
|
|
return self.chamber_area_m2 * self.chamber_length_m(
|
|
port4_displacement_m,
|
|
port5_displacement_m,
|
|
)
|
|
|
|
def chamber_volume_cm3(self, port4_displacement_m: float, port5_displacement_m: float) -> float:
|
|
return self.chamber_volume_m3(port4_displacement_m, port5_displacement_m) * M3_TO_CM3
|
|
|
|
def chamber_volume_rate_m3_s(self, port4_velocity_m_s: float, port5_velocity_m_s: float) -> float:
|
|
return self.chamber_area_m2 * (port5_velocity_m_s - port4_velocity_m_s)
|
|
|
|
def chamber_volume_rate_l_min(self, port4_velocity_m_s: float, port5_velocity_m_s: float) -> float:
|
|
return self.chamber_volume_rate_m3_s(
|
|
port4_velocity_m_s,
|
|
port5_velocity_m_s,
|
|
) * M3_PER_S_TO_L_PER_MIN
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
class AmesimElasticEndstop:
|
|
"""Contact force part of AMESim LSTP00A elastic endstop."""
|
|
|
|
contact_stiffness_n_per_m: float
|
|
contact_damping_n_per_m_per_s: float = 0.0
|
|
gap0_m: float = 0.0
|
|
|
|
def penetration_m_from_gap_mm(self, gap_mm: float) -> float:
|
|
return max(-(mm_to_m(gap_mm) - self.gap0_m), 0.0)
|
|
|
|
def static_contact_force(self, gap_mm: float) -> float:
|
|
return self.contact_stiffness_n_per_m * self.penetration_m_from_gap_mm(gap_mm)
|
|
|
|
def contact_force(self, gap_mm: float, penetration_velocity_m_s: float = 0.0) -> float:
|
|
if self.penetration_m_from_gap_mm(gap_mm) <= 0.0:
|
|
return 0.0
|
|
damping_force = self.contact_damping_n_per_m_per_s * penetration_velocity_m_s
|
|
return max(self.static_contact_force(gap_mm) + damping_force, 0.0)
|