Learn R Programming

CNAIM (cnaim.io)

Common Network Asset Indices Methodology (CNAIM) package for the R language.

Contains a series of algorithms which determine the probability of failure, consequences of failure and monetary risk associated with electricity distribution companies' assets such as transformers and cables. Results are visualized in an easy-to-understand risk matrix.

Open source implementation by Utiligize inspired by the framework specified by the Distribution Network Operators and the regulator (Ofgem) in Great Britain. The specification document is available here.

Installation

To install the latest development version from GitHub, run the following from an R console:

if (!require('devtools'))
  install.packages('devtools')
devtools::install_github('Utiligize/CNAIM')

A CRAN submission has been made.

Getting Started

We recommend you check out the examples and documentation at cnaim.io.

Contributing

Please report any issues on GitHub or send an email to contact@utiligize.com.

License

This package is made available under the MIT license:

Copyright (c) 2020 Utiligize ApS

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

// SPDX-License-Identifier: MIT

Copy Link

Version

Install

install.packages('CNAIM')

Monthly Downloads

260

Version

2.1.4

License

MIT + file LICENSE

Maintainer

Emil Larsen

Last Published

August 31st, 2022

Functions in CNAIM (2.1.4)

cof_transformer_11kv

Consequences of Failure for a 6.6/11 kV transformer
dga_test_modifier

DGA Test Modifier
beta_1

Initial Ageing Rate
current_health

Current Health score
duty_factor_transformer_11_20kv

Duty Factor for 6.6/11kV and 20kV Transformers
cof

Consequences of Failure
duty_factor_transformer_33_66kv

Duty Factor for 33/10kV and 66/10kV Transformers and Tapchanger
beta_2

Forecast Ageing Rate
duty_factor_cables

Duty Factor for all cables (incl. submarine cables).
cof_transformer_04_10kv

Consequences of Failure for a 0.4/10 kV transformer
environmental_cof_ehv_fittings

Environmental cost of Failure for EHV/132kV fittings
environmental_cof_lv_switchgear_and_other

Environmental cost of Failure for LV swicthgear and others
environmental_cof_hv_switchgear_primary

Environmental cost of Failure for HV switchgear primary
environmental_cof_cables_60_30kv

Environmental cost of Failure for 30-60 kV UG cables
environmental_cof_ehv_cables

Environmental cost of Failure for EHV UG cables & 132 kV UG cables
environmental_cof_cables_04_10kv

Environmental cost of Failure for 0.4kV and 10kV UG Cables
environmental_cof_hv_switchgear_distribution

Environmental cost of Failure for HV switchgear distribution
environmental_cof_ehv_switchgear

Environmental cost of Failure for EHV swicthgear & 132kV CB
e_cof_tf

Environmental Consequences of Failure for transformers
environmental_cof_board_04kv

Environmental cost of Failure for 0.4kV Board
environmental_cof_poles_ohl_support_50kv

Environmental cost of Failure for Poles OHL Support 50kV
environmental_cof_relay

Environmental cost of Failure for Relays
environmental_cof_serviceline

Environmental cost of Failure for Service Lines
environmental_cof_pillar_04kv

Environmental cost of Failure for 0.4kv Pillar
environmental_cof_switchgear_30_60kv

Environmental cost of Failure for 30kV and 60kV Switchgear
environmental_cof_switchgear_primary_10kv

Environmental cost of Failure for 10kV Switchgear Primary
environmental_cof_transformers

Environmental cost of Failure for Transformers
expected_life

Expected Life
environmental_cof_sub_cables

Environmental cost of Failure for sub cables
environmental_cof_tower_ohl_support_50kv

Environmental cost of Failure for Tower OHL Support 50 kV
f_cof_transformer_11kv

Financial Consequences of Failure for a 6.6/11 kV Transformer
environmental_cof_ohl_fittings_50kv

Environmental cost of Failure for 50kV Fittings
environmental_cof_transformer_30_60kv

Environmental cost of Failure for 30/10kV and 60/10kV Transformers
environmental_cof_lv_ugb

Environmental cost of Failure for LV UGB
environmental_cof_ohl_cond_50kv

Environmental cost of Failure for 50kV Overhead Line Conductors
environmental_cof_switchgear_secondary_10kv

Environmental cost of Failure for 10kV Switchgear Secondary
financial_cof_ehv_fittings

Financial cost of Failure for EHV/132kV fittings
environmental_cof_towers

Environmental cost of Failure for towers
financial_cof_ohl_fittings_50kv

Financial cost of Failure for 50kV Fittings
financial_cof_ehv_switchgear

Financial cost of Failure for EHV swicthgear & 132kV CB
environmental_cof_ohl_cond

Environmental cost of Failure for Overhead line conductors
financial_cof_relay

Financial cost of Failure for Relays
financial_cof_board_04kv

Financial cost of Failure for 0.4kV Board
financial_cof_cables_04_10kv

Financial cost of Failure for 0.4kV and 10kV UG Cables
financial_cof_serviceline

Financial cost of Failure for Service Lines
environmental_cof_poles

Environmental cost of Failure for Poles
ffa_test_modifier

Oil Test Modifier
financial_cof_poles_ohl_support_50kv

Financial cost of Failure for Poles OHL Support 50kV
financial_cof_poles

Financial cost of Failure for Poles
environmental_cof_submarine_30_60kv

Environmental cost of Failure for 30kV and 60kV Submarine Cables
financial_cof_switchgear_primary_10kv

Financial cost of Failure for 10kV Swicthgear Primary
financial_cof_switchgear_secondary_10kv

Financial cost of Failure for 10 kV Swicthgear Secondary
financial_cof_ehv_cables

Financial cost of Failure for EHV UG cables & 132 kV UG cables
environmental_cof_submarine_10kv

Environmental cost of Failure for 10kV Submarine Cables
financial_cof_ohl_cond

Financial cost of Failure for Overhead Line Conductors
financial_cof_pillar_04kv

Financial cost of Failure for 0.4kV Pillar
financial_cof_lv_switchgear_and_other

Financial cost of Failure for LV swicthgear and others
mmi

Maximum and Multiple Increment (MMI) Technique
financial_cof_sub_cables

Financial cost of Failure for Sub cables
financial_cof_cables_60_30kv

Financial cost of Failure for 30-60 kV UG cables
financial_cof_tower_ohl_support_50kv

Financial cost of Failure for Tower OHL Support 50 kV
financial_cof_ohl_cond_50kv

Financial cost of Failure for 50kV Overhead Line Conductors
financial_cof_hv_switchgear_primary

Financial cost of Failure for HV swicthgear primary
financial_cof_hv_switchgear_distribution

Financial cost of Failure for HV swicthgear distribution
financial_cof_submarine_cables_10kv

Financial cost of Failure for 10kV Submarine Cables
financial_cof_switchgear_30_60kv

Financial cost of Failure for 30kV and 60kV Switchgear
financial_cof_lv_ugb

Financial cost of Failure for LV UGB
location_factor

Location Factor (Excl.Submarine Cables)
network_cof_board_04kv

Network cost of Failure for 0.4kV Board
n_cof_excl_ehv_132kv_tf

Network cost of Failure for all Assets Categories excl. EHV and 132kV Transformers
network_cof_ehv_pole

Network cost of Failure for Poles
financial_cof_submarine_cables_30_60kv

Financial cost of Failure for 30kV and 60kV Submarine Cables
financial_cof_towers

Financial cost of Failure for Towers
network_cof_cables_04_10kv

Network cost of Failure for 0.4kV and 10kV UG Cables
location_factor_sub

Location Factor (Excl.Submarine Cables)
network_cof_ehv_fittings

Network cost of Failure for EHV/132kV Fittings
network_cof_ehv_sub_cable

Network cost of Failure for EHV /132 kV sub cables
network_cof_ohl_fittings_50kv

Network cost of Failure for 50kV Fittings
financial_cof_transformers

Financial cost of Failure for Transformers
network_cof_transformers

Network cost of Failure for Transformers
network_cof_pillar_04kv

Network cost of Failure for 0.4kV Pillar
network_cof_poles_ohl_support_50kv

Network cost of Failure for Poles OHL Support 50kV
network_cof_ehv_cables

Network cost of Failure for EHV UG cabkes & 132 kV UG cables
network_cof_cables_60_30kv

Network cost of Failure for 30-60 kV UG cables
financial_cof_transformer_30_60kv

Financial cost of Failure for 30/10 kV and 60/10 kV Transformers
network_cof_relay

Network cost of Failure for Relays
network_cof_transformer_30_60kv

Network cost of Failure for 30/10kV and 60/10kV Transformers
network_cof_hv_switchgear_distribution

Network cost of Failure for HV Switchgear distribution
health_score_excl_ehv_132kv_tf

Health Score Factor for all Assets Categories excl. EHV and 132kV Transformers
network_cof_lv_switchgear_and_other

Network cost of Failure for LV swicthgear and others
matrix_adjusted_circles

Adjust circles for matrix visualization
pof_cables_132kv

Current Probability of Failure for 132kV cables
network_cof_submarine_cables_10kv

Network cost of Failure for 10kV Submarine Cables
network_cof_submarine_cables_30_60kv

Network cost of Failure for 30kV and 60kV Submarine Cables
initial_health

Initial Health
network_cof_ehv_switchgear

Network cost of Failure for EHV swicthgear & 132kV CB
matrix_adjusted_intervals

Adjust banding for matrix visualization
network_cof_serviceline

Network cost of Failure for Service Lines
pof_cables_60_30kv

Current Probability of Failure for 30-60kV cables
network_cof_tower

Network cost of Failure for Towers
network_cof_hv_lv_poles

Network cost of Failure for LV,HV,EHV Poles
network_cof_lv_ugb

Network cost of Failure for LV UGB
network_cof_hv_sub_cables

Network cost of Failure for HV Sub cables
network_cof_ohl_cond_50kv

Network cost of Failure for 50kV Overhead Line Conductors
network_cof_hv_switchgear_primary

Network cost of Failure for HV Switchgear Primary
network_cof_ohl_cond

Network cost of Failure for Overhead Line Conductors
oil_test_modifier

Oil Test Modifier
plot_pof

Plot of probability of failure
pof_cables_10kv_pex

Current Probability of Failure for 10kV UG PEX Non Pressurised Cables
pof_cables_10kv_oil

Current Probability of Failure for 10kV UG Oil Non Preesurised Cables (Armed Paper Lead)
network_cof_switchgear_30_60kv

Network cost of Failure for 30kV and 60kV Switchgear
pof_future_building

Future Probability of Failure for Primary Substation Building and Secondary Substation Building.
pof_future_cables_04kv_pex

Future Probability of Failure for 0.4kV UG PEX Non Pressurised Cables
network_cof_switchgear_primary_10kv

Network cost of Failure for 10kV Switchgear Primary
pof_future_cables_10kv_pex

Future Probability of Failure for 10kV UG PEX Non Pressurised Cables
network_cof_tower_ohl_support_50kv

Network cost of Failure for Tower OHL Support 50 kV
pof_future_cables_10kv_oil

Future Probability of Failure for 10kV UG Oil Non Preesurised Cables (Armed Paper Lead)
pof_future_serviceline

Future Probability of Failure for Service Line
pof_board_04kv

Current Probability of Failure for 0.4kV Board
pof_132kv_cb

Current Probability of Failure for 132kV Switchgear
pof_future_meter

Future Probability of Failure for Meters
pof_building

Current Probability of Failure for Primary Substation Building and Secondary Substation Building.
pof_cables_04kv_pex

Current Probability of Failure for 0.4kV UG PEX Non Pressurised Cables
pof_future_cables_66_33kv

Future Probability of Failure for 33-66kV cables
pof_future_relay

Future Probability of Failure for Relay
pof_future_submarine_cables

Future Probability of Failure for Submarine Cables
pof_future_transformer_11_20kv

Future Probability of Failure for 6.6/11kV and 20kV Transformers
pof_future_rtu

Future Probability of Failure for RTU
pof_future_poles

Future Probability of Failure for Poles
pof_future_cables_60_30kv

Future Probability of Failure for 30-60kV cables
pof_cables_66_33kv

Current Probability of Failure for 33-66kV cables
pof_future_switchgear_30_60kv

Future Probability of Failure for 30kV and 60kV Switchgear
network_cof_switchgear_secondary_10kv

Network cost of Failure for 10kV Switchgear Secondary
pof_future_transformer_132kv

Future Probability of Failure for 132kV Transformers
pof_future_submarine_cables_10kv_oil

Future Probability of Failure for 10kV Oil Submarine Cables
pof_future_poles_ohl_support_50kv

Future Probability of Failure for Poles OHL support 50 kV
pof_ehv_fittings

Current Probability of Failure for EHV/132kV Fittings
pof_future_switchgear_primary_10kv

Future Probability of Failure for 10kV Switchgear Primary
pof_future_cables_132kv

Future Probability of Failure for 132kV cables
pof_future_submarine_cables_10kv_pex

Future Probability of Failure for 10kV Non Pressurised submarine cables
pof_future_board_04kv

Future Probability of Failure for 0.4kV Board
pof_future_ohl_cond_132_66_33kv

Future Probability of Failure for 33-132kV OHL Conductors
pof_poles

Current Probability of Failure for Poles
pof_submarine_cables

Current Probability of Failure for Submarine Cables
pof_future_pillar_04kv

Future Probability of Failure for 0.4kV Pillar
pof_lv_switchgear_and_other

Current Probability of Failure for LV switchgear and others
pof_future_switchgear_secondary_10kv

Future Probability of Failure for 10kV Switchgear Secondary
pof_future_submarine_cables_30_60kv_oil

Future Probability of Failure for 30kV and 60kV Oil Submarine Cables
pof_future_transformer_30_60kv

Future Probability of Failure for 30/10kV and 60/10kV Transformers
pof_future_transformer_33_66kv

Future Probability of Failure for 33/10kV and 66/10kV Transformers
pof_meter

Current Probability of Failure for Meters
pof_future_ohl_fittings_50kv

Future Probability of Failure for 50 kV Fittings
pof_transformer_132kv

Current Probability of Failure for 132kv Transformers
pof_future_transformer_04_10kv

Future Probability of Failure for 0.4/10kV Transformers
pof_ehv_switchgear

Current Probability of Failure for EHV Switchgear
pof_future_ohl_cond_50kv

Future Probability of Failure for 50kV OHL Conductors
pof_future_submarine_cables_30_60kv_pex

Future Probability of Failure for 30kV and 60kV Non Pressurised Submarine Cables
pof_hv_switchgear_distribution

Current Probability of Failure for HV Switchgear Distribution
pof_ohl_cond_132_66_33kv

Current Probability of Failure for 33-132kV OHL Conductors
pof_lv_ugb

Current Probability of Failure for LV UGB
pof_transformer_04_10kv

Current Probability of Failure for 0.4/10kV Transformers
pof_tower_ohl_support_50kv

Current Probability of Failure for Towers OHL support 50kV
pof_switchgear_primary_10kv

Current Probability of Failure for 10 kV Switchgear (GM) Primary
safety_cof_cables_60_30kv

Safety cost of Failure for 30-60 kV UG cables
predict_weibull_model

Prediction function for Weibull model
pof_transformer_33_66kv

Current Probability of Failure for 33/10kV and 66/10kV Transformers
pof_switchgear_secondary_10kV

Current Probability of Failure for 10kV Switchgear secondary
safety_cof_board_04kv

Safety cost of Failure for 0.4kV Board
pof_transformer_11_20kv

Current Probability of Failure for 6.6/11kV and 20kV Transformers
safety_cof_ehv_cables

Safety cost of Failure for EHV UG cables & 132 kV UG cables
safety_cof_hv_switchgear_distribution

Safety cost of Failure for HV Switchgear Distribution
safety_cof_hv_switchgear_primary

Safety cost of Failure for HV Switchgear Primary
risk_matrix_points_plot

Make a risk matrix with individual asset points
safety_cof_ohl_fittings_50kv

Safety cost of Failure for 50kV Fittings
pof_towers

Current Probability of Failure for Towers
safety_cof_cables_04_10kv

Safety cost of Failure for 0.4kV and 10kV UG Cables
risk_matrix_structure

Makes a default risk matrix structure
pof_transformer_30_60kv

Current Probability of Failure for 30/10kV and 60/10kV Transformers
risk_calculation

Calculates risk and converts to matrix coordinates
safety_cof_ohl_cond

Safety cost of Failure for Overhead Line Conductors
safety_cof_ohl_cond_50kv

Safety cost of Failure for 50kV Overhead Line Conductors
present_value_future_risk

Present Value of Future Risk
risk_matrix_summary_plot

Make a risk matrix with non-linear spacing
pof_hv_switchgear_primary

Current Probability of Failure for HV Switchgear Primary
safety_cof_submarine_cables_30_60kv

Safety cost of Failure for 30kV and 60kV Submarine Cables
safety_cof_ehv_fittings

Safety cost of Failure for EHV/132kV Fittings
s_cof_swg_tf_ohl

Safety Consequences of Failure for Switchgears, Transformers & Overhead Lines
safety_cof_ehv_switchgear

Safety cost of Failure for EHV swicthgear & 132kV CB
safety_cof_lv_switchgear_and_other

Safety cost of Failure for LV swicthgear and others
safety_cof_serviceline

Safety cost of Failure for Service Lines
safety_cof_pillar_04kv

Safety cost of Failure for 0.4kV Pillar
safety_cof_lv_ugb

Safety cost of Failure for LV UGB
safety_cof_switchgear_30_60kv

Safety cost of Failure for 30kV and 60kV Switchgear
safety_cof_sub_cables

Safety cost of Failure for Sub cables
safety_cof_relay

Safety cost of Failure for Relays
safety_cof_poles

Safety cost of Failure for Pole
safety_cof_transformers

Safety cost of Failure for Transformer
safety_cof_submarine_cables_10kv

Safety cost of Failure for 10kV Submarine Cables
safety_cof_transformer_30_60kv

Safety cost of Failure for 30/10kv and 60/10kv Transformer
safety_cof_towers

Safety cost of Failure for tower
safety_cof_tower_ohl_support_50kv

Safety cost of Failure for Tower OHL Support 50 kV
safety_cof_poles_ohl_support_50kv

Safety cost of Failure for Poles OHL Support 50kV
safety_cof_switchgear_primary_10kv

Safety cost of Failure for 10kV Switchgear Primary
safety_cof_switchgear_secondary_10kv

Safety cost of Failure for 10 kV Switchgear Secondary
transformer_11kv_faults

Failure statistics dataset for 10,000 6.6/11kV transformers
train_weibull_model

Training function for Weibull model