How cubickt/cargo works
Cargo is a Java desktop tool for checking whether a selected cargo shape fits the railway clearance envelope on a curve. The workflow selects cargo, gathers track and structure parameters, classifies protrusions by degree and zone, computes permitted movement mode and minimum clearances, then displays a diagram. The graph keeps geometry and clearance-table data distinct from calculation and Swing presentation. Some setup and enum implementations were not excerpted, so their internal links are omitted where the shown evidence does not establish a call.
Main entry points: Calculator.java Calculation orchestration · ResultCalculator.java Clearance and mode · Main.java Application entry · DrawPanel.java Calculation diagram
Components 23
Application workflow
- Application entry
src/main/java/com/cargo/Main.java - Cargo selection
src/main/java/com/cargo/Main.java - Track parameters
src/main/java/com/cargo/IO/CalculationParameters.java
Clearance calculation
- Calculation orchestration
src/main/java/com/cargo/Calculator/Calculator.java - Degree classification
src/main/java/com/cargo/util/GeometryUtils.java - Clearance and mode
src/main/java/com/cargo/Calculator/ResultCalculator.java
Geometry and domain
- Cargo and envelope
src/main/java/com/cargo/model/ShapeModel.java - Oversize zones
src/main/java/com/cargo/model/ZoneModel.java - Zone initialization
src/main/java/com/cargo/util/InitializationUtils.java - Geometry interface
src/main/java/com/cargo/util/GeometricShape.java - Geometry utilities
src/main/java/com/cargo/util/GeometryUtils.java - Coordinate utilities
src/main/java/com/cargo/util/Utils.java - Calculation result
src/main/java/com/cargo/model/Result.java - Result interface
src/main/java/com/cargo/model/ResultInterface.java
Clearance data
- Side degrees
src/main/java/com/cargo/data/DegreesSide.java - Top degrees
src/main/java/com/cargo/data/DegreesTop.java - Lower degrees
src/main/java/com/cargo/data/DegreesLower.java - Gap table reader
src/main/java/com/cargo/data/GapTableReader.java - Gap table row
src/main/java/com/cargo/data/GapTableRow.java - Clearance values
src/main/resources/com/cargo/data/gapTable.json
Diagram and UI
- Results window
src/main/java/com/cargo/ui/MainFrame.java - Calculation diagram
src/main/java/com/cargo/ui/DrawPanel.java
Other components
- Operator
Connections 29
- Operator → Application entry: starts
src/main/java/com/cargo/Main.java - Application entry → Cargo selection: offers choices
src/main/java/com/cargo/Main.java - Operator → Cargo selection: selects cargo
src/main/java/com/cargo/Main.java - Application entry → Calculation orchestration: requests calculation
src/main/java/com/cargo/Main.java - Calculation orchestration → Track parameters: reads input
src/main/java/com/cargo/Calculator/Calculator.java - Operator → Track parameters: enters parameters
src/main/java/com/cargo/IO/CalculationParameters.java - Calculation orchestration → Geometry utilities: classifies shape
src/main/java/com/cargo/Calculator/Calculator.java - Geometry utilities → Degree classification: implements
src/main/java/com/cargo/util/GeometryUtils.java - Calculation orchestration → Zone initialization: initializes zones
src/main/java/com/cargo/Calculator/Calculator.java - Zone initialization → Oversize zones: creates zones
src/main/java/com/cargo/util/InitializationUtils.java - Calculation orchestration → Gap table reader: loads table
src/main/java/com/cargo/Calculator/Calculator.java - Gap table reader → Gap table row: builds rows
src/main/java/com/cargo/data/GapTableReader.java - Gap table reader → Clearance values: reads resource
- Calculation orchestration → Clearance and mode: delegates calculation
src/main/java/com/cargo/Calculator/Calculator.java - Clearance and mode → Side degrees: maps side degree
src/main/java/com/cargo/Calculator/ResultCalculator.java - Clearance and mode → Top degrees: maps top degree
src/main/java/com/cargo/Calculator/ResultCalculator.java - Clearance and mode → Lower degrees: maps lower degree
src/main/java/com/cargo/Calculator/ResultCalculator.java - Clearance and mode → Gap table row: uses clearance rows
src/main/java/com/cargo/Calculator/ResultCalculator.java - Clearance and mode → Calculation result: creates result
src/main/java/com/cargo/Calculator/ResultCalculator.java - Cargo selection → Cargo and envelope: creates shape
src/main/java/com/cargo/Main.java - Cargo and envelope → Geometry interface: implements
src/main/java/com/cargo/model/ShapeModel.java - Cargo and envelope → Coordinate utilities: converts coordinates
src/main/java/com/cargo/model/ShapeModel.java - Degree classification → Coordinate utilities: converts points
src/main/java/com/cargo/util/GeometryUtils.java - Application entry → Results window: opens window
src/main/java/com/cargo/Main.java - Results window → Calculation diagram: displays diagram
src/main/java/com/cargo/ui/MainFrame.java - Calculation diagram → Calculation result: renders result
src/main/java/com/cargo/ui/DrawPanel.java - Calculation diagram → Oversize zones: draws zones
src/main/java/com/cargo/ui/DrawPanel.java - Calculation diagram → Geometry utilities: computes gaps
src/main/java/com/cargo/ui/DrawPanel.java - Calculation result → Track parameters: retains parameters
src/main/java/com/cargo/model/Result.java