pydim

The pydim.* api functions create dimensions in the PYTHA model programmatically — the same dimensions a user creates with the Dimensions functions in the PYTHA user interface.

Functions:

• pydim.create_linear_dimension — create a linear dimension between two part points (optionally with saw angle).
• pydim.create_radial_dimension — create a radius, diameter, center or arc-length dimension from three points on an arc.
• pydim.create_angular_dimension — create an angle dimension between two edges, or an edge-distance dimension for parallel edges.
• pydim.create_perpendicular_dimension — create a perpendicular dimension from a point onto an edge.

Dimension points

Dimensions in PYTHA are anchored to part points or reference points, not to free coordinates: when the element is modified, its dimensions follow. pydim therefore expects coordinates that coincide with an existing point. Each dimension point is given as a table with the coordinate at index 1 and, optionally, a part or group element handle at index 2 that restricts the point search to that element:

{ {x, y, z} }           -- searched everywhere
{ {x, y, z}, part }     -- searched only in this part
{ {x, y, z}, group }    -- searched only among this group's reference points

The search resolves the coordinate in this order:

1. Part reference points (of the given part, or of all parts)
2. Group reference points (only without a part handle)
3. Plain part points

Reference points always take priority over plain part points. A group handle only matches the group's reference points — groups have no plain points. If a coordinate does not match any point, no dimension is created and the function returns nil.

Edges

pydim.create_angular_dimension and pydim.create_perpendicular_dimension reference part edges. An edge is given as two dimension-point tables for its end coordinates; the coordinates are resolved to the part edge that connects them (the order of the two ends does not matter). An edge always lies completely within one part, so if both end points carry a part handle, it must be the same part. Edges connect plain part points only — group handles and reference points cannot describe an edge.

Dimension types and views

Every dimension belongs to one view and is displayed in that view only ("xy", "xz", "yz", their flipped counterparts, or "axo").

• In the plane views, "horizontal" measures along the horizontal axis of the view, "vertical" along the vertical axis, and "parallel" along the connection of the two dimension points.
• In the axo view, "horizontal" and "vertical" additionally need the plane the dimension lies in. A "parallel" dimension in the axo view is axis-parallel: it needs the axis the dimension line is parallel to and the plane it is projected into.

Dimension styles

A new dimension uses the current default dimension style (Environment -> Settings -> Dimension). Both can be overridden per dimension:

• style_file — a path handle to a dimension style file (as saved from the dimension attributes dialog) that is loaded as the base style.
• style — a table with individual style settings (pens, delimiters, text, tolerances, ...) applied on top.

See also:

pytha, pyplot, Element Handles, Path Handles