Shipment Node Performance Metrics in Refinery Simulation
A Shipment Node is a refinery simulation component that represents the controlled transfer of petroleum products from the refinery to external transportation systems or customers. It supports multiple shipment scheduling strategies, working calendars, operating hour restrictions, and shipment plan execution, enabling realistic simulation of pipeline transfers, terminal loading operations, and other product dispatch processes. In addition to controlling shipment behavior, the component provides comprehensive performance metrics for monitoring operational efficiency, plan execution, and historical shipment performance.
Why Shipment Nodes Require Specialized Statistics?
Shipment performance cannot be evaluated by flow rate alone. In refinery operations, product dispatch is governed by shipment plans, loading schedules, pipeline availability, and working calendars. A shipment may maintain a stable flow while failing to meet its planned target, or experience temporary interruptions without affecting overall plan execution.
To address this, the Shipment Node provides specialized performance metrics that combine operational and planning data. In addition to monitoring current flow conditions, it tracks shipment progress, compares planned and actual shipped volumes, calculates the remaining shipment target, and stores historical execution records for performance analysis.
All metrics are calculated for a single assigned product and the currently active shipment plan. Each planning period is evaluated independently, reflecting common refinery practice where shipment plans are generated separately for each planning horizon or pipeline dispatch schedule. As a result, unfulfilled shipment volumes are not automatically carried over to the next planning period.
To address this, the Shipment Node provides specialized performance metrics that combine operational and planning data. In addition to monitoring current flow conditions, it tracks shipment progress, compares planned and actual shipped volumes, calculates the remaining shipment target, and stores historical execution records for performance analysis.
All metrics are calculated for a single assigned product and the currently active shipment plan. Each planning period is evaluated independently, reflecting common refinery practice where shipment plans are generated separately for each planning horizon or pipeline dispatch schedule. As a result, unfulfilled shipment volumes are not automatically carried over to the next planning period.
Shipment Node Statistics Categories
Shipment Flow Statistics
Flow statistics provide real-time information about the product currently being transferred through the Shipment Node. These metrics are primarily used to monitor loading operations, verify pumping rates, and analyze the distribution of incoming product streams.
Shipment Plan Statistics
Shipment plan statistics evaluate how effectively the Shipment Node fulfills the assigned shipment plan. Unlike flow statistics, which describe the current operating state, these metrics measure shipment progress, compare planned and actual shipped volumes, determine the remaining shipment target, and calculate plan completion indicators.
The Shipment Node evaluates each planning period independently. Shipment plans are not automatically carried over between planning periods, allowing monthly, daily, or pipeline shipment schedules to be analyzed separately. When required, overplanning can be enabled to allow the actual shipped volume to exceed the planned target.
The Shipment Node evaluates each planning period independently. Shipment plans are not automatically carried over between planning periods, allowing monthly, daily, or pipeline shipment schedules to be analyzed separately. When required, overplanning can be enabled to allow the actual shipped volume to exceed the planned target.
Shipment Scheduling Statistics
Shipment scheduling statistics provide information about the scheduling strategy currently controlling the Shipment Node. These metrics help engineers verify that the expected planning algorithm is active and ensure that shipment operations follow the intended dispatch strategy.
Unlike shipment plan statistics, scheduling statistics do not measure performance. Instead, they describe the operational logic used to generate shipment requests and execute the shipment plan.
Unlike shipment plan statistics, scheduling statistics do not measure performance. Instead, they describe the operational logic used to generate shipment requests and execute the shipment plan.
Historical Shipment Statistics
Historical shipment statistics provide access to archived shipment plan and execution data stored during the simulation. These statistics support long-term performance analysis, monthly reporting, KPI calculation, and comparison of planned versus actual shipment volumes.
Shipment records are automatically stored immediately before the shipment plan is updated. Consequently, the recording frequency depends on the selected planning strategy. Monthly planning generates one record per month, while daily and evenly distributed daily planning generate one record per day.
Shipment records are automatically stored immediately before the shipment plan is updated. Consequently, the recording frequency depends on the selected planning strategy. Monthly planning generates one record per month, while daily and evenly distributed daily planning generate one record per day.
Applications of Shipment Node Performance Metrics
Shipment Node statistics support both operational monitoring and long-term analysis of refinery logistics. They enable engineers to evaluate shipment execution, identify deviations from planned schedules, and compare the effectiveness of alternative shipment strategies.
Typical applications include:
Typical applications include:
- Monitoring real-time shipment operations.
- Tracking shipment plan execution.
- Comparing planned and actual shipped volumes.
- Identifying shipment delays and incomplete deliveries.
- Evaluating pipeline export performance.
- Analyzing loading rack utilization.
- Generating monthly shipment reports.
- Building refinery logistics dashboards.
- Comparing alternative shipment scheduling strategies.
- Validating Digital Twin and production planning scenarios.
ShipmentNode shipment = ...;
ShipmentNodeStatistics stats = shipment.statistics;
double shipped = stats.getActualShipped();
double plan = stats.getActualPlan();
double completion = stats.getActualShippedRatio();
double remaining = stats.getRemainingToShip();Conclusion
Shipment Node performance metrics provide a comprehensive view of refinery shipment operations by combining real-time flow monitoring with shipment plan execution and historical performance analysis. Together, these statistics allow engineers to evaluate not only how much product is being shipped, but also how effectively shipment plans are being fulfilled.
The Petroleum Refining Library exposes these metrics through a straightforward API, making them suitable for operational dashboards, KPI reporting, Digital Twin applications, and automated analysis of refinery logistics. By integrating operational, planning, scheduling, and historical statistics, Shipment Node enables accurate evaluation and continuous optimization of refinery shipment performance.
The Petroleum Refining Library exposes these metrics through a straightforward API, making them suitable for operational dashboards, KPI reporting, Digital Twin applications, and automated analysis of refinery logistics. By integrating operational, planning, scheduling, and historical statistics, Shipment Node enables accurate evaluation and continuous optimization of refinery shipment performance.
FAQ
1. What is the purpose of Shipment Node performance metrics?
Shipment Node performance metrics measure both operational and planning performance. They report current shipment flows, evaluate shipment plan execution, calculate completion ratios, and provide historical statistics for long-term logistics analysis.
2. How is shipment plan completion calculated?
The Shipment Node compares the actual shipped volume with the current shipment plan and calculates the corresponding completion ratio. Additional metrics report the remaining shipment volume and the current plan completion status.
3. Does Shipment Node support overplanning?
Yes. Shipment Node can be configured to allow overplanning, enabling the actual shipped volume to exceed the planned shipment target when refinery operating conditions require additional product dispatch.
4. Are shipment plans carried over to the next planning period?
No. Each planning period is evaluated independently. Unfulfilled shipment volumes are not automatically transferred to the next shipment plan, reflecting common refinery planning and pipeline dispatch practices.
5. How often are historical shipment statistics recorded?
Historical records are stored automatically immediately before the shipment plan is updated. Therefore, the recording frequency depends on the selected planning strategy, typically once per month for monthly planning or once per day for daily scheduling.
6. Can historical shipment data be queried for a specific period?
Yes. The historical database supports queries for individual calendar months as well as arbitrary date ranges, allowing engineers to compare planned and actual shipment volumes over any reporting period.
7. Can Shipment Node statistics be integrated into refinery dashboards?
Yes. All performance metrics are available through the Petroleum Refining Library API, making them suitable for Digital Twin dashboards, KPI reporting, production monitoring, and refinery logistics analytics.
8. What is the difference between flow statistics and shipment plan statistics?
Flow statistics describe the current operating conditions of the Shipment Node, such as incoming flow rates. Shipment plan statistics evaluate operational performance by comparing planned and actual shipped volumes, calculating completion ratios, and tracking remaining shipment requirements.
Shipment Node performance metrics measure both operational and planning performance. They report current shipment flows, evaluate shipment plan execution, calculate completion ratios, and provide historical statistics for long-term logistics analysis.
2. How is shipment plan completion calculated?
The Shipment Node compares the actual shipped volume with the current shipment plan and calculates the corresponding completion ratio. Additional metrics report the remaining shipment volume and the current plan completion status.
3. Does Shipment Node support overplanning?
Yes. Shipment Node can be configured to allow overplanning, enabling the actual shipped volume to exceed the planned shipment target when refinery operating conditions require additional product dispatch.
4. Are shipment plans carried over to the next planning period?
No. Each planning period is evaluated independently. Unfulfilled shipment volumes are not automatically transferred to the next shipment plan, reflecting common refinery planning and pipeline dispatch practices.
5. How often are historical shipment statistics recorded?
Historical records are stored automatically immediately before the shipment plan is updated. Therefore, the recording frequency depends on the selected planning strategy, typically once per month for monthly planning or once per day for daily scheduling.
6. Can historical shipment data be queried for a specific period?
Yes. The historical database supports queries for individual calendar months as well as arbitrary date ranges, allowing engineers to compare planned and actual shipment volumes over any reporting period.
7. Can Shipment Node statistics be integrated into refinery dashboards?
Yes. All performance metrics are available through the Petroleum Refining Library API, making them suitable for Digital Twin dashboards, KPI reporting, production monitoring, and refinery logistics analytics.
8. What is the difference between flow statistics and shipment plan statistics?
Flow statistics describe the current operating conditions of the Shipment Node, such as incoming flow rates. Shipment plan statistics evaluate operational performance by comparing planned and actual shipped volumes, calculating completion ratios, and tracking remaining shipment requirements.