CONCEPT
Fields | Type | Description | Purpose |
|---|---|---|---|
ID (Concept identifier) | M | dwell | GRAMMAR |
Concept name | M | Dwell | GRAMMAR |
Concept type | M | status | GRAMMAR |
Also known as | O | Cargo at terminal, cargo stay | TIC Description |
Definition | M | The cargo visit dwell concept represents that the cargo is actually visiting a terminal from the administrative point of view. The status of the concept is “true”, between the moment the cargo is identified during the incoming of the cargo (check-in) and the moment of confirmation of the cargo’s departure (check-out). | TIC Description |
Further Detail | O | This definition only applies to non-divisible cargo where the “subject” (cargo) id does not change during the “cargovisit”. Future releases will address divisible cargo that will consider the way to split cargo and track the dwell of a “piece of cargo”. tos.cargovisit.dwell is the concept of the process (what status has the cargovisit) that defines if the cargo is formally (not physically) inside the terminal. It is considered to be formally inside the terminal between check-in and check-out (verification by the terminal of the cargo id). tos.cargovisit.dwell.status is true at the timestamp (observation time) if the cargo is inside the terminal (after check-in and before check-out: status = true) tos.cargovisit.dwell.duration represents how long the dwell.status is “true” without any interruption before the timestamp. So it represents that the cargo has been into the terminal for an uninterrupted duration (the value) time before the timestamp (the reference time). The resolution of the duration (usually the duration has a fixed frequency that determines how long it is) is up to the implementation and defines the resolution of the data (in the example it is a fixed value of 4 hours). tos.cargovisit.dwell.timer is the aggregation of the duration during a period of time (observation period). Please review https://tic40.atlassian.net/wiki/spaces/TIC40Definitions/pages/8618041/TIC4.0+Semantic#duration-vs-timer. tos.cargovisit.dwell.totaltimer is the aggregation of the duration from the check-in until the timestamp (observed time). Usually the cargovisit’s “age” is defined as how long the cargo has been in the terminal when it still is inside and it is obtained from: totaltimer value when “dwell.status = true” Usually cargovisit’s “dwelltime” is defined as the cargo age when check-out and it is obtained from the totaltimer value when “dwell.status = false” once the cargovisit ends. TIC 4.0 does not use “age” or “dwelltime”, but the generic observed property “totaltimer”. If the timestamp is during the stay of the cargo, it will represent “age”. If the timestamp is after the check-out, it will represent “dwelltime”. On top of this, TIC 4.0 has the “timer” observed property that allows to calculate the yard density for any period of time with a resolution of the “duration” Below you will find a unique cargovisit example with many considerations about different ways to use duration, timer and totaltimer to represent the age, dwelltime, yard density etc. Thanks to the TIC4.0 datamodel the “dwell” of any parameter of a single “cargovisit” or combination of many “cargovisit” can be done on top of the classical age, dwelltime like the yard density (average, max, min, STD, etc with different units boxes*time or teu*time).  Cargovisit is the process that “dwell” usually refers to. At the moment of this release 2022.004, no other subject is considered. In future releases, other subjects could be considered like carriervisit, visitor, etc that could stay in the terminal during a visit. | TIC Description |
Required Information | M | SUBJECT; OBSERVED PROPERTY and VALUE | TIC Description |
SUBJECT | M | service, servcevisit, cargo, carrier, carriervisit | GRAMMAR |
POINT OF MEASUREMENT | O | pom: input, output pomt: actual, planned, estimated | GRAMMAR |
OBSERVED PROPERTY | M | status; counter; duration; timer; totaltimer; age; dwelltime | GRAMMAR |
Value | M | type = operational/safety/component | GRAMMAR |
Related standards | O | TIC Description | |
Related TIC 4.0 definition | O | https://tic40.atlassian.net/l/c/j8R6vVZFInbound (Review) Check-in (Review) Check-out (Review) Outbound (Review) Announcement | TIC Description |
Example | M | A unique cargovist (20 foot box) stays at the terminal 2 days and we get several spot (instantaneous) observations and another 3 during a period of time: Events: cargovisit.check-in 02/01/2022 00:00:00 cargovisit.check-out 04/01/2022 00:00:00 Spots observation at 03/02/2022 00:00 tos.cargovisit.dwell.status = true 03/01/2022 00:00 tos.cargovisit.dwell.totaltimer = 1 day 04/02/2022 00:00 tos.cargovisit.dwell.status = false 04/02/2022 00:00 tos.cargovisit.dwell.totaltimer = 2 days 06/02/2022 00:00 tos.cargovisit.dwell.totaltimer = 2 days Observation period A from 02/01/2022 00:00 to 04/01/2022 00:00 tos.cargovisit.dwell.status = true (always) tos.cargovisit.dwell.timer = 2 days Observation period B from 03/02/2022 00:00 to 04/02/2022 00:00 tos.cargovisit.dwell.timer = 1 day (sum of all dwell duration, how long the cargo was in the terminal during the observation time). tos.cargovisit.dwell.average_timer.#unit#box: 1 day*(box/day) (sum of all the time the box was dwell, multiplied by the number of boxes (1) and divided by the total time of the observation (1 day) to get the average boxes per observed day). The same could be done with TEU to get the average yard density. tos.cargovisit.dwell.average_totaltimer.#unit#day = 1.5 day if dwell.status = true (average age) represents the average age of the container during a period of time (not the average dwelltime). because: 03/02/2022 00:00-23:59:59 tos.cargovisit.dwell.status = true Observation period C from 03/02/2022 00:00 to 05/02/2022 00:00 tos.cargovisit.dwell.timer = 1 day (sum of all dwell durations, how long the cargo was in the terminal during the observation time). tos.cargovisit.dwell.average_timer.#unit#box : 0.5 day*(box/day) (sum of all the time the box was dwell, multiplied by the number of boxes (1) and divided by the total time of the observation (2 days) to get the average boxes per observed day). The same could be done with TEU to get the average yard density in TEU (volume) during the observation time of 2 days, one day with 1 container and another day empty, so average only 0.5 TEUs (day*teu/day). tos.cargovisit.dwell.average_totaltimer.#unit#day = 1.5 day if dwell.status = true (average age) represents the average age of the container during a period of time (not the average dwelltime). It doesn't make sense to calculate the average age of a container that is not anymore in the terminal. because: 01/02/2022 00:00-23:59:59 tos.cargovisit.dwell.status = true 02-05/02/2022 tos.cargovisit.dwell.status = false To calculate the average dwelltime per box of the cargo you only have to sum the tos.cargovisit.dwell.totaltimer of the cargo that check-out and divide by the number of boxes. | TIC Description |
Example in the context of the grammar | M | The data model of cargo visit contains the major events and status of the cargo during the terminal visit. {
"tos": [
{
"id": "120SUPERCURRO2021",
"name": "TOS",
"cargovisit": [
{
"id": "",
"cargoflowtype": "domestic/import/export/transhipment/unknown",
"cargo": {
"timestamp": "2021-12-10T16:05:34.491Z",
"id": "ISO 6346/splitable_cargo_id?"
},
"size": {
"code": "",
"description": "",
"box": 1,
"teu": 2,
"20foot": 0,
"30foot": 0,
"40foot": 1,
"45foot": 0
},
"weight": {
"gross": [
{
"pom": "output",
"pomt": "actual",
"timestamp": "",
"unit": "ton",
"value": 0
}
],
"net": [
{
"pom": "output",
"pomt": "actual",
"timestamp": "",
"unit": "ton",
"value": 0
}
]
},
"inbound": {
"modality": "vessel/truck/train/barge/interterminaltransfer/unknown",
"time": [
{
"pom": "output",
"pomt": "actual",
"timestamp": "2021-12-10T16:05:34.491Z"
},
{
"pom": "output",
"pomt": "estimated",
"computingtime": "",
"forecasttime": "",
"timestamp": "2021-12-10T16:05:34.491Z"
}
],
"logical": [
{
"pom": "ioutput",
"pomt": "actual",
"timestamp": "2021-12-10T16:05:34.491Z",
"qualifier": "berth",
"name": "",
"value": "B 2",
"berthing": "2"
}
],
"coordinate": [
{
"pom": "ioutput",
"pomt": "actual",
"qualifier": "WGS84",
"timestamp": "2021-12-10T16:05:34.491Z",
"value": [
4012.22,
-7500.25
],
"status": true,
"accuracy": "12.0"
}
],
"carrier": [
{
"timestamp": "2021-12-10T16:05:34.491Z",
"id": ""
}
],
"carriervisit": {
"timestamp": "2021-12-10T16:05:34.492Z",
"id": ""
},
"service": [
{
"code": "",
"description": "",
"timestamp": "2021-12-10T16:05:34.492Z"
}
],
"servicevisit": [
{
"timestamp": "2021-12-10T16:05:34.492Z",
"id": ""
}
]
},
"checkin": {
"time": [
{
"pom": "output",
"pomt": "actual",
"timestamp": "2021-12-10T16:05:34.492Z"
},
{
"pom": "output",
"pomt": "estimated",
"computingtime": "",
"forecasttime": "",
"timestamp": "2021-12-10T16:05:34.492Z"
}
],
"logical": [
{
"pom": "ioutput",
"pomt": "actual",
"timestamp": "2021-12-10T16:05:34.492Z",
"qualifier": "berth",
"name": "",
"value": "B 2",
"berthing": "2"
}
],
"coordinate": [
{
"pom": "ioutput",
"pomt": "actual",
"qualifier": "WGS84",
"timestamp": "2021-12-10T16:05:34.492Z",
"value": [
4012.22,
-7500.25
],
"status": true,
"accuracy": "12.0"
}
]
},
"dwell": {
"status": [
{
"pom": "ioutput",
"pomt": "actual",
"timestamp": "2021-12-10T16:05:34.492Z",
"value": false
}
],
"duration": [
{
"pom": "ioutput",
"pomt": "actual",
"unit": "second",
"timestamp": "2021-12-10T16:05:34.492Z",
"value": 0
}
],
"counter": [
{
"pom": "ioutput",
"pomt": "actual",
"timestamp": "2021-12-10T16:05:34.492Z",
"value": 0,
"starttimestamp": "2021-12-10T16:05:34.492Z",
"endtimestamp": "2021-12-10T16:05:34.492Z"
}
],
"totalcounter": [
{
"pom": "ioutput",
"pomt": "actual",
"timestamp": "2021-12-10T16:05:34.492Z",
"value": 0
}
],
"timer": [
{
"pom": "ioutput",
"pomt": "actual",
"unit": "second",
"timestamp": "2021-12-10T16:05:34.492Z",
"value": 0,
"starttimestamp": "2021-12-10T16:05:34.492Z",
"endtimestamp": "2021-12-10T16:05:34.492Z"
}
],
"totaltimer": [
{
"pom": "ioutput",
"pomt": "actual",
"unit": "hour",
"timestamp": "2021-12-10T16:05:34.492Z",
"value": 0
}
],
"logical": [
{
"pom": "ioutput",
"pomt": "actual",
"qualifier": "yard",
"timestamp": "2021-12-10T16:05:34.492Z",
"value": "Y 01A 035 B 3",
"status": true,
"block": "01A",
"row": "035",
"bay": "B",
"tier": "3"
}
],
"coordinate": [
{
"pom": "output",
"pomt": "actual",
"qualifier": "WGS84",
"timestamp": "2021-12-10T16:05:34.492Z",
"value": [
4012.45,
-7500.15
],
"status": true,
"accuracy": "1.5"
}
]
},
"checkout": {
"time": [
{
"pom": "output",
"pomt": "actual",
"timestamp": "2021-12-10T16:05:34.492Z"
},
{
"pom": "output",
"pomt": "estimated",
"computingtime": "",
"forecasttime": "",
"timestamp": "2021-12-10T16:05:34.492Z"
}
],
"logical": [
{
"pom": "ioutput",
"pomt": "actual",
"timestamp": "2021-12-10T16:05:34.492Z",
"qualifier": "berth",
"name": "",
"value": "B 2",
"berthing": "2"
}
],
"coordinate": [
{
"pom": "ioutput",
"pomt": "actual",
"qualifier": "WGS84",
"timestamp": "2021-12-10T16:05:34.492Z",
"value": [
4012.22,
-7500.25
],
"status": true,
"accuracy": "12.0"
}
]
},
"outbound": {
"modality": "vessel/truck/train/barge/interterminaltransfer/unknown",
"time": [
{
"pom": "output",
"pomt": "actual",
"timestamp": "2021-12-10T16:05:34.492Z"
},
{
"pom": "output",
"pomt": "estimated",
"computingtime": "",
"forecasttime": "",
"timestamp": "2021-12-10T16:05:34.492Z"
}
],
"location": {
"logical": [
{
"pom": "ioutput",
"pomt": "actual",
"timestamp": "2021-12-10T16:05:34.492Z",
"qualifier": "berth",
"name": "",
"value": "B 2",
"berthing": "2"
}
],
"coordinate": [
{
"pom": "ioutput",
"pomt": "actual",
"qualifier": "WGS84",
"timestamp": "2021-12-10T16:05:34.492Z",
"value": [
4012.22,
-7500.25
],
"status": true,
"accuracy": "12.0"
}
]
},
"carrier": [
{
"timestamp": "2021-12-10T16:05:34.492Z",
"id": ""
}
],
"carriervisit": {
"timestamp": "2021-12-10T16:05:34.492Z",
"id": ""
},
"service": [
{
"code": "",
"description": "",
"timestamp": "2021-12-10T16:05:34.492Z"
}
],
"servicevisit": [
{
"timestamp": "2021-12-10T16:05:34.492Z",
"id": ""
}
]
}
}
]
}
]
}
| TIC Description |
Link to one or more operational processes | M | TIC Description | |
Search tags | M | dwell, dwelltime, age, life | Technical |
Version / Date | M | 2022.004 - 23/04/2022 | Technical |
Internal TIC Version | M | 20220423 | Technical |
M = Mandatory
O = Optional
Created by | Edited by | Review / Approve | Published |
Francisco Blanquer Jaraiz 2021-12-10 |
|
|
|
|
|
| |