Metadata-Version: 2.1
Name: scodec
Version: 0.0.1
Summary: Spatial encoding algorithm using psuedo hilbert curves
Home-page: https://leapsystems.online
Author: cSDes1gn
Author-email: christian@leapsystems.online
License: UNKNOWN
Download-URL: https://github.com/Incuvers/iris-stage/archive/0.0.1.tar.gz
Description: 
        # Spatial Codec
        [![ci](https://github.com/LEAP-Systems/spatial-codec/actions/workflows/ci.yaml/badge.svg?branch=master)](https://github.com/LEAP-Systems/spatial-codec/actions/workflows/ci.yaml)
        
        Modified: 2021-06
        
        <p align="center">
          <img src="docs/img/LEAP_INS_WHITE.png"/>
        </p>
        
        ## Navigation
          1. [About](#about)
          2. [Quickstart](#quickstart)
          3. [Dev](#dev)
          4. [License](#license)
        
        ## About
        Spatial codec is a spatial encoding and decoding algorithm developed for iteratively mapping any number of bytes to a 3D (N3 space) matrix. The algorithm uses a psuedo variant of [Hilbert's Space Filling Curve](https://en.wikipedia.org/wiki/Hilbert_curve) which preserves the relative localization of bits in 3D independant of the matrix dimension which is a convienient property for error correction and scalable network policies.
        
        ## Quickstart
        Install python dependancies
        ```bash
        python3 -m pip install -r requirements.txt
        ...
        ```
        Run the algorithm for a specified block size `-b` / `--block`, with a data stream `-d` / `--data` and dimension `-n` / `--dimension` (2 or 3). The MPL visualizer can be enabled with the `-v=` flag.
        ```bash
        # n2 codec invocation
        python3 -m codec -n 2 -b 512 -d "Hello World" -v=
        ...
        # n3 codec invocation 
        python3 -m codec -n 3 -b 8 -d "H" -v=
        ```
        
        ## Dev
        Setup on M1 macs requires some additional configuration. I have automated the installation:
        ```bash
        ./scripts/m1-setup.sh
        ```
        
        ## License
        BSD 2-Clause License available [here](LICENSE)
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Topic :: Security :: Cryptography
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Requires-Python: >=3.8.0
Description-Content-Type: text/markdown
