Input files

The totality of all the input files are all located in the config directory.

GridAPPSD needed files

test240b_open_76591_CIM100x.XML: CIM model for the example test case. Needed for populating the example test case.
system_message_bus.yml: Configuration of the message bus.
pnnl.goss.gridappsd.cfg: Informs the distributed version of GridAPPSD the test case to be utilized.

Main input configuration

input_config.toml:

core: strings to be replaced in other entries similar to a f-string in python
logging_configuration: contain the python logging configuration
test_case: GridAPPSD test case and simulation configuration
system_variables: Set of system variables added to the system
app_config: Id and description of application to GridAPPSD
feeder_agent_configuration: Feeder level agent configuration
area_agent_configuration: Switch delimited area agent configuration

Note: Multiple of the previous mentioned information configuration points to other files to be replaced by their information.

Message configuration

The message configuration is made by a json file selected in the input_config.toml. The files contain default message delays and losses and specific message delay and loss in between specific agents.

The delay are presented in seconds and the delays are added by a uniform random sample in between the upper and lower expected delays expressed in seconds.
The loss of messages is expressed in pu. E.G., the message loss of 0.5 implies that half the messages are expected to be lost.

DFLISR test case dependent input files

The files presented here are the HDF5 files. The HDF5 files contain pandas DataFrame tables. A portion of the tables will be presented hear to illustrate the information being provided to the agents making the decisions. Please note the float and complex numbers are truncate to reduce the space taken in the documentation.

area_connections.h5

Contain a single table with the information of the switch delimited areas connections. Below is the head of the table. node1 is the node name from. node2 is the node name to. area1 indicated the area number from. area2 indicates the area number to. The values with -1 indicated the area is connected tu a substation.

node1	node2	area1	area2
BUS1.1	BUS1001.1	-1	1
BUS1.2	BUS1001.2	-1	1
BUS1.3	BUS1001.3	-1	1
BUS1010.1	BUS2057.1	1	4
BUS1010.2	BUS2057.2	1	4

max_node_load.h5

Contain a single table with the information of the maximum load at each node. sensor_name sensor name. sensor_type the types are active power Pi or reactive power Qi for each node. node1 the from node location of the sensor. node2 the to node location of the sensor. measurement the sensor measurement value. variance the sensor variance (i.e., expected error). area the switch delimited area number of the sensor.

sensor_name	sensor_type	node1	node2	measurement	variance	area
Pi_BUS1001.1	Pi	BUS1001.1	BUS1001.1	-0.00	1.00e-09	1
Pi_BUS1001.2	Pi	BUS1001.2	BUS1001.2	-0.00	1.00e-09	1
Pi_BUS1001.3	Pi	BUS1001.3	BUS1001.3	-0.00	1.00e-09	1
Pi_BUS1002.1	Pi	BUS1002.1	BUS1002.1	-0.00	1.00e-09	1
Pi_BUS1002.2	Pi	BUS1002.2	BUS1002.2	-0.00	1.00e-09	1

sensors.h5

Contain a single table very similar to max_node_load.h5 the main deference is that all the sensor types are available and the measurement column is not related to the maximum load node.

sensor_name	sensor_type	node1	node2	measurement	variance
Vi_EQ_SOURCE_BUS.1	Vi	EQ	SOURCE	1.00	0.00
Vi_EQ_SOURCE_BUS.2	Vi	EQ	SOURCE	1.00	0.00
Vi_EQ_SOURCE_BUS.3	Vi	EQ	SOURCE	1.00	0.00
Vi_BUS_XFMR.1	Vi	BUS	XFMR.1	1.00	0.00
Vi_BUS_XFMR.2	Vi	BUS	XFMR.2	1.00	0.00

ybus_area.h5

Contain multiple tables. The table keys are area-1, area-2, area-3, area-4, area-5, and area-6. As the name suggests the the table contain the ybus matrix of each area. The table head below is from area-1.

BUS1001.1

BUS1001.2

BUS1001.3

BUS1002.1

BUS1002.2

BUS1002.3

BUS1003.1

BUS1003.2

BUS1003.3

BUS1004.1

BUS1004.2

BUS1004.3

BUS1005.1

BUS1005.2

BUS1005.3

BUS1006.1

BUS1006.2

BUS1006.3

BUS1007.1

BUS1007.2

BUS1008.1

BUS1008.2

BUS1008.3

BUS1009.1

BUS1009.2

BUS1009.3

BUS1010.1

BUS1010.2

BUS1010.3

BUS1011.1

BUS1011.2

BUS1011.3

BUS1012.1

BUS1012.2

BUS1012.3

BUS1013.1

BUS1013.2

BUS1013.3

BUS1014.2

BUS1015.2

BUS1016.3

BUS1017.3

1.67 + -1.01i

-0.41 + 0.35i

-1.67 + 1.01i

0.41 + -0.35i

0.00 + 0.00i

-0.41 + 0.35i

1.67 + -1.01i

-0.41 + 0.35i

0.41 + -0.35i

-1.67 + 1.01i

0.41 + -0.35i

0.00 + 0.00i

-0.41 + 0.35i

1.67 + -1.01i

0.41 + -0.35i

-1.67 + 1.01i

0.00 + 0.00i

-1.67 + 1.01i

0.41 + -0.35i

13.75 + -10.97i

-3.71 + 2.63i

-8.51 + 3.51i

2.27 + -0.70i

-3.57 + 6.45i

1.03 + -1.58i

0.00 + 0.00i

0.41 + -0.35i

-1.67 + 1.01i

0.41 + -0.35i

-3.71 + 2.63i

13.75 + -10.97i

-3.71 + 2.63i

2.27 + -0.70i

-8.51 + 3.51i

2.27 + -0.70i

1.03 + -1.58i

-3.57 + 6.45i

1.03 + -1.58i

0.00 + 0.00i