Running the Application
Standard Deployment
A standard deployment has updated network models and load readings being generated daily. With this configuration you can run the tool by executing the
following command at a terminal, where <heap size> is the desired size of the heap (e.g. 16g):
java -Xmx<heap size> -Xms<heap size> -jar <path to load-aggregator-jar> -conf <path to config file>
e.g.
java -Xmx20g -Xms20g -jar load-aggregator-3.2.0.jar -c .\loadagg_config.json
If you do not have new load readings for the day, the load aggregation will not run and the network database will not update. See Forced Aggregation.
Forced Aggregation
The usage points table in the network model database needs to be updated for the load server to work correctly with aggregated transformer data. If you are observing poor performance of the load aggregation function, its probably because something has gone wrong with the process that updates the usage points table in the network model.
The information needed to update the usage points table needs only the network database itself, like 2023-01-18-network-model.sqlite. Normally, this would
be done by the load-aggregator as part of the daily processing, however; in some situations, such as if the load-aggregator did not run or failed to run, or
if a new network model is needed to work with existing historical load databases, it will be necessary to force the load-aggregator to run manually. In this
situation, use this command line:
java -Xmx<heap size> -Xms<heap size> -jar <path to load-aggregator-jar> -conf <path to config file> --force-aggregation YYYY-MM-DD,YYYY-MM-DD
e.g.
java -Xmx20g -Xms20g -jar load-aggregator-3.2.0.jar -c .\loadagg_config.json --force-aggregation 2023-01-24,2023-01-24
Where the date range is the date of the model build, where the network model is located. If it can’t find the network database for the date specified,
it will search backwards and forwards and use the first load database it finds, up to daysToSearchForNetwork days in each direction.
Command Line Arguments
| Flag | Valid Values | Required | Default |
|---|---|---|---|
-c | Path to the configuration file (see Configuring for details including an example config file). | Yes | |
--detailed-stats-log | Used to show detailed messages for each warning collected in the stats output. | No | Disabled |
--force-aggregation <FROM_DATE,TO_DATE> | Allows all meters to be aggregated to their transformers for a specified date range. Dates formatted as YYYY-MM-DD, with no spaces around the ,. | No | Disabled |
Heap Size Estimation
The LV Mapping data requires around 2GB
The meter data requires around 1.5GB
Together with the process overhead, the recommended heap size is 8GB