Metadata-Version: 2.2
Name: coreforecast
Version: 0.0.17
Summary: Fast implementations of common forecasting routines
Keywords: forecasting,time-series
Author-Email: Jose Morales <jmoralz92@gmail.com>
License: Apache-2.0
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Project-URL: homepage, https://nixtla.github.io/coreforecast
Project-URL: documentation, https://nixtlaverse.nixtla.io/coreforecast
Project-URL: repository, https://github.com/Nixtla/coreforecast
Requires-Python: >=3.10
Requires-Dist: numpy>=1.20.0
Description-Content-Type: text/markdown

## Motivation
At Nixtla we have implemented several libraries to deal with time series data. We often have to apply some transformation over all of the series, which can prove time consuming even for simple operations like performing some kind of scaling.

We've used [numba](https://numba.pydata.org/) to speed up our expensive computations, however that comes with other issues such as cold starts and more dependencies (LLVM). That's why we developed this library, which implements several operators in C++ to transform time series data (or other kind of data that can be thought of as independent groups), with the possibility to use multithreading to get the best performance possible.

You probably won't need to use this library directly but rather use one of our higher level libraries like [mlforecast](https://nixtlaverse.nixtla.io/mlforecast/docs/how-to-guides/lag_transforms_guide.html#built-in-transformations-experimental), which will use this library under the hood. If you're interested on using this library directly (only depends on numpy) you should continue reading.

## Installation

### PyPI
```python
pip install coreforecast
```

### conda-forge
```python
conda install -c conda-forge coreforecast
```

## Minimal example
The base data structure is the "grouped array" which holds two numpy 1d arrays:

* **data**: values of the series.
* **indptr**: series boundaries such that `data[indptr[i] : indptr[i + 1]]` returns the `i-th` series. For example, if you have two series of sizes 5 and 10 the indptr would be [0, 5, 15].

```python
import numpy as np
from coreforecast.grouped_array import GroupedArray

data = np.arange(10)
indptr = np.array([0, 3, 10])
ga = GroupedArray(data, indptr)
```

Once you have this structure you can run any of the provided transformations, for example:

```python
from coreforecast.lag_transforms import ExpandingMean
from coreforecast.scalers import LocalStandardScaler

exp_mean = ExpandingMean(lag=1).transform(ga)
scaler = LocalStandardScaler().fit(ga)
standardized = scaler.transform(ga)
```

## Single-array functions
We've also implemented some functions that work on single arrays, you can refer to the following pages:

* [differences](https://nixtlaverse.nixtla.io/coreforecast/differences)
* [scalers](https://nixtlaverse.nixtla.io/coreforecast/scalers)
* [seasonal](https://nixtlaverse.nixtla.io/coreforecast/seasonal)
* [rolling](https://nixtlaverse.nixtla.io/coreforecast/rolling)
* [expanding](https://nixtlaverse.nixtla.io/coreforecast/expanding)
* [exponentially weighted](https://nixtlaverse.nixtla.io/coreforecast/exponentially_weighted)
