Fleet Utilization Series

Aggregated from Fleet Utilization Vessels

Note

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

class kpler.sdk.resources.fleet_utilization_series.FleetUtilizationSeries(configuration, column_ids=True, log_level=None)

The FleetUtilizationSeries endpoint returns 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, metric=None, period=None, split=None, products=None, unit=None, vessel_types_cpp=None, vessel_types_oil=None, vessel_states=None, percent=None, gte=None, lte=None, vessel_types=None, previous_zones=None, next_zones=None, vessel_directions=None, distinct_aggregation=False)

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

• metric – Optional[Enum] FleetUtilizationSeriesMetric

• period – Optional[Enum] FleetUtilizationSeriesPeriod

• split – Optional[Enum] FleetUtilizationSeriesSplit

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

• unit – Optional[Enum] FleetUtilizationSeriesUnit

• vessel_types_cpp – Optional[List[Enum]] VesselTypesCPP

• vessel_types_oil – Optional[List[Enum]] VesselTypesOil

• vessel_states – Optional[List[Enum]] FleetUtilizationSeriesVesselsState

• percent – Optional[bool] Access percentage of loaded vessels over ballast vessels

• 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

• 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

Examples

>>> from datetime import date
... from kpler.sdk.resources.fleet_utilization_series import FleetUtilizationSeries
... from kpler.sdk import FleetUtilizationSeriesMetric, FleetUtilizationSeriesPeriod,FleetUtilizationSeriesSplit, FleetUtilizationSeriesUnit
... fleet_utilization_series_client = FleetUtilizationSeries(config)
... fleet_utilization_series_client.get(
...     start_date=date(2020,10,1),
...     end_date=date(2020,11,1),
...     zones=["Japan"],
...     metric=FleetUtilizationSeriesMetric.Count,
...     period=FleetUtilizationSeriesPeriod.Daily,
...     split=FleetUtilizationSeriesSplit.Product,
...     unit=FleetUtilizationSeriesUnit.MT
... )

Date	Clean Products	crude/co	DPP	NPC	Other
2020-10-01	114	62	31	37	13
2020-10-02	114	60	36	40	14
2020-10-03	104	59	38	43	12
2020-10-04	105	55	38	42	13
2020-10-05	109	60	40	42	13
2020-10-06	100	61	37	36	14
2020-10-07	103	52	31	30	14
2020-10-08	105	38	33	24	13
2020-10-09	109	46	31	17	11
2020-10-10	115	48	35	21	10
…	…	…	…	…	…

class kpler.sdk.FleetUtilizationSeriesMetric(value)

Count = 'count'

DeadWeight = 'deadWeight'

class kpler.sdk.FleetUtilizationSeriesPeriod(value)

Annually = 'years'

Daily = 'days'

Monthly = 'months'

Quarterly = 'quarters'

Weekly = 'weeks'

class kpler.sdk.FleetUtilizationSeriesSplit(value)

CurrentContinents = 'currentContinents'

CurrentCountries = 'currentCountries'

CurrentSeas = 'currentSeas'

CurrentSubContinents = 'currentSubcontinents'

CurrentSubregions = 'currentSubregions'

Direction = 'direction'

NextContinents = 'nextContinents'

NextCountries = 'nextCountries'

NextPorts = 'nextPorts'

NextSubContinents = 'nextSubContinents'

NextTradingRegions = 'nextTradingRegions'

PreviousContinents = 'previousContinents'

PreviousCountries = 'previousCountries'

PreviousPorts = 'previousPorts'

PreviousSubContinents = 'previousSubContinents'

PreviousTradingRegions = 'previousTradingRegions'

Product = 'product'

State = 'state'

SubState = 'subState'

Total = 'total'

VesselType = 'vesselType'

VesselTypeCpp = 'vesselTypeCpp'

VesselTypeOil = 'vesselTypeOil'

class kpler.sdk.FleetUtilizationSeriesUnit(value)

KT = 'kt'

MT = 'mt'

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.FleetUtilizationSeriesVesselsState(value)

Ballast = 'Ballast'

Loaded = 'Loaded'

Maintenance = 'Maintenance'