Fleet Utilization Vessels

Note

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

class kpler.sdk.resources.fleet_utilization_vessels.FleetUtilizationVessels(configuration, column_ids=True, log_level=None)

The FleetUtilizationVessels provides current and historical supply & demand capacity balance, total,loaded & ballast capacity evolution and capacity available by products.

get(start_date=None, end_date=None, zones=None, products=None, vessel_types_cpp=None, vessel_types_oil=None, vessel_states=None, unit=None, size=None, gte=None, lte=None, vessel_types=None, period=None, previous_zones=None, next_zones=None, vessel_directions=None, distinct_aggregation=False, vessels=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[List[str]] Names of countries/geographical zones

• products – Optional[List[str]] Names of products

• vessel_types_cpp – Optional[List[Enum]] VesselTypesCPP

• vessel_types_oil – Optional[List[Enum]] VesselTypesOil

• vessel_states – Optional[List[Enum]] FleetUtilizationVesselsState

• unit – Optional[Enum] FleetUtilizationVesselsUnit

• size – Optional[int] Maximum number of fleet utilization vessels returned

• gte – Optional[int] Get vessels with deadweight/capacity greater or equals to this value by default 0

• lte – Optional[int] Get vessels with deadweight/capacity lower or equals to this value by default 606550

• vessel_types – Optional[List[Enum]] VesselTypesDry VesselTypesLNG VesselTypesLPG

• period – Optional[Enum] FleetUtilizationVesselsPeriod

• previous_zones – Optional[List[str]] Names of zones (port/region/country/continent) the vessel is coming from

• next_zones – Optional[List[str]] Names of zones (port/region/country/continent) the vessel is going to

• vessel_directions – Optional[List[str]] Names of the vessel’s course of direction on the given day

• distinct_aggregation – Option[bool] Show or hide distinct vessels by default false

• vessels – Optional[List[str]] Names or IMOs of the vessels

Examples

>>> from datetime import date
... from kpler.sdk.resources.fleet_utilization_vessels import FleetUtilizationVessels
... from kpler.sdk import FleetUtilizationVesselsState
... fleet_utilization_vessels_client=FleetUtilizationVessels(config)
... fleet_utilization_vessels_client.get(
...     start_date=date(2020,10,1),
...     end_date=date(2020,11,1),
...     zones=["Japan"],
...     products=["gasoline", "DPP"],
...    vessel_states=[FleetUtilizationVesselsState.Loaded],
...     size=5
... )

Date (timestamp)	IMO	Name	Dead Weight Tonnage	Vessel Type	Vessel State	Current Zone	Last Product on board
2020-10-01	9751121	Kakusho Iii	3500	GP	Loaded	Japan	DPP
2020-10-01	9774410	Sun Venus	6879	GP	Loaded	Japan	DPP
2020-10-01	9524475	Suez Rajan	158574	LR3	Loaded	Japan	DPP
2020-10-01	9636644	Maersk Aegean	37538	MR	Loaded	Japan	DPP
2020-10-01	9346873	Mare Oriens	110295	LR2	Loaded	Japan	DPP

get_columns()

This endpoint returns a recent and updated list of all columns available for the endpoint fleet-utilization.

Examples

>>> from kpler.sdk.resources.fleet_utilization_vessels import FleetUtilizationVessels
... fleet_utilization_vessels_client=FleetUtilizationVessels(config)
... fleet_utilization_vessels_client.get_columns()

id	name	description	deprecated	type
date	Date (timestamp)		False	date yyyy-MM-dd
vessel_imo	IMO	IMO of the vessel	False	long
vessel	Name	Name of the vessel	False	string
vessel_dwt_tons	Dead Weight Tonnage	Dead Weight Tonnage	False	long
vessel_type	Vessel Type	Type of the vessel	False	string
…	…	…	…	…

Return type

DataFrame

class kpler.sdk.VesselTypesCPP(value)

GP = 'GP'

LR1 = 'LR1'

LR2 = 'LR2'

LR3 = 'LR3'

MR = 'MR'

SmallTanker = 'Small Tanker'

VLCC = 'VLCC'

class kpler.sdk.VesselTypesOil(value)

Aframax = 'Aframax'

Panamax = 'Panamax'

ProductTanker = 'Product Tanker'

SmallTanker = 'Small Tanker'

Suezmax = 'Suezmax'

ULCC = 'ULCC'

VLCC = 'VLCC'

class kpler.sdk.VesselTypesLNG(value)

LLowerConventional = 'L (Lower Conventional)'

MMedMax = 'M (Med Max)'

QFlex = 'Q-Flex'

QMax = 'Q-Max'

SSmallSCale = 'S (Small Scale)'

XLUpperConventional = 'XL (Upper Conventional)'

XSPressureGas = 'XS (Pressure Gas)'

class kpler.sdk.VesselTypesLPG(value)

Handysize = 'Handysize'

LGC = 'LGC'

MGC = 'MGC'

SGC = 'SGC'

VLEC = 'VLEC'

VLGC = 'VLGC'

class kpler.sdk.VesselTypesDry(value)

BabyCapes = 'Baby Capes'

Capesize = 'Capesize'

Handymax = 'Handymax'

Handysize = 'Handysize'

Kamsarmax = 'Kamsarmax'

Newcastlemax = 'Newcastlemax'

Panamax = 'Panamax'

PostPanamax = 'Post-Panamax'

Supramax = 'Supramax'

Ultramax = 'Ultramax'

VLOC = 'VLOC'

Valemax = 'Valemax'

class kpler.sdk.FleetUtilizationVesselsState(value)

Ballast = 'Ballast'

Loaded = 'Loaded'

Maintenance = 'Maintenance'

class kpler.sdk.FleetUtilizationVesselsUnit(value)

KT = 'kt'

MT = 'mt'

class kpler.sdk.FleetUtilizationVesselsPeriod(value)

Annually = 'years'

Daily = 'days'

Monthly = 'months'

Quarterly = 'quarters'

Weekly = 'weeks'