Getting Started

Run the preprocessing script for a single exchange (exchange_EACAM):

python scripts/network_preprocess_input_files.py exchange_EACAM

This script will generate a broadband network made up of nodes and edges (assets and links).

After creating an ‘intermediate’ folder in data/digital_comms, we can run the following:

python network_collect_results.py

which will collect the intermediate results and assemble all individual exchange data into a set of aggregated system-wide files.

Todo

• Add directions to sample project files.

• Provide suggested instructions for setting up sample project

• Provide suggested instructions running the model

Project Configuration

Todo

• Provide outline of basic folder structure

Inputs

Data on a number of key inputs are required for the model to function.

Premises

Premises are the most granular layer the model utilises. Data should ideally consist of a set of premises points with indicators for the number of residential or non-residential premises at that particular location. Coordinates for these points, and also the postcode they are attached to, are useful attributes.

Premises input data

Premise_ID	Residential	Non_Residential	Latitude	Longitude	Dist_Point_ID	Postcode
premise_1	0	1	52.205304	0.11661316	dist_point_1	CB2 1TN
premise_2	0	1	52.200671	0.11371496	dist_point_5	CB3 9EU

Distribution Points

Distribution points serve a very limited number of premises and are either hung aerially or exist in a buried manhole. Each distribution point usually serves approximately 8 premises.

Distribution point input data

Dist_Point_ID	Latitude	Longitude	Cabinet_ID
dist_point_1	52.205304	0.11661316	cabinet_1
dist_point_2	52.205304	0.11661316	cabinet_1

Cabinets

A cabinet exists as a green box, often on a street corner, and holds active equipment (such as a VDSL2 DSLAM). Cabinets serve up to approximately 500 premises.

Cabinets input data

Cabinet_ID	Latitude	Longitude	Exchange_ID
cabinet_1	52.205304	0.11661316	exchange_1
cabinet_2	52.205304	0.11661316	exchange_1

Exchanges

Exchanges are also know as ‘Central Offices’, and contain the Main Distribution Frame (ADSL) and Optical Fibre Distribution Frame (FTTx)

Exchanges input data

Exchange_ID	Latitude	Longitude
exchange_1	52.205304	0.11661316
exchange_2	52.205304	0.11661316