constrainthg 0.1.0__tar.gz

constrainthg-0.1.0/LICENSE

@@ -0,0 +1,4 @@
+Al rights reserved. All code written and referenced in this package is the property of the authors listed below, and cannot be used without permission.
+
+Authors:
+- John Morris, jhmrrs@clemson.edu, https://orcid.org/0009-0005-6571-1959

constrainthg-0.1.0/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.1
+Name: constrainthg
+Version: 0.1.0
+Summary: Methods for building and simulating constraint hypergraphs.
+Author-email: John Morris <jhmrrs@clemson.edu>
+License: All rights reserved
+Project-URL: Homepage, https://github.com/jmorris335/ConstraintHg/wiki
+Project-URL: Documentation, https://constrainthg.readthedocs.io/en/latest/
+Project-URL: Repository, https://github.com/jmorris335/ConstraintHg
+Project-URL: Bug Tracker, https://github.com/jmorris335/ConstraintHg/issues
+Keywords: hypergraphs,systems engineering
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python
+Requires-Python: >=3.1
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+
+![Static Badge](https://img.shields.io/badge/homepage-blue?link=https%3A%2F%2Fgithub.com%2Fjmorris335%2FConstraintHg%2Fwiki)
+ ![Read the Docs](https://img.shields.io/readthedocs/constrainthg?link=https%3A%2F%2Fconstrainthg.readthedocs.io%2Fen%2Flatest%2Findex.html) ![Static Badge](https://img.shields.io/badge/tests-passing-brightgreen) ![GitHub Release](https://img.shields.io/github/v/release/jmorris335/ConstraintHg?include_prereleases&display_name=tag) ![GitHub last commit](https://img.shields.io/github/last-commit/jmorris335/ConstraintHg)
+
+
+
+# ConstraintHg
+This repository enables usage of hypergraphs to define and execute system models. **It is not a rigorous data storage solution. Do not use this as a database.** Note that this repo is under active development (no official release yet), therefore changes may occur rapidly. Fork the repository before using it.
+
+## Install
+ConstraintHg is listed on the Python Package Index. Just use `pip install constrainthg` to get started.
+
+# Introduction
+Hypergraphs are normal graphs but without the constraint that edges must only link between two nodes. Because of this expanded generality, hypergraphs can be used to model more complex relationships. For instance, the relationship `A + B = C` is a multinodal relationship between three nodes, A, B, and C. You can think of all three nodes being linked by a 2D hyperedge, so that to move along that hyperedge you need at least two of three nodes. 
+
+An constraint hypergraph is a hypergraph where the relationships are constraints that can be solved for by some execution engine, generally via API calls. These constraints reveal the behavior of the system. The goal is for the hypergraph to be platform agnostic, while API calls allow for edges to be processed on any available software.
+
+Processing a series of nodes and edges (a "route") is what constitutes a simulation, so one of the uses of an constraint hypergraph is enabling high-level simulation ability from any possible entry point in a system model.
+
+## Getting started
+*Note that this demo is found in [`demos/demo_basic.py`](https://github.com/jmorris335/ConstraintHg/blob/main/demos/demo_basic.py)*
+Let's build a basic constraint hypergraph of the following equations:
+- $A + B = C$
+- $A = -D$
+- $B = -E$
+- $D + E = F$  
+- $F = -C$
+
+First, import the classes. 
+```[python]
+from constrainthg.hypergraph import Hypergraph
+import constrainthg.relations as R
+```
+
+A hypergraph consists of edges that map between a set of nodes to a single node. We provide the mapping by defining a constraint function (many of which are already defined in the `relationships` module). The two relationships defined in the governing equations are addition and negation. Using the typical syntax, we refer to the functions defined in `relationships` with `R.<name>`, in this case `R.Rsum` and `R.Rnegate`. To make the hypergraph we'll need to compose the 5 edges (equations) given above. 
+```[python]
+hg = Hypergraph()
+hg.addEdge(['A', 'B'], C, R.Rsum)
+hg.addEdge('A', 'D', R.Rnegate)
+hg.addEdge('B', 'E', R.Rnegate)
+hg.addEdge(['D', 'E'], 'F', R.Rsum)
+hg.addEdge('F', 'C', R.Rnegate)
+```
+
+We can verify that the hypergraph was made correctly by tracing all possible paths for generating C using the `printPaths` function.
+```[python]
+print(hg.printPaths('C'))
+```
+
+This should give us the following output. Hyperedges are indicated with a `◯`, with the last source separated from other edges with a `●`.
+```
+└──C, cost=1
+   ├◯─A, cost=0
+   ├●─B, cost=0
+   └──F, cost=3
+      ├◯─D, cost=1
+      │  └──A, cost=0
+      └●─E, cost=1
+         └──B, cost=0
+```
+
+Compute the value of $C$ by picking a set of source nodes (inputs), such as $A$ and $B$ or $A$ and $E$. Set values for the inputs and the solver will automatically calulate an optimized route to simulate $C$. 
+```[python]
+print("**Inputs A and E**")
+hg.solve('C', {'A':3, 'E':-7}, toPrint=True)
+print("**Inputs A and B**")
+hg.solve('C', {'A':3, 'B':7}, toPrint=True)
+```
+
+The output of the above should be:
+```
+**Inputs A and E**
+└──C= 10, cost=3
+   └──F= -10, cost=2
+      ├──D= -3, cost=1
+      │  └──A= 3, cost=0
+      └──E= -7, cost=0
+
+**Inputs A and B**
+└──C= 10, cost=1
+   ├──A= 3, cost=0
+   └──B= 7, cost=0
+```
+
+Check out the  [demos](https://github.com/jmorris335/ConstraintHg/tree/main/demos) directory for more examples.
+
+## Licensing and Usage
+Author: [John Morris](https://www.people.clemson.edu/jhmrrs/)  
+Organization: [PLM Center](https://github.com/Clemson-PLMC) at Clemson University  
+Contact: Reach out to my GitHub profile ([jmorris335](https://github.com/jmorris335))  
+Usage: An official release will *likely* be provided under the CC BY-NC-SA 4.0 license, but for now **all rights are reserved**. For usage, please reach out to the author directly.

constrainthg-0.1.0/README.md

@@ -0,0 +1,90 @@
+![Static Badge](https://img.shields.io/badge/homepage-blue?link=https%3A%2F%2Fgithub.com%2Fjmorris335%2FConstraintHg%2Fwiki)
+ ![Read the Docs](https://img.shields.io/readthedocs/constrainthg?link=https%3A%2F%2Fconstrainthg.readthedocs.io%2Fen%2Flatest%2Findex.html) ![Static Badge](https://img.shields.io/badge/tests-passing-brightgreen) ![GitHub Release](https://img.shields.io/github/v/release/jmorris335/ConstraintHg?include_prereleases&display_name=tag) ![GitHub last commit](https://img.shields.io/github/last-commit/jmorris335/ConstraintHg)
+
+
+
+# ConstraintHg
+This repository enables usage of hypergraphs to define and execute system models. **It is not a rigorous data storage solution. Do not use this as a database.** Note that this repo is under active development (no official release yet), therefore changes may occur rapidly. Fork the repository before using it.
+
+## Install
+ConstraintHg is listed on the Python Package Index. Just use `pip install constrainthg` to get started.
+
+# Introduction
+Hypergraphs are normal graphs but without the constraint that edges must only link between two nodes. Because of this expanded generality, hypergraphs can be used to model more complex relationships. For instance, the relationship `A + B = C` is a multinodal relationship between three nodes, A, B, and C. You can think of all three nodes being linked by a 2D hyperedge, so that to move along that hyperedge you need at least two of three nodes. 
+
+An constraint hypergraph is a hypergraph where the relationships are constraints that can be solved for by some execution engine, generally via API calls. These constraints reveal the behavior of the system. The goal is for the hypergraph to be platform agnostic, while API calls allow for edges to be processed on any available software.
+
+Processing a series of nodes and edges (a "route") is what constitutes a simulation, so one of the uses of an constraint hypergraph is enabling high-level simulation ability from any possible entry point in a system model.
+
+## Getting started
+*Note that this demo is found in [`demos/demo_basic.py`](https://github.com/jmorris335/ConstraintHg/blob/main/demos/demo_basic.py)*
+Let's build a basic constraint hypergraph of the following equations:
+- $A + B = C$
+- $A = -D$
+- $B = -E$
+- $D + E = F$  
+- $F = -C$
+
+First, import the classes. 
+```[python]
+from constrainthg.hypergraph import Hypergraph
+import constrainthg.relations as R
+```
+
+A hypergraph consists of edges that map between a set of nodes to a single node. We provide the mapping by defining a constraint function (many of which are already defined in the `relationships` module). The two relationships defined in the governing equations are addition and negation. Using the typical syntax, we refer to the functions defined in `relationships` with `R.<name>`, in this case `R.Rsum` and `R.Rnegate`. To make the hypergraph we'll need to compose the 5 edges (equations) given above. 
+```[python]
+hg = Hypergraph()
+hg.addEdge(['A', 'B'], C, R.Rsum)
+hg.addEdge('A', 'D', R.Rnegate)
+hg.addEdge('B', 'E', R.Rnegate)
+hg.addEdge(['D', 'E'], 'F', R.Rsum)
+hg.addEdge('F', 'C', R.Rnegate)
+```
+
+We can verify that the hypergraph was made correctly by tracing all possible paths for generating C using the `printPaths` function.
+```[python]
+print(hg.printPaths('C'))
+```
+
+This should give us the following output. Hyperedges are indicated with a `◯`, with the last source separated from other edges with a `●`.
+```
+└──C, cost=1
+   ├◯─A, cost=0
+   ├●─B, cost=0
+   └──F, cost=3
+      ├◯─D, cost=1
+      │  └──A, cost=0
+      └●─E, cost=1
+         └──B, cost=0
+```
+
+Compute the value of $C$ by picking a set of source nodes (inputs), such as $A$ and $B$ or $A$ and $E$. Set values for the inputs and the solver will automatically calulate an optimized route to simulate $C$. 
+```[python]
+print("**Inputs A and E**")
+hg.solve('C', {'A':3, 'E':-7}, toPrint=True)
+print("**Inputs A and B**")
+hg.solve('C', {'A':3, 'B':7}, toPrint=True)
+```
+
+The output of the above should be:
+```
+**Inputs A and E**
+└──C= 10, cost=3
+   └──F= -10, cost=2
+      ├──D= -3, cost=1
+      │  └──A= 3, cost=0
+      └──E= -7, cost=0
+
+**Inputs A and B**
+└──C= 10, cost=1
+   ├──A= 3, cost=0
+   └──B= 7, cost=0
+```
+
+Check out the  [demos](https://github.com/jmorris335/ConstraintHg/tree/main/demos) directory for more examples.
+
+## Licensing and Usage
+Author: [John Morris](https://www.people.clemson.edu/jhmrrs/)  
+Organization: [PLM Center](https://github.com/Clemson-PLMC) at Clemson University  
+Contact: Reach out to my GitHub profile ([jmorris335](https://github.com/jmorris335))  
+Usage: An official release will *likely* be provided under the CC BY-NC-SA 4.0 license, but for now **all rights are reserved**. For usage, please reach out to the author directly.

constrainthg-0.1.0/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "constrainthg"
+version = "0.1.0"
+dependencies = [
+    "numpy"
+]
+requires-python = ">=3.1"
+authors = [
+  {name = "John Morris", email = "jhmrrs@clemson.edu"},
+]
+description = "Methods for building and simulating constraint hypergraphs."
+readme = "README.md"
+license = {text = "All rights reserved"}
+keywords = ["hypergraphs", "systems engineering"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Programming Language :: Python"
+]
+
+[project.urls]
+Homepage = "https://github.com/jmorris335/ConstraintHg/wiki"
+Documentation = "https://constrainthg.readthedocs.io/en/latest/"
+Repository = "https://github.com/jmorris335/ConstraintHg"
+"Bug Tracker" = "https://github.com/jmorris335/ConstraintHg/issues"
+
+[project.scripts]
+constrainthg-cli = "constrainthg:main_cli"
+
+[tool.pytest.ini_options]
+pythonpath = "src"
+addopts = [
+    "--import-mode=importlib",
+]

constrainthg-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

constrainthg-0.1.0/src/constrainthg/__init__.py

@@ -0,0 +1,24 @@
+"""Initialization file for ConstraintHg."""
+
+import logging
+
+from constrainthg.hypergraph import *
+import constrainthg.relations as R
+
+LOG_LEVEL = logging.INFO
+
+logger = logging.getLogger(__name__)
+
+fh = logging.FileHandler("constrainthg.log")
+fh.setLevel(LOG_LEVEL)
+logger.info('Package begin execution')
+
+log_formatter = logging.Formatter(
+    fmt="[{asctime} | {levelname}]: {message}",
+    style="{",
+    datefmt="%Y-%m-%d %H:%M",
+    )
+fh.setFormatter(log_formatter)
+logger.addHandler(fh)
+
+logger.setLevel(LOG_LEVEL)