hg-systematic 0.0.1__py3-none-any.whl

hg_systematic/data/generators.py

@@ -0,0 +1,72 @@
+import math
+from datetime import timedelta, datetime
+from zoneinfo import ZoneInfo
+
+import numpy as np
+from hg_oap.dates.dt_utils import date_tz_to_utc
+from hgraph import generator, TS, EvaluationEngineApi, graph, lag, delayed_binding, feedback, compute_node, \
+    RECORDABLE_STATE, TimeSeriesSchema, STATE, SIGNAL
+
+__all__ = ["white_noise_generator", "auto_regressive_generator"]
+
+@compute_node
+def white_noise_generator(
+        signal: SIGNAL,
+        loc: float = 0.0,
+        scale: float = 1.0,
+        size: int = 1000,
+        _state: STATE = None
+) -> TS[float]:
+    """
+    Generates a stream of white noise at each tick of the ``signal`` input.
+    The buffer will be initialised at start, and will be re-initialised if the number of ticks exceeds the buffer
+    ``size``.
+    The noise stream can now be generated based on any input signal, for example, a calendar ticking out business days.
+    """
+    out = _state.buffer[_state.ndx]
+    _state.ndx += 1
+    if size == _state.ndx:
+        _state.buffer = np.random.normal(loc, scale, size=size)
+        _state.ndx = 0
+    return out
+
+@white_noise_generator.start
+def white_noise_generator_start(
+        loc: float = 0.0,
+        scale: float = 1.0,
+        size: int = 1000,
+        _state: STATE = None
+):
+    _state.buffer = np.random.normal(loc, scale, size=size)
+    _state.ndx = 0
+
+
+
+class ARState(TimeSeriesSchema):
+    previous_terms: TS[tuple[float,...]]
+
+@compute_node(
+    requires=lambda m, s: len(s["initial_values"]) == (order:=s["order"]) and len(s["coefficients"]) == order+1
+)
+def auto_regressive_generator(
+        white_noise: TS[float],
+        order: int = 1,
+        initial_values: tuple[float, ...] = (1.0,),
+        coefficients: tuple[float, ...] = (1.0, 0.5),
+        _state: RECORDABLE_STATE[ARState] = None
+) -> TS[float]:
+    """
+    An autoregressive generator.
+    The order defines how many terms to use.
+    The size of the initial values is ``order`` and coefficients must be the size of ``order+1``.
+    """
+    result = white_noise.value + coefficients[0]
+    prev = _state.previous_terms.value
+    result += sum(coefficients[i+1] * prev[i] for i in range(order))
+    _state.previous_terms.apply_result((result,) + prev[1:])
+    return result
+
+@auto_regressive_generator.start
+def autoregressive_generator_start(initial_values: tuple[float, ...], _state: RECORDABLE_STATE[ARState] = None):
+    _state.previous_terms.apply_result(initial_values)
+

hg_systematic-0.0.1.dist-info/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Howard Henson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

hg_systematic-0.0.1.dist-info/METADATA

@@ -0,0 +1,91 @@
+Metadata-Version: 2.1
+Name: hg_systematic
+Version: 0.0.1
+Summary:  A library and examples to show how HGraph can be used for systematic trading. 
+License: MIT
+Keywords: reactive,graph,fpg,forward propogating graph,time series,functional reactive programming,frp,functional,time-series,systematic,trading,strategy
+Author: Howard Henson
+Author-email: howard@henson.me.uk
+Requires-Python: >=3.12
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Requires-Dist: frozendict (>=2.3.10)
+Requires-Dist: hg_oap (>=0.1.9)
+Requires-Dist: hgraph (>=0.3.26)
+Requires-Dist: matplotlib
+Requires-Dist: numpy (>=1.23)
+Requires-Dist: ordered-set (>=4.1.0)
+Requires-Dist: polars (>=1.0)
+Requires-Dist: sortedcontainers (>=2.4.0)
+Requires-Dist: sphinx (>=7.4)
+Requires-Dist: sphinx-autodoc-typehints (>=2.3.0)
+Requires-Dist: sphinx_rtd_theme (>=2.0.0)
+Requires-Dist: sphinxcontrib-plantuml (>=0.30)
+Project-URL: Changelog, https://github.com/hhenson/hg_systematic/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://github.com/hhenson/hg_systematic/blob/main/README.md
+Project-URL: Homepage, https://github.com/hhenson/hg_systematic
+Project-URL: Issues, https://github.com/hhenson/hg_systematic/blob/main/ISSUES.md
+Project-URL: Repository, https://github.com/hhenson/hg_systematic.git
+Description-Content-Type: text/markdown
+
+# HG Systematic
+
+This is a library of utilities and examples to highlight how HGraph can be used to implement
+systematic trading strategies.
+
+
+See [this](https://hgraph.readthedocs.io/en/latest/) for more information.
+
+## Development
+
+The project is currently configured to make use of [Poetry](https://python-poetry.org) for dependency management. 
+Take a look at the website to see how best to install the tool.
+
+Here are some useful commands:
+
+First, this will cause the virtual environment to be installed in the same folder as the project (in .venv folder)
+
+```bash
+poetry config virtualenvs.in-project true
+```
+
+Use this command to set the version of Python to make use of if you want a specific version of Python.
+
+```bash
+poetry env use 3.12
+```
+
+Then use the following command to install the project and its dependencies. Note that the ``--with docs`` installs
+the dependencies to build the documentation set which is not required otherwise, also the ``--all-extras`` is only
+required for the adaptors.
+
+```bash
+poetry install --with docs --all-extras
+```
+
+If you did not use the first command, you can find the location of the installation using:
+
+```bash
+poetry env info
+```
+
+PyCharm can make use of poetry to ``setup`` the project.
+
+### Run Tests
+
+```bash
+# No Coverage
+poetry run pytest
+```
+
+```bash
+# Generate Coverage Report
+poetry run pytest --cov=your_package_name --cov-report=xml
+```
+

hg_systematic-0.0.1.dist-info/RECORD

@@ -0,0 +1,8 @@
+hg_systematic/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hg_systematic/data/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hg_systematic/data/generators.py,sha256=L8xpEfjbo1hUfQrwkbuYhDwDpBbe3gGL00SkHIzazkY,2448
+hg_systematic-0.0.1.dist-info/LICENSE,sha256=XknxcS0Tg4ZyGciZAoM3SXoMnAyPZC00HclKokINUNk,1070
+hg_systematic-0.0.1.dist-info/METADATA,sha256=U3YbjBOKWL95QwILfthpfAThdxkx7AKQNMDCZBMzOsI,3078
+hg_systematic-0.0.1.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
+hg_systematic-0.0.1.dist-info/entry_points.txt,sha256=8N5SofWe8lQrhmJFPd5add1Efz_jF_JoqB1zcR9z8XM,52
+hg_systematic-0.0.1.dist-info/RECORD,,

hg_systematic-0.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 1.9.1
+Root-Is-Purelib: true
+Tag: py3-none-any

hg_systematic-0.0.1.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+build-docs=sphinx.cmd.build:main
+