Skip to main content

Framework for the Ising model and QUBO.

Project description

OpenJij : Framework for the Ising model and QUBO.

PyPI version shields.io PyPI pyversions PyPI implementation PyPI format PyPI license PyPI download month Downloads

build-test Build Documentation CodeQL Codacy Badge Maintainability codecov

Coverage Graph

Sunburst Grid Icicle
  • python >= 3.7
  • (optional) gcc >= 7.0.0
  • (optional) cmake >= 3.22
  • (optional) Ninja

Change IMPORT

  • OpenJij >= v0.5.0

    import openjij.cxxjij
    
  • OpenJij <= v0.4.9

    import cxxjij
    
  • Documents

  • C++ Docs

install

install via pip

Note: To use GPGPU algorithms, please follow the section install via pip from source codes below. GPGPU algorithms are automatically enabled once CMake finds CUDA frameworks during installation.

# Binary
$ pip install openjij 
# From Source (CUDA)
$ pip install --no-binary=openjij,jij-cimod  openjij

install via pip from source codes

To install OpenJij from source codes, please install CMake first then install OpenJij.

cmake setup

If you want to use setup.py instead of PIP, You will need to install CMake>=3.22.
We are Highly recommended install CMake via PYPI.

$ pip install -U cmake

Make sure the enviroment path for CMake is set correctly.

install OpenJij

$ pip install --no-binary=openjij,jij-cimod openjij

install from github repository

$ git clone git@github.com:OpenJij/OpenJij.git
$ cd openjij
$ python -m pip install -vvv .

For Contributor

Use pre-commit for auto chech before git commit. .pre-commit-config.yaml

# pipx install pre-commit 
# or 
# pip install pre-commit
pre-commit install

Test

Python

$ python -m venv .venv
$ . .venv/bin/activate
$ pip install pip-tools 
$ pip-compile setup.cfg
$ pip-compile dev-requirements.in
$ pip-sync requirements.txt dev-requirements.txt
$ source .venv/bin/activate
$ export CMAKE_BUILD_TYPE=Debug
$ python setup.py --force-cmake install --build-type Debug -G Ninja
$ python setup.py --build-type Debug test 
$ python -m coverage html

C++

$ mkdir build 
$ cmake -DCMAKE_BUILD_TYPE=Debug -S . -B build
$ cmake --build build --parallel
$ cd build
$ ./tests/cxxjij_test
# Alternatively  Use CTest 
$ ctest --extra-verbose --parallel --schedule-random

Needs: CMake > 3.22, C++17

  • Format
$ pip-compile format-requirements.in
$ pip-sync format-requirements.txt
$ python -m isort 
$ python -m black 
  • Aggressive Format
$ python -m isort --force-single-line-imports --verbose ./openjij
$ python -m autoflake --in-place --recursive --remove-all-unused-imports --ignore-init-module-imports --remove-unused-variables ./openjij
$ python -m autopep8 --in-place --aggressive --aggressive  --recursive ./openjij
$ python -m isort ./openjij
$ python -m black ./openjij
  • Lint
$ pip-compile setup.cfg
$ pip-compile dev-requirements.in
$ pip-compile lint-requirements.in
$ pip-sync requirements.txt dev-requirements.txt lint-requirements.txt
$ python -m flake8
$ python -m mypy
$ python -m pyright

Python Documentation

Use Juyter Book for build documentation.
With KaTeX
Need: Graphviz

$ pip-compile setup.cfg
$ pip-compile build-requirements.in
$ pip-compile doc-requirements.in
$ pip-sync requirements.txt build-requirements.txt doc-requirements.txt

Please place your document to docs/tutorialeither markdown or jupyter notebook style.

$ pip install -vvv .
$ jupyter-book build docs --all

How to use

Python example

import openjij as oj
sampler = oj.SASampler()
response = sampler.sample_ising(h={0: -1}, J={(0,1): -1})
response.states
# [[1,1]]

# with indices
response = sampler.sample_ising(h={'a': -1}, J={('a','b'): 1})
[{index: s for index, s in zip(response.indices, state)} for state in response.states]
# [{'b': -1, 'a': 1}]

Community

About us

This product is maintained by Jij Inc.

Please visit our website for more information! https://www.j-ij.com/

Licences

Copyright 2022 Jij Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

 http://www.apache.org/licenses/LICENSE-2.0  

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

openjij-0.5.40.tar.gz (86.5 kB view hashes)

Uploaded Source

Built Distributions

openjij-0.5.40-cp310-cp310-win_amd64.whl (743.6 kB view hashes)

Uploaded CPython 3.10 Windows x86-64

openjij-0.5.40-cp310-cp310-manylinux_2_28_x86_64.whl (12.6 MB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.28+ x86-64

openjij-0.5.40-cp310-cp310-manylinux_2_28_aarch64.whl (3.1 MB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.28+ ARM64

openjij-0.5.40-cp310-cp310-macosx_12_0_x86_64.whl (562.4 kB view hashes)

Uploaded CPython 3.10 macOS 12.0+ x86-64

openjij-0.5.40-cp310-cp310-macosx_11_0_x86_64.whl (554.0 kB view hashes)

Uploaded CPython 3.10 macOS 11.0+ x86-64

openjij-0.5.40-cp310-cp310-macosx_11_0_arm64.whl (489.7 kB view hashes)

Uploaded CPython 3.10 macOS 11.0+ ARM64

openjij-0.5.40-cp310-cp310-macosx_10_16_x86_64.whl (554.0 kB view hashes)

Uploaded CPython 3.10 macOS 10.16+ x86-64

openjij-0.5.40-cp39-cp39-win_amd64.whl (742.8 kB view hashes)

Uploaded CPython 3.9 Windows x86-64

openjij-0.5.40-cp39-cp39-manylinux_2_28_x86_64.whl (12.6 MB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.28+ x86-64

openjij-0.5.40-cp39-cp39-manylinux_2_28_aarch64.whl (3.1 MB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.28+ ARM64

openjij-0.5.40-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (12.6 MB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.17+ x86-64

openjij-0.5.40-cp39-cp39-macosx_12_0_x86_64.whl (561.8 kB view hashes)

Uploaded CPython 3.9 macOS 12.0+ x86-64

openjij-0.5.40-cp39-cp39-macosx_11_0_x86_64.whl (553.3 kB view hashes)

Uploaded CPython 3.9 macOS 11.0+ x86-64

openjij-0.5.40-cp39-cp39-macosx_11_0_arm64.whl (489.1 kB view hashes)

Uploaded CPython 3.9 macOS 11.0+ ARM64

openjij-0.5.40-cp39-cp39-macosx_10_16_x86_64.whl (553.3 kB view hashes)

Uploaded CPython 3.9 macOS 10.16+ x86-64

openjij-0.5.40-cp38-cp38-win_amd64.whl (743.2 kB view hashes)

Uploaded CPython 3.8 Windows x86-64

openjij-0.5.40-cp38-cp38-manylinux_2_28_x86_64.whl (12.6 MB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.28+ x86-64

openjij-0.5.40-cp38-cp38-manylinux_2_28_aarch64.whl (3.1 MB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.28+ ARM64

openjij-0.5.40-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (12.6 MB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.17+ x86-64

openjij-0.5.40-cp38-cp38-macosx_12_0_x86_64.whl (562.0 kB view hashes)

Uploaded CPython 3.8 macOS 12.0+ x86-64

openjij-0.5.40-cp38-cp38-macosx_11_0_x86_64.whl (553.4 kB view hashes)

Uploaded CPython 3.8 macOS 11.0+ x86-64

openjij-0.5.40-cp38-cp38-macosx_11_0_arm64.whl (489.1 kB view hashes)

Uploaded CPython 3.8 macOS 11.0+ ARM64

openjij-0.5.40-cp38-cp38-macosx_10_16_x86_64.whl (553.4 kB view hashes)

Uploaded CPython 3.8 macOS 10.16+ x86-64

openjij-0.5.40-cp37-cp37m-win_amd64.whl (757.2 kB view hashes)

Uploaded CPython 3.7m Windows x86-64

openjij-0.5.40-cp37-cp37m-manylinux_2_28_x86_64.whl (12.6 MB view hashes)

Uploaded CPython 3.7m manylinux: glibc 2.28+ x86-64

openjij-0.5.40-cp37-cp37m-manylinux_2_28_aarch64.whl (3.1 MB view hashes)

Uploaded CPython 3.7m manylinux: glibc 2.28+ ARM64

openjij-0.5.40-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (12.6 MB view hashes)

Uploaded CPython 3.7m manylinux: glibc 2.17+ x86-64

openjij-0.5.40-cp37-cp37m-macosx_12_0_x86_64.whl (555.1 kB view hashes)

Uploaded CPython 3.7m macOS 12.0+ x86-64

openjij-0.5.40-cp37-cp37m-macosx_11_0_x86_64.whl (546.5 kB view hashes)

Uploaded CPython 3.7m macOS 11.0+ x86-64

openjij-0.5.40-cp37-cp37m-macosx_10_16_x86_64.whl (546.5 kB view hashes)

Uploaded CPython 3.7m macOS 10.16+ x86-64

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page