Returns a weighting check for one rig: how much lead to add or remove to be neutral at the end of the dive, the net buoyancy at the start (full cylinders at the target depth) and the end (near-empty cylinders at 3 m), what a flooded drysuit, a failed wing or a dropped stage would do and how to recover, and advisories. Use this when a diver asks how much weight they need, whether a rig is balanced, or how a change of suit, cylinder or water moves it. Not for gas planning.
cylinders take a role (single, twinset, sidemount, stage) and cylinder: a lookup_cylinders id (al80, steel12-232) or a plan_dive preset, or cylinder_size and empty_buoyancy (sea water, with valve), plus empty_weight if known, for one not in the data. Weights are kg (lb imperial); gear weight is positive when it sinks. Omitted fields take Dive Kit defaults (salt water, 30 m, a 5 mm full wetsuit, a 16 kg wing, no body offset), listed in assumptions. Body buoyancy comes only from a measured body_offset (diver), never from body measurements; without one it is taken as neutral. An estimate to start from: confirm with an in-water weight check. Compare two setups with two calls. No engine call.
Example: {"cylinders":[{"role":"single","cylinder":"al80"}],"exposure":{"type":"wetsuit","thickness_mm":7},"gear":[{"label":"belt","weight":6,"ditchable":true}]}
View input schema
{
"type": "object",
"properties": {
"units": {
"type": "string",
"enum": [
"metric",
"imperial"
],
"description": "metric (m, bar, L, °C) or imperial (ft, psi, ft³, °F): the unit system for every value in and out. Default metric."
},
"water": {
"type": "string",
"enum": [
"salt",
"fresh",
"en13319",
"red_sea"
],
"description": "Water type, from its density: en13319 (EN 13319, the dive computer standard) 10.00 m per bar, salt 9.95, fresh 10.20, red_sea 9.92. Default en13319."
},
"target_depth": {
"type": "number",
"minimum": 0,
"maximum": 1000,
"description": "Deepest point of the dive (m or ft), where full cylinders are checked. Default 30 m (98 ft)."
},
"cylinders": {
"description": "Cylinders on the rig. Default one single AL80.",
"minItems": 1,
"maxItems": 6,
"type": "array",
"items": {
"type": "object",
"properties": {
"role": {
"type": "string",
"enum": [
"single",
"twinset",
"sidemount",
"stage"
],
"description": "single, twinset (two on a manifold), sidemount (a pair, one each side) or stage (one slung cylinder; one entry per stage)."
},
"cylinder": {
"description": "A lookup_cylinders id (al80, steel12-232, hp100) or a plan_dive preset (al80, twin_12l, stage_11l). For twinset and sidemount name ONE cylinder of the pair. Default al80.",
"type": "string",
"maxLength": 40
},
"cylinder_size": {
"description": "For a cylinder not in the data: water litres of one cylinder, or ft³ at rated_pressure on imperial. Needs empty_buoyancy.",
"type": "number",
"minimum": 0.5,
"maximum": 400
},
"rated_pressure": {
"description": "Imperial only, with cylinder_size: the psi its ft³ is rated at. Default 3000.",
"type": "number",
"minimum": 725,
"maximum": 7252
},
"empty_buoyancy": {
"type": "number",
"minimum": -100,
"maximum": 250,
"description": "For a cylinder not in the data: buoyancy of one empty cylinder in sea water with its valve, kg (lb imperial), negative when it sinks. From the maker's sheet."
},
"empty_weight": {
"type": "number",
"minimum": -100,
"maximum": 250,
"description": "For a cylinder not in the data: weight of one empty cylinder without its valve, kg (lb imperial). Optional: with it the conversion to other water matches a cylinder in the data. Without it the conversion uses the internal volume, which understates the shift."
},
"regulator": {
"description": "Regulator on each cylinder: travel, standard, cold_water or none. Default by role: standard (single, sidemount), cold_water (twinset), travel (stage).",
"type": "string",
"enum": [
"travel",
"standard",
"cold_water",
"none"
]
},
"rigging": {
"description": "Count bands, manifold or stage hardware. Default true for twinset, sidemount and stage.",
"type": "boolean"
},
"cylinder_lead": {
"type": "number",
"minimum": -100,
"maximum": 250,
"description": "Lead fixed to each cylinder (a tail or V-weight), kg (lb). Default 0."
},
"oxygen_pct": {
"description": "Oxygen % of the gas in it. Default 21.",
"type": "number",
"minimum": 5,
"maximum": 100
},
"helium_pct": {
"description": "Helium % of the gas in it. Default 0.",
"type": "number",
"minimum": 0,
"maximum": 95
},
"start_pressure": {
"description": "Fill at the start (bar or psi). Default: the preset fill, else the dataset working pressure.",
"type": "number",
"minimum": 0,
"maximum": 7252
}
},
"required": [
"role"
],
"additionalProperties": false
}
},
"exposure": {
"description": "Exposure suit. Default a 5 mm full wetsuit.",
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"none",
"wetsuit",
"drysuit"
],
"description": "none, wetsuit or drysuit."
},
"thickness_mm": {
"description": "Wetsuit neoprene thickness in mm (both unit systems), 0 to 10. Default 5.",
"type": "number",
"minimum": 0,
"maximum": 10
},
"neoprene": {
"description": "Wetsuit foam: soft (new, compresses most), standard (default) or old (about 20% less lift).",
"type": "string",
"enum": [
"soft",
"standard",
"old"
]
},
"cut": {
"description": "Wetsuit cut: full (default), shorty or farmer_john.",
"type": "string",
"enum": [
"full",
"shorty",
"farmer_john"
]
},
"hood_mm": {
"description": "Hood thickness in mm; 0 or omitted for none.",
"type": "number",
"minimum": 0,
"maximum": 10
},
"gloves_mm": {
"description": "Glove thickness in mm; 0 or omitted for none.",
"type": "number",
"minimum": 0,
"maximum": 10
},
"booties_mm": {
"description": "Bootie thickness in mm; 0 or omitted for none.",
"type": "number",
"minimum": 0,
"maximum": 10
},
"vest_mm": {
"description": "Vest or hooded vest thickness in mm; 0 or omitted for none.",
"type": "number",
"minimum": 0,
"maximum": 10
},
"undersuit": {
"description": "Drysuit undersuit: light, medium (default) or heavy.",
"type": "string",
"enum": [
"light",
"medium",
"heavy"
]
},
"custom_lift": {
"type": "number",
"minimum": -100,
"maximum": 250,
"description": "Measured suit lift at the surface, kg (lb), instead of the model."
}
},
"required": [
"type"
],
"additionalProperties": false
},
"wing": {
"description": "Buoyancy devices.",
"type": "object",
"properties": {
"lift": {
"type": "number",
"minimum": -100,
"maximum": 250,
"description": "Wing lift, kg (lb). Default 16 kg."
},
"redundant_bladder_lift": {
"type": "number",
"minimum": -100,
"maximum": 250,
"description": "Second bladder lift, kg (lb); omit for none."
},
"smb_lift": {
"type": "number",
"minimum": -100,
"maximum": 250,
"description": "Emergency lift from an SMB, kg (lb); omit for none."
},
"lift_bag_lift": {
"type": "number",
"minimum": -100,
"maximum": 250,
"description": "Emergency lift from a lift bag, kg (lb); omit for none."
}
},
"additionalProperties": false
},
"gear": {
"description": "Lead and other gear. Omit to get the lead the rig needs from zero.",
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"maxLength": 40,
"description": "What it is: belt, trim pockets, backplate, torch."
},
"weight": {
"type": "number",
"minimum": -100,
"maximum": 250,
"description": "In-water weight, kg (lb), positive when it sinks (a 6 kg belt is 6)."
},
"ditchable": {
"description": "Can be dropped in an emergency. Default false.",
"type": "boolean"
}
},
"required": [
"label",
"weight"
],
"additionalProperties": false
}
},
"diver": {
"description": "Optional. A measured body_offset; without one the body is taken as neutral.",
"type": "object",
"properties": {
"body_offset": {
"type": "number",
"minimum": -100,
"maximum": 250,
"description": "The diver's own buoyancy with no suit or gear, from an in-water float test at the end of a breath out, kg (lb): positive floats, negative sinks."
},
"body_offset_water": {
"type": "string",
"enum": [
"salt",
"fresh",
"en13319",
"red_sea"
],
"description": "Water type, from its density: en13319 (EN 13319, the dive computer standard) 10.00 m per bar, salt 9.95, fresh 10.20, red_sea 9.92. Default en13319."
}
},
"additionalProperties": false
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}