Centrifugal Compressor Performance

ccp is a python library for calculation of centrifugal compressor performance. It uses CoolProp/REFPROP for the gas properties calculations.

import ccp

# ccp uses pint to handle units. Q_ is a pint quantity.
# If a pint quantity is not provided, SI units are assumed.
Q_ = ccp.Q_
ps = Q_(3, 'bar')
Ts = 300

# Define the fluid as a dictionary:
fluid = {
    "CarbonDioxide": 0.8,
    "Nitrogen": 0.2,
}

# Define suction and discharge states:

suc0 = ccp.State(fluid=fluid, p=ps, T=Ts)
disch0 = ccp.State(fluid=fluid, p=Q_(7.255, 'bar'), T=391.1)
disch1 = ccp.State(fluid=fluid, p=Q_(6.754, 'bar'), T=382.1)

# Create performance point(s):

point0 = ccp.Point(
    suc=suc0,
    disch=disch0,
    speed=Q_(7941, 'RPM'),
    flow_m=Q_(34203.6, 'kg/hr'),
    b=0.0285,
    D=0.365,
)
point1 = ccp.Point(
    suc=suc0,
    disch=disch1,
    speed=Q_(7941, 'RPM'),
    flow_m=Q_(36204.8, 'kg/hr'),
    b=0.0285,
    D=0.365,
)

# Create an impeller with those points:

imp = ccp.Impeller([point0, point1])

# Get results from the Impeller with methods such as
imp.head_plot()
imp.disch.T_plot()

Installation

Install ccp with:

pip install ccp-performance

If you work with an AI coding agent (Claude Code, GitHub Copilot, Cursor, Codex), install the ccp agent skill so your agent knows how to build states, points and impellers and run performance analyses:

ccp-install-skill

The skill activates automatically whenever you ask your agent about centrifugal compressor performance with ccp. In Claude Code you can also invoke it explicitly:

/ccp create an impeller from these test points and convert the curves to the new suction condition

Documentation

Access the documentation here.

Questions

If you have any questions, you can use the Discussions area in the repository.

Contributing to ccp

ccp is a community-driven project. If you want to contribute to the project, please check CONTRIBUTING.md.

Metadata

Release files for ccp-performance 0.4.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 ccp-performance 0.4.1
File	Size	Uploaded
ccp_performance-0.4.1.tar.gz	7.8 MB	Sep 9, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for ccp-performance 0.4.1
File	Interpreter	ABI	Platform	Reset
ccp_performance-0.4.1-py3-none-any.whl 7.8 MB Sep 9, 2026	Python 3	none	any	Details

Total release size: 15.6 MB

Release files / ccp_performance-0.4.1.tar.gz

Download URL	ccp_performance-0.4.1.tar.gz
Size	7.8 MB
Tags	Source
SHA-256 checksum How to use checksums	`b6a58c260bfc89e26fd3332f9942245d263c427816e39139343450137cca571a`
BLAKE2b-256 checksum How to use checksums	`eaadef13ff41d4a61c63a1af976c47100f33acf842fb5d7900b632c238341b28`
Upload date	Sep 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / ccp_performance-0.4.1-py3-none-any.whl

Download URL	ccp_performance-0.4.1-py3-none-any.whl
Size	7.8 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`e4b4e356e4e116cb58b7dee292897c040aa9f0f50b600b40f3c1463da0394ff8`
BLAKE2b-256 checksum How to use checksums	`cbb0f4aae67716a6f072a30da5d1a44dffc9792008880ec15a050e94d2b992af`
Upload date	Sep 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`