Skip to main content

ccp4i2

ccp4i2 is the Python backend of CCP4i2 — the graphical interface and scripting environment for the CCP4 macromolecular crystallography suite. This is the Django/Qt-free generation of CCP4i2: a REST API, a task/pipeline framework, and the data-management core that drive the CCP4i2 desktop (Electron/React) and web deployments.

CCP4-free control plane

The control plane — the REST API, task configuration, parameter validation, and the container/digest machinery — imports and runs on a stock Python with no CCP4 installation. Only actual job execution (running Refmac, Phaser, Servalcat, …) needs the full CCP4 suite, and that always happens out-of-process on a CCP4-bearing worker.

In practice that means you can pip install ccp4i2 into a plain virtual environment to configure and validate tasks, serve the API, and drive the frontend; the crystallographic binaries and their toolkits (clipper, iotbx, mmtbx, ccp4mg, phaser, dials, xia2, …) are supplied by CCP4 at execution time and are deliberately not pip dependencies.

Installation

pip install ccp4i2

Optional extras:

pip install ccp4i2[science]   # rdkit, scipy, pandas — fuller local execution
pip install ccp4i2[dev]       # test/lint toolchain (pytest, mypy, black, …)

ccp4i2 depends on the shared ccp4i2-api library (authentication + DRF integration), which is installed automatically.

Note — demo_data (the ~400 MB of example datasets used by the test/demo workflows) is not bundled in the package; it is distributed out-of-band.

Running

export DJANGO_SETTINGS_MODULE=ccp4i2.config.settings

# i2run — run a task from the command line
i2run <task> --project_name <proj> [--PARAM value ...]

# development server
python -m uvicorn ccp4i2.config.asgi:application

Links

Licence

LGPL-3.0. See the repository for full licensing details.

Release files for ccp4i2 3.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ccp4i2 3.0.1
File Size Uploaded
ccp4i2-3.0.1.tar.gz 21.7 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for ccp4i2 3.0.1
File Interpreter ABI Platform
ccp4i2-3.0.1-py3-none-any.whl Python 3 none any Details

Total release size: 44.0 MB

Release files / ccp4i2-3.0.1.tar.gz

Download URL ccp4i2-3.0.1.tar.gz
Size 21.7 MB
Tags Source
SHA-256 checksum
How to use checksums
59e69d4aaf999329df8a11684e996d928caa649825040f16e6e5de7b027e6438
BLAKE2b-256 checksum
How to use checksums
8d6c5d55210b55da1bbcbdf33896e24aea988c04b28d3798b70191b847184aa9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.2

Release files / ccp4i2-3.0.1-py3-none-any.whl

Download URL ccp4i2-3.0.1-py3-none-any.whl
Size 22.3 MB
Tags Python 3
SHA-256 checksum
How to use checksums
bc3eed38dbd05bc99db155ec379173dc088ae4b4fe9df8136e1f1d6743000dc3
BLAKE2b-256 checksum
How to use checksums
a7df0e477cc1b1b706314083ca9faf269a53af229b683c5929566e9ac21adf46
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.2

Release history Release notifications | RSS feed

This release

3.0.1 This release

2 release files

3.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page