Moldflow API

Moldflow API is a Python wrapper library for the Synergy API, designed to simplify interactions with Autodesk Moldflow Synergy. This library provides a clean, pythonic interface to Moldflow's simulation capabilities, making it easier to integrate Moldflow functionality into your Python applications.

Prerequisites

Before you begin, ensure you have:

• Windows 10/11
• Python 3.10.x - 3.13.x
• Autodesk Moldflow Synergy 2026.0.1 or later

Install

python -m pip install moldflow

Quick Start

from moldflow import Synergy

# Initialize the API
synergy = Synergy()

# Example: Get version information
version = synergy.version
print(f"Moldflow Synergy version: {version}")

See the full documentation for more in-depth examples.

For Development

1. Clone the Repository

git clone https://github.com/Autodesk/moldflow-api.git

2. Navigate to the Repository

cd moldflow-api

3. Set Up Development Environment

python -m pip install -r requirements.txt
pre-commit install

Usage

Building the Package

python run.py build

Building the Documentation

python run.py build-docs

Options:

• --skip-build (-s): Skip building before generating docs

The documentation can be accessed locally by opening the index.html in the html folder.

Running the Formatter

python run.py format

Options:

• --check: Check the code formatting without making changes

Running Lint Checks

python run.py lint

Options:

• --skip-build (-s): Skip building before linting

Running Tests

python run.py test

Option	Alias	Description
<tests>...	-	Test files/directories path
--marker	-m	Marker [unit, integration, core]
--skip-build	-s	Skip building before testing
--keep-files	-k	Don't remove the .coverage files after testing [for report generation]
--unit	-	Run Unit Tests
--core	-	Run Core Functionality Tests
--integration	-	Run Integration Tests
--quiet	q	Simple test output

Flag Combinations

Flag Combination	Runs Unit	Runs Core	Runs Integration	Runs Custom Marker
Default (no flags)	✅	✅	❌	❌
--unit	✅	❌	❌	❌
--core	❌	✅	❌	❌
--integration	❌	❌	✅	❌
--unit --core	✅	✅	❌	❌
--unit --integration	✅	❌	✅	❌
--core --integration	❌	✅	✅	❌
--unit --core --integration	✅	✅	✅	❌
--all	✅	✅	✅	❌
--marker foo	❌	❌	❌	✅ (foo)
--unit --marker bar	✅	❌	❌	✅ (bar)
--integration --marker baz	❌	❌	✅	✅ (baz)

Running specific test files

python run.py test tests/api/unit_tests/test_unit_material_finder.py

API Documentation

For detailed API documentation, please visit our online documentation.

Key modules include:

• synergy: Main interface to Moldflow Synergy
• study_doc: Study document management
• mesh_editor: Mesh manipulation and analysis
• material_finder: Material database interactions
• plot: Results visualization

Contributing

We welcome contributions! Please see our Contributing Guide for details on how to contribute to this project. Here's a quick overview:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes
4. Run tests (python run.py test)
5. Commit your changes (git commit -m 'Add amazing feature')
6. Push to the branch (git push origin feature/amazing-feature)
7. Open a Pull Request

Versioning

We use Semantic Versioning. For available versions, see the tags on this repository.

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Support

• Documentation: Full documentation available online
• Issues: Report bugs and request features through GitHub Issues
• Security: For security issues, please see our Security Policy
• Discussions: Join our GitHub Discussions for questions and community support

Code of Conduct

This project adheres to the Contributor Covenant code of conduct. By participating, you are expected to uphold this code.