sea_traffic

sea_traffic … end_sea_traffic

sea_traffic
   port <name>
      position <latitude-value> <longitude-value> <length-value>
      port_route
         position <latitude-value> <longitude-value> <length-value>
      end_port_route

      local_traffic_region <latitude-value> <longitude-value> <length-value> <fractional>
      departure_interval <time-value>
      use_all_lanes
      lane <name> <weighting-factor>
   end_port

   lane <name>
      port <port-name> [ignore_port_route]
      lane_route ... end_lane_route
      position <latitude-value> <longitude-value> <length-value>
   end_lane

   departure_traffic <fraction>
      ship <platform-type> ... end_ship
      fraction <fraction>
      mean_speed <speed>
      sigma_speed <speed>
   end_ship

   local_traffic <fraction>
      ship <platform-type> ... end_ship
      fraction <fraction>
      mean_loiter_time <time>
      sigma_loiter_time <time>
      loiter_route <name>
      mean_speed <speed>
      sigma_speed <speed>
   end_local_traffic
end_sea_traffic

Overview

The sea_traffic command generates background ship traffic during the simulation. The generator creates ships traveling to and from ports as well as the local ship traffic surrounding a port.

Commands

port <name> … end_port

Defines a port that ship traffic originates and terminates at.

position <latitude-value> <longitude-value> <length-value>

Defines the location and size of the port. The third argument is used as a diameter so ships entering the port will end up inside of a circle with the given diameter, centered about the specified latitude and longitude.

port_route … end_port_route

Defines the route ship traffic uses for entering and exiting the port. This gives the ability to navigate ships around obstacles after leaving the main shipping lane. Specify multiple positions to build up a path entering the port. When ships leave a port they use the reverse of the defined port route.

position <latitude-value> <longitude-value> <length-value>

Defines a waypoint along the route into the port. The third argument is used as a diameter so ships traveling along the port route will have a random path inside of the circle with the given diameter, centered about the specified latitude and longitude.

Note

Specify multiple position commands to place as many waypoints as needed.

local_traffic_region <latitude-value> <longitude-value> <length-value> <fractional>

The region where local traffic from this port will travel to. The fraction specifies the fraction of traffic from this port that goes to this region.

departure_interval <time-value>

Specifies the ship departure interval from the port.

use_all_lanes

Ship traffic departing and terminating at the port will use all available ship lane_s.

lane <name> <weighting-factor>

Specifies a lane ship traffic can use. The weighting factor is used to spread traffic amongst the various lanes.

Example:

port seattle
  position 48:15n 123:00w 1 km
  port_route
     position 48:30n 125:00w 10 km
     position 48:15n 124:00w  1 km
  end_port_route
  local_traffic_region 48:15n 123:00w 10 km 0.3
  local_traffic_region 48:10n 122:50w 10 km 0.2
  local_traffic_region 48:20n 122:52w 15 km 0.25
  local_traffic_region 48:25n 123:10w 15 km 0.25
  departure_interval 5 min
  lane lane-seattle-to-british-columbia 0.7
  lane lane-seattle-to-baja-mexico      0.3
end_port

lane <name> … end_lane

Defines a sea-lane that ship traffic uses to travel from port to port.

port <port-name> [ignore_port_route]

Specifies either the beginning or ending port. ignore_port_route is optional and specifies that ships traveling this lane will ignore a port’s defined port_route.

lane_route … end_lane_route

Specifies the route ships will travel when using this lane.

Note

Do not specify the starting or ending port’s location.

position <latitude-value> <longitude-value> <length-value>

Specifies a point of the lane. The third argument is used as a diameter so ships traveling along the shipping lane will have a random path inside of the circle with the given diameter, centered about the specified latitude and longitude.

Example:

lane lane-seattle-to-british-columbia
  port seattle
  port british-columbia
  lane_route
     position 50:00n 129:00w 50 km
  end_lane_route
end_lane

departure_traffic <fraction> … end_departure_traffic

Defines the shipping traffic that will leave a port and head to a local_traffic_region. The fractional-quantity is the percentage of ships that leave a port, which are going to a local region. This fraction and the departure_traffic fraction must sum to 1.0.

ship <platform-type> … end_ship

Defines the attributes of a specific ship type.

Note

To use multiple ship types for departure traffic, create multiple ship blocks.

fraction <fraction>

Controls how much ship traffic will use this ship type.

Note

The sum of all the ship fractions must be 1

mean_speed <speed>

The mean speed the ship traffic will travel at.

sigma_speed <speed>

The standard deviation for the ship’s speed.

Example:

departure_traffic 0.5
   ship TANKER_SHIP
      fraction     0.5
      mean_speed   20.0 kts
      sigma_speed  5.0 kts
   end_ship
   ship CONTAINER_SHIP
      fraction     0.5
      mean_speed   20.0 kts
      sigma_speed  5.0 kts
   end_ship
end_departure_traffic

local_traffic <fraction> … end_local_traffic

Defines the shipping traffic that will leave a port and head to a local_traffic_region. The fractional-quantity is the percentage of ships that leave a port, which are going to a local region. This fraction and the departure_traffic fraction must sum to 1.0.

ship <platform-type> … end_ship

Defines the attributes of a specific ship type.

Note

To use multiple ship types in a local traffic region, create multiple ship blocks.

fraction <fraction>

Controls how much ship traffic will use this ship type.

Note

The sum of all the ship fractions must be 1

mean_loiter_time <time>

Specifies how long the ship type will loiter in a local_traffic_region.

sigma_loiter_time <time>

The standard deviation of the ship’s loiter time.

loiter_route <name>

The ship type will use the specified route for its loiter. More than 1 loiter_route can be entered.

mean_speed <speed>

The mean speed the ship traffic will travel at.

sigma_speed <speed>

The standard deviation for the ship’s speed.

Example:

local_traffic 0.5
   ship SMALL_FISHING_SHIP
      fraction          0.75
      mean_loiter_time  30.0 min
      sigma_loiter_time 10.0 min
      mean_speed        40.0 kts
      sigma_speed       15.0 kts
   end_ship
   ship JETSKI
      fraction          0.25
      mean_loiter_time  30.0 min
      sigma_loiter_time 10.0 min
      mean_speed        20.0 kts
      sigma_speed       5.0 kts
      loiter_route ship-loiter-route-1
      loiter_route ship-loiter-route-2
   end_ship
end_local_traffic