Fleet Metrics Vessels

Note

available on platforms : Platform.Liquids, Platform.LPG, Platform.LNG

class kpler.sdk.resources.fleet_metrics_vessels.FleetMetricsVessels(configuration, column_ids=True, log_level=None)

The FleetMetricsVessels endpoint provides the list of vessels with their cargo per day on a given period, for the Floating Storage or the Loaded Vessels metrics, and their location.

get(start_date=None, end_date=None, zones=None, metric=None, floating_storage_duration_min=None, floating_storage_duration_max=None, products=None, unit=None, with_freight_view=False, vessel_types=None, vessel_types_alt=None)

Parameters

• start_date – Optional[date] Start of the period (YYYY-MM-DD)

• end_date – Optional[date] End of the period (YYYY-MM-DD)

• zones – Optional[str] Names of countries/geographical zones

• metric – Optional[Enum] FleetMetricsVesselsAlgo

• floating_storage_duration_min – Optional[str] Minimum floating days [7-10-12-15-20-30-90] or [1-3-5-7-10-12-15-20-30-90] on LNG platform

• floating_storage_duration_max – Optional[str] Maximum floating days [7-10-12-15-20-30-90-Inf] or [1-3-5-7-10-12-15-20-30-90-Inf] on LNG platform

• products – Optional[str] Names of products. Not available on LNG platform

• unit – Optional[Enum] FleetMetricsVesselsMeasurementUnit by default return in bbl unit or cm on LNG platform

• with_freight_view – bool By default: with_freight_view=False. Provides access to the entire fleet’s trades, irrespective of your current cargo subscription. Only available via Freight subscription.

• vessel_types – Optional[List[str]] = Names of vessel types

• vessel_types_alt – Optional[List[str]] = Names of vessel types for oil liquids platform only

Examples

>>> from datetime import date
... from kpler.sdk.resources.fleet_metrics_vessels import FleetMetricsVessels
... from kpler.sdk import FleetMetricsVesselsAlgo,FleetMetricsVesselsMeasurementUnit
... fleet_metrics_vessels_client=FleetMetricsVessels(config)
... fleet_metrics_vessels_client.get(
...     metric=FleetMetricsVesselsAlgo.LoadedVessels,
...     zones=["China"],
...     start_date=date(2020,10,1),
...     end_date=date(2020,10,31),
...     floating_storage_duration_min="7",
...     floating_storage_duration_max="10",
...     products=["Dirty"],
...     unit=FleetMetricsVesselsMeasurementUnit.BBL
... )

Date	IMO	Name	Dead Weight Tonnage	Quantity (bbl)	Family	Group	Product	Grade	Current Continent	…
2020-10-01	9376749	Advantage Value	297557	1057204	Dirty	crude/co	crude	Iracema	Asia	…
2020-10-01	9430313	Afra Royal	115948	530973	Dirty	crude/co	crude	Hamaca	Asia	…
2020-10-01	9759836	Agios Sostis I	299983	2000003	Dirty	crude/co	crude	Arab Hy.	Asia	…
2020-10-01	9653410	Al Derwazah	316884	2000003	Dirty	crude/co	crude	Kuwait	Asia	…
2020-10-01	9329708	Al Jabriyah Ii	317570	2000003	Dirty	crude/co	crude	Kuwait	Asia	…
…	…	…	…	…	…	…	…	…	…	…

class kpler.sdk.FleetMetricsVesselsAlgo(value)

FloatingStorage = 'floating_storage'

LoadedVessels = 'loaded_vessels'

class kpler.sdk.FleetMetricsVesselsMeasurementUnit(value)

BBL = 'bbl'

CM = 'cm'

KB = 'kb'

KT = 'kt'

MMBBL = 'mmbbl'

MT = 'mt'

T = 't'