This Docker image code sample demonstrates how to install the STK Engine for Linux Python API in a containerized environment.

• Docker must be running on your system.
• Access to an Ansys Licensing Server with a valid STK license. Edit the licensing.env file to ensure the ANSYSLMD_LICENSE_FILE environment variable has your Ansys License Server information.
• You have already built the stk-engine-baseline image.

This image is built using the yum and pip tools to install package dependencies. Please see the custom-environment Docker image code sample project and build the ansys/stk/stk-engine-custom-baseline:{version}-centos7 image, if needed, before proceeding with this image.

If you did not build the custom-environment image described above, run docker build -t ansys/stk/stk-engine-python:{version}-centos7 . on the command line in this directory after replacing {version} with the version number. i.e 12.6.0

If you did build the custom-environment image described above, run docker build -t ansys/stk/stk-engine-python:{version}-centos7 --build-arg baseImage=ansys/stk/stk-engine-custom-baseline:{version}-centos7 . on the command line in this directory after replacing {version} with the version number. i.e 12.6.0

This image starts the python3 interpreter when starting the container. You can verify that STK Engine is working inside the stk-engine-python container with the following steps:

1. Run the following command from this directory after replacing {version} with the version number. i.e 12.6.0: docker run -it --env-file ../configuration/licensing.env --name stk-python --rm ansys/stk/stk-engine-python:{version}-centos7
2. Execute the following Python commands and verify it returns a valid response:

   from agi.stk12.stkengine import STKEngine
   stk = STKEngine.StartApplication(noGraphics=True)
   print(stk.Version)

3. Quit the Python interpreter and the container by executing the command quit()

1. If you built the custom-environment images described in the Special Configuration section, edit the docker-compose.yml file to set the value of the baseImage build argument to ansys/stk/stk-engine-custom-baseline:{version}-centos7 after replacing {version} with the version number. i.e 12.6.0
2. Run docker compose build on the command line in this directory.

This image starts the python3 interpreter when starting the container. You can verify that STK Engine is working inside the stk-engine-python container with the following steps:

1. On the command line, run docker compose run --rm stk-engine-python.
2. Execute the following Python commands and verify it returns a valid response:

   from agi.stk12.stkengine import STKEngine
   stk = STKEngine.StartApplication(noGraphics=True)
   print(stk.Version)

3. Quit the Python interpreter and the container by executing the command quit()