Accumulative Tank Farm Control in Refinery Digital Twins
Introduction
While the ReservoirPark template provides generic control capabilities, accumulative tank faarms extends them with specialized mechanisms for production planning, passportization, shipment preparation, and tank availability. These capabilities allow engineers to manage accumulative reservoir parks during model execution. Engineers can manage passportization, shipment preparation, tank availability, and production planning without interrupting the simulation.
Modern refinery simulation models and refinery digital twins combine automatic production scheduling with operator supervision to reproduce realistic petroleum refining operations. While Accumulative tank farm automatically generates and executes filling requests, operators can initiate passportization, adjust output throughput, manage reserve tanks, and respond to changing operating conditions at runtime.
Modern refinery simulation models and refinery digital twins combine automatic production scheduling with operator supervision to reproduce realistic petroleum refining operations. While Accumulative tank farm automatically generates and executes filling requests, operators can initiate passportization, adjust output throughput, manage reserve tanks, and respond to changing operating conditions at runtime.
Passportization Control
Passportization is one of the key operational procedures in accumulative reservoir parks. During this process, product remains in the storage tank for a specified residence time while laboratory personnel verify its quality against key specification parameters before the tank is released for shipment. This capability of digital twins allows engineers to model operator interventions, laboratory delays, emergency shipments, and other operational scenarios while preserving the integrity of the reservoir park control algorithm. This functionality is essential for realistic tank farm simulation, where laboratory delays and product certification directly influence storage utilization and shipment schedules.
Throughput Control
Controlling inlet and outlet rates is essential for reproducing real refinery operating conditions. Reservoir parks in refinery digital twins allow engineers to dynamically limit the total inlet and outlet flow rates, making it possible to simulate pump capacity limits, maximum throughput of downstream processing units, pipeline restrictions, and other operational bottlenecks. In refinery process simulation, dynamic throughput limits help engineers reproduce real operating constraints caused by pumps, pipelines, and downstream processing units.
Throughput limits can be modified or reset at runtime without interrupting the simulation. This enables engineers to evaluate different operating scenarios while preserving the automatic production planning and shipment algorithms.
Throughput limits can be modified or reset at runtime without interrupting the simulation. This enables engineers to evaluate different operating scenarios while preserving the automatic production planning and shipment algorithms.
Event-Driven Production Planning
Modern accumulative reservoir parks in petroleum refining simulation rely on production planning algorithms to automatically generate and execute filling requests according to current operational objectives. Rather than creating requests manually, operators and external applications interact with the planning process through runtime control mechanisms and event-driven callbacks that report request creation and completion.
These events allow custom business logic to synchronize production schedules, reporting systems, optimization algorithms, and other external applications with the current state of the reservoir park. Completion notifications can also provide execution statistics, allowing engineers to evaluate planning performance and identify partially completed requests caused by operational constraints. This event-driven architecture also simplifies integration with production scheduling, logistics simulation, and refinery optimization applications that depend on real-time operational data.
These events allow custom business logic to synchronize production schedules, reporting systems, optimization algorithms, and other external applications with the current state of the reservoir park. Completion notifications can also provide execution statistics, allowing engineers to evaluate planning performance and identify partially completed requests caused by operational constraints. This event-driven architecture also simplifies integration with production scheduling, logistics simulation, and refinery optimization applications that depend on real-time operational data.
Operator Control and Automation
Accumulative tanks farms combines automatic production planning with interactive operator control. While production planning and filling request generation are managed automatically, operators can intervene at runtime through the integrated control panel by initiating passportization, managing reserve tanks, and adjusting shipment throughput to reflect changing operating conditions.
All operator actions are immediately synchronized with the simulation through an event-driven architecture. This approach simplifies integration with custom business logic, production planning systems, optimization algorithms, and reporting tools while preserving the consistency of the reservoir park control algorithm.
All operator actions are immediately synchronized with the simulation through an event-driven architecture. This approach simplifies integration with custom business logic, production planning systems, optimization algorithms, and reporting tools while preserving the consistency of the reservoir park control algorithm.
Accumulative Reservoir Park Control in Petroleum Refining Library
The runtime control capabilities described above are implemented in Petroleum Refining Library (PRL) through the RpAccumulative template. The component inherits all runtime control features of the ReservoirPark template, including operating modes, flow routing, throughput control, runtime configuration, and the integrated operator control panel. No additional application code is required to enable these capabilities, allowing engineers to configure and control accumulative reservoir parks directly within refinery simulation models. The same control mechanisms can be applied in refinery simulation studies, storage simulation models, and operator training simulators without additional implementation effort.
In addition, RpAccumulative provides specialized control mechanisms for accumulative reservoir parks, including manual passportization, automatic filling request management, reserve tank control, and event-driven integration with production planning. These capabilities allow engineers to customize operational behavior while preserving the library's built-in planning algorithms and maintaining realistic refinery operations.
In addition, RpAccumulative provides specialized control mechanisms for accumulative reservoir parks, including manual passportization, automatic filling request management, reserve tank control, and event-driven integration with production planning. These capabilities allow engineers to customize operational behavior while preserving the library's built-in planning algorithms and maintaining realistic refinery operations.
Passportization Control
Passportization processing can be initiated programmatically using dedicated API methods that temporarily override the automatic planning logic and force one or multiple tanks into passportization mode:
forcePassportization(int tankIndex);
forcePassportization(); These methods allow engineers to manually prepare product batches for shipment, certification, laboratory approval, or operational transfer without modifying the reservoir park control algorithm. The first method forces passportization for a specific tank using its one-based operator index, while the second automatically processes all eligible tanks containing sufficient product volume. Empty tanks and tanks that do not satisfy the operational loading requirements are skipped automatically.
Throughput Control
Runtime throughput limits can be configured using dedicated API methods for both inlet and outlet flow control:
setInputSpeedLimit(double speedLimit);
resetInputSpeedLimit();
setOutputSpeedLimit(double speedLimit, boolean action);
resetOutputSpeedLimit(); These methods allow engineers to temporarily restrict or restore the maximum inlet and outlet flow rates without modifying the simulation model or interrupting execution. Throughput control is commonly used to reproduce pump capacity limits, pipeline constraints, downstream processing bottlenecks, scheduled maintenance, and emergency operating conditions. Input limits restrict the maximum product flow entering the reservoir park, while output limits control the maximum shipment rate through the outlet valve. All changes take effect immediately, enabling rapid evaluation of different operating scenarios while preserving the automatic production planning and shipment algorithms. These capabilities are particularly valuable when evaluating alternative production schedules, logistics simulation scenarios, and equipment capacity constraints.
Event-Driven Production Planning
The ReservoirPark component fully implements the event-driven production planning mechanism described in Tank Farm Planning Algorithm for Production Scheduling, automatically generating filling requests according to the A–D priority hierarchy.
External applications can subscribe to planning events that report request creation and completion, enabling integration with production scheduling, optimization, reporting, and MES/ERP systems. Completion events also provide execution statistics for evaluating planning performance and identifying partially completed requests.
External applications can subscribe to planning events that report request creation and completion, enabling integration with production scheduling, optimization, reporting, and MES/ERP systems. Completion events also provide execution statistics for evaluating planning performance and identifying partially completed requests.
Conclusion
Modern refinery simulation and petroleum refining digital twins require more than static tank configuration. Effective runtime control is essential for production scheduling, storage simulation, and realistic tank farm operation. Operators must be able to intervene during simulation, while automatic production planning continues to coordinate filling requests, passportization, shipment preparation, and tank availability.
Accumulative reservoir park combines runtime control, event-driven integration, and operator supervision within a unified framework. By inheriting the generic control capabilities of ReservoirPark and extending them with accumulative-specific functionality, it enables engineers to build realistic refinery simulation models that remain flexible under changing production and logistics conditions.
Accumulative reservoir park combines runtime control, event-driven integration, and operator supervision within a unified framework. By inheriting the generic control capabilities of ReservoirPark and extending them with accumulative-specific functionality, it enables engineers to build realistic refinery simulation models that remain flexible under changing production and logistics conditions.
FAQ
1. What is Accumulative Reservoir Park control?
Accumulative Reservoir Park control is the runtime management of accumulative reservoir park operations, including passportization, shipment throughput, reserve tanks, and integration with the automatic production planning algorithm.
2. Can operators manually start passportization?
Yes. Passportization can be initiated at runtime for either an individual tank or all eligible tanks without interrupting the simulation.
3. How are filling requests created?
Filling requests are generated automatically by the internal production planning algorithm. External applications interact with these requests through event-driven callbacks rather than creating them manually.
4. Can shipment throughput be limited during simulation?
Yes. Accumulative Reservoir Parkallows engineers to dynamically limit or reset the total outlet flow rate of the reservoir park to simulate operational constraints such as pump or pipeline capacity.
5. Does Accumulative Reservoir Park support runtime operator control?
Yes. The integrated operator control panel allows engineers to manage passportization, reserve tanks, and throughput settings while the simulation is running.
6. How can external applications react to production planning events?
Accumulative Reservoir Park provides event-driven callbacks for filling request creation, request completion, inlet valve state changes, and reserve tank operations, allowing seamless integration with custom business logic.
7. Does RpAccumulative replace ReservoirPark control?
No. Accumulative Reservoir Parkinherits all runtime control capabilities of ReservoirPark and extends them with specialized functionality for accumulative reservoir parks, including passportization, filling request management, and production planning integration.
Accumulative Reservoir Park control is the runtime management of accumulative reservoir park operations, including passportization, shipment throughput, reserve tanks, and integration with the automatic production planning algorithm.
2. Can operators manually start passportization?
Yes. Passportization can be initiated at runtime for either an individual tank or all eligible tanks without interrupting the simulation.
3. How are filling requests created?
Filling requests are generated automatically by the internal production planning algorithm. External applications interact with these requests through event-driven callbacks rather than creating them manually.
4. Can shipment throughput be limited during simulation?
Yes. Accumulative Reservoir Parkallows engineers to dynamically limit or reset the total outlet flow rate of the reservoir park to simulate operational constraints such as pump or pipeline capacity.
5. Does Accumulative Reservoir Park support runtime operator control?
Yes. The integrated operator control panel allows engineers to manage passportization, reserve tanks, and throughput settings while the simulation is running.
6. How can external applications react to production planning events?
Accumulative Reservoir Park provides event-driven callbacks for filling request creation, request completion, inlet valve state changes, and reserve tank operations, allowing seamless integration with custom business logic.
7. Does RpAccumulative replace ReservoirPark control?
No. Accumulative Reservoir Parkinherits all runtime control capabilities of ReservoirPark and extends them with specialized functionality for accumulative reservoir parks, including passportization, filling request management, and production planning integration.
Last updated on 29.06.2026