gplearn-CUDA 0.4.3__tar.gz

gplearn_cuda-0.4.3/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,41 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: bug
+assignees: ''
+
+---
+
+<!-- Thanks for contributing to gplearn!
+Please ensure you have taken a look at the contribution guidelines:
+https://gplearn.readthedocs.io/en/stable/contributing.html -->
+
+**Describe the bug**
+<!-- A clear and concise description of what the bug is.-->
+
+**Expected behavior**
+<!-- A clear and concise description of what you expected to happen.-->
+
+**Actual behavior**
+<!-- Please paste or specifically describe the actual output or traceback.-->
+
+**Steps to reproduce the behavior**
+<!-- 
+```python
+from gplearn.genetic import [...]
+```
+If the code is too long, feel free use a public gist : https://gist.github.com
+-->
+
+**System information**
+<!--
+Please run the following snippet and paste the output below.
+import platform; print(platform.platform())
+import sys; print("Python", sys.version)
+import numpy; print("NumPy", numpy.__version__)
+import scipy; print("SciPy", scipy.__version__)
+import sklearn; print("Scikit-Learn", sklearn.__version__)
+import joblib; print("Joblib", joblib.__version__)
+import gplearn; print("gplearn", gplearn.__version__)
+-->

gplearn_cuda-0.4.3/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,23 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: enhancement
+assignees: ''
+
+---
+
+<!-- Thanks for contributing to gplearn!
+Please ensure you have taken a look at the contribution guidelines:
+https://gplearn.readthedocs.io/en/stable/contributing.html -->
+
+**Is your feature request related to a problem? Please describe.**
+<!-- A clear and concise description of what the problem is.-->
+
+**Describe the solution you'd like**
+<!-- A clear and concise description of what you want to happen.-->
+
+**Additional context**
+<!-- Add any other context or screenshots about the feature request here.
+If related to a publication, please provide a link to the paper that does not
+require any login or payment.-->

gplearn_cuda-0.4.3/.github/pull_request_template.md

@@ -0,0 +1,13 @@
+<!-- Thanks for contributing to gplearn!
+Please ensure you have taken a look at the contribution guidelines:
+https://gplearn.readthedocs.io/en/stable/contributing.html -->
+
+**Reference Issues/PRs**
+<!--
+Example: Fixes #1234. See also #3456.
+Please use keywords (e.g., Fixes) to create link to the issues or pull requests
+you resolved, so that they will automatically be closed when your pull request
+is merged. See https://github.com/blog/1506-closing-issues-via-pull-requests
+-->
+
+**What does this implement/fix? Explain your changes.**

gplearn_cuda-0.4.3/.github/workflows/build.yml

@@ -0,0 +1,61 @@
+name: build
+
+on:
+  schedule:
+    # Every friday at 4am UTC
+    - cron:  '0 4 * * 5'
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    strategy:
+      fail-fast: false
+      matrix:
+        os:
+          - ubuntu-latest
+        python_version:
+          - '3.11'
+          - '3.12'
+          - '3.13'
+          - '3.14'
+        include:
+          - os: windows-latest
+            python_version: '3.14'
+          - os: ubuntu-latest
+            python_version: '3.14'
+            coverage: true
+    runs-on: ${{ matrix.os }}
+
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python ${{ matrix.python_version }} on ${{ matrix.os }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python_version }}
+    - name: Install global dependencies
+      run: |
+        python -m pip install --upgrade pip
+        python -m pip install pytest pytest-cov coveralls
+        python -m pip install pandas
+    - name: Install minimal dependencies
+      if: ${{ matrix.python_version == '3.11' }}
+      run: python -m pip install scikit-learn==1.8.0 joblib==1.3.0
+    - name: Install gplearn
+      run: python -m pip install .
+    - name: Describe Python environment
+      run: |
+        python --version
+        python -c "import sklearn; print('sklearn %s' % sklearn.__version__)"
+        python -c "import joblib; print('joblib %s' % joblib.__version__)"
+        python -c "import numpy; print('numpy %s' % numpy.__version__)"
+        python -c "import scipy; print('scipy %s' % scipy.__version__)"
+    - name: Test with pytest
+      run: pytest -v --cov
+    - name: Coverage
+      if: ${{ matrix.coverage }}
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      run: coveralls --service=github

gplearn_cuda-0.4.3/.github/workflows/publish.yml

@@ -0,0 +1,36 @@
+name: Publish Python 🐍 distribution 📦 to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  build-n-publish:
+    name: Build and publish Python 📦 to PyPI
+    environment: "publishing env"
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write  # IMPORTANT: mandatory for trusted publishing
+      contents: read
+
+    steps:
+    - name: Checkout source
+      uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.x"
+
+    - name: Install pypa/build
+      run: >-
+        python -m
+        pip install
+        build
+        --user
+
+    - name: Build a binary wheel and a source tarball
+      run: python -m build
+
+    - name: Publish package distributions to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1

gplearn_cuda-0.4.3/.gitignore

@@ -0,0 +1,79 @@
+# Hidden files
+*~
+.#*
+.DS_Store
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+.venv/
+uv.lock
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+setup.cfg
+*.egg
+.ipynb_checkpoints/
+.vscode/
+
+# PyInstaller
+#  Usually these files are written by a python script from a terminal
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage*
+.cache
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.cupy/
+nosetests.xml
+coverage.xml
+/.idea/
+.idea/*
+.idea/workspace.xml
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+
+# Sphinx documentation
+doc/_build/
+
+# PyBuilder
+target/
+
+# Local project files
+GEMINI.md
+GPU_ACCELERATION_PLAN.md
+
+# Build logs
+logs/

gplearn_cuda-0.4.3/.readthedocs.yaml

@@ -0,0 +1,35 @@
+# Read the Docs configuration file for Sphinx projects
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
+version: 2
+
+# Set the OS, Python version and other tools you might need
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "3.12"
+    # You can also specify other tool versions:
+    # nodejs: "20"
+    # rust: "1.70"
+    # golang: "1.20"
+
+# Build documentation in the "docs/" directory with Sphinx
+sphinx:
+  configuration: doc/conf.py
+  # You can configure Sphinx to use a different builder, for instance use the dirhtml builder for simpler URLs
+  # builder: "dirhtml"
+  # Fail on all warnings to avoid broken references
+  # fail_on_warning: true
+
+# Optionally build your docs in additional formats such as PDF and ePub
+# formats:
+#   - pdf
+#   - epub
+
+# Optional but recommended, declare the Python requirements required
+# to build your documentation
+# See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
+python:
+  install:
+    - requirements: doc/rtd-pip-requirements

gplearn_cuda-0.4.3/CODE_OF_CONDUCT.md

@@ -0,0 +1,76 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, sex characteristics, gender identity and expression,
+level of experience, education, socio-economic status, nationality, personal
+appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+ advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+ address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+ professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at @trevorstephens. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see
+https://www.contributor-covenant.org/faq

gplearn_cuda-0.4.3/CONTRIBUTING.md

@@ -0,0 +1,44 @@
+Contributing
+============
+
+``gplearn-CUDA`` welcomes your contributions! Whether it is a bug report, bug fix,
+new feature or documentation enhancements, please help to improve the project!
+
+In general, please follow the
+[scikit-learn contribution guidelines](http://scikit-learn.org/stable/developers/contributing.html)
+for how to contribute to an open-source project.
+
+If you would like to open a bug report, please [open one here](https://github.com/LGA-Personal/gplearn-CUDA/issues).
+Please try to provide a [Short, Self Contained, Example](http://sscce.org/)
+so that the root cause can be pinned down and corrected more easily.
+
+If you would like to contribute a new feature or fix an existing bug, the basic
+workflow to follow (as detailed more at the scikit-learn link above) is:
+
+- [Open an issue](https://github.com/LGA-Personal/gplearn-CUDA/issues) with what
+  you would like to contribute to the project and its merits. Some features may
+  be out of scope for ``gplearn-CUDA``, so be sure to get the go-ahead before
+  working on something that is outside of the project's goals.
+- Fork the ``gplearn-CUDA`` repository, clone it locally, and create your new feature
+  branch.
+- Make your code changes on the branch, commit them, and push to your fork.
+- Open a pull request.
+
+Please ensure that:
+
+- Only data-dependent arguments should be passed to the fit/transform methods
+  (``X``, ``y``, ``sample_weight``), and conversely, no data should be passed to the
+  estimator initialization.
+- No input validation occurs before fitting the estimator.
+- Any new feature has great test coverage.
+- Any new feature is well documented with
+  [numpy-style docstrings](https://numpydoc.readthedocs.io/en/latest/format.html#docstring-standard)
+  & an example, if appropriate and illustrative.
+- Any bug fix has regression tests.
+- Comply with [PEP8](https://pypi.python.org/pypi/pep8).
+
+Currently ``gplearn-CUDA`` uses [GitHub workflows](https://github.com/LGA-Personal/gplearn-CUDA/actions/workflows/build.yml)
+for testing, [Coveralls](https://coveralls.io/github/LGA-Personal/gplearn-CUDA)
+for code coverage reports, and [Codacy](https://app.codacy.com/gh/LGA-Personal/gplearn-CUDA/dashboard)
+for code quality checks. These applications should automatically run on your
+new pull request to give you guidance on any problems in the new code.

gplearn_cuda-0.4.3/LICENSE

@@ -0,0 +1,30 @@
+BSD 3-Clause License
+
+Copyright (c) 2015-2026, Trevor Stephens (Original Work)
+Copyright (c) 2026, LGA-Personal (CUDA Extension)
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of gplearn-CUDA nor the names of its
+  contributors may be used to endorse or promote products derived from
+  this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

gplearn_cuda-0.4.3/PKG-INFO

@@ -0,0 +1,111 @@
+Metadata-Version: 2.4
+Name: gplearn-CUDA
+Version: 0.4.3
+Summary: GPU-accelerated Genetic Programming in Python (CUDA extension of gplearn)
+Project-URL: homepage, https://github.com/LGA-Personal/gplearn-CUDA
+Project-URL: source, https://github.com/LGA-Personal/gplearn-CUDA
+Project-URL: tracker, https://github.com/LGA-Personal/gplearn-CUDA/issues
+Author-email: Trevor Stephens <trev.stephens@gmail.com>
+License-Expression: BSD-3-Clause
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: Unix
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Software Development
+Requires-Python: >=3.11
+Requires-Dist: joblib>=1.3.0
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: scikit-learn>=1.8.0
+Provides-Extra: cuda
+Requires-Dist: cupy-cuda12x>=13.0.0; extra == 'cuda'
+Description-Content-Type: text/x-rst
+
+.. image:: https://github.com/LGA-Personal/gplearn-CUDA/actions/workflows/build.yml/badge.svg
+    :target: https://github.com/LGA-Personal/gplearn-CUDA/actions/workflows/build.yml
+    :alt: Build Status
+.. image:: https://img.shields.io/github/v/release/LGA-Personal/gplearn-CUDA.svg
+    :target: https://github.com/LGA-Personal/gplearn-CUDA/releases
+    :alt: Version
+.. image:: https://img.shields.io/github/license/LGA-Personal/gplearn-CUDA.svg
+    :target: https://github.com/LGA-Personal/gplearn-CUDA/blob/main/LICENSE
+    :alt: License
+.. image:: https://readthedocs.org/projects/gplearn-cuda/badge/?version=stable
+    :target: http://gplearn-cuda.readthedocs.io/
+    :alt: Documentation Status
+
+|
+
+Welcome to gplearn-CUDA!
+========================
+
+`gplearn-CUDA` implements GPU-accelerated Genetic Programming in Python, with a 
+`scikit-learn <http://scikit-learn.org>`_ inspired and compatible API.
+
+**This project is a high-performance extension of the original** `gplearn <https://github.com/trevorstephens/gplearn>`_ 
+**library developed by Trevor Stephens.** It maintains all the original 
+functionality while introducing massive parallelization via NVIDIA CUDA.
+
+Overview
+--------
+
+While Genetic Programming (GP) can be used to perform a `very wide variety of tasks <http://www.genetic-programming.org/combined.php>`_, gplearn-CUDA is purposefully constrained to solving symbolic regression problems. This is motivated by the scikit-learn ethos, of having powerful estimators that are straight-forward to implement.
+
+Symbolic regression is a machine learning technique that aims to identify an underlying mathematical expression that best describes a relationship.
+
+CUDA Acceleration
+-----------------
+
+The core contribution of ``gplearn-CUDA`` is high-performance **GPU acceleration** 
+via NVIDIA CUDA. By setting ``device='cuda'``, the library utilizes a custom 
+virtual machine interpreter on the GPU to achieve **2x–4x speedups** on massive 
+datasets and large populations.
+
+.. code-block:: python
+
+    from gplearn.genetic import SymbolicRegressor
+    # Enable CUDA acceleration
+    est = SymbolicRegressor(device='cuda', population_size=5000)
+    est.fit(X, y)
+
+Installation
+------------
+
+``gplearn-CUDA`` requires a recent version of scikit-learn. The CUDA acceleration 
+is compatible with **CUDA 11.2 through 13.x**.
+
+To install the GPU-enabled version via pip (targeting CUDA 12.x by default)::
+
+    pip install gplearn-CUDA[cuda]
+
+For other CUDA versions or Conda installation, please see the 
+`Installation Guide <http://gplearn-cuda.readthedocs.io/en/stable/installation.html>`_.
+
+License & Credits
+-----------------
+
+``gplearn-CUDA`` is released under the **BSD 3-Clause License**, following the 
+licensing of the original project.
+
+*   Original Author: **Trevor Stephens** (`@trevorstephens <https://github.com/trevorstephens>`_)
+*   CUDA Extension: **LGA-Personal**
+
+For the latest development version, first get the source from github::
+
+    git clone https://github.com/LGA-Personal/gplearn-CUDA.git
+
+Then navigate into the local directory and simply run::
+
+    pip install .
+
+If you come across any issues in running or installing the package, `please submit a bug report <https://github.com/LGA-Personal/gplearn-CUDA/issues>`_.

gplearn_cuda-0.4.3/README.rst

@@ -0,0 +1,78 @@
+.. image:: https://github.com/LGA-Personal/gplearn-CUDA/actions/workflows/build.yml/badge.svg
+    :target: https://github.com/LGA-Personal/gplearn-CUDA/actions/workflows/build.yml
+    :alt: Build Status
+.. image:: https://img.shields.io/github/v/release/LGA-Personal/gplearn-CUDA.svg
+    :target: https://github.com/LGA-Personal/gplearn-CUDA/releases
+    :alt: Version
+.. image:: https://img.shields.io/github/license/LGA-Personal/gplearn-CUDA.svg
+    :target: https://github.com/LGA-Personal/gplearn-CUDA/blob/main/LICENSE
+    :alt: License
+.. image:: https://readthedocs.org/projects/gplearn-cuda/badge/?version=stable
+    :target: http://gplearn-cuda.readthedocs.io/
+    :alt: Documentation Status
+
+|
+
+Welcome to gplearn-CUDA!
+========================
+
+`gplearn-CUDA` implements GPU-accelerated Genetic Programming in Python, with a 
+`scikit-learn <http://scikit-learn.org>`_ inspired and compatible API.
+
+**This project is a high-performance extension of the original** `gplearn <https://github.com/trevorstephens/gplearn>`_ 
+**library developed by Trevor Stephens.** It maintains all the original 
+functionality while introducing massive parallelization via NVIDIA CUDA.
+
+Overview
+--------
+
+While Genetic Programming (GP) can be used to perform a `very wide variety of tasks <http://www.genetic-programming.org/combined.php>`_, gplearn-CUDA is purposefully constrained to solving symbolic regression problems. This is motivated by the scikit-learn ethos, of having powerful estimators that are straight-forward to implement.
+
+Symbolic regression is a machine learning technique that aims to identify an underlying mathematical expression that best describes a relationship.
+
+CUDA Acceleration
+-----------------
+
+The core contribution of ``gplearn-CUDA`` is high-performance **GPU acceleration** 
+via NVIDIA CUDA. By setting ``device='cuda'``, the library utilizes a custom 
+virtual machine interpreter on the GPU to achieve **2x–4x speedups** on massive 
+datasets and large populations.
+
+.. code-block:: python
+
+    from gplearn.genetic import SymbolicRegressor
+    # Enable CUDA acceleration
+    est = SymbolicRegressor(device='cuda', population_size=5000)
+    est.fit(X, y)
+
+Installation
+------------
+
+``gplearn-CUDA`` requires a recent version of scikit-learn. The CUDA acceleration 
+is compatible with **CUDA 11.2 through 13.x**.
+
+To install the GPU-enabled version via pip (targeting CUDA 12.x by default)::
+
+    pip install gplearn-CUDA[cuda]
+
+For other CUDA versions or Conda installation, please see the 
+`Installation Guide <http://gplearn-cuda.readthedocs.io/en/stable/installation.html>`_.
+
+License & Credits
+-----------------
+
+``gplearn-CUDA`` is released under the **BSD 3-Clause License**, following the 
+licensing of the original project.
+
+*   Original Author: **Trevor Stephens** (`@trevorstephens <https://github.com/trevorstephens>`_)
+*   CUDA Extension: **LGA-Personal**
+
+For the latest development version, first get the source from github::
+
+    git clone https://github.com/LGA-Personal/gplearn-CUDA.git
+
+Then navigate into the local directory and simply run::
+
+    pip install .
+
+If you come across any issues in running or installing the package, `please submit a bug report <https://github.com/LGA-Personal/gplearn-CUDA/issues>`_.