ansys-acp-core

A Python client for Ansys Composite PrepPost (ACP).

Installation

Install PyACP with:

pip install ansys-acp-core[all]

For installing PyACP in development mode, see the Development Setup instructions below.

Documentation

The PyACP documentation can be viewed online at https://acp.docs.pyansys.com.

Getting Started

Launching ACP

The ACP server can be started with launch_acp:

import ansys.acp.core as pyacp

acp = pyacp.launch_acp()

Basic Usage

Once the server is running, we can start working with PyACP. For example, to load an ACP Model from an existing file:

>>> remote_path = acp.upload_file(local_path="<MODEL_PATH>")
>>> model = acp.import_model(path=remote_path)
>>> model.name
'ACP Model'

Development Setup

Installation

Installing PyACP in developer mode allows you to modify the source and enhance it. Before contributing to the project, please refer to the PyAnsys Developer’s guide.

You will need to follow these steps:

Start by cloning this repository, and entering the newly created directory:
```
git clone https://github.com/ansys/pyacp
cd pyacp
```
Make sure you have the latest version of uv, using one of the methods described at https://docs.astral.sh/uv/getting-started/installation/.

Note

At this point, you may need to restart your shell or editor to ensure that the new uv command is available.

4. Install the project and all its development dependencies using uv. This also takes care of creating a new virtual environment:
```
uv sync --all-groups --all-extras
```
This step installs PyACP in an editable mode (no build step is needed, no re-install when changing the code).

Activate your development virtual environment with:
```
source .venv/bin/activate
```
On Windows PowerShell:
```
.venv\Scripts\Activate.ps1
```

Testing

The PyACP test suite uses pytest. You can run it with

pytest --license-server=<YOUR_LICENSE_SERVER> tests/unittests

Benchmarking

As part of the test suite, we run some performance benchmarks. These can be run with

pytest --license-server=<YOUR_LICENSE_SERVER> tests/benchmarks

Additional options can be found in the pytest-benchmark documentation.

NOTE: The benchmarks use the tc-netem Linux kernel module to simulate a slow network connection within a Docker container. This is available only on Linux, not on Docker for MacOS or Windows.

The benchmark results from the main branch are uploaded to https://acp.docs.pyansys.com/benchmarks.

Pre-commit hooks

Style and linter checks are run through the pre-commit tool. You can run these checks with

pre-commit run --all-files

We also recommend installing pre-commit into your repository:

pre-commit install

This will run the pre-commit hooks on the changed files before every git commit. If you ever need to create a commit without running the hooks, you can skip them with git commit -n.

Documentation

Basic documentation build

To build the documentation, run the following commands:

On Linux & MacOS:

make -C doc html

On Windows:

cd doc; .\make.bat html

The generated HTML files can be viewed with the browser of your choice.

This method of building the documentation will run the examples with the default or currently configured launch options for the ACP, MAPDL, and DPF servers. Make sure to have these installed and configured correctly, or alternatively follow the Docker-based instructions below.

Alternative: start services with docker

Alternatively, you can use the provided docker-compose file to start the MAPDL and DPF servers.

First, review the DPF preview license agreement, and if you agree, set the ANSYS_DPF_ACCEPT_LA environment variable to Y. See the PyDPF documentation for details.

On Windows, you can then use the shipped shell script:

.\doc\create_doc_windows.ps1

The following manual steps can be used on any platform:

Set the following additional environment variables in your shell:
- ANSYSLMD_LICENSE_FILE: To a valid license server (e.g 1055@mylicenseserver.com).
- PYMAPDL_PORT: Choose any free port.
- PYMAPDL_START_INSTANCE=FALSE
- PYDPF_COMPOSITES_DOCKER_CONTAINER_PORT: Choose any free port.

Start the docker containers with:

docker compose -f docker-compose/docker-compose-extras.yaml up -d

Build the documentation with the Sphinx commands mentioned above:

On Linux & MacOS:
```
make -C doc html
```
On Windows:
```
cd doc; .\make.bat html
```

Partial builds

Two environment variables can be used to run a quicker partial documentation build:

PYACP_DOC_SKIP_API=1: Skip the API reference build.
PYACP_DOC_SKIP_GALLERY=1: Skip running the examples.

Distribution

The following commands can be used to build and check the PyACP package:

uv build
twine check dist/*

This creates both a source distribution, and a wheel file. An alternative is

pip install build
python -m build --wheel

License

PyACP is licensed under the MIT license. Please see the LICENSE for more details.

Download files

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

Source Distribution

ansys_acp_core-0.4.1.tar.gz (130.0 kB view details)

Uploaded Sep 10, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

ansys_acp_core-0.4.1-py3-none-any.whl (278.1 kB view details)

Uploaded Sep 10, 2026 Python 3

File details

Details for the file ansys_acp_core-0.4.1.tar.gz.

File metadata

Download URL: ansys_acp_core-0.4.1.tar.gz
Upload date: Sep 10, 2026
Size: 130.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for ansys_acp_core-0.4.1.tar.gz
Algorithm	Hash digest
SHA256	`8bbc783f7fab359b3f39e1ea2e262db6ef052183289bf4122fb442674b05512d`
MD5	`d83ef7da51a7b303d6a1bf7f70cc1c07`
BLAKE2b-256	`5ddc1bb751d0469da0b1a8d5743c05c4d1ceeaa0a3e87ae01e05e64f5473bd0a`

See more details on using hashes here.

Provenance

The following attestation bundles were made for ansys_acp_core-0.4.1.tar.gz:

Publisher: ci_cd.yml on ansys/pyacp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: ansys_acp_core-0.4.1.tar.gz
- Subject digest: 8bbc783f7fab359b3f39e1ea2e262db6ef052183289bf4122fb442674b05512d
- Sigstore transparency entry: 2784628761
- Sigstore integration time: Sep 10, 2026
Source repository:
- Permalink: ansys/pyacp@52951d285356c977cb2572f0a3507146fb764878
- Branch / Tag: refs/tags/v0.4.1
- Owner: https://github.com/ansys
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: ci_cd.yml@52951d285356c977cb2572f0a3507146fb764878
- Trigger Event: push