%global _empty_manifest_terminate_build 0 Name: python-neuralprophet Version: 0.5.4 Release: 1 Summary: Explainable Forecasting at Scale License: MIT URL: https://github.com/ourownstory/neural_prophet Source0: https://mirrors.nju.edu.cn/pypi/web/packages/68/60/d43efb8b68c95dbd6d2bab96eda6e3a6aa28db4a979fad3fe334a8adfd41/neuralprophet-0.5.4.tar.gz BuildArch: noarch Requires: python3-captum Requires: python3-convertdate Requires: python3-holidays Requires: python3-ipywidgets Requires: python3-LunarCalendar Requires: python3-matplotlib Requires: python3-numpy Requires: python3-pandas Requires: python3-plotly Requires: python3-dash Requires: python3-plotly-resampler Requires: python3-dateutil Requires: python3-pytorch-lightning Requires: python3-tensorboard Requires: python3-torch Requires: python3-torchmetrics Requires: python3-widgetsnbextension Requires: python3-dataclasses Requires: python3-typing-extensions Requires: python3-black[jupyter] Requires: python3-flake8 Requires: python3-isort Requires: python3-livelossplot Requires: python3-pyright Requires: python3-pytest-cov Requires: python3-pytest Requires: python3-twine Requires: python3-wheel Requires: python3-kaleido Requires: python3-sphinx Requires: python3-sphinx-fontawesome Requires: python3-myst-parser Requires: python3-nbsphinx Requires: python3-nbsphinx-link Requires: python3-furo Requires: python3-prophet Requires: python3-livelossplot %description [![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/ourownstory/neural_prophet?logo=github)](https://github.com/ourownstory/neural_prophet/releases) [![Pypi_Version](https://img.shields.io/pypi/v/neuralprophet.svg)](https://pypi.python.org/pypi/neuralprophet) [![Python Version](https://img.shields.io/badge/python-3.7+-blue?logo=python)](https://www.python.org/) [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) [![License](https://img.shields.io/badge/license-MIT-brightgreen)](https://opensource.org/licenses/MIT) [![Tests](https://github.com/ourownstory/neural_prophet/actions/workflows/ci.yml/badge.svg)](https://github.com/ourownstory/neural_prophet/actions/workflows/ci.yml) [![codecov](https://codecov.io/gh/ourownstory/neural_prophet/branch/master/graph/badge.svg?token=U5KXCL55DW)](https://codecov.io/gh/ourownstory/neural_prophet) [![Slack](https://img.shields.io/badge/slack-@neuralprophet-CF0E5B.svg?logo=slack&logoColor=white&labelColor=3F0E40)](https://neuralprophet.slack.com/join/shared_invite/zt-sgme2rw3-3dCH3YJ_wgg01IXHoYaeCg#/shared-invite/email) [![Downloads](https://static.pepy.tech/personalized-badge/neuralprophet?period=total&units=international_system&left_color=black&right_color=blue&left_text=Downloads)](https://pepy.tech/project/neuralprophet) ![NP-logo-wide_cut](https://user-images.githubusercontent.com/21246060/111388960-6c367e80-866d-11eb-91c1-46f2c0d21879.PNG) Please note that the project is still in beta phase. Please report any issues you encounter or suggestions you have. We will do our best to address them quickly. Contributions are very welcome! # NeuralProphet: human-centered forecasting NeuralProphet is an easy to learn framework for interpretable time series forecasting. NeuralProphet is built on PyTorch and combines Neural Network and traditional time-series algorithms, inspired by [Facebook Prophet](https://github.com/facebook/prophet) and [AR-Net](https://github.com/ourownstory/AR-Net). - With few lines of code, you can define, customize, visualize, and evaluate your own forecasting models. - It is designed for iterative human-in-the-loop model building. That means that you can build a first model quickly, interpret the results, improve, repeat. Due to the focus on interpretability and customization-ability, NeuralProphet may not be the most accurate model out-of-the-box; so, don't hesitate to adjust and iterate until you like your results. - NeuralProphet is best suited for time series data that is of higher-frequency (sub-daily) and longer duration (at least two full periods/years). ## Documentation The [documentation page](https://neuralprophet.com) may not be entirely up to date. Docstrings should be reliable, please refer to those when in doubt. We are working on an improved documentation. We appreciate any help to improve and update the docs. For a visual introduction to NeuralProphet, [view this presentation](notes/NeuralProphet_Introduction.pdf). ## Contribute We compiled a [Contributing to NeuralProphet](CONTRIBUTING.md) page with practical instructions and further resources to help you become part of the family. ## Community #### Discussion and Help If you have any question or suggestion, you can participate with [our community right here on Github](https://github.com/ourownstory/neural_prophet/discussions) #### Slack Chat We also have an active [Slack community](https://join.slack.com/t/neuralprophet/shared_invite/zt-sgme2rw3-3dCH3YJ_wgg01IXHoYaeCg). Come and join the conversation! ## Tutorials [![Open All Collab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/ourownstory/neural_prophet) There are several [example notebooks](tutorials/) to help you get started. You can find the datasets used in the tutorials, including data preprocessing examples, in our [neuralprophet-data repository](https://github.com/ourownstory/neuralprophet-data). Please refer to our [documentation page](https://neuralprophet.com) for more resources. ### Minimal example ```python from neuralprophet import NeuralProphet ``` After importing the package, you can use NeuralProphet in your code: ```python m = NeuralProphet() metrics = m.fit(df) forecast = m.predict(df) ``` You can visualize your results with the inbuilt plotting functions: ```python fig_forecast = m.plot(forecast) fig_components = m.plot_components(forecast) fig_model = m.plot_parameters() ``` If you want to forecast into the unknown future, extend the dataframe before predicting: ```python m = NeuralProphet().fit(df, freq="D") df_future = m.make_future_dataframe(df, periods=30) forecast = m.predict(df_future) fig_forecast = m.plot(forecast) ``` ## Install You can now install neuralprophet directly with pip: ```shell pip install neuralprophet ``` ### Install options If you plan to use the package in a Jupyter notebook, we recommended to install the 'live' version: ```shell pip install neuralprophet[live] ``` This will allow you to enable `plot_live_loss` in the `fit` function to get a live plot of train (and validation) loss. If you would like the most up to date version, you can instead install direclty from github: ```shell git clone cd neural_prophet pip install . ``` ## Features ### Model components * Autoregression: Autocorrelation modelling - linear or NN (AR-Net) * Trend: Piecewise linear trend with optional automatic changepoint detection * Seasonality: Fourier terms at different periods such as yearly, daily, weekly, hourly. * Lagged regressors: Lagged observations (e.g temperature sensor) - linear or NN * Future regressors: In advance known features (e.g. temperature forecast) - linear * Events: Country holidays & recurring custom events ### Framework features * Multiple time series: Fit a global/glocal model with (partially) shared model parameters * Uncertainty: Estimate values of specific quantiles - Quantile Regression * Regularize modelling components * Plotting of forecast components, model coefficients and more * Time series crossvalidation utility * Model checkpointing and validation ### Coming soon:tm: * Cross-relation of lagged regressors * Cross-relation and non-linear modelling of future regressors * Static features / Time series featurization * Logistic growth for trend component. * Model bias modelling / correction with secondary model * Multimodal seasonality For a list of past changes, please refer to the [releases page](https://github.com/ourownstory/neural_prophet/releases). The vision for future development can be seen at [Development Timeline](notes/development_timeline.md) (partially outdated). ## Cite Please cite [NeuralProphet](https://arxiv.org/abs/2111.15397) in your publications if it helps your research: ``` @misc{triebe2021neuralprophet, title={NeuralProphet: Explainable Forecasting at Scale}, author={Oskar Triebe and Hansika Hewamalage and Polina Pilyugina and Nikolay Laptev and Christoph Bergmeir and Ram Rajagopal}, year={2021}, eprint={2111.15397}, archivePrefix={arXiv}, primaryClass={cs.LG} } ``` ## About NeuralProphet is and open-source community project, supported by awesome people like you. If you are interested in joining the project, please feel free to reach out to me (Oskar) - you can find my email on the [NeuralProphet Paper](https://arxiv.org/abs/2111.15397). %package -n python3-neuralprophet Summary: Explainable Forecasting at Scale Provides: python-neuralprophet BuildRequires: python3-devel BuildRequires: python3-setuptools BuildRequires: python3-pip %description -n python3-neuralprophet [![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/ourownstory/neural_prophet?logo=github)](https://github.com/ourownstory/neural_prophet/releases) [![Pypi_Version](https://img.shields.io/pypi/v/neuralprophet.svg)](https://pypi.python.org/pypi/neuralprophet) [![Python Version](https://img.shields.io/badge/python-3.7+-blue?logo=python)](https://www.python.org/) [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) [![License](https://img.shields.io/badge/license-MIT-brightgreen)](https://opensource.org/licenses/MIT) [![Tests](https://github.com/ourownstory/neural_prophet/actions/workflows/ci.yml/badge.svg)](https://github.com/ourownstory/neural_prophet/actions/workflows/ci.yml) [![codecov](https://codecov.io/gh/ourownstory/neural_prophet/branch/master/graph/badge.svg?token=U5KXCL55DW)](https://codecov.io/gh/ourownstory/neural_prophet) [![Slack](https://img.shields.io/badge/slack-@neuralprophet-CF0E5B.svg?logo=slack&logoColor=white&labelColor=3F0E40)](https://neuralprophet.slack.com/join/shared_invite/zt-sgme2rw3-3dCH3YJ_wgg01IXHoYaeCg#/shared-invite/email) [![Downloads](https://static.pepy.tech/personalized-badge/neuralprophet?period=total&units=international_system&left_color=black&right_color=blue&left_text=Downloads)](https://pepy.tech/project/neuralprophet) ![NP-logo-wide_cut](https://user-images.githubusercontent.com/21246060/111388960-6c367e80-866d-11eb-91c1-46f2c0d21879.PNG) Please note that the project is still in beta phase. Please report any issues you encounter or suggestions you have. We will do our best to address them quickly. Contributions are very welcome! # NeuralProphet: human-centered forecasting NeuralProphet is an easy to learn framework for interpretable time series forecasting. NeuralProphet is built on PyTorch and combines Neural Network and traditional time-series algorithms, inspired by [Facebook Prophet](https://github.com/facebook/prophet) and [AR-Net](https://github.com/ourownstory/AR-Net). - With few lines of code, you can define, customize, visualize, and evaluate your own forecasting models. - It is designed for iterative human-in-the-loop model building. That means that you can build a first model quickly, interpret the results, improve, repeat. Due to the focus on interpretability and customization-ability, NeuralProphet may not be the most accurate model out-of-the-box; so, don't hesitate to adjust and iterate until you like your results. - NeuralProphet is best suited for time series data that is of higher-frequency (sub-daily) and longer duration (at least two full periods/years). ## Documentation The [documentation page](https://neuralprophet.com) may not be entirely up to date. Docstrings should be reliable, please refer to those when in doubt. We are working on an improved documentation. We appreciate any help to improve and update the docs. For a visual introduction to NeuralProphet, [view this presentation](notes/NeuralProphet_Introduction.pdf). ## Contribute We compiled a [Contributing to NeuralProphet](CONTRIBUTING.md) page with practical instructions and further resources to help you become part of the family. ## Community #### Discussion and Help If you have any question or suggestion, you can participate with [our community right here on Github](https://github.com/ourownstory/neural_prophet/discussions) #### Slack Chat We also have an active [Slack community](https://join.slack.com/t/neuralprophet/shared_invite/zt-sgme2rw3-3dCH3YJ_wgg01IXHoYaeCg). Come and join the conversation! ## Tutorials [![Open All Collab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/ourownstory/neural_prophet) There are several [example notebooks](tutorials/) to help you get started. You can find the datasets used in the tutorials, including data preprocessing examples, in our [neuralprophet-data repository](https://github.com/ourownstory/neuralprophet-data). Please refer to our [documentation page](https://neuralprophet.com) for more resources. ### Minimal example ```python from neuralprophet import NeuralProphet ``` After importing the package, you can use NeuralProphet in your code: ```python m = NeuralProphet() metrics = m.fit(df) forecast = m.predict(df) ``` You can visualize your results with the inbuilt plotting functions: ```python fig_forecast = m.plot(forecast) fig_components = m.plot_components(forecast) fig_model = m.plot_parameters() ``` If you want to forecast into the unknown future, extend the dataframe before predicting: ```python m = NeuralProphet().fit(df, freq="D") df_future = m.make_future_dataframe(df, periods=30) forecast = m.predict(df_future) fig_forecast = m.plot(forecast) ``` ## Install You can now install neuralprophet directly with pip: ```shell pip install neuralprophet ``` ### Install options If you plan to use the package in a Jupyter notebook, we recommended to install the 'live' version: ```shell pip install neuralprophet[live] ``` This will allow you to enable `plot_live_loss` in the `fit` function to get a live plot of train (and validation) loss. If you would like the most up to date version, you can instead install direclty from github: ```shell git clone cd neural_prophet pip install . ``` ## Features ### Model components * Autoregression: Autocorrelation modelling - linear or NN (AR-Net) * Trend: Piecewise linear trend with optional automatic changepoint detection * Seasonality: Fourier terms at different periods such as yearly, daily, weekly, hourly. * Lagged regressors: Lagged observations (e.g temperature sensor) - linear or NN * Future regressors: In advance known features (e.g. temperature forecast) - linear * Events: Country holidays & recurring custom events ### Framework features * Multiple time series: Fit a global/glocal model with (partially) shared model parameters * Uncertainty: Estimate values of specific quantiles - Quantile Regression * Regularize modelling components * Plotting of forecast components, model coefficients and more * Time series crossvalidation utility * Model checkpointing and validation ### Coming soon:tm: * Cross-relation of lagged regressors * Cross-relation and non-linear modelling of future regressors * Static features / Time series featurization * Logistic growth for trend component. * Model bias modelling / correction with secondary model * Multimodal seasonality For a list of past changes, please refer to the [releases page](https://github.com/ourownstory/neural_prophet/releases). The vision for future development can be seen at [Development Timeline](notes/development_timeline.md) (partially outdated). ## Cite Please cite [NeuralProphet](https://arxiv.org/abs/2111.15397) in your publications if it helps your research: ``` @misc{triebe2021neuralprophet, title={NeuralProphet: Explainable Forecasting at Scale}, author={Oskar Triebe and Hansika Hewamalage and Polina Pilyugina and Nikolay Laptev and Christoph Bergmeir and Ram Rajagopal}, year={2021}, eprint={2111.15397}, archivePrefix={arXiv}, primaryClass={cs.LG} } ``` ## About NeuralProphet is and open-source community project, supported by awesome people like you. If you are interested in joining the project, please feel free to reach out to me (Oskar) - you can find my email on the [NeuralProphet Paper](https://arxiv.org/abs/2111.15397). %package help Summary: Development documents and examples for neuralprophet Provides: python3-neuralprophet-doc %description help [![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/ourownstory/neural_prophet?logo=github)](https://github.com/ourownstory/neural_prophet/releases) [![Pypi_Version](https://img.shields.io/pypi/v/neuralprophet.svg)](https://pypi.python.org/pypi/neuralprophet) [![Python Version](https://img.shields.io/badge/python-3.7+-blue?logo=python)](https://www.python.org/) [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) [![License](https://img.shields.io/badge/license-MIT-brightgreen)](https://opensource.org/licenses/MIT) [![Tests](https://github.com/ourownstory/neural_prophet/actions/workflows/ci.yml/badge.svg)](https://github.com/ourownstory/neural_prophet/actions/workflows/ci.yml) [![codecov](https://codecov.io/gh/ourownstory/neural_prophet/branch/master/graph/badge.svg?token=U5KXCL55DW)](https://codecov.io/gh/ourownstory/neural_prophet) [![Slack](https://img.shields.io/badge/slack-@neuralprophet-CF0E5B.svg?logo=slack&logoColor=white&labelColor=3F0E40)](https://neuralprophet.slack.com/join/shared_invite/zt-sgme2rw3-3dCH3YJ_wgg01IXHoYaeCg#/shared-invite/email) [![Downloads](https://static.pepy.tech/personalized-badge/neuralprophet?period=total&units=international_system&left_color=black&right_color=blue&left_text=Downloads)](https://pepy.tech/project/neuralprophet) ![NP-logo-wide_cut](https://user-images.githubusercontent.com/21246060/111388960-6c367e80-866d-11eb-91c1-46f2c0d21879.PNG) Please note that the project is still in beta phase. Please report any issues you encounter or suggestions you have. We will do our best to address them quickly. Contributions are very welcome! # NeuralProphet: human-centered forecasting NeuralProphet is an easy to learn framework for interpretable time series forecasting. NeuralProphet is built on PyTorch and combines Neural Network and traditional time-series algorithms, inspired by [Facebook Prophet](https://github.com/facebook/prophet) and [AR-Net](https://github.com/ourownstory/AR-Net). - With few lines of code, you can define, customize, visualize, and evaluate your own forecasting models. - It is designed for iterative human-in-the-loop model building. That means that you can build a first model quickly, interpret the results, improve, repeat. Due to the focus on interpretability and customization-ability, NeuralProphet may not be the most accurate model out-of-the-box; so, don't hesitate to adjust and iterate until you like your results. - NeuralProphet is best suited for time series data that is of higher-frequency (sub-daily) and longer duration (at least two full periods/years). ## Documentation The [documentation page](https://neuralprophet.com) may not be entirely up to date. Docstrings should be reliable, please refer to those when in doubt. We are working on an improved documentation. We appreciate any help to improve and update the docs. For a visual introduction to NeuralProphet, [view this presentation](notes/NeuralProphet_Introduction.pdf). ## Contribute We compiled a [Contributing to NeuralProphet](CONTRIBUTING.md) page with practical instructions and further resources to help you become part of the family. ## Community #### Discussion and Help If you have any question or suggestion, you can participate with [our community right here on Github](https://github.com/ourownstory/neural_prophet/discussions) #### Slack Chat We also have an active [Slack community](https://join.slack.com/t/neuralprophet/shared_invite/zt-sgme2rw3-3dCH3YJ_wgg01IXHoYaeCg). Come and join the conversation! ## Tutorials [![Open All Collab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/ourownstory/neural_prophet) There are several [example notebooks](tutorials/) to help you get started. You can find the datasets used in the tutorials, including data preprocessing examples, in our [neuralprophet-data repository](https://github.com/ourownstory/neuralprophet-data). Please refer to our [documentation page](https://neuralprophet.com) for more resources. ### Minimal example ```python from neuralprophet import NeuralProphet ``` After importing the package, you can use NeuralProphet in your code: ```python m = NeuralProphet() metrics = m.fit(df) forecast = m.predict(df) ``` You can visualize your results with the inbuilt plotting functions: ```python fig_forecast = m.plot(forecast) fig_components = m.plot_components(forecast) fig_model = m.plot_parameters() ``` If you want to forecast into the unknown future, extend the dataframe before predicting: ```python m = NeuralProphet().fit(df, freq="D") df_future = m.make_future_dataframe(df, periods=30) forecast = m.predict(df_future) fig_forecast = m.plot(forecast) ``` ## Install You can now install neuralprophet directly with pip: ```shell pip install neuralprophet ``` ### Install options If you plan to use the package in a Jupyter notebook, we recommended to install the 'live' version: ```shell pip install neuralprophet[live] ``` This will allow you to enable `plot_live_loss` in the `fit` function to get a live plot of train (and validation) loss. If you would like the most up to date version, you can instead install direclty from github: ```shell git clone cd neural_prophet pip install . ``` ## Features ### Model components * Autoregression: Autocorrelation modelling - linear or NN (AR-Net) * Trend: Piecewise linear trend with optional automatic changepoint detection * Seasonality: Fourier terms at different periods such as yearly, daily, weekly, hourly. * Lagged regressors: Lagged observations (e.g temperature sensor) - linear or NN * Future regressors: In advance known features (e.g. temperature forecast) - linear * Events: Country holidays & recurring custom events ### Framework features * Multiple time series: Fit a global/glocal model with (partially) shared model parameters * Uncertainty: Estimate values of specific quantiles - Quantile Regression * Regularize modelling components * Plotting of forecast components, model coefficients and more * Time series crossvalidation utility * Model checkpointing and validation ### Coming soon:tm: * Cross-relation of lagged regressors * Cross-relation and non-linear modelling of future regressors * Static features / Time series featurization * Logistic growth for trend component. * Model bias modelling / correction with secondary model * Multimodal seasonality For a list of past changes, please refer to the [releases page](https://github.com/ourownstory/neural_prophet/releases). The vision for future development can be seen at [Development Timeline](notes/development_timeline.md) (partially outdated). ## Cite Please cite [NeuralProphet](https://arxiv.org/abs/2111.15397) in your publications if it helps your research: ``` @misc{triebe2021neuralprophet, title={NeuralProphet: Explainable Forecasting at Scale}, author={Oskar Triebe and Hansika Hewamalage and Polina Pilyugina and Nikolay Laptev and Christoph Bergmeir and Ram Rajagopal}, year={2021}, eprint={2111.15397}, archivePrefix={arXiv}, primaryClass={cs.LG} } ``` ## About NeuralProphet is and open-source community project, supported by awesome people like you. If you are interested in joining the project, please feel free to reach out to me (Oskar) - you can find my email on the [NeuralProphet Paper](https://arxiv.org/abs/2111.15397). %prep %autosetup -n neuralprophet-0.5.4 %build %py3_build %install %py3_install install -d -m755 %{buildroot}/%{_pkgdocdir} if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi pushd %{buildroot} if [ -d usr/lib ]; then find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst fi if [ -d usr/lib64 ]; then find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst fi if [ -d usr/bin ]; then find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst fi if [ -d usr/sbin ]; then find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst fi touch doclist.lst if [ -d usr/share/man ]; then find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst fi popd mv %{buildroot}/filelist.lst . mv %{buildroot}/doclist.lst . %files -n python3-neuralprophet -f filelist.lst %dir %{python3_sitelib}/* %files help -f doclist.lst %{_docdir}/* %changelog * Sun Apr 23 2023 Python_Bot - 0.5.4-1 - Package Spec generated