calcShipType.Rd
Assigns a generalizable ship type based on the Vessel_Type
field in
ship registry data.
calcShipType(vesselType, method = "imo", inputTableLocation = NULL)
vesselType | Unstandardized vessel types from ship registry data (vector of strings) |
---|---|
method | Select the methodology that should be used (i.e., which set of ship types to return):
|
inputTableLocation | File path (optional). Used to specify a
user-supplied mapping between unstandardized |
shipType
, a data.table column of the general ship type,
corresponding to the input data. NA
s represent Vessel_Types not in
shipMap
(or the inputTableLocation
parameter, if that was used).
There are different sets of ship types available for use: IMO's ship types or Starcrest's ship types. Since ship types are important for assigning default auxiliary and boiler engine assumptions, the methodology selected here should match with the methodology used for assigning auxiliary and boiler loads. The IMO ship types are based on the Third GHG Study, and the Starcrest ship types are based on the 2017 Port of Los Angeles air emissions inventory.
If the default mapping between the unstandardized VesselType
s and
standardized shipType
s does not catch everything (i.e, if there are
unstandardized VesselType
s that are not standardized by this function),
or if you want to use your own standardized shipType
s, you can supply
a custom mapping file using the inputTableLocation
argument.
If user-supplied ship type mapping is used, the file should be
in .csv format with two columns and a header row. The headers should be
"Vessel_Type" and "shipType", and the values should specify which
Vessel_Type
s map to which shipType
s. See data(shipMap)
for the default mapping used by this function.
For more information about ship type, see Section 3.3.3 of the Port Emissions Inventory Guidance.
International Maritime Organization. 2014. "Third IMO GHG study 2014 - Final report." London: International Maritime Organization.
calcShipType(vesselType = c("Fully Cellular Container", "Deck Cargo Carrier", "Open Hatch Carrier", "Cruise Ship", "LNG Carrier") )#> imoShipType #> 1: container.ship #> 2: general.cargo #> 3: bulk.carrier #> 4: cruise #> 5: liquified.gas.tankercalcShipType(vesselType = c("Fully Cellular Container", "Deck Cargo Carrier", "Open Hatch Carrier", "Cruise Ship", "LNG Carrier"), method="starcrest")#> starcrestShipType #> 1: container.ship #> 2: general.cargo #> 3: bulk.carrier #> 4: cruise #> 5: tanker