elecu package

Submodules

elecu.create_std_dicts module

elecu.extract_values module

elecu.extract_values.extract_eleccion(df_resultados, dignidad_codigo=None, territorio_codigo=None, agrupar_por_territorio=None, sexo=None, vuelta=None)

Extrae los valores de la elección de acuerdo a los parámetros de entrada

Parámetros:

• df_resultados (DataFrame) – DataFrame con los resultados de la elección

• dignidad_codigo (int) – Código de la dignidad a filtrar

• territorio_codigo (str) – Código del territorio a filtrar (provincia, cantón, parroquia)

• agrupar_por_territorio (str) – Agrupar los resultados por territorio (PAIS, PROVINCIA, CANTON, CIRCUNSCRIPCION, PARROQUIA)

• sexo (str) – Sexo a filtrar (S0, S1, AMBOS, AGRUPAR)

• vuelta (int) – Vuelta a filtrar(1, 2,None)

Devuelve:

DataFrame con los resultados de la elección filtrados

Tipo del valor devuelto:

DataFrame

Ejemplos

>>> df_resultados = pd.read_csv("test_2023_eleccion.csv")
>>> df_resultados_filtered = extract_eleccion(df_resultados, dignidad_codigo=1, territorio_codigo="P01",agrupar_por_territorio="PROVINCIA", sexo="AMBOS", vuelta=None)
>>> print(df_resultados_filtered)
>>>  PROVINCIA_CODIGO  OP_CODIGO        CANDIDATO_NOMBRE SEXO  VUELTA   VOTOS
>>>               P01       18.0  FERNANDO VILLAVICENCIO   S0       1   36890
>>>               P01       18.0  FERNANDO VILLAVICENCIO   S1       1   44222
>>>               ...       ...                      ...  ...     ...     ...

elecu.restructure_results module

class elecu.restructure_results.Standarized_Results(input_folder, standarized_folder=None)

Bases: object

Clase para reestructurar los resultados de las elecciones en Ecuador.

change_registro()

Cambia el registro de los archivos de resultados.

Parámetros:

df_registro (-) – DataFrame con el registro de los archivos de resultados.

Devuelve:

- df_registro – DataFrame con el registro de los archivos de resultados.

Tipo del valor devuelto:

pd.DataFrame

change_resultados()

Cambia los resultados de los archivos de resultados.

Devuelve:

- df_resultados – DataFrame con los resultados de los archivos de resultados estandarizados

Tipo del valor devuelto:

pd.DataFrame

create_dict_mapping(df)

Crea un diccionario de mapeo a partir de un DataFrame.

Parámetros:

df (-) – DataFrame con varias columnas. La primera columna es el estandar y las demás columnas son equivalentes.

Devuelve:

- mapping_dict – Diccionario con el mapeo de las columnas del DataFrame.

Tipo del valor devuelto:

dict

divide_resultados()

Divide los resultados en dos DataFrames: uno con los resultados de la votación y otro con la elección de candidatos.

Devuelve:

• - df_votacion (pd.DataFrame) – DataFrame con los resultados de la votación.

• - df_eleccion (pd.DataFrame) – DataFrame con la elección de candidatos.

load_std_data(file)

Carga los diccionarios estandarizados de las elecciones

Parámetros:

file (-) – path al archivo csv que contiene el archivo que esta en la carpeta «data_csv/Codigos_estandar»

Devuelve:

DataFrame con los códigos estandarizados para el procesamiento posterior

Tipo del valor devuelto:

• DataFrame

Ejemplos

load_std_data(«data_csv/Codigos_estandar/dignidades/dignidades_std_post_2007.csv»)

put_standar_geo_codes_registro(drop_old=False)

Pone los códigos geográficos estandarizados en el DataFrame de registro :param drop_old: Si es True, se eliminan las columnas que terminan con «_OLD» :type drop_old: bool

Devuelve:

- df_registro – DataFrame con los códigos geográficos estandarizados

Tipo del valor devuelto:

pd.DataFrame

put_standar_geo_codes_results(drop_old=False)

Pone los códigos geográficos estandarizados en el DataFrame de resultados

Parámetros:

drop_old (bool) – Si es True, se eliminan las columnas que terminan con «_OLD»

Devuelve:

- df_resultados – DataFrame con los códigos geográficos estandarizados

Tipo del valor devuelto:

pd.DataFrame

recuperar_registro()

Recupera el registro de los archivos de resultados.

Devuelve:

- df_registro – DataFrame con el registro de los archivos de resultados.

Tipo del valor devuelto:

pd.DataFrame

recuperar_resultados()

Recupera los resultados de los archivos de resultados.

Devuelve:

- df_resultados – DataFrame con los resultados de los archivos de resultados raw

Tipo del valor devuelto:

pd.DataFrame

elecu.transform_to_csv module

elecu.transform_to_csv.convert_sav_to_csv(input_folder, output_folder)

Convierte todos los archivos .sav en el directorio de entrada a archivos .csv en el directorio de salida.

Paramaters

• input_folder: str

  path al directorio de entrada que contiene los archivos .sav

• output_folder: str

  path al directorio de salida donde se guardarán los archivos .csv

rtype:

none

Ejemplos

convert_sav_to_csv(«data», «data_csv»)

elecu.transform_to_csv.get_data(link, download_folder)

Función que obtiene los datos de un archivo comprimido en la web y los guarda en un directorio local. (Trabajo en progreso)

Parámetros:

• link (-) – URL del archivo comprimido

• download_folder (-) – Directorio donde se guardarán los archivos descargados

Tipo del valor devuelto:

None

elecu.visualize_results module

Module contents