digital_comms.fixed_network package

Submodules

digital_comms.fixed_network.interventions module

Decide on interventions

digital_comms.fixed_network.interventions.decide_interventions(system, technology, policy, parameters)[source]

???

digital_comms.fixed_network.interventions.get_all_assets_ranked(system, technology, roll_out, percentile)[source]

Specifically obtain and rank exchanges by technology and policy.

Parameters

  • distributions (list of digital_comms.fixed_network.model.Distribution) – A list of distribution points

  • technology (str) – The current technology being deployed.

  • reverse_value (bool) – Used as an argument in ‘sorted’ to rank how assets will be deployed.

Returns

Returns desired assets ranked based on technology benefit-cost ratio and reverse_value preference.

Return type

list_of_objects

digital_comms.fixed_network.model module

Cambridge Communications Assessment Model

class digital_comms.fixed_network.model.Exchange(data, simulation_parameters)[source]

Bases: object

Exchange object

Parameters

  • data (dict) – Contains asset data including, id, name, postcode, region, county and available technologies.

  • dwellings (list_of_objects) – Contains all assets (Cabinets) served by an Exchange.

  • parameters (dict) – Contains all parameters from ‘digital_comms.yml’.

  • = raw number of unserved premises (self.adsl) –

  • = raw number of unserved premises –

  • = raw number of unserved premises –

  • = raw number of unserved premises –

  • = number of unserved premises per km^2 (self.fttc_unserved) –

  • = number of unserved premises per km^2 –

  • = number of unserved premises per km^2 –

upgrade(action)[source]

Upgrade the asset’s clients with an action If a leaf asset (e.g. an Asset with no clients), upgrade self. :param action: :type action: str

Notes

Could check whether self is an instance of Distribution instead

class digital_comms.fixed_network.model.NetworkManager(exchanges, simulation_parameters)[source]

Bases: object

Model controller class.

Parameters

  • assets (dict) – Contains keys for Premises, Distribution Points, Cabinets and Exchanges, with each value constituting a list of respective assets.

  • links (list_of_dicts) – Contains all links between Premises, Distribution Points, Cabinets and Exchanges.

  • parameters (dict) – Contains all parameters from ‘digital_comms.yml’.

assets
number_of_assets
lads
update_adoption_desirability()

Takes exogenously defined annual demand and updates premises adoption desirability.

coverage()[source]

Allocates premises-level technology technologies to a dict of coverage_results by Local Authority District.

aggregate_coverage()

Calculates the sum and percentage coverage of premises-level technology by Local Authority District.

capacity()[source]

Calculates the average premises connection.

capacity()[source]

Define capacity

coverage()[source]

define coverage

upgrade(interventions)[source]

Upgrades the system with a list of interventions

Parameters

interventions (list of tuple) – A list of intervention tuples containing asset id and technology