stratax 0.1.0__tar.gz

stratax-0.1.0/.gitignore

@@ -0,0 +1,15 @@
+.vscode/
+build/
+dist/
+main.cpp
+util.h
+*.exe
+.venv
+test.py
+*__pycache__/
+*.pytest_cache
+
+
+
+
+

stratax-0.1.0/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog
+
+## 0.1.0
+
+### Added
+
+- Shape
+- Vector
+- Matrix
+- Tensor
+- Element-wise arithmetic
+- Element-wise comparisons
+- Python bindings
+- Type hints
+- Examples
+- Doxygen documentation

stratax-0.1.0/CMakeLists.txt

@@ -0,0 +1,93 @@
+cmake_minimum_required(VERSION 3.20)
+
+project(Stratax
+    VERSION 0.1.0
+    LANGUAGES CXX
+)
+
+set(CMAKE_CXX_STANDARD 20)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_CXX_EXTENSIONS OFF)
+
+set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)
+
+include(CTest)
+
+find_package(Doxygen QUIET)
+if(DOXYGEN_FOUND)
+    add_custom_target(docs
+        COMMAND ${DOXYGEN_EXECUTABLE} ${CMAKE_SOURCE_DIR}/Doxyfile
+        WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
+        COMMENT "Generating Stratax API documentation"
+        VERBATIM
+    )
+endif()
+
+find_package(Python REQUIRED COMPONENTS Interpreter Development)
+find_package(pybind11 CONFIG REQUIRED)
+
+pybind11_add_module(_core
+    bindings/module.cpp
+    bindings/shape.cpp
+    bindings/vector.cpp
+    bindings/matrix.cpp
+    bindings/tensor.cpp
+)
+
+target_include_directories(_core PRIVATE include)
+
+add_custom_command(TARGET _core POST_BUILD
+    COMMAND ${CMAKE_COMMAND} -E copy_if_different
+        $<TARGET_FILE:_core>
+        ${CMAKE_SOURCE_DIR}/python/stratax/$<TARGET_FILE_NAME:_core>
+)
+
+install(TARGETS _core
+    LIBRARY DESTINATION stratax
+    RUNTIME DESTINATION stratax
+)
+
+# --------------------------------------------------------------------------
+# Tests
+# --------------------------------------------------------------------------
+
+option(STRATAX_BUILD_TESTS "Build Stratax tests" ON)
+
+if(BUILD_TESTING AND STRATAX_BUILD_TESTS)
+
+    find_package(GTest CONFIG QUIET)
+
+    if(NOT GTest_FOUND)
+        include(FetchContent)
+
+        set(INSTALL_GTEST OFF CACHE BOOL "" FORCE)
+        set(gtest_force_shared_crt ON CACHE BOOL "" FORCE)
+
+        FetchContent_Declare(
+            googletest
+            URL https://github.com/google/googletest/archive/refs/tags/v1.15.2.zip
+            DOWNLOAD_EXTRACT_TIMESTAMP TRUE
+        )
+
+        FetchContent_MakeAvailable(googletest)
+    endif()
+
+    file(GLOB_RECURSE STRATAX_CPP_TEST_SOURCES CONFIGURE_DEPENDS
+        tests/cpp/*.cpp
+    )
+
+    add_executable(stratax_cpp_tests
+        ${STRATAX_CPP_TEST_SOURCES}
+    )
+
+    target_include_directories(stratax_cpp_tests PRIVATE include)
+
+    target_link_libraries(stratax_cpp_tests
+        PRIVATE GTest::gtest_main
+    )
+
+    include(GoogleTest)
+
+    gtest_discover_tests(stratax_cpp_tests)
+
+endif()

stratax-0.1.0/Doxyfile

@@ -0,0 +1,41 @@
+PROJECT_NAME           = "Stratax"
+PROJECT_BRIEF          = "Scientific computing containers and operations"
+OUTPUT_DIRECTORY       = docs/cpp
+
+INPUT                  = include README.md docs/dev
+RECURSIVE              = YES
+FILE_PATTERNS          = *.hpp *.h *.md
+
+GENERATE_HTML          = YES
+HTML_OUTPUT            = html
+GENERATE_LATEX         = NO
+
+EXTRACT_ALL            = YES
+EXTRACT_PRIVATE        = NO
+EXTRACT_STATIC         = YES
+HIDE_UNDOC_MEMBERS     = NO
+HIDE_UNDOC_CLASSES     = NO
+
+MARKDOWN_SUPPORT       = YES
+AUTOLINK_SUPPORT       = YES
+JAVADOC_AUTOBRIEF      = YES
+MULTILINE_CPP_IS_BRIEF = NO
+
+SOURCE_BROWSER         = YES
+INLINE_SOURCES         = NO
+REFERENCED_BY_RELATION = YES
+REFERENCES_RELATION    = YES
+
+QUIET                  = NO
+WARNINGS               = YES
+WARN_IF_UNDOCUMENTED   = YES
+WARN_IF_DOC_ERROR      = YES
+
+ALIASES               += complexity="\par Complexity"
+
+PREDEFINED            += "requires(...)="
+PREDEFINED            += "requires="
+PREDEFINED            += "Numeric=typename"
+PREDEFINED            += "Array=typename"
+
+EXTENSION_MAPPING      = hpp=C++

stratax-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Noah Ryan
+
+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.

stratax-0.1.0/PKG-INFO

@@ -0,0 +1,229 @@
+Metadata-Version: 2.1
+Name: stratax
+Version: 0.1.0
+Summary: Modern scientific array library for C++20 with Python bindings.
+Keywords: scientific,array,tensor,matrix,vector,cpp,pybind11,numerical
+Author: Noah Ryan
+License: MIT License
+         
+         Copyright (c) 2026 Noah Ryan
+         
+         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.
+         
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: C++
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Software Development :: Libraries
+Project-URL: Homepage, https://github.com/njryan-boou/stratax
+Project-URL: Repository, https://github.com/njryan-boou/stratax
+Project-URL: Issues, https://github.com/njryan-boou/stratax/issues
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# Stratax
+
+Stratax is a modern scientific computing library built around modern C++20
+containers, shape metadata, and element-wise array operations. The core library
+is header-first, with Python bindings powered by pybind11.
+
+The project is still young: vectors, matrices, tensors, shape/stride metadata,
+indexing, slicing, reshaping, conversions, creation helpers, printing,
+comparison, and arithmetic are active. Linear algebra, calculus, random, and
+statistics modules are currently reserved API areas.
+
+## Current Features
+
+- C++20 `Vector`, `Matrix`, and `Tensor` containers
+- Contiguous `Buffer` storage with shape and stride metadata
+- Bounds-checked `at(...)` and multidimensional `operator(...)` access
+- Element-wise arithmetic and comparison operators
+- Reshape, flatten, slicing, and container conversion helpers
+- Tensor creation helpers such as `zeros`, `ones`, `full`, and `identity`
+- Stream printing for vectors, matrices, tensors, shapes, and strides
+- Python bindings for `Shape`, `Vector`, `Matrix`, and `Tensor`
+- Doxygen API documentation
+
+## Requirements
+
+- C++20 compiler
+- CMake 3.20 or newer
+- Python 3.10 or newer for bindings
+- pybind11 2.12 or newer
+- scikit-build-core 0.10 or newer
+- pytest 8 or newer for Python tests
+- Doxygen 1.17 or newer for API docs
+
+## Quick C++ Example
+
+```cpp
+#include <stratax.h>
+#include <iostream>
+
+int main()
+{
+    stratax::container::Vector<double> a{1.0, 2.0, 3.0};
+    stratax::container::Vector<double> b{4.0, 5.0, 6.0};
+
+    auto c = a + b;
+
+    std::cout << c << '\n'; // [5, 7, 9]
+}
+```
+
+## Quick Python Example
+
+```python
+from stratax import Matrix, Shape, Tensor, Vector
+
+shape = Shape([2, 2])
+vector = Vector([1.0, 2.0, 3.0])
+matrix = Matrix([[1.0, 2.0], [3.0, 4.0]])
+tensor = Tensor([2, 2], 1.0)
+
+tensor[1, 1] = 9.0
+
+print(shape.elements)
+print(vector.tolist())
+print(matrix.tolist())
+print(tensor.tolist())
+```
+
+Python bindings currently expose `double`-based `Shape`, `Vector`, `Matrix`,
+and `Tensor` wrappers. The C++ API remains the primary interface while the
+binding surface grows.
+
+## Build From Source
+
+Configure and build with CMake:
+
+```powershell
+cmake -S . -B build
+cmake --build build
+```
+
+For editable Python installation, use pip from an environment with the build
+dependencies available:
+
+```powershell
+python -m pip install -e .
+```
+
+## Run Tests
+
+The C++ tests live under `tests/cpp/` and are registered with CTest through
+GoogleTest:
+
+```powershell
+cmake -S . -B build
+cmake --build build
+ctest --test-dir build --output-on-failure
+```
+
+The Python tests live under `tests/python/` and use pytest:
+
+```powershell
+python -m pytest tests/python
+```
+
+## Generate Documentation
+
+Generate API documentation with Doxygen:
+
+```powershell
+doxygen Doxyfile
+```
+
+The generated HTML entry point is:
+
+```text
+docs/cpp/html/index.html
+```
+
+If you configure through CMake and Doxygen is available, you can also run:
+
+```powershell
+cmake --build build --target docs
+```
+
+## Repository Layout
+
+```text
+include/stratax/      Public C++ headers
+bindings/             pybind11 binding sources
+python/stratax/       Python package
+tests/cpp/            C++ tests
+tests/python/         Python tests
+examples/cpp/         C++ examples
+examples/python/      Python examples
+docs/cpp/             C++ API documentation
+docs/python/          Python documentation
+```
+
+## Installation
+
+### Python
+
+```powershell
+pip install stratax
+```
+
+### C++
+
+Stratax is header-first for C++. Include the repository `include/` directory in
+your build and include the umbrella header:
+
+```cpp
+#include <stratax.h>
+```
+
+## License
+
+Stratax is licensed under the MIT License.
+
+## Contributing
+
+Contributions, bug reports, and feature requests are welcome through GitHub Issues and Pull Requests.
+
+## Project Status
+
+Implemented:
+
+- Core storage and metadata: `Buffer`, `Shape`, `Strides`, `Slice`
+- Containers: `Vector`, `Matrix`, `Tensor`
+- Operations: arithmetic, comparison, indexing, reshape, slicing
+- Container helpers: creation and conversions
+- I/O: stream printing
+- Python bindings: `Shape`, `Vector`, `Matrix`, `Tensor`
+
+## Roadmap
+
+- Broadcasting
+- Logical operations
+- Linear algebra algorithms
+- Calculus helpers
+- Random sampling and distributions
+- Statistics routines
+- CSV and binary I/O

stratax-0.1.0/README.md

@@ -0,0 +1,184 @@
+# Stratax
+
+Stratax is a modern scientific computing library built around modern C++20
+containers, shape metadata, and element-wise array operations. The core library
+is header-first, with Python bindings powered by pybind11.
+
+The project is still young: vectors, matrices, tensors, shape/stride metadata,
+indexing, slicing, reshaping, conversions, creation helpers, printing,
+comparison, and arithmetic are active. Linear algebra, calculus, random, and
+statistics modules are currently reserved API areas.
+
+## Current Features
+
+- C++20 `Vector`, `Matrix`, and `Tensor` containers
+- Contiguous `Buffer` storage with shape and stride metadata
+- Bounds-checked `at(...)` and multidimensional `operator(...)` access
+- Element-wise arithmetic and comparison operators
+- Reshape, flatten, slicing, and container conversion helpers
+- Tensor creation helpers such as `zeros`, `ones`, `full`, and `identity`
+- Stream printing for vectors, matrices, tensors, shapes, and strides
+- Python bindings for `Shape`, `Vector`, `Matrix`, and `Tensor`
+- Doxygen API documentation
+
+## Requirements
+
+- C++20 compiler
+- CMake 3.20 or newer
+- Python 3.10 or newer for bindings
+- pybind11 2.12 or newer
+- scikit-build-core 0.10 or newer
+- pytest 8 or newer for Python tests
+- Doxygen 1.17 or newer for API docs
+
+## Quick C++ Example
+
+```cpp
+#include <stratax.h>
+#include <iostream>
+
+int main()
+{
+    stratax::container::Vector<double> a{1.0, 2.0, 3.0};
+    stratax::container::Vector<double> b{4.0, 5.0, 6.0};
+
+    auto c = a + b;
+
+    std::cout << c << '\n'; // [5, 7, 9]
+}
+```
+
+## Quick Python Example
+
+```python
+from stratax import Matrix, Shape, Tensor, Vector
+
+shape = Shape([2, 2])
+vector = Vector([1.0, 2.0, 3.0])
+matrix = Matrix([[1.0, 2.0], [3.0, 4.0]])
+tensor = Tensor([2, 2], 1.0)
+
+tensor[1, 1] = 9.0
+
+print(shape.elements)
+print(vector.tolist())
+print(matrix.tolist())
+print(tensor.tolist())
+```
+
+Python bindings currently expose `double`-based `Shape`, `Vector`, `Matrix`,
+and `Tensor` wrappers. The C++ API remains the primary interface while the
+binding surface grows.
+
+## Build From Source
+
+Configure and build with CMake:
+
+```powershell
+cmake -S . -B build
+cmake --build build
+```
+
+For editable Python installation, use pip from an environment with the build
+dependencies available:
+
+```powershell
+python -m pip install -e .
+```
+
+## Run Tests
+
+The C++ tests live under `tests/cpp/` and are registered with CTest through
+GoogleTest:
+
+```powershell
+cmake -S . -B build
+cmake --build build
+ctest --test-dir build --output-on-failure
+```
+
+The Python tests live under `tests/python/` and use pytest:
+
+```powershell
+python -m pytest tests/python
+```
+
+## Generate Documentation
+
+Generate API documentation with Doxygen:
+
+```powershell
+doxygen Doxyfile
+```
+
+The generated HTML entry point is:
+
+```text
+docs/cpp/html/index.html
+```
+
+If you configure through CMake and Doxygen is available, you can also run:
+
+```powershell
+cmake --build build --target docs
+```
+
+## Repository Layout
+
+```text
+include/stratax/      Public C++ headers
+bindings/             pybind11 binding sources
+python/stratax/       Python package
+tests/cpp/            C++ tests
+tests/python/         Python tests
+examples/cpp/         C++ examples
+examples/python/      Python examples
+docs/cpp/             C++ API documentation
+docs/python/          Python documentation
+```
+
+## Installation
+
+### Python
+
+```powershell
+pip install stratax
+```
+
+### C++
+
+Stratax is header-first for C++. Include the repository `include/` directory in
+your build and include the umbrella header:
+
+```cpp
+#include <stratax.h>
+```
+
+## License
+
+Stratax is licensed under the MIT License.
+
+## Contributing
+
+Contributions, bug reports, and feature requests are welcome through GitHub Issues and Pull Requests.
+
+## Project Status
+
+Implemented:
+
+- Core storage and metadata: `Buffer`, `Shape`, `Strides`, `Slice`
+- Containers: `Vector`, `Matrix`, `Tensor`
+- Operations: arithmetic, comparison, indexing, reshape, slicing
+- Container helpers: creation and conversions
+- I/O: stream printing
+- Python bindings: `Shape`, `Vector`, `Matrix`, `Tensor`
+
+## Roadmap
+
+- Broadcasting
+- Logical operations
+- Linear algebra algorithms
+- Calculus helpers
+- Random sampling and distributions
+- Statistics routines
+- CSV and binary I/O