Running the Application
Configuration options for the GIS Network Extractor are provided as command line arguments.
Command Line Options
| Usage | Description | Default |
|---|---|---|
-com, --company <COMPANY> | Selects the processing data logic to be used based on company name. CPPAL or EE | CPPAL |
-cpi, --connection-point-identifier <IDENTIFIER> | allows renaming the connection point identifier. e.g. use ICP instead of NMI | NMI |
-dl, --detailed-log | Controls if a detailed set of errors are logged, or just the summary | false |
-dsc, --dont-stitch-conductors | Controls if the conductor stitching processor runs. | stitch |
-e, --ewb-data <EWB_DATA_PATH> | The root path for the EWB data | ./ewb |
-ep, --extract-phases <true or false> | Controls if the phase information will be extracted from the source data. If disabled everything will be extracted as ABC | true |
-g, --gis-data <GIS_DATA_PATH> | The path where the input GIS JSON files are located | ./gis |
-h, --help | Shows this help message. | false |
-lvt, --low-voltage-threshold <LOW_VOLTAGE_THRESHOLD> | Defines the LV voltage upper limit in volts (inclusive) | 1000 |
-m, --meter-mappings <METER_MAPPINGS_PATH> | The path where the input meter mappings csv files are located | ./meter_mappings |
-mmdp, --meter-mappings-date-pattern <METER_MAPPINGS_DATE_PATTERN> | Specifies the pattern used to represent dates for the records in the meter mappings csv files | yyyyMMdd |
-mmfp, --meter-mappings-file-pattern <METER_MAPPING_FILE_PATTERN> | Specifies the file name pattern for meter mapping files | NMI_TX_MAPPING_(\d{8}).*[.]csv |
-n, --network-hierarchy <NETWORK_HIERARCHY_FILE> | The file containing the network hierarchy JSON | ./network-hierarchy.json |
-nc, --nodes-config <NODES_CONFIG_PATH> | The file containing the nodes JSON config | ./nodes-config.json |
-pc, --processor-config <PROCESSOR_CONFIG_PATH> | The file containing the processor JSON config | ./processor-config.json |
-pl, --pole-data <POLE_DATA_PATH> | The file containing the pole data JSON | ./poles.json |
-pof, --poweron-fusion <HOST> <PORT> <INSTANCE> | PowerOn Fusion database connection configuration | null |
-q, --quality-checks <CHECKS> | Controls which quality checks are run. Comma separated list of [NONE, ALL, PHASES] | ALL |
-si, --source-impedance <SOURCE_IMPEDANCES_FILE> | The file containing the source impedance values | ./source-impedances.csv |
-tc, --types-config <TYPES_FILE> | The file containing the cable types JSON or SINCAL standard types database | ./cable-types.json |
Environment Variables
If the option for processing PowerOn Fusion is enabled, the following environment variables must be set to connect to the PowerOn Fusion database.
| Variable | Description | Default |
|---|---|---|
ENMAC_USER | The user for the PoF Oracle database. | enmac |
ENMAC_PASSWORD | The password for the PoF Oracle database. | password |
To run the tool, execute the following command at a terminal.
java -Xmx<heap size> -Xms<heap size> -jar <path to gis-network-extractor> <COMMAND LINE OPTIONS>
where:
-
PoF databse connection environment variables have been defined. e.g. ENMAC_USER=enmac; ENMAC_PASSWORD=password;
-
heap size is the desired size of the heap. e.g. 16g
Heap Size Estimation
PoF system with 2.5 million components requires around 10GB
The LV Mapping data requires around 2GB
Together with the process overhead, the recommended heap size is 16GB