📋 Tabla de Contenidos

🎯 Conceptos Básicos

¿Qué es una serie?

Una serie es un conjunto de datos ordenados en el tiempo. Por ejemplo:

Códigos de serie

Cada serie tiene un código único. Ejemplos:

PN01660XM = PBI total
PN01273PM = Tipo de cambio
PN01654XM = PBI minero
PN01279PM = Reservas internacionales

Períodos

Puedes elegir el rango de fechas con el formato AÑO-MES/AÑO-MES:

2010-1/2023-12  # De enero 2010 a diciembre 2023
2015/2020       # De 2015 a 2020 (datos anuales)
2020-1/2020-12  # Todo el año 2020

🚀 Primeros Pasos

📌 Ejemplo 1: Tu primer gráfico

from easyviz import generate_figure

# Crear figura con una sola serie
fig = generate_figure(
    Serie1='PN01660XM',           # PBI total
    Serie2='',                     # Sin segunda serie
    Serie3='',                     # Sin tercera serie
    Serie4='',                     # Sin cuarta serie
    Fechas='2015-1/2023-12',       # Últimos 8 años
    color_fondo='#f0f0f0',         # Gris claro
    color_area='white',            # Área blanca
    color_linea1='tomato',         # Línea roja
    Tipo1='linea'                  # Gráfico de línea
)

# Mostrar el gráfico
plt.show()

📌 Ejemplo 2: Comparando dos series

fig = generate_figure(
    Serie1='PN01660XM',           # PBI
    Serie2='PN01654XM',           # PBI minero
    Fechas='2015-1/2023-12',
    color_linea1='tomato',
    color_linea2='royalblue',
    Tipo1='linea',
    Tipo2='linea'
)

⚙️ Configuración de Series

Parámetros por Serie

Parámetro Qué hace Ejemplo
Serie1 Código de la serie 'PN01660XM'
Tipo1 Línea o barra 'linea' o 'barra'
color_linea1 Color de la serie 'tomato', '#FF5733'
Eje_secundario2 Usar eje derecho 'Si' o 'No'
Cambiar_Nombre1 Título personalizado 'Mi PBI'

Colores disponibles

'tomato' - Rojo
'royalblue' - Azul
'gold' - Dorado
'limegreen' - Verde
'orchid' - Morado
'#FF5733' - Naranja
'#33FF57' - Verde claro
'#3357FF' - Azul intenso

🎨 Personalización Visual

Estilos de Fondo

color_fondo = 'lavender'     # Fondo lila suave
color_area = 'white'         # Área del gráfico blanca

# O con códigos HEX
color_fondo = '#E6E6FA'      # Lavender
color_area = '#FFFFFF'       # Blanco

Características adicionales

Parámetro Opciones Descripción
Marcar_recesiones 'Si' / 'No' Muestra crisis económicas sombreadas
Linea_cero 'Si' / 'No' Línea horizontal en cero
mostrar_creditos 'Si' / 'No' Muestra "ode.pe" en el gráfico
Mostrar_titulo 'Si' / 'No' Muestra u oculta la leyenda

🔢 Operaciones con Datos

Puedes transformar las series sobre la marcha:

Modificar_Serie1 = 'Si'      # Activar modificación
Operacion1 = '*'              # Operación: +, -, *, /
Valor1 = 100                  # Valor a aplicar

Ejemplos útiles:

📊 Convertir a porcentajes

Operacion1 = '*'
Valor1 = 100

📈 Cambiar base (índice 100)

Operacion1 = '/'
Valor1 = 245.6
Operacion2 = '*'
Valor2 = 100

🔄 Invertir serie

Operacion1 = '*'
Valor1 = -1

💡 Ejemplos Prácticos

📌 Ejemplo 3: PBI vs Tipo de cambio (ejes diferentes)

fig = generate_figure(
    Serie1='PN01660XM',        # PBI (eje izquierdo)
    Serie2='PN01273PM',        # Tipo de cambio (eje derecho)
    Fechas='2010-1/2023-12',
    color_linea1='royalblue',
    color_linea2='tomato',
    Eje_secundario2='Si',      # Serie2 en eje derecho
    Tipo1='linea',
    Tipo2='linea',
    Marcar_recesiones='Si'
)

📌 Ejemplo 4: Combinando líneas y barras

fig = generate_figure(
    Serie1='PN01660XM',        # PBI (línea)
    Serie2='PN01654XM',        # PBI minero (barras)
    Fechas='2018-1/2023-12',
    color_linea1='royalblue',
    color_linea2='gold',
    Tipo1='linea',
    Tipo2='barra',              # Segunda serie como barras
    color_fondo='#fafafa'
)

📌 Ejemplo 5: Cuatro series con nombres personalizados

fig = generate_figure(
    Serie1='PN01660XM',
    Serie2='PN01654XM',
    Serie3='PN01273PM',
    Serie4='PN01279PM',
    Fechas='2019-1/2023-12',
    color_linea1='tomato',
    color_linea2='royalblue',
    color_linea3='gold',
    color_linea4='limegreen',
    Tipo1='linea',
    Tipo2='linea',
    Tipo3='linea',
    Tipo4='barra',
    Cambiar_Nombre1='PBI Total',
    Cambiar_Nombre2='PBI Minero',
    Cambiar_Nombre3='Tipo de Cambio',
    Cambiar_Nombre4='Reservas Internacionales'
)

❓ Solución de Problemas

⚠️ Error: "Introduzca una Serie1 válida"

El código de serie no existe. Verifica en el catálogo de series.

⚠️ Error: "Series iguales detectadas"

Estás usando el mismo código más de una vez.

⚠️ Error: "Elija series con las mismas frecuencias"

No puedes mezclar datos mensuales con trimestrales.

📌 El gráfico no se ve bien

Ajusta el rango de fechas. Muy pocos o muchos datos pueden afectar la visualización.

📌 Las barras se ven muy delgadas

Usa menos años o cambia el tipo de gráfico a línea.

📌 Las etiquetas se superponen

Elige un rango de fechas más corto o usa menos datos.

📝 Tips y Trucos

🎯 Para principiantes:

  • Empieza con 1-2 series
  • Usa colores contrastantes
  • Prueba primero con datos mensuales
  • Siempre verifica los códigos en el catálogo

🚀 Para usuarios avanzados:

  • Combina escalas (eje izquierdo/derecho)
  • Usa operaciones para normalizar datos
  • Personaliza nombres para mejor legibilidad
  • Marca recesiones para contexto histórico

💡 Buenas prácticas:

  • 📌 Usa títulos descriptivos
  • 🎯 Elige colores con significado (rojo = negativo, verde = positivo)
  • 📏 Mantén consistencia en unidades
  • 🔍 Verifica las fuentes de datos

Ayuda Rápida

¿Qué necesitas? Código
Guardar gráfico fig.savefig('mi_grafico.png', dpi=300, bbox_inches='tight')
Exportar datos df = generate_data('PN01660XM', '', '', '', '2015-1/2023-12')
df.to_excel('datos.xlsx')

📚 Glosario

Término Significado
API Interfaz que conecta con los datos del BCRP
Eje secundario Escala adicional en el lado derecho del gráfico
Frecuencia Periodicidad de los datos (diaria, mensual, trimestral, anual)
n.d. "No disponible" - dato faltante en la serie
Recesión Período de contracción económica

© 2024 ODE - Herramienta de visualización de series económicas

Manual versión 1.0 - Actualizado para la API del BCRP

¿Necesitas ayuda? Consulta la documentación técnica o contacta al equipo de soporte