polars-ta 0.4.6__py3-none-any.whl → 0.5.1__py3-none-any.whl

{polars_ta-0.4.6.dist-info → polars_ta-0.5.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: polars_ta
-Version: 0.4.6
+Version: 0.5.1
 Summary: polars expressions
 Author-email: wukan <wu-kan@163.com>
 License: MIT License
@@ -31,13 +31,14 @@ Classifier: Programming Language :: Python
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: polars>=0.20.19
+Requires-Dist: polars>=1.26.0
 Requires-Dist: polars-ols>=0.3.0
 Requires-Dist: numpy
 Requires-Dist: numba
 Requires-Dist: pandas
 Provides-Extra: talib
 Requires-Dist: TA-Lib; extra == "talib"
+Dynamic: license-file
 
 # polars_ta
 
@@ -65,6 +66,7 @@ pip install polars_ta-0.1.2-py3-none-any.whl
 ```
 
 ### How to Install TA-Lib
+
 Non-official `TA-Lib` wheels can be downloaded from `https://github.com/cgohlke/talib-build/releases`
 
 ## Usage
@@ -91,6 +93,18 @@ df = df.with_columns([
 ])
 ```
 
+When both `min_periods` and `MIN_SAMPLES` are set, `min_periods` takes precedence. default value is `None`.
+
+```python
+import polars_ta
+
+# Global settings. Priority Low
+polars_ta.MIN_SAMPLES = 1
+
+# High priority
+ts_mean(CLOSE, 10, min_samples=1)
+```
+
 ## How We Designed This
 
 1. We use `Expr` instead of `Series` to avoid using `Series` in the calculation. Functions are no longer methods of class.
@@ -108,32 +122,6 @@ See [compare](compare.md)
 
 See [nan_to_null](nan_to_null.md)
 
-## Evolve of Our TA-Lib Wrappers
-
-1. `Expr.map_batches` can be used to call third-party libraries, such as `TA-Lib, bottleneck`. But because of the input and output format requirements, you need to wrap the third-party API with a function.
-  - Both input and output can only be one column. If you want to support multiple columns, you need to convert them to `pl.Struct`. After that, you need to use `unnest` to split `pl.Struct`.
-  - The output must be `pl.Series`
-2. Start to use `register_expr_namespace` to simplify the code
-  - Implementation [helper.py](polars_ta/utils/helper.py)
-  - Usage demo [demo_ta1.py](examples/demo_ta1.py)
-  - Pros: Easy to use
-  - Cons:
-    - The `member function call mode` is not convenient for inputting into genetic algorithms for factor mining
-    - `__getattribute__` dynamic method call is very flexible, but loses `IDE` support.
-3. Prefix expression. Convert all member functions into formulas
-  - Implementation [wrapper.py](polars_ta/utils/wrapper.py)
-  - Usage demo [demo_ta2.py](examples/demo_ta2.py)
-  - Pros: Can be input into our implementation of genetic algorithms
-  - Cons: `__getattribute__` dynamic method call is very flexible, but loses `IDE` support.
-4. Code generation.
-  - Implementation [codegen_talib.py](tools/codegen_talib.py)
-  - Generated result will be at [\_\_init\_\_.py](polars_ta/talib/__init__.py)
-  - Usage demo [demo_ta3.py](examples/demo_ta3.py)
-  - Pros:
-    - Can be input into our implementation of genetic algorithms
-    - `IDE` support
-
-
 ## Debugging
 
 ```commandline
@@ -157,10 +145,6 @@ This is required to use in `expr_codegen`.
 - https://support.worldquantbrain.com/hc/en-us/community/posts/20278408956439-从价量看技术指标总结-Technical-Indicator-
 - https://platform.worldquantbrain.com/learn/operators/operators
 
-
-
-
-
 # polars_ta
 
 基于`polars`的算子库。实现量化投研中常用的技术指标、数据处理等函数。对于不易翻译成`Expr`的库（如：`TA-Lib`）也提供了函数式调用的封装
@@ -185,6 +169,7 @@ pip install polars_ta-0.1.2-py3-none-any.whl
 ```
 
 ### TA-Lib安装
+
 Windows用户不会安装可从`https://github.com/cgohlke/talib-build/releases` 下载对应版本whl文件
 
 ## 使用方法
@@ -211,6 +196,19 @@ df = df.with_columns([
 ])
 ```
 
+当`min_periods`和`MIN_SAMPLES`都设置时，以`min_periods`为准，默认值为`None`
+
+```python
+import polars_ta
+
+# 全局设置。优先级低
+polars_ta.MIN_SAMPLES = 1
+
+# 指定函数。优先级高
+ts_mean(CLOSE, 10, min_samples=1)
+
+```
+
 ## 设计原则
 
 1. 调用方法由`成员函数`换成`独立函数`。输入输出使用`Expr`，避免使用`Series`
@@ -228,28 +226,6 @@ df = df.with_columns([
 
 请参考[nan_to_null](nan_to_null.md)
 
-## TA-Lib封装的演化
-
-1. `Expr.map_batches`可以实现调用第三方库，如`TA-Lib, bottleneck`。但因为对输入与输出格式有要求，所以还需要用函数对第三方API封装一下。
-    - 输入输出都只能是一列，如要支持多列需转换成`pl.Struct`。事后`pl.Struct`要拆分需使用`unnest`
-    - 输出必须是`pl.Series`
-2. 参数多，代码长。开始使用`register_expr_namespace`来简化代码
-    - 实现代码[helper.py](polars_ta/utils/helper.py)
-    - 使用演示[demo_ta1.py](examples/demo_ta1.py)
-    - 优点：使用简单
-    - 不足：`成员函数调用模式`不便于输入到遗传算法中进行因子挖掘
-    - 不足：`__getattribute__`动态方法调用非常灵活，但失去了`IDE`智能提示
-3. 前缀表达式。将所有的成员函数都转换成公式
-    - 实现代码[wrapper.py](polars_ta/utils/wrapper.py)
-    - 使用演示[demo_ta2.py](examples/demo_ta2.py)
-    - 优点：可以输入到遗传算法
-    - 不足：`__getattribute__`动态方法调用非常灵活，但失去了`IDE`智能提示
-4. 代码自动生成。
-    - 实现代码[codegen_talib.py](tools/codegen_talib.py)
-    - 生成结果[\_\_init\_\_.py](polars_ta/talib/__init__.py)
-    - 使用演示[demo_ta3.py](examples/demo_ta3.py)
-    - 优点：即可以输入到遗传算法，`IDE`还有智能提示
-
 ## 开发调试
 
 ```commandline
@@ -260,6 +236,18 @@ pip install -e .
 
 注意：如果你在`ta`或`tdx`中添加了新的函数，请再运行`tools`下的`prefix_ta.py`或`prefix_tdx.py`，用于生成对应的前缀文件。前缀文件方便在`expr_codegen`中使用
 
+## 文档生成
+
+```commandline
+pip install -r requirements-docs.txt
+mkdocs build
+```
+
+文档生成在`site`目录下，其中的`llms-full.txt`可以作为大语言模型的知识库导入。
+
+也可以通过以下链接导入：
+https://polars-ta.readthedocs.io/en/latest/llms-full.txt
+
 ## 参考
 
 - https://github.com/pola-rs/polars

{polars_ta-0.4.6.dist-info → polars_ta-0.5.1.dist-info}/RECORD

@@ -1,5 +1,5 @@
-polars_ta/__init__.py,sha256=UfRKvBoFTFhGlL9fNsarlPs0_FV6kxM1vfWvJD5YBe8,53
-polars_ta/_version.py,sha256=bbBpXE_PBbo_SaI807mDML0QJywD0_ufCDPgAMlDHaE,22
+polars_ta/__init__.py,sha256=ig6f6c1AMSpntwKjqaX3msBzVIwkI7J776IujEmiuvA,123
+polars_ta/_version.py,sha256=eZ1bOun1DDVV0YLOBW4wj2FP1ajReLjbIrGmzN7ASBw,22
 polars_ta/noise.py,sha256=LJHubBqnWlU3Bz84z07N1JB-b-hAMW2rgBF1BT4m0FE,1471
 polars_ta/candles/__init__.py,sha256=AW68IuFC0gD4_OyjwLP3p22WSzSIYqlSrsS9fW_15xw,141
 polars_ta/candles/cdl1.py,sha256=RnRu1QzpqEt5y0-1hlfZRUvza1no-Gj4x_dx2QWxr5A,3130
@@ -26,7 +26,7 @@ polars_ta/ta/statistic.py,sha256=dS5dPBszbdlroJ9u5aXBniJmKgPQnuh9zE7miYKzICs,968
 polars_ta/ta/transform.py,sha256=c4s5l6khVqIer50g6oScdZ1EEPWYANeKm64AkBkPrtY,1789
 polars_ta/ta/volatility.py,sha256=yQDKLxos521y3RzywOcE0hTj3qIG_2mfqpARpdxQ1KU,836
 polars_ta/ta/volume.py,sha256=fPd9Po30kFu-cSmYoRQP4_Ypi9oSWROj650-mjwlfwM,739
-polars_ta/talib/__init__.py,sha256=bdNWsIrLlaOU2DVZWiFVBoQEBWtz-BJ1_4hAR5fa1H0,71818
+polars_ta/talib/__init__.py,sha256=UZIkJ6tDYTcxBuKqjeKW93Ya_VyzTtNjXefoTqMd5P8,69701
 polars_ta/tdx/__init__.py,sha256=HBVPri6GwiEsFx4op0ZxDa3Yk4MbnPZgth5xJhtnxiA,662
 polars_ta/tdx/_chip.py,sha256=2eCe-y_0DcBivVjQHXlFwAiY410-hH-KKPrsUcRJcyk,3832
 polars_ta/tdx/_nb.py,sha256=IV3XrgSYPoR4jnOOT8p7jJWGtnoRrHLw5-fnIOfmMvA,2192
@@ -47,22 +47,22 @@ polars_ta/tdx/trend_feature.py,sha256=uNc4Z46Kyd7Prl0Ftl2ljSAXztTzQtbO28p7gy8iMv
 polars_ta/tdx/volume.py,sha256=juYM4Qlx2BX5okRCSwuf-6kRUETqDF7MVWUbYIzc4ww,901
 polars_ta/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 polars_ta/utils/helper.py,sha256=rqxBhmA-RhpHd1-qxdYi7OEZloQpPxR30Kz8fJ_hLic,6254
-polars_ta/utils/numba_.py,sha256=HzizWbCJ8qJs-_3RwCqb33XlXMULI5UG1jUgleBNWZk,2808
-polars_ta/utils/pandas_.py,sha256=xdh-vc5I8RPYGVLh2WQkIwefPsdaah7fa7sb901vdj8,1956
+polars_ta/utils/numba_.py,sha256=jiOxEZjdGBr8aFivCQbJllBsZCfQsBJXQ-DyGhTS2cI,5832
+polars_ta/utils/pandas_.py,sha256=codb51l45TUMngY55twQaUPUxnffjvj8UEOm35zFpNE,1989
 polars_ta/utils/pit.py,sha256=YNgUE6mbwhrtA-7wyOL0PCUDdwfTQouXwage-cK6efY,4312
 polars_ta/utils/wrapper.py,sha256=jbR-ZQdzBf5iWvtnJ1HsN9HdepmDbU7fUj4w8Bt2BkU,3422
 polars_ta/wq/__init__.py,sha256=C3YYJc997XCUI7H_afGT_mj2m4UdHMcql4sboCVvrXU,327
-polars_ta/wq/_nb.py,sha256=cYEUlEvLQJCjt5_o_1qnWrJ2eWMamwUedOsLwYTq_Oo,9470
+polars_ta/wq/_nb.py,sha256=Vh7n0_uOK9sTpmSYHCdLpu-Hc8QrOF0ugK_wgRWJXlg,11233
 polars_ta/wq/_slow.py,sha256=MfWg9FYX8NGNLWN4ezI_awf3pPTqhSq_zo0LOS4nCzw,937
-polars_ta/wq/arithmetic.py,sha256=rLKfp1Kvu_BFJKH7t7zp0jkfVHRn_HjkDUC0d-Jq9q8,23445
+polars_ta/wq/arithmetic.py,sha256=rVFWhHpmgsMRfPj08VaXCrKapIZ3TP7-1Nc8wBi2BpE,23682
 polars_ta/wq/cross_sectional.py,sha256=mHLwuXu9m4ladb6cUJVnH4OofliBSkpzmIZu6TtBoe4,13697
 polars_ta/wq/logical.py,sha256=5lttGwQi9oHml7soqmxEwgIVVLpeWO7JSXmQ3-TUqlU,2261
 polars_ta/wq/preprocess.py,sha256=xbESoAtsbQgXJMhnLzg4r5o2H9uwPyHfySg5skk_DUg,4188
-polars_ta/wq/time_series.py,sha256=L74rqAUyZS6rI3S3R9aIwrKosGFFHWxP3BESNJ67ak8,27093
+polars_ta/wq/time_series.py,sha256=joPwnC9uPwWch0oqJsc4gbOmhlFsQIT1sEekrPkFGUU,31043
 polars_ta/wq/transformational.py,sha256=ktluqo-lcxWysFL3huNypId0EFR1wn1PmyBGO180UQo,7194
 polars_ta/wq/vector.py,sha256=Qs-mHC2YsiWXoyMuXZZPzd5W5w_HL1ZgDCj9wRAnqmQ,1902
-polars_ta-0.4.6.dist-info/LICENSE,sha256=nREFtfwxWCCYD-ZA1jMzhhxMyTz-wGWFlnkpgg0DCtQ,1062
-polars_ta-0.4.6.dist-info/METADATA,sha256=fGq4fKlaXhEFSNeLl4rne1t56Xasvyw3Vbbnagn38yg,10711
-polars_ta-0.4.6.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-polars_ta-0.4.6.dist-info/top_level.txt,sha256=eat2IhP79-dIGA4DAFOz1o-95--UDqfjeIgmU9TBsDQ,10
-polars_ta-0.4.6.dist-info/RECORD,,
+polars_ta-0.5.1.dist-info/licenses/LICENSE,sha256=nREFtfwxWCCYD-ZA1jMzhhxMyTz-wGWFlnkpgg0DCtQ,1062
+polars_ta-0.5.1.dist-info/METADATA,sha256=jy8YfW0sYfO_Xz7Xl9yFK3aQqSCA9NNmyCtpM6FufD8,8633
+polars_ta-0.5.1.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+polars_ta-0.5.1.dist-info/top_level.txt,sha256=eat2IhP79-dIGA4DAFOz1o-95--UDqfjeIgmU9TBsDQ,10
+polars_ta-0.5.1.dist-info/RECORD,,

{polars_ta-0.4.6.dist-info → polars_ta-0.5.1.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.8.0)
+Generator: setuptools (78.1.0)
 Root-Is-Purelib: true
 Tag: py3-none-any