meridian.data.time_coordinates.TimeCoordinates

Es un wrapper alrededor de las coordenadas de tiempo de los datos de entrada de Meridian.

meridian.data.time_coordinates.TimeCoordinates(
    datetime_index: pd.DatetimeIndex
)

En los modelos de Meridian, las coordenadas de tiempo se almacenan como cadenas sin tipo, funcionan como etiquetas y no tienen un significado intrínseco más allá de la suposición de que representan ciertas coordenadas de tiempo que aumentan de manera lineal.

Este objeto wrapper aplica algunos métodos y validaciones adicionales para extraer valores de estas coordenadas temporales que se tratan como valores numéricos de "fecha".

Atributos
datetime_index	Son las coordenadas de tiempo proporcionadas, analizadas en el formato indexable DatetimeIndex.
all_dates	Son las coordenadas de tiempo proporcionadas, presentadas como una lista de objetos datetime.date de Python.
all_dates_str	Son las coordenadas de tiempo proporcionadas, presentadas como una lista de cadenas de fecha en el formato de Meridian. Esta opción se puede usar en los procesos internos del modelo, que consideran las coordenadas de tiempo como etiquetas simples.
interval_days	Devuelve el intervalo entre dos fechas adyacentes de all_dates.

Métodos

expand_selected_time_dims

Ver código fuente

expand_selected_time_dims(
    start_date: (Date | None) = None, end_date: (Date | None) = None
) -> (list[datetime.date] | None)

Valida y devuelve los valores de la dimensión de tiempo según los horarios seleccionados.

Si se especifica None para start_date y end_date, se devuelve None. Si se especifica, start_date y end_date son inclusivos, y deben estar presentes en las coordenadas temporales de los datos de entrada.

Args
start_date	Fecha de inicio del período seleccionado. Si se establece en None, sugiere el valor de dimensión del período más antiguo incluido en los datos de entrada.
end_date	Fecha de finalización del período seleccionado. Si se establece en None, sugiere el valor de dimensión del período más reciente incluido en los datos de entrada.

Returns
Se devuelve una lista de los valores de la dimensión de tiempo (como objetos datetime.date) indicados en los datos de entrada para el período seleccionado, o no se hace nada y se pasa None si ambos argumentos son None o si start_date y end_date corresponden a todo el período de los datos de entrada.

Raises
ValueError se muestra si start_date o end_date no se incluyen en las coordenadas de la dimensión de tiempo de los datos de entrada.

from_dates

Ver código fuente

@classmethod
from_dates(
    dates: _TimeCoordinateValues
) -> 'TimeCoordinates'

Crea TimeCoordinates a partir de una serie polimórfica de fechas.

Args
dates	Es una serie polimórfica de fechas. Puede ser un índice DatetimeIndex de Pandas o un array DataArray de Xarray con etiquetas de cadena en el formato "AAAA-mm-dd".

Returns
Devuelve una clase de datos TimeCoordinates normalizada.

get_selected_dates

Ver código fuente

get_selected_dates(
    selected_interval: (meridian.data.time_coordinates.DateInterval | None) = None
) -> list[datetime.date]

Crea una secuencia de fechas que contiene todos los puntos del intervalo seleccionado.

Args
selected_interval	Es una tupla de las horas de inicio y finalización, o bien un prototipo de DateInterval. Si es None, se devuelve all_dates.

Returns
Se devuelve una secuencia de fechas que representa el subconjunto de all_dates entre las fechas de inicio y finalización proporcionadas, como los objetos datetime.date integrados de Python.

Raises
ValueError	Se muestra este error si selected_interval no es un subconjunto de all_dates.

__eq__

__eq__(
    other
)

Devuelve self==value.