Skip to main content

A python module to access the CATIA Measurable object.

Project description

pycatia was primarily created to access the CATIA API Measurable object and it’s methods without the need of visual basic / CATScripts. There is further functionaliy available which can be seen by looking at the examples provided and reading the API at

Some of the methods can be accessed simply using the pywin32 module but further access to methods such as GetCOG do not seem to be accessible using pure python. There are several questions on stack overflow and the pywin32 mailing list regarding this. But, they fail to provide any working examples with the VB Measurable object in python.

pycatia accesses these methods by running VBA scripts using the Dispatch(‘CATIA.Application’).SystemService.Evaluate() function where required and passing a small public function to it. Otherwise, pycatia uses the VB method directly but exposes it within the same python class.

This has currently only been tested in CATIA V5 R21.


  • python >= 3.6
  • CATIA V5
  • see requirements.txt


with pip

pip install pycatia

For more detailed instructions please refer to the installation instructions available at


This example shows how to get the first point in the geometrical set ‘Points’.

# initial set-up to get access to the CATIA COM objects.
import pycatia
catia = pycatia.CATIAApplication()
document = pycatia.Document(catia.catia)
part = pycatia.Part(document.document)
spa_workbench = pycatia.create_spa_workbench(document.document)

# find the geometrical set by name called 'Points'
hybrid_body = part.get_hybrid_body_by_name('Points')

# get the first point in the geometrical set.
point1 = hybrid_body.HybridShapes.Item(1)

# create the reference and measurable objects
point1_reference = pycatia.create_reference(part.part, point1)
point1_measurable = pycatia.create_measurable(spa_workbench, point1_reference)

# create the catia measurable object
measurable = pycatia.CATIAMeasurable(point1_measurable)

# run the get_point() method from CATIAMeasurable.
point_coordinate = measurable.get_point()
# point_coordinate is a tuple representing it's x, y, z values.

# outputs (0.0, 8.0, -4.0)
# print x
# output 0,0


See the examples provided for more pycatia goodness.


  1. Open the file catia_measurable.CATPart from the folder tests.

  2. Run the example scripts.


    Shows how to access the CATIA COM object with a .CATPart open and get the center of gravity for the part body ‘PartBody’.


    Shows how to get all the points in the geometrical set ‘Points’ and get the co-ordinate.


    Shows how to search for all points in the document and return the co-ordinates.


    Shows how to loop through a product and determine whether child is a CATProduct or CATPart.


    Shows how to parse and csv file and create points in a CATIA part.


    Examples of how to open, save as and close a CATIA file.


    Example of how open a document using the context manager.

Running The Tests

To run the tests with coverage:

py.test -v --cov-report term-missing --cov=pycatia

Project details

Download files

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

Files for pycatia, version 0.1.1
Filename, size File type Python version Upload date Hashes
Filename, size pycatia-0.1.1-py3-none-any.whl (22.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size pycatia-0.1.1.tar.gz (19.1 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page