How a Ship-to-Shore Gantry Crane Works
This interactive ship-to-shore (STS) crane simulator reconstructs an articulated hoisting system above a container terminal. A tall gantry supports a waterside boom, moving trolley, multi-line hoist and container spreader. Operate the trolley and hoist, then vary payload and wind conditions to observe how suspended-load dynamics affect precision handling.
Portal legs, lattice girders, boom stays, machinery platform, wheel bogies and maintenance details are constructed with reusable procedural elements. The scene is illustrative, rather than a certified structural model.
Trolley acceleration drives fore-aft sway. A quadratic crosswind force drives transverse sway. Varying rope payout changes the natural oscillation period and the relationship between load and carriage motion.
Acceleration-limited trolley travel and variable-speed hoisting can be paused, nudged and reset. Camera presets and component selection support inspection from crane-operator and ship-deck viewpoints.
The Physics Behind Cargo Sway
The suspended load uses two coupled-by-hoist-length, small-deflection-inspired pendulum axes, integrated at a fixed 120 Hz step. The trolley moves along world Z; the crosswind acts along world X. We use the full sine restoring term, but approximate the three-dimensional cable system as one effective pendulum of length L. This is an educational, not crane-certified, motion model.
θ̈x = −(g/L) sin(θx) + (Fwind/mL) cos(θx) − 2(L̇/L) θ̇x − c θ̇x
Fwind = ½ ρ Cd A v |v|; T ≈ m [g cos(θx) cos(θz) + L(θ̇x² + θ̇z²)]
Here g = 9.81 m/s², air density ρ = 1.225 kg/m³, the approximate exposed area A = 15.8 m², and drag coefficient Cd = 1.2. Tension excludes pulley friction, cable elasticity, crane-flex modes, aerodynamic shielding and operational safety factors. Motion and displayed measurements are derived from the simulation state rather than preset animation curves.
Interaction Guide
Use Trolley target to move a load from the landside toward the vessel. Change Speed limit to compare sway generated by acceleration and braking. Adjust Rope payout to change pendulum length and Crosswind to test lateral disturbances. The Nudge control adds a small angular velocity impulse to the suspended load. Pause and reset at any point.
Frequently Asked Questions
What is a ship-to-shore container crane?
A ship-to-shore crane, also called a quayside gantry crane, transfers standardized cargo containers between a ship and the terminal. Its elevated boom provides reach over vessel rows, while a moving trolley positions the hoist and spreader.
Why does a container sway when the trolley moves?
The load tends to maintain its previous horizontal velocity while the support point accelerates. The resulting relative displacement and gravity produce pendulum motion. Faster acceleration and braking can excite stronger oscillations.
How does rope length change sway?
For a small-angle pendulum, the approximate natural period is 2π√(L/g). Lengthening the hoist rope reduces the natural frequency and increases the period. Changing rope length during a swing also affects angular velocity through the radial-motion coupling term.
Why is the wind force proportional to velocity squared?
For many blunt bodies at typical operating Reynolds numbers, drag is approximated by one-half air density times drag coefficient, exposed area and speed squared. The signed form v|v| preserves wind direction.
Does payload mass affect sway?
Gravitational pendulum frequency is independent of mass in the ideal model. However, a fixed aerodynamic force produces less acceleration on a heavier payload, so the simulated lateral wind response varies with mass.
Is the crane structure dynamically deformable?
No. The steel framework is a detailed, stationary visualization. The model does not solve finite-element structural stresses, elastic boom deflection, fatigue or rail-to-wheel reactions.
Are the four hoist lines individually simulated?
No. Four rigging lines follow the moving spreader visually, but the dynamics use a single effective suspension length and one rigid load. Differential cable tension and torsional twist are outside this simplified model.
Does the container collide with the vessel?
The terminal and ship provide visual scale and working context, but the demonstrator does not implement cargo-to-vessel contact, landing detection or automatic spreader attachment. Operators should not interpret overlaps as physically valid moves.
Does the simulation require WebGPU?
No. It prefers the Three.js WebGPU renderer and automatically uses its WebGL 2 backend when WebGPU is unavailable. Both require modern browser graphics support and access to the pinned Three.js CDN.
Can the model be used for real lift planning?
No. It illustrates broad physical relationships but omits site-specific wind measurements, load charts, structural safety factors, operational interlocks, spreader certification, contact mechanics and regulatory engineering checks.