@jetta/axle-load-calculator 0.1.3 → 0.2.0

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

@@ -1,131 +0,0 @@
-import type { Transport } from '../transports/transport.js'
-import type { MultiContainerAllocatedItems } from '../items/multi_container_allocated_items.js'
-import { calculate_chassi_forces_from_multi } from '../items/compute_grouper_center_of_mass.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 { solve_linear_system } from '../../math/gaussian_elimination.js'
-
-/**
- * Rodotrem: semi+tractor 4×4 plus simple trailer 2-axle lever.
- */
-export class RodotremModel
-{
-    readonly chassi: Chassi
-    private readonly matrix: number[][]
-
-    /**
-     * @param transport - Parsed transport.
-     */
-    constructor(private readonly transport: Transport)
-    {
-        this.chassi = new Chassi(transport)
-        this.matrix = generate_rodotrem_semi_matrix(this.chassi)
-    }
-
-    /**
-     * @param multi_items - Allocated items.
-     * @returns Loaded weights per axle.
-     */
-    calculate_weight_on_axles(multi_items: MultiContainerAllocatedItems): number[]
-    {
-        const forces = this.calculate_chassi_forces(multi_items)
-        return forces.list_axles_indexes().map((index) => forces.get_force_on_axle(index))
-    }
-
-    /**
-     * @param multi_items - Allocated items.
-     * @returns Chassis forces.
-     */
-    calculate_chassi_forces(multi_items: MultiContainerAllocatedItems): ChassiForces
-    {
-        return calculate_chassi_forces_from_multi(
-            this.transport,
-            multi_items,
-            (center_of_mass_by_grouper) =>
-                this.calculate_chassi_forces_with_load_center_of_mass(center_of_mass_by_grouper))
-    }
-
-    /**
-     * @param center_of_mass_by_grouper - CM for groupers 1 and 2.
-     * @returns Five-axle chassis forces.
-     */
-    calculate_chassi_forces_with_load_center_of_mass(
-        center_of_mass_by_grouper: Record<number, CenterOfMass>
-    ): ChassiForces
-    {
-        const semi_solution = solve_semi_tractor_system(
-            this.matrix,
-            center_of_mass_by_grouper[1])
-        const simple_solution = solve_simple_trailer_system(
-            this.chassi,
-            center_of_mass_by_grouper[2])
-        const forces = new ChassiForces()
-        forces.add_pin_forces([semi_solution[1]])
-        forces.add_axle_forces([
-            semi_solution[3],
-            semi_solution[2],
-            semi_solution[0],
-            simple_solution[1],
-            simple_solution[0]
-        ])
-        return forces
-    }
-}
-
-/**
- * @param chassi - Chassis geometry.
- * @returns Semi+tractor 4×4 matrix.
- */
-function generate_rodotrem_semi_matrix(chassi: Chassi): 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)
-    return [
-        [1, 1, 0, 0],
-        [semi_axle_3, semi_pin, 0, 0],
-        [0, -1, 1, 1],
-        [0, -tractor_pin, tractor_axle_2, tractor_axle_1]
-    ]
-}
-
-/**
- * @param matrix - Semi system matrix.
- * @param center_of_mass - Semi trailer CM.
- * @returns 4-vector solution.
- */
-function solve_semi_tractor_system(matrix: number[][], center_of_mass: CenterOfMass): number[]
-{
-    const independent = [
-        center_of_mass.mass,
-        center_of_mass.mass * center_of_mass.z,
-        0,
-        0
-    ]
-    return solve_linear_system(matrix, independent)
-}
-
-/**
- * @param chassi - Chassis geometry.
- * @param center_of_mass - Simple trailer CM.
- * @returns Two-axle lever solution [axle4, axle5].
- */
-function solve_simple_trailer_system(
-    chassi: Chassi,
-    center_of_mass: CenterOfMass
-): [number, number]
-{
-    const axle_4 = chassi.get_axle_position(3, CHASSI_REFERENCE.GROUPER_2)
-    const axle_5 = chassi.get_axle_position(4, CHASSI_REFERENCE.GROUPER_2)
-    const axle_4_force = center_of_mass.mass
-        * (axle_4 - center_of_mass.z)
-        / (axle_4 - axle_5)
-    const axle_5_force = center_of_mass.mass
-        * (center_of_mass.z - axle_5)
-        / (axle_4 - axle_5)
-    return [axle_4_force, axle_5_force]
-}

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

@@ -1,103 +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 { solve_linear_system } from '../../math/gaussian_elimination.js'
-
-/**
- * Semi-trailer 4×4 static system base.
- */
-export class SemiReboqueBase
-{
-    chassi_positions: number[] = []
-    private matrix: number[][] = []
-
-    /**
-     * @param transport - Parsed transport.
-     */
-    constructor(private readonly transport: Transport)
-    {
-        this.set_linear_system_matrix()
-    }
-
-    /**
-     * @param center_of_mass_by_grouper - CM per grouper.
-     * @returns Chassis forces.
-     */
-    calculate_chassi_forces_with_load_center_of_mass(
-        center_of_mass_by_grouper: Record<number, CenterOfMass>
-    ): ChassiForces
-    {
-        const solution = this.solve_weight_on_axles_system(center_of_mass_by_grouper[1])
-        const forces = new ChassiForces()
-        forces.add_pin_forces([solution[1]])
-        forces.add_axle_forces([solution[3], solution[2], solution[0]])
-        return forces
-    }
-
-    /**
-     * @param chassi_positions - Optional preset positions.
-     */
-    set_linear_system_matrix(chassi_positions?: number[]): void
-    {
-        if (chassi_positions)
-        {
-            this.chassi_positions = chassi_positions
-        }
-        else
-        {
-            this.chassi_positions = this.get_chassi_positions()
-        }
-        this.matrix = build_semi_matrix(this.chassi_positions)
-    }
-
-    /**
-     * @param center_of_mass - Load CM.
-     * @returns 4-vector solution.
-     */
-    private solve_weight_on_axles_system(center_of_mass: CenterOfMass): number[]
-    {
-        const independent = [
-            center_of_mass.mass,
-            center_of_mass.mass * center_of_mass.z,
-            0,
-            0
-        ]
-        return solve_linear_system(this.matrix, independent)
-    }
-
-    /**
-     * @returns Default chassis positions for semi system.
-     */
-    private get_chassi_positions(): number[]
-    {
-        const chassi = new Chassi(this.transport)
-        return [
-            chassi.get_pin_position(0, CHASSI_REFERENCE.TRACTOR),
-            chassi.get_axle_position(0, CHASSI_REFERENCE.TRACTOR),
-            chassi.get_axle_position(1, CHASSI_REFERENCE.TRACTOR),
-            chassi.get_pin_position(0, CHASSI_REFERENCE.GROUPER_1),
-            chassi.get_axle_position(2, CHASSI_REFERENCE.GROUPER_1)
-        ]
-    }
-}
-
-/**
- * @param positions - Pin and axle positions.
- * @returns 4×4 coefficient matrix.
- */
-function build_semi_matrix(positions: number[]): number[][]
-{
-    const tractor_pin = positions[0]
-    const tractor_axle_1 = positions[1]
-    const tractor_axle_2 = positions[2]
-    const semi_pin = positions[3]
-    const semi_axle_3 = positions[4]
-    return [
-        [1, 1, 0, 0],
-        [semi_axle_3, semi_pin, 0, 0],
-        [0, -1, 1, 1],
-        [0, -tractor_pin, tractor_axle_2, tractor_axle_1]
-    ]
-}

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

@@ -1,127 +0,0 @@
-import type { Transport } from '../transports/transport.js'
-import { MergedContainers } from '../transports/merged_containers.js'
-import type { MultiContainerAllocatedItems } from '../items/multi_container_allocated_items.js'
-import {
-    calculate_chassi_forces_from_multi,
-    compute_center_of_mass_by_grouper
-} from '../items/compute_grouper_center_of_mass.js'
-import { VEHICLE_VERSION } from '../../contracts/vehicle_version.js'
-import { CenterOfMass } from '../items/center_of_mass.js'
-import { ChassiForces } from './chassi_forces.js'
-import { SemiReboqueBase } from './semi_reboque_base.js'
-import { QuadSemiTrailerModel } from './quad_semi_trailer_model.js'
-import { BiTruckTractorSemiTrailerModel } from './bi_truck_tractor_semi_trailer_model.js'
-
-type SemiDelegate = {
-    calculate_chassi_forces_with_load_center_of_mass: (
-        center_of_mass_by_grouper: Record<number, CenterOfMass>
-    ) => ChassiForces
-}
-
-/**
- * Semi-reboque axle weight with quad/bitruck variants.
- */
-export class SemiReboqueModel
-{
-    private readonly delegate: SemiDelegate & {
-        chassi_positions?: number[]
-        equivalent_semi_trailer?: SemiReboqueBase
-    }
-    private readonly transport: Transport
-    private readonly merged_containers: MergedContainers
-
-    /**
-     * @param transport - Parsed transport.
-     */
-    constructor(transport: Transport)
-    {
-        this.transport = transport
-        this.merged_containers = new MergedContainers(transport)
-        if (transport.vehicle_version === VEHICLE_VERSION.SEMIREBOQUE_QUAD
-            || transport.vehicle_version === VEHICLE_VERSION.SEMIREBOQUE_QUAD_ALT)
-        {
-            this.delegate = new QuadSemiTrailerModel(transport)
-        }
-        else if (transport.vehicle_version === VEHICLE_VERSION.SEMIREBOQUE_BITRUCK)
-        {
-            this.delegate = new BiTruckTractorSemiTrailerModel(transport)
-        }
-        else
-        {
-            const base = new SemiReboqueBase(transport)
-            base.set_linear_system_matrix()
-            this.delegate = base
-        }
-    }
-
-    /**
-     * @param multi_items - Allocated items.
-     * @returns Loaded weights per axle.
-     */
-    calculate_weight_on_axles(multi_items: MultiContainerAllocatedItems): number[]
-    {
-        const forces = this.calculate_chassi_forces(multi_items)
-        return forces.list_axles_indexes().map((index) => forces.get_force_on_axle(index))
-    }
-
-    /**
-     * @param multi_items - Allocated items.
-     * @returns Chassis forces.
-     */
-    calculate_chassi_forces(multi_items: MultiContainerAllocatedItems): ChassiForces
-    {
-        return calculate_chassi_forces_from_multi(
-            this.transport,
-            multi_items,
-            (center_of_mass_by_grouper) =>
-                this.calculate_chassi_forces_with_load_center_of_mass(center_of_mass_by_grouper))
-    }
-
-    /**
-     * @param multi_items - Allocated items.
-     * @returns Deflection support pairs.
-     */
-    calculate_support_data(multi_items: MultiContainerAllocatedItems): [number, number][]
-    {
-        const quad_or_bitruck = this.transport.vehicle_version === VEHICLE_VERSION.SEMIREBOQUE_QUAD
-            || this.transport.vehicle_version === VEHICLE_VERSION.SEMIREBOQUE_QUAD_ALT
-            || this.transport.vehicle_version === VEHICLE_VERSION.SEMIREBOQUE_BITRUCK
-        if (quad_or_bitruck)
-        {
-            const center_of_mass_by_grouper = compute_center_of_mass_by_grouper(
-                multi_items,
-                this.merged_containers)
-            const quad = this.delegate as QuadSemiTrailerModel
-            const forces = quad.equivalent_semi_trailer
-                .calculate_chassi_forces_with_load_center_of_mass(center_of_mass_by_grouper)
-            const positions = quad.equivalent_semi_trailer.chassi_positions
-            return [[positions[3], forces.get_force_on_pin(0)], [positions[4], forces.get_force_on_axle(2)]]
-        }
-        const forces = this.calculate_chassi_forces(multi_items)
-        const base = this.delegate as SemiReboqueBase
-        return [
-            [base.chassi_positions[3], forces.get_force_on_pin(0)],
-            [base.chassi_positions[4], forces.get_force_on_axle(2)]
-        ]
-    }
-
-    /**
-     * @returns Merged grouper 1 length.
-     */
-    calculate_container_length(): number
-    {
-        return this.merged_containers.get_container_by_grouper_index(1).length
-    }
-
-    /**
-     * @param center_of_mass_by_grouper - CM per grouper.
-     * @returns Chassis forces.
-     */
-    calculate_chassi_forces_with_load_center_of_mass(
-        center_of_mass_by_grouper: Record<number, CenterOfMass>
-    ): ChassiForces
-    {
-        return this.delegate.calculate_chassi_forces_with_load_center_of_mass(
-            center_of_mass_by_grouper)
-    }
-}

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

@@ -1,70 +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'
-
-/**
- * Two-axle truck lever equilibrium.
- */
-export class SimpleTruckBase
-{
-    axles_positions: number[] = []
-
-    /**
-     * @param transport - Parsed transport.
-     */
-    constructor(private readonly transport: Transport)
-    {
-        this.set_axles_positions()
-    }
-
-    /**
-     * @param center_of_mass_by_grouper - CM per grouper id.
-     * @returns Chassis forces.
-     */
-    calculate_chassi_forces_with_load_center_of_mass(
-        center_of_mass_by_grouper: Record<number, CenterOfMass>
-    ): ChassiForces
-    {
-        const center_of_mass = center_of_mass_by_grouper[1]
-        const [axle_1, axle_2] = this.solve_linear_system(center_of_mass)
-        const forces = new ChassiForces()
-        forces.add_axle_forces([axle_1, axle_2])
-        return forces
-    }
-
-    /**
-     * @param axles_positions - Optional preset positions.
-     */
-    set_axles_positions(axles_positions?: number[]): void
-    {
-        if (axles_positions)
-        {
-            this.axles_positions = axles_positions
-            return
-        }
-        const chassi = new Chassi(this.transport)
-        this.axles_positions = [
-            chassi.get_axle_position(0, CHASSI_REFERENCE.GROUPER_1),
-            chassi.get_axle_position(1, CHASSI_REFERENCE.GROUPER_1)
-        ]
-    }
-
-    /**
-     * @param center_of_mass - Load center of mass.
-     * @returns Axle 1 and 2 cargo reactions.
-     */
-    private solve_linear_system(center_of_mass: CenterOfMass): [number, number]
-    {
-        const axle_1_position = this.axles_positions[0]
-        const axle_2_position = this.axles_positions[1]
-        const axle_1 = center_of_mass.mass
-            * (center_of_mass.z - axle_2_position)
-            / (axle_1_position - axle_2_position)
-        const axle_2 = center_of_mass.mass
-            * (axle_1_position - center_of_mass.z)
-            / (axle_1_position - axle_2_position)
-        return [axle_1, axle_2]
-    }
-}

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

@@ -1,115 +0,0 @@
-import type { Transport } from '../transports/transport.js'
-import { MergedContainers } from '../transports/merged_containers.js'
-import type { MultiContainerAllocatedItems } from '../items/multi_container_allocated_items.js'
-import {
-    calculate_chassi_forces_from_multi,
-    compute_center_of_mass_by_grouper
-} from '../items/compute_grouper_center_of_mass.js'
-import { VEHICLE_VERSION } from '../../contracts/vehicle_version.js'
-import { CenterOfMass } from '../items/center_of_mass.js'
-import { ChassiForces } from './chassi_forces.js'
-import { SimpleTruckBase } from './simple_truck_base.js'
-import { BiTruckModel } from './bi_truck_model.js'
-
-type TruckDelegate = {
-    calculate_chassi_forces_with_load_center_of_mass: (
-        center_of_mass_by_grouper: Record<number, CenterOfMass>
-    ) => ChassiForces
-}
-
-/**
- * Caminhão / VUC axle weight (optional bitruck variant).
- */
-export class SimpleTruckModel
-{
-    private readonly delegate: TruckDelegate & { axles_positions?: number[]; equivalent_truck?: SimpleTruckBase }
-    private readonly transport: Transport
-    private readonly merged_containers: MergedContainers
-
-    /**
-     * @param transport - Parsed transport.
-     */
-    constructor(transport: Transport)
-    {
-        this.transport = transport
-        this.merged_containers = new MergedContainers(transport)
-        if (transport.vehicle_version === VEHICLE_VERSION.CAMINHAO_BITRUCK)
-        {
-            this.delegate = new BiTruckModel(transport)
-        }
-        else
-        {
-            const base = new SimpleTruckBase(transport)
-            base.set_axles_positions()
-            this.delegate = base
-        }
-    }
-
-    /**
-     * @param multi_items - Allocated items.
-     * @returns Loaded weights per axle.
-     */
-    calculate_weight_on_axles(multi_items: MultiContainerAllocatedItems): number[]
-    {
-        const forces = this.calculate_chassi_forces(multi_items)
-        return forces.list_axles_indexes().map((index) => forces.get_force_on_axle(index))
-    }
-
-    /**
-     * @param multi_items - Allocated items.
-     * @returns Chassis forces.
-     */
-    calculate_chassi_forces(multi_items: MultiContainerAllocatedItems): ChassiForces
-    {
-        return calculate_chassi_forces_from_multi(
-            this.transport,
-            multi_items,
-            (center_of_mass_by_grouper) =>
-                this.calculate_chassi_forces_with_load_center_of_mass(center_of_mass_by_grouper))
-    }
-
-    /**
-     * @param multi_items - Allocated items.
-     * @returns Deflection support pairs.
-     */
-    calculate_support_data(multi_items: MultiContainerAllocatedItems): [number, number][]
-    {
-        if (this.transport.vehicle_version === VEHICLE_VERSION.CAMINHAO_BITRUCK)
-        {
-            const center_of_mass_by_grouper = compute_center_of_mass_by_grouper(
-                multi_items,
-                this.merged_containers)
-            const bi_truck = this.delegate as BiTruckModel
-            const forces = bi_truck.equivalent_truck
-                .calculate_chassi_forces_with_load_center_of_mass(center_of_mass_by_grouper)
-            const positions = bi_truck.equivalent_truck.axles_positions
-            return [[positions[0], forces.get_force_on_axle(0)], [positions[1], forces.get_force_on_axle(1)]]
-        }
-        const forces = this.calculate_chassi_forces(multi_items)
-        const base = this.delegate as SimpleTruckBase
-        return [
-            [base.axles_positions[0], forces.get_force_on_axle(0)],
-            [base.axles_positions[1], forces.get_force_on_axle(1)]
-        ]
-    }
-
-    /**
-     * @returns Merged grouper 1 length.
-     */
-    calculate_container_length(): number
-    {
-        return this.merged_containers.get_container_by_grouper_index(1).length
-    }
-
-    /**
-     * @param center_of_mass_by_grouper - CM per grouper.
-     * @returns Chassis forces.
-     */
-    calculate_chassi_forces_with_load_center_of_mass(
-        center_of_mass_by_grouper: Record<number, CenterOfMass>
-    ): ChassiForces
-    {
-        return this.delegate.calculate_chassi_forces_with_load_center_of_mass(
-            center_of_mass_by_grouper)
-    }
-}

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

@@ -1,56 +0,0 @@
-import { CenterOfMass } from '../items/center_of_mass.js'
-import { AxleWeightModel } from './axle_weight_model.js'
-import type { Transport } from '../transports/transport.js'
-
-/**
- * Physics-based tare from uniform load at volume centroid.
- */
-export class SingleContainerTare
-{
-    /**
-     * @param transport - Parsed transport.
-     */
-    constructor(private readonly transport: Transport)
-    {}
-
-    /**
-     * @returns Calculated tare per axle.
-     */
-    calculate(): number[]
-    {
-        const forces = this.calculate_forces_on_axles(
-            this.calculate_z_centroid(),
-            this.transport.supported_weight)
-        return this.transport.axle_manager.list_axles_indexes().map((index) =>
-        {
-            const axle = this.transport.axle_manager.get_axle(index)
-            return axle.max_supported_weight - forces.get_force_on_axle(index)
-        })
-    }
-
-    private calculate_z_centroid(): number
-    {
-        let z_offset = 0
-        let sum_z = 0
-        let total_volume = 0
-        for (const sequence of this.transport.list_containers_sequence_indexes())
-        {
-            const container = this.transport.get_container_by_sequence_index(sequence)
-            const z_centroid = z_offset + container.length / 2
-            z_offset += container.length
-            const volume = container.volume()
-            sum_z += z_centroid * volume
-            total_volume += volume
-        }
-        return sum_z / total_volume
-    }
-
-    private calculate_forces_on_axles(z_position: number, mass: number)
-    {
-        const model = new AxleWeightModel(this.transport)
-        const center_of_mass = new CenterOfMass()
-        center_of_mass.z = z_position
-        center_of_mass.mass = mass
-        return model.calculate_chassi_forces_with_load_center_of_mass({ 1: center_of_mass })
-    }
-}

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

@@ -1,46 +0,0 @@
-import { VEHICLE_TYPE } from '../../contracts/vehicle_type.js'
-import type { Transport } from '../transports/transport.js'
-import { OldTareModel } from './old_tare_model.js'
-import { SingleContainerTare } from './single_container_tare.js'
-
-const DISTANCE_TOLERANCE = 0.9
-
-/**
- * Selects legacy or physics tare model per axle.
- */
-export class TareModel
-{
-    /**
-     * @param transport - Parsed transport.
-     * @returns Tare per axle.
-     */
-    calculate(transport: Transport): number[]
-    {
-        if (transport.vehicle_type === VEHICLE_TYPE.BITREM
-            || transport.vehicle_type === VEHICLE_TYPE.RODOTREM)
-        {
-            return new OldTareModel().calculate(transport)
-        }
-        const reference = new OldTareModel().calculate(transport)
-        const physics = new SingleContainerTare(transport).calculate()
-        return choose_tare_model(reference, physics)
-    }
-}
-
-/**
- * @param reference_values - Legacy tare per axle.
- * @param new_values - Physics tare per axle.
- * @returns Selected tare list.
- */
-function choose_tare_model(reference_values: number[], new_values: number[]): number[]
-{
-    for (let index = 0; index < reference_values.length; index++)
-    {
-        const ref = reference_values[index]
-        if (Math.abs(new_values[index] - ref) > ref * DISTANCE_TOLERANCE)
-        {
-            return reference_values
-        }
-    }
-    return new_values
-}