Initial commit to ivm-xyz

Initial commit to ivm-xyz, largely building off of 4dsolutions (Kirby Urner), and Cursor + language models.

BACKGROUND.md

@@ -0,0 +1,28 @@
+# Background
+The Isotropic Vector Matrix (IVM) and XYZ conversion package draws its inspiration from the groundbreaking work of R. Buckminster Fuller in the field of Synergetics. This discipline merges the principles of tetrahedral coordination geometries with the complexities of multi-dimensional mathematics. The suite provides a comprehensive set of computational tools designed to leverage various reference frames in geometric analysis and design, seamlessly integrating the conventional Cartesian coordinates with the sophisticated IVM framework.
+
+## Synergetics and Tetrahedral Coordination
+- **Synergetics**, as conceptualized by Fuller, underscores the critical role of tetrahedrons as the primary building blocks of spatial configuration.
+- **Tetrahedral Coordination** employs tetrahedrons to articulate space and spatial interrelations, offering a more nuanced comprehension of intricate structures through the repetition of simple, fundamental units.
+
+## Multi-Dimensional Mathematics and Topology
+- Concentrates on the application of multi-dimensional mathematics and the topology of interfaces and volumes, enabling a detailed portrayal of object locations, connections, continuity, and transformations.
+- Aids in the transition from traditional 3D geometric spaces (XYZ) to the more complex 4D tetrahedral coordination (IVM), thus broadening the scope of spatial analysis and design possibilities.
+
+## Isotropic Vector Matrix (IVM)
+- Represents a notable leap forward in geometric modeling with its 4D coordinate system, which is predicated on the dense packing of spheres to guarantee isotropy, ensuring that each point within the matrix maintains an equal distance from its neighbors.
+- Offers a sophisticated framework for the depiction of intricate geometric relationships and transformations.
+
+## Applications and Implications
+- Facilitates effortless transition between the conventional XYZ coordinate systems and the advanced IVM framework, paving the way for new research and development opportunities across a multitude of disciplines.
+- Enhances the conversion and manipulation of geometric data among diverse reference frames, promoting creative problem-solving and design methodologies.
+- Anchored in the core principles of geometry and topology, this package stimulates exploration and innovation within both the scientific and artistic communities.
+
+## Codebase Functionalities
+- **Conversion Functions**: The package includes robust conversion algorithms for accurate and efficient transformations between XYZ and IVM coordinate systems.
+- **High-Precision Calculations**: Utilizes high-precision calculations to ensure accuracy, crucial for scientific and engineering applications.
+- **Easy Integration**: Provides an easy-to-use interface for seamless integration into existing projects with minimal setup.
+- **Comprehensive Documentation**: Each function and module come with comprehensive documentation, catering to both beginners and experienced users.
+- **Extensive Test Suite**: Guarantees reliability and stability across different platforms and Python versions.
+
+In summary, the IVM-XYZ conversion package stands as a powerful instrument that forges a link between the traditional Cartesian spaces and the vibrant, multi-dimensional realm of Synergetics and tetrahedral coordination geometries. Inspired by Buckminster Fuller's visionary contributions, it introduces a novel perspective on spatial geometry, encouraging exploration and innovation across a wide range of disciplines.

LICENSE

@@ -1,21 +1,7 @@
-MIT License
+An initial synthetic license
 
-Copyright (c) 2024 Daniel Ari Friedman
+This software is made available to all individuals to access and utilize the software and its associated knowledge resources (the "Software"). 
 
-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:
+Users are encouraged to explore, adapt, collaborate, and innovate with the Software freely, promoting learning, creation, sharing, and inspiration.
 
-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.
+THE SOFTWARE IS PROVIDED "AS IS," WITHOUT ANY RESTRICTIONS OR OBSTACLES, EMBRACING THE SPIRIT OF INNOVATION AND PROGRESS. UNDER NO CIRCUMSTANCES SHALL THE CREATORS OR CONTRIBUTORS BE LIABLE FOR ANY DIFFICULTIES, INTERRUPTIONS, OR CONSTRAINTS, WHETHER ARISING FROM THE USE OF THE SOFTWARE OR THE PURSUIT OF KNOWLEDGE AND WISDOM.

README.md

@@ -0,0 +1,22 @@
+# ivm-xyz
+
+Welcome to ivm-xyz, a powerful Python package tailored for computational geometry, 3D modeling, physics simulations, and any domain where geometric transformations play a crucial role.
+
+## Key Features:
+
+- Robust conversion algorithms for precise and efficient transformations between XYZ and IVM coordinate systems
+- High-precision calculations ensuring accuracy for scientific and engineering applications
+- Seamless integration into existing projects with minimal setup required
+- Comprehensive documentation for easy accessibility to users of all levels
+- Extensive test suite for reliability and stability across various platforms and Python versions
+
+## Installation:
+
+Currently available on [GitHub - docxology/ivm-xyz](https://github.com/docxology/ivm-xyz) 
+
+## Usage:
+
+- Simply import the package and start using the functions
+- Check out tetravolume and other scripts/notebooks for practical examples
+
+### 

clone_4dsolutions.py

@@ -0,0 +1,31 @@
+# Clones all repositories from a specified GitHub user for further analysis.
+
+import os
+from github import Github
+
+# Replace with your GitHub access token
+ACCESS_TOKEN = "REPLACE_WITH_ACCESS_TOKEN"
+
+# Specify the GitHub username to clone repositories from
+USERNAME = "4dsolutions"
+
+# Authenticate with GitHub using the access token
+g = Github(ACCESS_TOKEN)
+
+# Retrieve the user object
+user = g.get_user(USERNAME)
+
+# Get all repositories of the user
+repos = user.get_repos()
+
+# Create a directory to store the cloned repositories
+os.makedirs(USERNAME, exist_ok=True)
+
+# Clone each repository
+for repo in repos:
+    print(f"Cloning {repo.name}...")
+
+    # Clone the repository into a subdirectory with the repository name
+    os.system(f"git clone {repo.clone_url} {USERNAME}/{repo.name}")
+
+print("Finished cloning all repositories!")