Ecosystems

Ghostwriter is an accelerator specific to power utilities. When enabled, it can be accessed via the menu button ( ) in the top-left corner of the Utilihive Console.

Ecosystems represent an area on the map where simulated meter readings will take place. To create a new ecosystem, select the Ecosystems tab on the left, then select the "Create New Ecosystem" button in the top-right corner. You will see the following form to specify a name and time zone:

An overlay displays a form to enter an ecosystem name and select a time zone.

Usage Points

After the ecosystem is created, you will need to add usage points (i.e., meter reading locations) to it. This can be done automatically by selecting the "Generate Points" button, which will display the following map:

A map displays a green circle around New York, with the area of the circle set to 30 square kilometers.

Click on the map to set the center of the circle and use the sliders to adjust the size of the area and number of usage points to create within.

You can also upload a CSV file instead, where each line of the file would need to have the following data:

id,type,profile,coordSystem;lat;lon,city,address,zip

A complete example would look like the following:

METER-1234,type-1,Basic24hActive,L.CRS.EPSG3857;40.7580;-73.9855,Manhattan,Times Square,10036
Once you’ve created the usage points, you cannot edit them and will need to delete the ecosystem and/or create a new one.

Events

Events are negative effects like a power outage or corrupt reading that you would want to test your flows against. Ecosystems must have at least one event added to them before a simulation can be run.

To add an event, select the "Create New Event Scenario" button in the top-right corner of the screen. This will bring up the following form:

The scenario form displays a map and fields to enter a scenario name, start and end dates, type of event, and percentage of affected usage points.

Note the Selection option that defaults to "Percentage". This value sets what percentage of the usage points will be affected by the event.

Alternatively, you can draw a perimeter around the usage points that should be part of the event. Select the polygon button ( ) in the top-left corner of the map, then click on different areas of the map to define the boundaries. The following image demonstrates what you should see:

The map displays an orange polygon surrounding several of the usage points.

Lastly, select the Add button to add the current event to the scenario. Multiple events can be added before finalizing the scenario by selecting Create.