@jetta/axle-load-calculator 0.1.3 → 0.2.0

package/src/core/physics/models/deflection/integration_constant_calculator.ts

@@ -1,62 +0,0 @@
-import type { AllocatedItemManager } from '../../items/allocated_item_manager.js'
-import { solve_linear_system } from '../../../math/gaussian_elimination.js'
-import type { DeflectionSupportManager } from './deflection_support_manager.js'
-
-/**
- * Integration constants for beam elastic curve (two supports).
- */
-export class IntegrationConstantCalculator
-{
-    private readonly b_constants: number[]
-
-    /**
-     * @param deflection_supports - Support manager.
-     * @param structural_offset - Beam offset.
-     */
-    constructor(
-        private readonly deflection_supports: DeflectionSupportManager,
-        private readonly structural_offset: number
-    )
-    {
-        this.b_constants = deflection_supports.list_support_indexes().map(() => 0)
-    }
-
-    /**
-     * @param allocated_items - Load items.
-     * @returns Integration constants C1 and C2.
-     */
-    calculate_integration_constants(
-        allocated_items: AllocatedItemManager
-    ): [number, number]
-    {
-        this.calculate_b_constants(allocated_items)
-        const a_matrix = this.deflection_supports.list_support_indexes().map((index) => [
-            this.deflection_supports.get_position(index),
-            1
-        ])
-        const displacement = this.deflection_supports.get_position(1)
-            - this.deflection_supports.get_position(0)
-        const second_term = (-this.deflection_supports.get_force(0) / 6)
-            * displacement * displacement * displacement
-        const solution = solve_linear_system(a_matrix, [this.b_constants[0], this.b_constants[1] + second_term])
-        return [solution[0], solution[1]]
-    }
-
-    private calculate_b_constants(allocated_items: AllocatedItemManager): void
-    {
-        for (const item_index of allocated_items.list_item_indexes())
-        {
-            const item = allocated_items.get_item(item_index)
-            const center = item.zi + item.length / 2 + this.structural_offset
-            const factor = item.weight / 6
-            for (const support_index of this.deflection_supports.list_support_indexes())
-            {
-                const displacement = this.deflection_supports.get_position(support_index) - center
-                if (displacement > 0)
-                {
-                    this.b_constants[support_index] += factor * displacement ** 3
-                }
-            }
-        }
-    }
-}

package/src/core/physics/models/deflection/rodotrem_deflection.ts

@@ -1,57 +0,0 @@
-import { CHASSI_REFERENCE } from '../../../contracts/chassi_reference.js'
-import type { RodotremModel } from '../rodotrem_model.js'
-import type { ChassiForces } from '../chassi_forces.js'
-import type { MultiContainerAllocatedItems } from '../../items/multi_container_allocated_items.js'
-import { BeamDeflection } from './beam_deflection.js'
-import { calculate_deflection_indicator } from './deflection_tools.js'
-
-/**
- * Rodotrem semi + simple trailer deflection indicator sum.
- */
-export class RodotremDeflection
-{
-    /**
-     * @param rodotrem_model - Axle weight model.
-     * @param number_of_curve_samples - Curve sample count.
-     */
-    constructor(
-        private readonly rodotrem_model: RodotremModel,
-        private readonly number_of_curve_samples: number
-    )
-    {}
-
-    /**
-     * @param multi_items - Allocated items.
-     * @returns Combined deflection indicator.
-     */
-    calculate_deflection(multi_items: MultiContainerAllocatedItems): number
-    {
-        const forces = this.rodotrem_model.calculate_chassi_forces(multi_items)
-        const semi = this.semi_curve(multi_items, forces)
-        const simple = this.simple_curve(multi_items, forces)
-        return calculate_deflection_indicator(semi) + calculate_deflection_indicator(simple)
-    }
-
-    private semi_curve(multi_items: MultiContainerAllocatedItems, forces: ChassiForces): number[]
-    {
-        const pin = this.rodotrem_model.chassi.get_pin_position(0, CHASSI_REFERENCE.GROUPER_1)
-        const axle_3 = this.rodotrem_model.chassi.get_axle_position(2, CHASSI_REFERENCE.GROUPER_1)
-        const support: [number, number][] = [[pin, forces.get_force_on_pin(0)], [axle_3, forces.get_force_on_axle(2)]]
-        const items = multi_items.get_allocated_items_by_grouper_index(1)
-        const length = this.rodotrem_model.chassi.get_grouper_end(1, CHASSI_REFERENCE.GROUPER_1)
-        return new BeamDeflection(support, items).generate_curve_values(length, this.number_of_curve_samples)
-    }
-
-    private simple_curve(multi_items: MultiContainerAllocatedItems, forces: ChassiForces): number[]
-    {
-        const axle_4 = this.rodotrem_model.chassi.get_axle_position(3, CHASSI_REFERENCE.GROUPER_2)
-        const axle_5 = this.rodotrem_model.chassi.get_axle_position(4, CHASSI_REFERENCE.GROUPER_2)
-        const support: [number, number][] = [
-            [axle_4, forces.get_force_on_axle(3)],
-            [axle_5, forces.get_force_on_axle(4)]
-        ]
-        const items = multi_items.get_allocated_items_by_grouper_index(2)
-        const length = this.rodotrem_model.chassi.get_grouper_end(2, CHASSI_REFERENCE.GROUPER_2)
-        return new BeamDeflection(support, items).generate_curve_values(length, this.number_of_curve_samples)
-    }
-}

package/src/core/physics/models/deflection/semi_reboque_deflection.ts

@@ -1,40 +0,0 @@
-import type { SemiReboqueModel } from '../semi_reboque_model.js'
-import type { MultiContainerAllocatedItems } from '../../items/multi_container_allocated_items.js'
-import { BeamDeflection } from './beam_deflection.js'
-import { calculate_deflection_indicator } from './deflection_tools.js'
-
-/**
- * Semi-reboque beam deflection indicator.
- */
-export class SemiReboqueDeflection
-{
-    /**
-     * @param semi_reboque_model - Axle weight model.
-     * @param number_of_curve_samples - Curve sample count.
-     */
-    constructor(
-        private readonly semi_reboque_model: SemiReboqueModel,
-        private readonly number_of_curve_samples: number
-    )
-    {}
-
-    /**
-     * @param multi_items - Allocated items.
-     * @returns Deflection indicator scalar.
-     */
-    calculate_deflection(multi_items: MultiContainerAllocatedItems): number
-    {
-        const curve = this.calculate_deflection_curve(multi_items)
-        return calculate_deflection_indicator(curve)
-    }
-
-    private calculate_deflection_curve(multi_items: MultiContainerAllocatedItems): number[]
-    {
-        const support = this.semi_reboque_model.calculate_support_data(multi_items)
-        const allocated = multi_items.get_allocated_items_by_grouper_index(1)
-        const beam = new BeamDeflection(support, allocated)
-        return beam.generate_curve_values(
-            this.semi_reboque_model.calculate_container_length(),
-            this.number_of_curve_samples)
-    }
-}

package/src/core/physics/models/deflection/simple_truck_deflection.ts

@@ -1,35 +0,0 @@
-import type { SimpleTruckModel } from '../simple_truck_model.js'
-import type { MultiContainerAllocatedItems } from '../../items/multi_container_allocated_items.js'
-import { BeamDeflection } from './beam_deflection.js'
-import { calculate_deflection_indicator } from './deflection_tools.js'
-
-/**
- * Caminhão beam deflection indicator.
- */
-export class SimpleTruckDeflection
-{
-    /**
-     * @param simple_truck_model - Axle weight model.
-     * @param number_of_curve_samples - Curve sample count.
-     */
-    constructor(
-        private readonly simple_truck_model: SimpleTruckModel,
-        private readonly number_of_curve_samples: number
-    )
-    {}
-
-    /**
-     * @param multi_items - Allocated items.
-     * @returns Deflection indicator scalar.
-     */
-    calculate_deflection(multi_items: MultiContainerAllocatedItems): number
-    {
-        const support = this.simple_truck_model.calculate_support_data(multi_items)
-        const allocated = multi_items.get_allocated_items_by_grouper_index(1)
-        const beam = new BeamDeflection(support, allocated)
-        const curve = beam.generate_curve_values(
-            this.simple_truck_model.calculate_container_length(),
-            this.number_of_curve_samples)
-        return calculate_deflection_indicator(curve)
-    }
-}

package/src/core/physics/models/deflection/vanderleia_deflection.ts

@@ -1,48 +0,0 @@
-import { CHASSI_REFERENCE } from '../../../contracts/chassi_reference.js'
-import type { VanderleiaModel } from '../vanderleia_model.js'
-import type { MultiContainerAllocatedItems } from '../../items/multi_container_allocated_items.js'
-import { BeamDeflection } from './beam_deflection.js'
-import { calculate_deflection_indicator } from './deflection_tools.js'
-
-/**
- * Vanderleia trailer beam deflection indicator.
- */
-export class VanderleiaDeflection
-{
-    /**
-     * @param vanderleia_model - Axle weight model.
-     * @param number_of_curve_samples - Curve sample count.
-     */
-    constructor(
-        private readonly vanderleia_model: VanderleiaModel,
-        private readonly number_of_curve_samples: number
-    )
-    {}
-
-    /**
-     * @param multi_items - Allocated items.
-     * @returns Deflection indicator scalar.
-     */
-    calculate_deflection(multi_items: MultiContainerAllocatedItems): number
-    {
-        const support = this.generate_support_data(multi_items)
-        const allocated = multi_items.get_allocated_items_by_grouper_index(1)
-        const beam = new BeamDeflection(support, allocated)
-        const length = this.vanderleia_model.chassi.get_grouper_end(1, CHASSI_REFERENCE.GROUPER_1)
-        const curve = beam.generate_curve_values(length, this.number_of_curve_samples)
-        return calculate_deflection_indicator(curve)
-    }
-
-    private generate_support_data(multi_items: MultiContainerAllocatedItems): [number, number][]
-    {
-        const forces = this.vanderleia_model.calculate_chassi_forces(multi_items)
-        const trailer_force = forces.get_force_on_axle(2)
-            + forces.get_force_on_axle(3)
-            + forces.get_force_on_axle(4)
-        const pin = this.vanderleia_model.chassi.get_pin_position(0, CHASSI_REFERENCE.GROUPER_1)
-        const axle_3 = this.vanderleia_model.chassi.get_axle_position(2, CHASSI_REFERENCE.GROUPER_1)
-        const axle_5 = this.vanderleia_model.chassi.get_axle_position(4, CHASSI_REFERENCE.GROUPER_1)
-        const mean_axle = 0.5 * (axle_5 - axle_3) + axle_3
-        return [[pin, forces.get_force_on_pin(0)], [mean_axle, trailer_force]]
-    }
-}

package/src/core/physics/models/old_tare_model.ts

@@ -1,51 +0,0 @@
-import { VEHICLE_TYPE } from '../../contracts/vehicle_type.js'
-import type { Transport } from '../transports/transport.js'
-import { scale_tare } from './old_tare_scale.js'
-import { semireboque_tare } from './old_tare_semireboque.js'
-import { vanderleia_tare } from './old_tare_vanderleia.js'
-import { truck_tare } from './old_tare_truck.js'
-
-/**
- * Legacy tare split by vehicle type (Python OldTareModel).
- */
-export class OldTareModel
-{
-    /**
-     * @param transport - Parsed transport.
-     * @returns Tare per axle.
-     */
-    calculate(transport: Transport): number[]
-    {
-        return old_tare_by_vehicle(transport)
-    }
-}
-
-/**
- * @param transport - Parsed transport.
- * @returns Tare per axle for vehicle type.
- */
-export function old_tare_by_vehicle(transport: Transport): number[]
-{
-    const type = transport.vehicle_type
-    if (type === VEHICLE_TYPE.BITREM)
-    {
-        return scale_tare(transport.tare, [0.23, 0.255, 0.285, 0.23])
-    }
-    if (type === VEHICLE_TYPE.RODOTREM)
-    {
-        return scale_tare(transport.tare, [0.19, 0.28, 0.21, 0.16, 0.16])
-    }
-    if (type === VEHICLE_TYPE.SEMIREBOQUE || type === VEHICLE_TYPE.REBAIXADO)
-    {
-        return semireboque_tare(transport)
-    }
-    if (type === VEHICLE_TYPE.VANDERLEIA)
-    {
-        return vanderleia_tare(transport)
-    }
-    if (type === VEHICLE_TYPE.CAMINHAO || type === VEHICLE_TYPE.VUC)
-    {
-        return truck_tare(transport)
-    }
-    return []
-}

package/src/core/physics/models/old_tare_scale.ts

@@ -1,9 +0,0 @@
-/**
- * @param tare - Total vehicle tare.
- * @param multipliers - Per-axle factors.
- * @returns Scaled tare list.
- */
-export function scale_tare(tare: number, multipliers: number[]): number[]
-{
-    return multipliers.map((factor) => tare * factor)
-}

package/src/core/physics/models/old_tare_semireboque.ts

@@ -1,51 +0,0 @@
-import { VEHICLE_VERSION } from '../../contracts/vehicle_version.js'
-import type { Transport } from '../transports/transport.js'
-import { scale_tare } from './old_tare_scale.js'
-
-const TRUNCATED_LIMIT = 13000
-
-/**
- * @param transport - Parsed transport.
- * @returns Semireboque tare per axle.
- */
-export function semireboque_tare(transport: Transport): number[]
-{
-    const version = transport.vehicle_version
-    if (version === VEHICLE_VERSION.SEMIREBOQUE_QUAD
-        || version === VEHICLE_VERSION.SEMIREBOQUE_QUAD_ALT)
-    {
-        return scale_tare(transport.tare, [0.27509640559, 0.29967158355, 0.11978366503, 0.30544834583])
-    }
-    if (version === VEHICLE_VERSION.SEMIREBOQUE_BITRUCK)
-    {
-        return scale_tare(transport.tare, [0.17852139406, 0.17852139406, 0.43218944824, 0.21076776365])
-    }
-    return semireboque_standard_tare(transport)
-}
-
-function semireboque_standard_tare(transport: Transport): number[]
-{
-    const axle_1_max = transport.axle_manager.get_axle(1).max_supported_weight
-    if (axle_1_max > TRUNCATED_LIMIT)
-    {
-        return semireboque_heavy_axle_tare(transport.tare)
-    }
-    if (transport.tare < 18500)
-    {
-        return scale_tare(transport.tare, [0.312, 0.2, 0.488])
-    }
-    return scale_tare(transport.tare, [0.26, 0.35, 0.39])
-}
-
-function semireboque_heavy_axle_tare(tare: number): number[]
-{
-    if (tare > 19000)
-    {
-        return scale_tare(tare, [0.24, 0.35, 0.41])
-    }
-    if (tare > 17000)
-    {
-        return scale_tare(tare, [0.3, 0.315, 0.385])
-    }
-    return scale_tare(tare, [0.286, 0.379, 0.335])
-}

package/src/core/physics/models/old_tare_truck.ts

@@ -1,15 +0,0 @@
-import { VEHICLE_VERSION } from '../../contracts/vehicle_version.js'
-import type { Transport } from '../transports/transport.js'
-import { scale_tare } from './old_tare_scale.js'
-
-/**
- * @param transport - Truck or VUC transport.
- * @returns Tare per axle.
- */
-export function truck_tare(transport: Transport): number[]
-{
-    const multipliers = transport.vehicle_version === VEHICLE_VERSION.CAMINHAO_BITRUCK
-        ? [0.2834844826865682, 0.28348448268656806, 0.43303103462686376]
-        : [0.452, 0.548]
-    return scale_tare(transport.tare, multipliers)
-}

package/src/core/physics/models/old_tare_vanderleia.ts

@@ -1,44 +0,0 @@
-import type { Transport } from '../transports/transport.js'
-import { scale_tare } from './old_tare_scale.js'
-
-const TRUNCATED_LIMIT = 13000
-
-/**
- * @param transport - Parsed transport.
- * @returns Vanderleia tare per axle.
- */
-export function vanderleia_tare(transport: Transport): number[]
-{
-    const axle_1_max = transport.axle_manager.get_axle(1).max_supported_weight
-    if (axle_1_max > TRUNCATED_LIMIT)
-    {
-        return vanderleia_heavy_axle_tare(transport.tare)
-    }
-    return vanderleia_light_axle_tare(transport.tare)
-}
-
-function vanderleia_heavy_axle_tare(tare: number): number[]
-{
-    if (tare > 23500)
-    {
-        return scale_tare(tare, [0.22, 0.33, 0.155, 0.155, 0.14])
-    }
-    if (tare > 21000)
-    {
-        return scale_tare(tare, [0.25, 0.32, 0.145, 0.145, 0.14])
-    }
-    return scale_tare(tare, [0.267, 0.314, 0.141, 0.141, 0.137])
-}
-
-function vanderleia_light_axle_tare(tare: number): number[]
-{
-    if (tare > 23500)
-    {
-        return scale_tare(tare, [0.22, 0.24, 0.185, 0.185, 0.17])
-    }
-    if (tare > 21000)
-    {
-        return scale_tare(tare, [0.25, 0.2, 0.185, 0.185, 0.18])
-    }
-    return scale_tare(tare, [0.267, 0.164, 0.191, 0.191, 0.187])
-}

package/src/core/physics/models/percentage_on_axles_calculator.ts

@@ -1,49 +0,0 @@
-import { VEHICLE_TYPE } from '../../contracts/vehicle_type.js'
-import type { Transport } from '../transports/transport.js'
-
-/**
- * Converts loaded cargo per axle into utilization percentages.
- */
-export class PercentageOnAxlesCalculator
-{
-    /**
-     * @param transport - Parsed transport.
-     */
-    constructor(private readonly transport: Transport)
-    {}
-
-    /**
-     * @param loaded_weight_list - Cargo load per axle index.
-     * @returns Utilization ratio per axle (bitrem: 4 entries).
-     */
-    weight_on_axles_to_percentages(loaded_weight_list: number[]): number[]
-    {
-        if (this.transport.vehicle_type === VEHICLE_TYPE.BITREM)
-        {
-            return [
-                this.calculate_percentage(0, loaded_weight_list[0]),
-                this.calculate_percentage(1, loaded_weight_list[1]),
-                this.calculate_bitrem_joined_percentage(
-                    loaded_weight_list[2] + loaded_weight_list[3]),
-                this.calculate_percentage(4, loaded_weight_list[4])
-            ]
-        }
-        return this.transport.axle_manager.list_axles_indexes().map((index) =>
-            this.calculate_percentage(index, loaded_weight_list[index]))
-    }
-
-    private calculate_percentage(axle_index: number, loaded_weight: number): number
-    {
-        const axle = this.transport.axle_manager.get_axle(axle_index)
-        return (loaded_weight + axle.tare) / axle.max_supported_weight
-    }
-
-    private calculate_bitrem_joined_percentage(loaded_weight: number): number
-    {
-        const axle_2 = this.transport.axle_manager.get_axle(2)
-        const axle_3 = this.transport.axle_manager.get_axle(3)
-        const total_tare = axle_2.tare + axle_3.tare
-        const total_max = axle_2.max_supported_weight + axle_3.max_supported_weight
-        return (loaded_weight + total_tare) / total_max
-    }
-}

package/src/core/physics/models/quad_semi_trailer_model.ts

@@ -1,87 +0,0 @@
-import type { Transport } from '../transports/transport.js'
-import { Chassi } from '../transports/chassi.js'
-import { CHASSI_REFERENCE } from '../../contracts/chassi_reference.js'
-import { CenterOfMass } from '../items/center_of_mass.js'
-import { ChassiForces } from './chassi_forces.js'
-import { SemiReboqueBase } from './semi_reboque_base.js'
-import { solve_linear_system } from '../../math/gaussian_elimination.js'
-
-/**
- * Quad-axle semi-trailer (equivalent semi + 2×2 split on axles 3–4).
- */
-export class QuadSemiTrailerModel
-{
-    private readonly chassi: Chassi
-    readonly equivalent_semi_trailer: SemiReboqueBase
-
-    /**
-     * @param transport - Parsed transport.
-     */
-    constructor(transport: Transport)
-    {
-        this.chassi = new Chassi(transport)
-        this.equivalent_semi_trailer = new SemiReboqueBase(transport)
-        this.equivalent_semi_trailer.set_linear_system_matrix(
-            get_equivalent_chassi_positions(this.chassi, transport))
-    }
-
-    /**
-     * @param center_of_mass_by_grouper - CM per grouper.
-     * @returns Four-axle chassis forces.
-     */
-    calculate_chassi_forces_with_load_center_of_mass(
-        center_of_mass_by_grouper: Record<number, CenterOfMass>
-    ): ChassiForces
-    {
-        const equivalent = this.equivalent_semi_trailer
-            .calculate_chassi_forces_with_load_center_of_mass(center_of_mass_by_grouper)
-        const equivalent_z = this.equivalent_semi_trailer.chassi_positions[4]
-        const independent = [
-            equivalent.get_force_on_axle(2),
-            equivalent.get_force_on_axle(2) * equivalent_z
-        ]
-        const quad = solve_linear_system(generate_quad_matrix(this.chassi), independent)
-        const forces = new ChassiForces()
-        forces.add_axle_forces([
-            equivalent.get_force_on_axle(0),
-            equivalent.get_force_on_axle(1),
-            quad[0],
-            quad[1]
-        ])
-        forces.add_pin_forces([equivalent.get_force_on_pin(0)])
-        return forces
-    }
-}
-
-/**
- * @param chassi - Chassis geometry.
- * @returns 2×2 quad axle matrix.
- */
-function generate_quad_matrix(chassi: Chassi): number[][]
-{
-    const semi_axle_3 = chassi.get_axle_position(2, CHASSI_REFERENCE.GROUPER_1)
-    const semi_axle_4 = chassi.get_axle_position(3, CHASSI_REFERENCE.GROUPER_1)
-    return [[1, 1], [semi_axle_3, semi_axle_4]]
-}
-
-/**
- * @param chassi - Chassis geometry.
- * @param transport - Parsed transport.
- * @returns Equivalent 5-position layout for semi base.
- */
-function get_equivalent_chassi_positions(chassi: Chassi, transport: Transport): number[]
-{
-    const tractor_pin = chassi.get_pin_position(0, CHASSI_REFERENCE.TRACTOR)
-    const tractor_axle_1 = chassi.get_axle_position(0, CHASSI_REFERENCE.TRACTOR)
-    const tractor_axle_2 = chassi.get_axle_position(1, CHASSI_REFERENCE.TRACTOR)
-    const semi_pin = chassi.get_pin_position(0, CHASSI_REFERENCE.GROUPER_1)
-    const semi_axle_3 = chassi.get_axle_position(2, CHASSI_REFERENCE.GROUPER_1)
-    const semi_axle_4 = chassi.get_axle_position(3, CHASSI_REFERENCE.GROUPER_1)
-    const axle_3 = transport.axle_manager.get_axle(2)
-    const axle_4 = transport.axle_manager.get_axle(3)
-    const semi_equivalent = (
-        semi_axle_3 * axle_3.max_supported_weight
-        + semi_axle_4 * axle_4.max_supported_weight
-    ) / (axle_3.max_supported_weight + axle_4.max_supported_weight)
-    return [tractor_pin, tractor_axle_1, tractor_axle_2, semi_pin, semi_equivalent]
-}