# PyAnsys V23 - SpaceClaim API Virtual Library
**PyAnsysV23** is a virtual/mock Python library that provides a comprehensive API for working with ANSYS SpaceClaim V23. This library enables developers to write and test SpaceClaim automation scripts without having SpaceClaim installed, and serves as an excellent learning resource for the SpaceClaim API.
## Features
### Core Modules
- **`geometry`** - 3D geometric primitives (Point, Vector, Plane, Matrix transformations)
- **`modeler`** - 3D body creation and manipulation (boxes, spheres, cylinders, cones)
- **`document`** - Document, part, and assembly management
- **`annotation`** - Annotations including notes, symbols, and barcodes
- **`analysis`** - FEA mesh and analysis functionality
- **`instance`** - Component instances and occurrences
- **`extensibility`** - Add-in development framework
- **`core`** - Command system, write blocks, and application control
### Key Classes
#### Geometry (`pyansysv23.geometry`)
```python
Point # 3D point representation
Vector # 3D vector with operations (dot, cross, normalize)
Plane # Infinite plane in 3D space
Matrix # 4x4 transformation matrices
Geometry # Utility class for geometric operations
```
#### Modeler (`pyansysv23.modeler`)
```python
Body # CAD body (solid or surface)
DesignBody # High-level body abstraction
Face, Edge, Vertex # Topological elements
Modeler # Factory for creating primitives
```
#### Document (`pyansysv23.document`)
```python
Document # SpaceClaim document
Part # CAD part
Assembly # Component assembly
DrawingSheet # Drawing/annotation sheet
DatumPlane # Reference plane
```
#### Annotation (`pyansysv23.annotation`)
```python
Note # Text annotations
Barcode # Barcode annotations (supports multiple types)
Symbol # Symbol annotations
Table # Table annotations
BarcodeType # Enum: Code39, EAN13, QRCode, DataMatrix, etc.
```
#### Analysis (`pyansysv23.analysis`)
```python
BodyMesh # Mesh on a body
PartMesh # Mesh on a part
AssemblyMesh # Mesh on an assembly
MeshNode # Individual mesh node
VolumeElement # Volume mesh element
FaceElement # Face mesh element
EdgeElement # Edge mesh element
HexaBlocking # Hexahedral mesh blocking
AnalysisAspect # Analysis tools
```
#### Extensibility (`pyansysv23.extensibility`)
```python
AddIn # Base class for all add-ins
CommandCapsule # Base class for command implementations
IExtensibility # Add-in interface
ICommandExtensibility # Command extension interface
IRibbonExtensibility # Ribbon customization interface
```
#### Core (`pyansysv23.core`)
```python
Command # SpaceClaim command
WriteBlock # Transaction/write operation
Application # Application singleton
Window # Application window
```
## Installation
```bash
pip install -e .
```
Or simply copy the `pyansysv23` directory to your Python project.
## Quick Start
### 1. Create Geometric Primitives
```python
from pyansysv23.geometry import Point, Vector
from pyansysv23.modeler import Modeler
# Create a box
box = Modeler.create_box(Point(0, 0, 0), length=1, width=1, height=1)
print(f"Box volume: {box.master.volume}")
# Create a sphere
sphere = Modeler.create_sphere(Point(2, 0, 0), radius=0.5)
# Create vectors and perform operations
v1 = Vector(1, 0, 0)
v2 = Vector(0, 1, 0)
cross_product = v1.cross(v2)
```
### 2. Work with Documents and Parts
```python
from pyansysv23.document import Document, Part
# Create a document
doc = Document("MyDesign.scdoc")
# Create a part
part = Part("Part1")
# Add bodies
part.add_design_body(box)
part.add_design_body(sphere)
# Add to document and save
doc.add_part(part)
doc.save("C:\\designs\\MyDesign.scdoc")
```
### 3. Create Annotations
```python
from pyansysv23.annotation import Note, Barcode, BarcodeType
from pyansysv23.geometry import PointUV
from pyansysv23.document import DrawingSheet
# Create a drawing sheet
sheet = DrawingSheet("Drawing1")
# Add a note
note = Note(sheet, "Important Note", PointUV(0.1, 0.1))
# Add a QR code barcode
qr = Barcode.create(sheet, PointUV(0.2, 0.2), BarcodeType.QRCode, "https://example.com")
```
### 4. Create Commands
```python
from pyansysv23.core import Command, WriteBlock
# Create a command
cmd = Command.create("MyAddIn.MyCommand", "My Command", "Execute my command")
# Add event handlers
def on_execute(context):
print("Command executed!")
cmd.add_executing_handler(on_execute)
# Execute within a write block
def my_operation():
print("Performing modifications...")
WriteBlock.ExecuteTask("My Operation", my_operation)
```
### 5. Develop an Add-in
```python
from pyansysv23.extensibility import AddIn, ICommandExtensibility, IRibbonExtensibility
from pyansysv23.core import Command
class MySpaceClaimAddIn(AddIn, ICommandExtensibility, IRibbonExtensibility):
def connect(self) -> bool:
print("Add-in loaded")
return True
def disconnect(self) -> None:
print("Add-in unloaded")
def initialize(self) -> None:
cmd = Command.create("MyAddIn.CreateBox")
cmd.text = "Create Box"
def get_custom_ui(self) -> str:
return '''<?xml version="1.0"?>
<customUI xmlns="http://schemas.spaceclaim.com/customui">
<ribbon>
<tabs>
<tab id="MyAddIn.Tab" label="My Add-In">
<group id="MyAddIn.Group" label="Geometry">
<button id="MyAddIn.CreateBox" command="MyAddIn.CreateBox"/>
</group>
</tab>
</tabs>
</ribbon>
</customUI>'''
# Use the add-in
addin = MySpaceClaimAddIn()
addin.connect()
addin.initialize()
```
### 6. Mesh Operations
```python
from pyansysv23.analysis import MeshBodySettings, BodyMesh, MeshNode, HexaBlocking
# Create mesh settings
mesh_settings = MeshBodySettings.create(box)
mesh_settings.element_size = 0.01
# Create and populate body mesh
body_mesh = BodyMesh(box)
node = MeshNode(0, Point(0, 0, 0))
body_mesh.nodes.append(node)
# Use hexahedral blocking
hexa = HexaBlocking()
success, error = hexa.process_command_with_error("HEXA QUADS 100")
```
## API Structure
```
pyansysv23/
├── __init__.py # Package initialization and exports
├── geometry.py # Geometric primitives
├── modeler.py # 3D modeling operations
├── document.py # Document management
├── annotation.py # Annotations
├── analysis.py # Analysis and meshing
├── instance.py # Instances and components
├── extensibility.py # Add-in framework
└── core.py # Core commands and application
```
## Usage Examples
See `examples.py` for comprehensive examples including:
- Creating geometric primitives
- Document and part management
- Command creation and execution
- Annotation operations
- Mesh operations
- Add-in development
Run examples:
```bash
python examples.py
```
## Documentation
This library is designed to closely match the official SpaceClaim API. Reference documentation:
- `API_Class_Library.chm` - Complete API reference
- `Developers Guide.pdf` - Development guide
- `Building Sample Add-Ins.pdf` - Add-in examples
## Testing
```python
# Test geometry operations
from pyansysv23.geometry import Point, Vector
p1 = Point(0, 0, 0)
p2 = Point(1, 1, 1)
distance = p1.distance_to(p2)
assert abs(distance - 1.732050808) < 0.0001
# Test vector operations
v = Vector(3, 4, 0)
assert abs(v.magnitude() - 5.0) < 0.0001
```
## Supported Barcode Types
- Code25, Code25Interleaved
- Code39, Code93, Code11
- Code128 (A, B, C variants)
- EAN (8, 13, 14, 128)
- UPC (A, E)
- ISBN, ISMN, ISSN
- LOGMARS, VIN
- QR Code, Data Matrix, PDF417, Aztec
## Notes
This is a **virtual/mock library** intended for:
- Learning the SpaceClaim API
- Offline development and testing
- Script validation and preview
- Documentation reference
For production SpaceClaim automation, use the actual SpaceClaim API available through:
- SpaceClaim SDK (includes `SpaceClaim.Api.V23.dll`)
- Official Python add-in examples
- SpaceClaim IronPython scripting environment
## License
This is a learning/reference implementation. SpaceClaim is a product of ANSYS.
## Compatibility
- **Python**: 3.7+
- **Platform**: Windows (reflects SpaceClaim platform)
- **API Version**: V23
## Contributing
Feel free to extend this library with additional functionality based on the SpaceClaim API documentation.
## See Also
- SpaceClaim API Documentation
- ANSYS SpaceClaim Official Website
- PyAnsys Project
---
**Disclaimer**: This is a virtual/educational library. It does not interface with actual SpaceClaim installations. For real SpaceClaim automation, use the official SpaceClaim SDK.
Raw data
{
"_id": null,
"home_page": "https://github.com/pyansys/pyansysv23",
"name": "PyAnsysV23",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "ansys, spaceclaim, cad, api, modeling, geometry, 3d, mechanical, simulation",
"author": "PyAnsys Contributors",
"author_email": "PyAnsys Contributors <contact@pyansys.dev>",
"download_url": "https://files.pythonhosted.org/packages/6a/97/a540bfb08b4d740bb8f3c5407f0c4d0fe6c331b30de340d39cb4a6d20a23/pyansysv23-0.23.0.tar.gz",
"platform": null,
"description": "# PyAnsys V23 - SpaceClaim API Virtual Library\r\n\r\n**PyAnsysV23** is a virtual/mock Python library that provides a comprehensive API for working with ANSYS SpaceClaim V23. This library enables developers to write and test SpaceClaim automation scripts without having SpaceClaim installed, and serves as an excellent learning resource for the SpaceClaim API.\r\n\r\n## Features\r\n\r\n### Core Modules\r\n\r\n- **`geometry`** - 3D geometric primitives (Point, Vector, Plane, Matrix transformations)\r\n- **`modeler`** - 3D body creation and manipulation (boxes, spheres, cylinders, cones)\r\n- **`document`** - Document, part, and assembly management\r\n- **`annotation`** - Annotations including notes, symbols, and barcodes\r\n- **`analysis`** - FEA mesh and analysis functionality\r\n- **`instance`** - Component instances and occurrences\r\n- **`extensibility`** - Add-in development framework\r\n- **`core`** - Command system, write blocks, and application control\r\n\r\n### Key Classes\r\n\r\n#### Geometry (`pyansysv23.geometry`)\r\n```python\r\nPoint # 3D point representation\r\nVector # 3D vector with operations (dot, cross, normalize)\r\nPlane # Infinite plane in 3D space\r\nMatrix # 4x4 transformation matrices\r\nGeometry # Utility class for geometric operations\r\n```\r\n\r\n#### Modeler (`pyansysv23.modeler`)\r\n```python\r\nBody # CAD body (solid or surface)\r\nDesignBody # High-level body abstraction\r\nFace, Edge, Vertex # Topological elements\r\nModeler # Factory for creating primitives\r\n```\r\n\r\n#### Document (`pyansysv23.document`)\r\n```python\r\nDocument # SpaceClaim document\r\nPart # CAD part\r\nAssembly # Component assembly\r\nDrawingSheet # Drawing/annotation sheet\r\nDatumPlane # Reference plane\r\n```\r\n\r\n#### Annotation (`pyansysv23.annotation`)\r\n```python\r\nNote # Text annotations\r\nBarcode # Barcode annotations (supports multiple types)\r\nSymbol # Symbol annotations\r\nTable # Table annotations\r\nBarcodeType # Enum: Code39, EAN13, QRCode, DataMatrix, etc.\r\n```\r\n\r\n#### Analysis (`pyansysv23.analysis`)\r\n```python\r\nBodyMesh # Mesh on a body\r\nPartMesh # Mesh on a part\r\nAssemblyMesh # Mesh on an assembly\r\nMeshNode # Individual mesh node\r\nVolumeElement # Volume mesh element\r\nFaceElement # Face mesh element\r\nEdgeElement # Edge mesh element\r\nHexaBlocking # Hexahedral mesh blocking\r\nAnalysisAspect # Analysis tools\r\n```\r\n\r\n#### Extensibility (`pyansysv23.extensibility`)\r\n```python\r\nAddIn # Base class for all add-ins\r\nCommandCapsule # Base class for command implementations\r\nIExtensibility # Add-in interface\r\nICommandExtensibility # Command extension interface\r\nIRibbonExtensibility # Ribbon customization interface\r\n```\r\n\r\n#### Core (`pyansysv23.core`)\r\n```python\r\nCommand # SpaceClaim command\r\nWriteBlock # Transaction/write operation\r\nApplication # Application singleton\r\nWindow # Application window\r\n```\r\n\r\n## Installation\r\n\r\n```bash\r\npip install -e .\r\n```\r\n\r\nOr simply copy the `pyansysv23` directory to your Python project.\r\n\r\n## Quick Start\r\n\r\n### 1. Create Geometric Primitives\r\n\r\n```python\r\nfrom pyansysv23.geometry import Point, Vector\r\nfrom pyansysv23.modeler import Modeler\r\n\r\n# Create a box\r\nbox = Modeler.create_box(Point(0, 0, 0), length=1, width=1, height=1)\r\nprint(f\"Box volume: {box.master.volume}\")\r\n\r\n# Create a sphere\r\nsphere = Modeler.create_sphere(Point(2, 0, 0), radius=0.5)\r\n\r\n# Create vectors and perform operations\r\nv1 = Vector(1, 0, 0)\r\nv2 = Vector(0, 1, 0)\r\ncross_product = v1.cross(v2)\r\n```\r\n\r\n### 2. Work with Documents and Parts\r\n\r\n```python\r\nfrom pyansysv23.document import Document, Part\r\n\r\n# Create a document\r\ndoc = Document(\"MyDesign.scdoc\")\r\n\r\n# Create a part\r\npart = Part(\"Part1\")\r\n\r\n# Add bodies\r\npart.add_design_body(box)\r\npart.add_design_body(sphere)\r\n\r\n# Add to document and save\r\ndoc.add_part(part)\r\ndoc.save(\"C:\\\\designs\\\\MyDesign.scdoc\")\r\n```\r\n\r\n### 3. Create Annotations\r\n\r\n```python\r\nfrom pyansysv23.annotation import Note, Barcode, BarcodeType\r\nfrom pyansysv23.geometry import PointUV\r\nfrom pyansysv23.document import DrawingSheet\r\n\r\n# Create a drawing sheet\r\nsheet = DrawingSheet(\"Drawing1\")\r\n\r\n# Add a note\r\nnote = Note(sheet, \"Important Note\", PointUV(0.1, 0.1))\r\n\r\n# Add a QR code barcode\r\nqr = Barcode.create(sheet, PointUV(0.2, 0.2), BarcodeType.QRCode, \"https://example.com\")\r\n```\r\n\r\n### 4. Create Commands\r\n\r\n```python\r\nfrom pyansysv23.core import Command, WriteBlock\r\n\r\n# Create a command\r\ncmd = Command.create(\"MyAddIn.MyCommand\", \"My Command\", \"Execute my command\")\r\n\r\n# Add event handlers\r\ndef on_execute(context):\r\n print(\"Command executed!\")\r\n\r\ncmd.add_executing_handler(on_execute)\r\n\r\n# Execute within a write block\r\ndef my_operation():\r\n print(\"Performing modifications...\")\r\n\r\nWriteBlock.ExecuteTask(\"My Operation\", my_operation)\r\n```\r\n\r\n### 5. Develop an Add-in\r\n\r\n```python\r\nfrom pyansysv23.extensibility import AddIn, ICommandExtensibility, IRibbonExtensibility\r\nfrom pyansysv23.core import Command\r\n\r\nclass MySpaceClaimAddIn(AddIn, ICommandExtensibility, IRibbonExtensibility):\r\n def connect(self) -> bool:\r\n print(\"Add-in loaded\")\r\n return True\r\n \r\n def disconnect(self) -> None:\r\n print(\"Add-in unloaded\")\r\n \r\n def initialize(self) -> None:\r\n cmd = Command.create(\"MyAddIn.CreateBox\")\r\n cmd.text = \"Create Box\"\r\n \r\n def get_custom_ui(self) -> str:\r\n return '''<?xml version=\"1.0\"?>\r\n<customUI xmlns=\"http://schemas.spaceclaim.com/customui\">\r\n <ribbon>\r\n <tabs>\r\n <tab id=\"MyAddIn.Tab\" label=\"My Add-In\">\r\n <group id=\"MyAddIn.Group\" label=\"Geometry\">\r\n <button id=\"MyAddIn.CreateBox\" command=\"MyAddIn.CreateBox\"/>\r\n </group>\r\n </tab>\r\n </tabs>\r\n </ribbon>\r\n</customUI>'''\r\n\r\n# Use the add-in\r\naddin = MySpaceClaimAddIn()\r\naddin.connect()\r\naddin.initialize()\r\n```\r\n\r\n### 6. Mesh Operations\r\n\r\n```python\r\nfrom pyansysv23.analysis import MeshBodySettings, BodyMesh, MeshNode, HexaBlocking\r\n\r\n# Create mesh settings\r\nmesh_settings = MeshBodySettings.create(box)\r\nmesh_settings.element_size = 0.01\r\n\r\n# Create and populate body mesh\r\nbody_mesh = BodyMesh(box)\r\nnode = MeshNode(0, Point(0, 0, 0))\r\nbody_mesh.nodes.append(node)\r\n\r\n# Use hexahedral blocking\r\nhexa = HexaBlocking()\r\nsuccess, error = hexa.process_command_with_error(\"HEXA QUADS 100\")\r\n```\r\n\r\n## API Structure\r\n\r\n```\r\npyansysv23/\r\n\u251c\u2500\u2500 __init__.py # Package initialization and exports\r\n\u251c\u2500\u2500 geometry.py # Geometric primitives\r\n\u251c\u2500\u2500 modeler.py # 3D modeling operations\r\n\u251c\u2500\u2500 document.py # Document management\r\n\u251c\u2500\u2500 annotation.py # Annotations\r\n\u251c\u2500\u2500 analysis.py # Analysis and meshing\r\n\u251c\u2500\u2500 instance.py # Instances and components\r\n\u251c\u2500\u2500 extensibility.py # Add-in framework\r\n\u2514\u2500\u2500 core.py # Core commands and application\r\n```\r\n\r\n## Usage Examples\r\n\r\nSee `examples.py` for comprehensive examples including:\r\n- Creating geometric primitives\r\n- Document and part management\r\n- Command creation and execution\r\n- Annotation operations\r\n- Mesh operations\r\n- Add-in development\r\n\r\nRun examples:\r\n```bash\r\npython examples.py\r\n```\r\n\r\n## Documentation\r\n\r\nThis library is designed to closely match the official SpaceClaim API. Reference documentation:\r\n- `API_Class_Library.chm` - Complete API reference\r\n- `Developers Guide.pdf` - Development guide\r\n- `Building Sample Add-Ins.pdf` - Add-in examples\r\n\r\n## Testing\r\n\r\n```python\r\n# Test geometry operations\r\nfrom pyansysv23.geometry import Point, Vector\r\n\r\np1 = Point(0, 0, 0)\r\np2 = Point(1, 1, 1)\r\ndistance = p1.distance_to(p2)\r\nassert abs(distance - 1.732050808) < 0.0001\r\n\r\n# Test vector operations\r\nv = Vector(3, 4, 0)\r\nassert abs(v.magnitude() - 5.0) < 0.0001\r\n```\r\n\r\n## Supported Barcode Types\r\n\r\n- Code25, Code25Interleaved\r\n- Code39, Code93, Code11\r\n- Code128 (A, B, C variants)\r\n- EAN (8, 13, 14, 128)\r\n- UPC (A, E)\r\n- ISBN, ISMN, ISSN\r\n- LOGMARS, VIN\r\n- QR Code, Data Matrix, PDF417, Aztec\r\n\r\n## Notes\r\n\r\nThis is a **virtual/mock library** intended for:\r\n- Learning the SpaceClaim API\r\n- Offline development and testing\r\n- Script validation and preview\r\n- Documentation reference\r\n\r\nFor production SpaceClaim automation, use the actual SpaceClaim API available through:\r\n- SpaceClaim SDK (includes `SpaceClaim.Api.V23.dll`)\r\n- Official Python add-in examples\r\n- SpaceClaim IronPython scripting environment\r\n\r\n## License\r\n\r\nThis is a learning/reference implementation. SpaceClaim is a product of ANSYS.\r\n\r\n## Compatibility\r\n\r\n- **Python**: 3.7+\r\n- **Platform**: Windows (reflects SpaceClaim platform)\r\n- **API Version**: V23\r\n\r\n## Contributing\r\n\r\nFeel free to extend this library with additional functionality based on the SpaceClaim API documentation.\r\n\r\n## See Also\r\n\r\n- SpaceClaim API Documentation\r\n- ANSYS SpaceClaim Official Website\r\n- PyAnsys Project\r\n\r\n---\r\n\r\n**Disclaimer**: This is a virtual/educational library. It does not interface with actual SpaceClaim installations. For real SpaceClaim automation, use the official SpaceClaim SDK.\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Virtual SpaceClaim API V23 library for Python",
"version": "0.23.0",
"project_urls": {
"Bug Tracker": "https://github.com/pyansys/pyansysv23/issues",
"Changelog": "https://github.com/pyansys/pyansysv23/releases",
"Documentation": "https://github.com/pyansys/pyansysv23/blob/main/README.md",
"Homepage": "https://github.com/pyansys/pyansysv23",
"Repository": "https://github.com/pyansys/pyansysv23.git"
},
"split_keywords": [
"ansys",
" spaceclaim",
" cad",
" api",
" modeling",
" geometry",
" 3d",
" mechanical",
" simulation"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "60f3c2b055ce09a71c275b29679b55c397e7a540db6b9056fa261eabc6d83503",
"md5": "2aea480abd0adefd46a4d3549581cb17",
"sha256": "1bd3d5d40387cdeeefe9f10afca08e75c6fe0937a91c568b896d2ad6c448bfdd"
},
"downloads": -1,
"filename": "pyansysv23-0.23.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2aea480abd0adefd46a4d3549581cb17",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 24308,
"upload_time": "2025-10-23T00:18:16",
"upload_time_iso_8601": "2025-10-23T00:18:16.365931Z",
"url": "https://files.pythonhosted.org/packages/60/f3/c2b055ce09a71c275b29679b55c397e7a540db6b9056fa261eabc6d83503/pyansysv23-0.23.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "6a97a540bfb08b4d740bb8f3c5407f0c4d0fe6c331b30de340d39cb4a6d20a23",
"md5": "ae93583bf9eb2904b039a91fd9c8b6f1",
"sha256": "4a4cfb51e857ee020dc393d177bb53190164071a397cb19e504b4a904f0a339a"
},
"downloads": -1,
"filename": "pyansysv23-0.23.0.tar.gz",
"has_sig": false,
"md5_digest": "ae93583bf9eb2904b039a91fd9c8b6f1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 37214,
"upload_time": "2025-10-23T00:18:17",
"upload_time_iso_8601": "2025-10-23T00:18:17.879995Z",
"url": "https://files.pythonhosted.org/packages/6a/97/a540bfb08b4d740bb8f3c5407f0c4d0fe6c331b30de340d39cb4a6d20a23/pyansysv23-0.23.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-23 00:18:17",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "pyansys",
"github_project": "pyansysv23",
"github_not_found": true,
"lcname": "pyansysv23"
}
JSON
