How the gantry crane operates
A ship-to-shore container crane transfers standardized freight containers between a vessel and a landside terminal. Its long cantilevered boom supports a motorized trolley, while steel hoist ropes suspend a spreader and attached container. The portal legs carry the loads into quay rails; counterweight and diagonal bracing help stabilize the structure.
A velocity-limited motor model accelerates and brakes the trolley toward the selected berth location. This acceleration excites load sway.
Two coupled-by-geometry angular directions approximate a four-rope suspended load. Rope length changes its natural oscillation period.
Aerodynamic drag acts on the exposed container face. Higher wind velocity increases forcing approximately with velocity squared.
Physical model
The simulation uses fixed 1/120-second integration steps. For each swing direction, the angular acceleration is approximated by θ̈ = −(g/L) sin θ − 2(L̇/L) θ̇ − c θ̇ + (Fwind/m − atrolley)/L. The hoist motor changes rope length at a bounded speed. Crosswind drag follows F = ½ ρ Cd A v², with air density 1.225 kg/m³ and a nominal drag coefficient of 1.2. Cable tension is estimated from radial load balance, combining gravity, swing angular velocity and radial acceleration. This is an educational reduced-order model, not a structural certification tool.
Common questions
Why does the load continue to swing after the trolley stops?
The moving trolley transfers momentum to the hanging mass. Once the trolley brakes, the load retains angular velocity and exchanges potential and kinetic energy as a pendulum. Damping slowly removes energy, so the oscillation does not stop instantly.
Why does a longer hoist rope increase the swing period?
For a small-angle simple pendulum, T ≈ 2π√(L/g). Increasing the rope length reduces the natural angular frequency, producing a slower oscillation. This relationship is reproduced by the model's gravitational restoring acceleration.
Does increasing container mass always decrease sway?
Without air forces, ideal pendulum motion is approximately independent of mass. In a crosswind, the same aerodynamic force gives a heavier load less acceleration because acceleration equals force divided by mass.
What is cable tension and why does it fluctuate?
Cable tension is the pull carried by the hoisting system. It changes with the load's weight, swing angle and centripetal acceleration. The displayed value represents total effective vertical suspension tension, not individual strand forces.
Why does faster trolley travel increase swing?
High speed itself does not automatically create swing, but reaching that speed and braking requires acceleration. Acceleration shifts the suspension point relative to the load, producing an angular response. Timing the stop is especially important.
Does this simulation calculate real ship crane structural stresses?
No. It represents kinematics, simplified motor actuation, crosswind forcing and load motion. It does not perform finite-element analysis, fatigue modeling, gust spectra, rope elasticity or detailed load-path certification.
How is the crane model rendered?
Procedural beam assemblies, trusses, rails, pulleys, ladders, container corrugations, rail bogies and vessel geometry are generated in Three.js. The WebGPU renderer can use WebGL 2 automatically when WebGPU is unavailable.
Can the crane operate in strong winds?
Real terminals use specified wind limits, monitoring systems and operational procedures. The wind control here demonstrates the resulting sway trends; it does not establish a safe real-world operating limit.
What changes when the hoist length is adjusted while swinging?
Shortening a rope raises the natural frequency; changing its length also affects the angular velocity through angular-momentum-like terms. The educational model includes the corresponding length-rate term in its equations.
What do the different camera presets show?
Overview frames the quay, vessel and crane; vessel side emphasizes the outreach over the ship; hoist detail brings the trolley, sheaves, cables and load close enough to study their arrangement. Orbit and pan remain available in all three views.