CE MATRIX

1. Instruccions
1.1. Incorporació de files (un únic tipus)
Codi d’exemple per afegir un grup de files :
ce_matrix.add_single_input(
flag='SMOKE DETECTORS',
df=df_rooms,
cols=['LOCATION'],
input_type='SMOKE DETECTOR',
equipment_prefix='SD_',
col_equipment='LOCATION',
filter={'col': 'DETECTOR', 'value_equal': 'Yes'}

Explicació:

El mètode add_single_input serveix per afegir un grup de files i accepta els arguments següents
(no és necessari que hi siguin tots):

• flag: Només és una descripció de l’input. No té efectes sobre la matriu final. Tot i així,
pot servir per depurar errors i trobar d’on ve una determinada creu.
• df: La taula on es troben les dades. Prové del Master Schedule. En aquest cas, df_rooms
conté les dades del full “1_ROOMS”.
• cols: Una llista de les columnes a llegir. Format: [‘columna 1’, ‘columna 2’]
• input_type: Una indicació del tipus d’input. Servirà per aplicar-hi regles més tard.
• col_equipment: Columna que conté el nom dels inputs.
• equipment_prefix: Prefix pel nom dels inputs, si cal.
• equipment_suffix: Sufix pel nom dels inputs, si cal.
• filter: Filtre dels inputs segons el valor d’alguna columna. Format: {‘col’: ‘columna’,
‘value_equal: ‘valor’}. També funciona amb value_not_equal.
• cols_to_rename: Columnes a canviar de nom. Útil per LOCATION_2 i altres casos
particulars. Format: {‘columna excel’: ‘columna nou nom’}.

Resum:

El codi de l’exemple incorpora la columna ‘LOCATION’ del full ‘1_ROOMS’ del Master Schedule,
només si la columna ‘DETECTOR’ és ‘Yes’, i afegint el prefix ‘SD_’. El resultat és la creació d’una
fila de nom ‘SD_ROOM’ per cada ROOM que tingui detector.

1.2. Incorporació de files (més d’un tipus alhora a partir de cada fila del MS)
Codi d’exemple:
ce_matrix.add_multiple_inputs(
flag='FM200',
df=df_rooms,
cols=['LOCATION'],
input_types=['CA STAGE 1', 'CA STAGE 2', 'CA PANEL FAULT', 'CA LOW PRESSURE',
 'CA GAS DISCHARGE', 'CA GAS PURGING PUSH BUTTON'],
equipment_prefix='CA_',
equipment_suffixes=['_STAGE 1', '_STAGE 2', '_PANEL FAULT', '_LOW PRESSURE',
'_GAS DISCHARGE', '_GAS PURGING PUSH BUTTON'],
col_equipment='LOCATION', filter={'col': 'FM200', 'value_equal': 'Yes'}
)

Explicació:

El mètode add_multiple_inputs funciona com l’anterior, però afegint més d’un tipus per cada
fila del Master Schedule (l’argument input_types és una llista de més d’un tipus). Alguns
arguments van en plural.

Resum:

El codi de l’exemple incorpora 6 tipus d’input (6 files) per cada equip d’FM200, creat a partir de
les sales del full ‘1_ROOMS’ del Master Schedule, quan la columna ‘FM200’ és ‘Yes’. Les
etiquetes són de l’estil ‘CA_ROOM_STAGE1’.

1.3. Incorporació de columnes + criteris

Codi d’exemple per afegir un grup de columnes:
ce_matrix.add_output(
flag='FAN STOP',
df=df_fans,
col_equipment='CE2_MEP_EQUIPMENT NAME',
match_on='LOCATION',
input_types=['SMOKE DETECTOR'],
equipment_suffix=' STOP',
filter={'col': 'STOP', 'value_equal': 1},
)

Explicació:

El mètode add_output serveix per afegir un grup de columnes i criteris i accepta els arguments
següents (no és necessari que hi siguin tots):

• flag: Només és una descripció de l’output. No té efectes sobre la matriu final. Tot i així,
pot servir per depurar errors i trobar d’on ve una determinada creu.
• df: La taula on es troben les dades. Prové del Master Schedule. En aquest cas, df_fans
conté les des del full “3_FANS”.
• col_equipment: Columna que conté el nom dels outputs.
• equipment_prefix: Prefix pel nom dels outputs, si cal.
• equipment_suffix: Sufix pel nom dels outputs, si cal.
• match_on: Camp a creuar amb els inputs. Només s’afegeixen creus en aquelles caselles
on la fila i la columna coincideixen en el camp ‘match_on’. Format: {‘input’: ‘camp_files’,
‘output: ‘camp_columnes’}. Si les dues són iguals, es pot passar una cadena de text, com
‘LOCATION’ a l’exemple.
• input_types: Tipus dels inputs als quals s’ha de marcar la X per aquest output.
• filter: Filtre dels outputs segons el valor d’una altra columna. Format: {‘col’: ‘columna’,
‘value_equal: ‘valor’}. També funciona amb value_not_equal.
 • filter_input: Filtre pels inputs a combinar amb aquest output.
• equipment_startswith: Filtre pel començament del nom dels equips.

Resum:

El codi de l’exemple incorpora l’output ‘FAN STOP’. Els equips provenen de la columna
‘CE2_MEP_EQUIPMENT NAME’ del full ‘3_FANS’ del Master Schedule, quan la columna ‘STOP’
sigui igual a 1, afegint el sufix ‘ STOP’ pel nom de la columna que sortirà a la CE Matrix.

Per cada columna afegida segons l’anterior, es marcaran files segons si el tipus és ‘SMOKE
DETECTOR’ i la ‘LOCATION’ és la mateixa que el fan.