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)[source]

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)[source]
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)[source]
FloatingStorage = 'floating_storage'
LoadedVessels = 'loaded_vessels'
class kpler.sdk.FleetMetricsVesselsMeasurementUnit(value)[source]
BBL = 'bbl'
CM = 'cm'
KB = 'kb'
KT = 'kt'
MMBBL = 'mmbbl'
MT = 'mt'
T = 't'