Natural rolling period

Extraits de code

curl "https://api.oanor.com/shipstability-api/v1/roll-period" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/shipstability-api/v1/roll-period", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/shipstability-api/v1/roll-period");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/shipstability-api/v1/roll-period",
    headers={"x-oanor-key": "oanor_test_..."}
)

Exemple de réponse

Une réponse réelle de ce endpoint, capturée lors du dernier contrôle de santé.

{
    "data": {
        "note": "The natural rolling period T = 2π·k / √(g·GM), where k is the transverse radius of gyration (about 0.34–0.40 of the beam for a typical ship). A stiff ship (large GM) rolls fast with a short period; a tender ship rolls slowly. Sailors run this in reverse as the 'rolling-period test' — timing the roll to estimate GM — and a period that suddenly lengthens warns that GM has dropped dangerously.",
        "inputs": {
            "gm_m": 1,
            "beam_m": 15,
            "roll_gyration_factor": 0.35
        },
        "roll_period_s": 10.53,
        "radius_of_gyration_m": 5.25
    },
    "meta": {
        "timestamp": "2026-06-06T23:53:54.115Z",
        "request_id": "9c63a356-cfc1-46de-81d3-1a7a316396da"
    },
    "status": "ok",
    "message": "Roll period",
    "success": true
}