quantumHams

KO | EN

gitlite — search

#cross-platform #artificial-intelligence #monitoring #json #api #postgresql #data-science #sql #privacy #cpp

(★ 9)

A Python library containing code for rubidium neutral atom and ytterbium trapped íons quantum computer hamiltonian. This lib has support to run the hamiltonians with CudaQ.

파일 탐색기

ZIP 다운로드

- - bug_report.yml
- - ci.yml
  - codeql.yml
  - docs.yml
  - release.yml
- dependabot.yml
- pull_request_template.md
- extending.md
- index.md
- usage.md
- bell_state.py
- - __init__.py
  - py.typed
- test_backends.py
- test_cudaq_backend.py
- test_neutral_atoms.py
- test_pauli.py
- test_states.py
- test_trapped_ions.py
.gitignore
.pre-commit-config.yaml
CHANGELOG.md
CODE_OF_CONDUCT.md
CONTRIBUTING.md
LICENSE
mkdocs.yml
NOTICE
pyproject.toml
README.md
SECURITY.md

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

# 프로젝트 배지

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

**quantumHams** is an extensible Python library for constructing and simulating Hamiltonians from different quantum-computing technologies. The first models cover:

- rubidium Rydberg neutral-atom arrays;
- ytterbium trapped-ion effective Ising/Mølmer–Sørensen systems.

The core implementation runs with NumPy/SciPy on CPU. When CUDA-Q is installed, quantumHams performs native GPU-accelerated time evolution through the CUDA-Q Dynamics target; otherwise it automatically falls back to SciPy.

## Installation

The Python import is `quantumhams`.

```bash
pip install quantumhams
```

Optional CUDA-Q integration on a supported Linux x86-64 environment:

```bash
pip install "quantumhams[cudaq]"
```

For development:

```bash
git clone https://github.com/venturusbr/quantumHams.git
cd quantumHams
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev,docs]"
pre-commit install
pytest
```

## Examples

### Neutral-atom Bell state

```python
import numpy as np

from quantumhams import NeutralAtomRegister, RubidiumRydbergHamiltonian

omega = 2.0 * np.pi
register = NeutralAtomRegister.linear(n_atoms=2, spacing=1.0)
model = RubidiumRydbergHamiltonian(
    atom_register=register,
    rabi_frequency=omega,
    detuning=0.0,
    c6=100.0 * omega,
)

times = np.linspace(0.0, np.pi / (np.sqrt(2.0) * omega), 101)
result = model.evolve(initial_state="00", times=times)

# Under Rydberg blockade, the final state approaches
# (|01> + |10>) / sqrt(2).
print(result.states[-1])
print(result.probabilities[-1])
```

### Trapped-ion Bell state

```python
import numpy as np

from quantumhams import YtterbiumIonChain, YtterbiumMolmerSorensenHamiltonian

coupling = 2.0 * np.pi
chain = YtterbiumIonChain.linear(n_ions=2, spacing=1.0)
model = YtterbiumMolmerSorensenHamiltonian.power_law(
    chain=chain,
    coupling=coupling,
    exponent=0.0,
    transverse_field=0.0,
)

times = np.linspace(0.0, np.pi / (4.0 * coupling), 101)
result = model.evolve(initial_state="00", times=times)

# The final state approaches (|00> - i|11>) / sqrt(2).
print(result.states[-1])
print(result.probabilities[-1])
```

The complete example supports both technologies and explicit CPU, GPU, or
automatic backend selection:

```bash
python examples/bell_state.py --technology neutral-atom --compute cpu
python examples/bell_state.py --technology trapped-ion --compute auto
```

## Backend selection

```python
from quantumhams.backends import backend_status, get_backend

print(backend_status())
backend = get_backend("auto")  # CUDA-Q when available, otherwise SciPy
```

With `backend="auto"` (the default), quantumHams first attempts native CUDA-Q Dynamics evolution and falls back to SciPy with a warning if CUDA-Q or a compatible GPU runtime is unavailable. Use `backend="cudaq"` to require CUDA-Q or `backend="scipy"` to force CPU execution.

## Extending quantumHams

Add a model by implementing `HamiltonianModel` and returning a `PauliHamiltonian` from `pauli_hamiltonian()`. This separates physics models from execution backends, making new technologies and accelerators independently pluggable.

See `docs/extending.md` and `CONTRIBUTING.md`.

## Governance and attribution

Author: **Daniel de Haro Moraes**  
Company: **Venturus**

Licensed under Apache License 2.0.

quantumHams

오너의 다른 레포

파일 탐색기

# CDN으로 사용하기

# 프로젝트 배지

Was this content helpful?

Recent Feedback

quantumHams

오너의 다른 레포

파일 탐색기

# CDN으로 사용하기

# 프로젝트 배지

Was this content helpful?

Recent Feedback

Download README