Metadata-Version: 2.1
Name: paddlets
Version: 0.1.1
Summary: PaddleTS (Paddle Time Series Tool),            PaddlePaddle-based Time Series Modeling in Python
Home-page: https://github.com/PaddlePaddle/PaddleTS
Maintainer: paddlets Team
Maintainer-email: paddlets@baidu.com
License: LICENSE
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy (==1.19.5)
Requires-Dist: pandas (==1.1.5)
Requires-Dist: scikit-learn (==1.0.2)
Requires-Dist: chinese-calendar (==1.7.2)
Requires-Dist: python-docx (==0.8.11)
Requires-Dist: matplotlib (==3.5.2)
Requires-Dist: PyWavelets (==1.3.0)
Provides-Extra: all
Requires-Dist: numpy (==1.19.5) ; extra == 'all'
Requires-Dist: pandas (==1.1.5) ; extra == 'all'
Requires-Dist: scikit-learn (==1.0.2) ; extra == 'all'
Requires-Dist: chinese-calendar (==1.7.2) ; extra == 'all'
Requires-Dist: python-docx (==0.8.11) ; extra == 'all'
Requires-Dist: matplotlib (==3.5.2) ; extra == 'all'
Requires-Dist: PyWavelets (==1.3.0) ; extra == 'all'
Requires-Dist: protobuf (==3.19.0) ; extra == 'all'
Requires-Dist: paddlepaddle (==2.3.0) ; extra == 'all'
Provides-Extra: paddle
Requires-Dist: protobuf (==3.19.0) ; extra == 'paddle'
Requires-Dist: paddlepaddle (==2.3.0) ; extra == 'paddle'

**简体中文** | [English](./README_en.md)

<p align="center">
  <img src="docs/static/images/logo/paddlets-readme-logo.png" align="middle"  width="500">
<p>

------------------------------------------------------------------------------------------

<p align="center">
  <a href="https://github.com/PaddlePaddle/PaddleTS/graphs/contributors"><img src="https://img.shields.io/github/contributors/PaddlePaddle/PaddleTS?color=9ea"></a>
  <a href=""><img src="https://img.shields.io/badge/python-3.7+-aff.svg"></a>
  <a href=""><img src="https://img.shields.io/badge/paddlepaddle-2.3.0+-aff.svg"></a>
  <a href="https://github.com/PaddlePaddle/PaddleTS/commits"><img src="https://img.shields.io/github/commit-activity/m/PaddlePaddle/PaddleTS?color=3af"></a>
  <a href="https://github.com/PaddlePaddle/PaddleTS/issues"><img src="https://img.shields.io/github/issues/PaddlePaddle/PaddleTS?color=9cc"></a>
</p>

--------------------------------------------------------------------------------

PaddleTS 是一个易用的深度时序建模的Python库，它基于飞桨深度学习框架PaddlePaddle，专注业界领先的深度模型，旨在为领域专家和行业用户提供可扩展的时序建模能力和便捷易用的用户体验。PaddleTS 的主要特性包括：

* 设计统一数据结构，实现对多样化时序数据的表达，支持单目标与多目标变量，支持多类型协变量
* 封装基础模型功能，如数据加载、回调设置、损失函数、训练过程控制等公共方法，帮助开发者在新模型开发过程中专注网络结构本身
* 内置业界领先的深度学习模型，如NBEATS、NHiTS、LSTNet、TCN、Transformer等
* 内置多样化的数据转换算子，支持数据处理与转换，包括缺失值填充、异常值处理、归一化、时间相关的协变量提取等
* 内置经典的数据分析算子，帮助开发者便捷实现数据探索，包括数据统计量信息及数据摘要等功能

未来，更多的高级特性会进一步发布，包括但不限于：
* 自动超参寻优
* 时序表征模型
* 概率预测模型
* 场景化Pipeline，支持端到端真实场景解决方案


## 关于 PaddleTS

具体来说，PaddleTS 时序库包含以下子模块：

| 模块                                                                                                            | 简述                                              |
|---------------------------------------------------------------------------------------------------------------|-------------------------------------------------|
| [**paddlets.datasets**](https://paddlets.readthedocs.io/zh_CN/latest/source/modules/datasets/overview.html)   | 时序数据模块，统一的时序数据结构和预定义的数据处理方法           |
| [**paddlets.transform**](https://paddlets.readthedocs.io/zh_CN/latest/source/modules/transform/overview.html) | 数据转换模块，提供数据预处理和特征工程相关能力 |
| [**paddlets.models**](https://paddlets.readthedocs.io/zh_CN/latest/source/modules/models/overview.html)       | 时序模型模块，基于飞桨深度学习框架PaddlePaddle的时序模型     |
| [**paddlets.pipeline**](https://paddlets.readthedocs.io/zh_CN/latest/source/modules/pipeline/overview.html)   | 建模任务流模块，支持特征工程、模型训练、模型评估的任务流实现    |
| [**paddlets.metrics**](https://paddlets.readthedocs.io/zh_CN/latest/source/modules/metrics/overview.html)     | 效果评估模块，提供多维度模型评估能力                         |
| [**paddlets.analysis**](https://paddlets.readthedocs.io/zh_CN/latest/source/modules/analysis/overview.html)   | 数据分析模块，提供高效的时序特色数据分析能力                      |
| [**paddlets.utils**](https://paddlets.readthedocs.io/zh_CN/latest/source/modules/backtest/overview.html)      | 工具集模块，提供回测等基础功能                           |


## 安装

### 前置条件

* python >= 3.7
* paddlepaddle >= 2.3

pip 安装 paddlets 命令如下：
```bash
pip install paddlets
```

更多安装方式请参考：[环境安装](https://paddlets.readthedocs.io/zh_CN/latest/source/installation/overview.html)


## 文档

* [开始使用](https://paddlets.readthedocs.io/zh_CN/latest/source/get_started/get_started.html)

* [API文档](https://paddlets.readthedocs.io/zh_CN/latest/source/api/paddlets.analysis.html)


## 代码发布与贡献

我们非常感谢每一位代码贡献者。如果您发现任何Bug，请随时通过[提交issue](https://github.com/PaddlePaddle/PaddleTS/issues)的方式告知我们。

如果您计划贡献涉及新功能、工具类函数、或者扩展PaddleTS的核心组件相关的代码，请您在提交代码之前先[提交issue](https://github.com/PaddlePaddle/PaddleTS/issues)，并针对此次提交的功能与我们进行讨论。

如果在没有讨论的情况下直接发起的PR请求，可能会导致此次PR请求被拒绝。原因是对于您提交的PR涉及的模块，我们也许希望该模块朝着另一个不同的方向发展。


## 许可证
PaddleTS 使用Apache风格的许可证, 可参考 [LICENSE](LICENSE) 文件.
