Output:

•This routine translates parts along a vector by a constant value (in inches.)

Input:

•The direction of translation can be defined with either a direction or a point or feature.  If a point or feature is selected, it should be added to the Target Features list.  If a direction is used, the Dir. No. should be changed to 1.  Then, a direction must be defined.  If AssocDir type will be used, the point or feature must be placed in the Target Feature list.

•Add the desired Part(s) to the Move Parts list.

•Select the [Values] button and Add a value to the Edit Constants List.

Move an object Point to the center of a calculated circle from three target points.

This routine is a move-deviate routine, which is "moving" the object points instead of moving the components.

Input:

•Object: One Object Point is required.

•Target: Three Target Points are required.

•Values: 1 value is optionally required.

Output:

•The output of the routine will depend on the input value.

No Value or Val1 = 0:

•The Object Point will be moved to the center for the circle created from the three Target Points.

•If the Object Point has a diameter, the diameter will change based on the calculated size of the three points.

Val1 = 1:

•The Object Point is projected to the line formed by the first two Target Points.

•The third Target Point is ignored.

Val1 = 2:

•The Object Point is projected to the plane formed by the three Target Points.

Rotate by a calculated angle from selected features.

Input:

•One Object Feature is required.

•Two Target Features are required. (The first feature has to be Cylindrical Type.)

•Component List cannot be empty.

Output:

•Components will be rotated around the first feature (Cylindrical Type) till at least one meshed point on the object feature touches the target plane calculated from the second target feature.  

Calculation Methods:

•The first feature provides an axis, which is calculated with Least-Square Method.

•The second target feature provides an infinite plane, which is calculated by Least-Square HP Method.

Note:

To facilitate the verification of the move routine dcsFeatRotateMv, a feature-based measure, as a User DLL measure routine, is added.

Translate object points to the average center calculated from all target features. This routine is a move-deviate routine, which is deviating the object points instead of moving the components. This routine is used to replace Dynamic Point calculation.

Input:

•Object Features: At least one Object Point is required.

•Target Features: At least one Target Feature is required.

•Value (Optional):

oFirst Value: Controls how features are treated. Can be not set, zero, or one.

▪If not set or zero, every mesh node on the feature will be used individually to calculate the average center.

▪If one, only the Feature Locator Point is used to calculate the average center.

Output:

•Object Points will be translated to the average center calculated from all Target Features.

Translate object points to the geometric center calculated from all target points. The object point direction is not changed. This routine is a move-deviate routine, which is deviating the object points instead of moving the components.

Input:

•At least one Object Point is required.

•At least one Target Feature is required.

Output:

•Object Points will be translated to the geometric center calculated from all Target Points. Geometric center = (max xyz + min xyz) / 2.

Note:

•Treat the cad feature as multiple Points in calculating the geometric center

Move an object Point from its current position to the target feature (either sphere, or general surface, or a DCS circle).  It is optional to move the object point along a direction.

This routine is a move-deviate routine, which is deviating the object points instead of moving the components.

Use Cases:

•Project Point to the closest feature: Apply no direction.

•Project to a target feature along a direction: Set the direction to =1 and apply Type-In to project the point in that direction, or use the target direction.

Input:

•One Object Point is required.

•One Target Feature (surf with mesh) is required.

•Optionally, One Direction can be specified.

•Set String=1 to project point in the given direction for irregular surface (eg Cones)

Output:

•The Object Point will be moved to the target feature. When a direction is specified, Point moves along the direction.

Notes:

•Multi-Points are supported – Object Point moved to Target Point in each pair, or along the optionally specified direction.

•Offsets are supported – The Offset Value (if existing) is applied for each pair.

•Feature distance measure now used to find the closest target position and direction instead of the closest meshed point.

•The object point direction is updated based on the direction of the target point.

This routine adds a delta to the existing diameter. The delta value is taken from a measurement input. This routine is a move-deviate routine, which is deviating the diameter(s) associated with object point(s) instead of moving the component(s).

Input:

•One Center Object Point or Diametrical Feature. One is required.

•One Measurement is required. Make sure the measurement provides the delta value.

Output:

•The diameters associated with Center Object Points or Diametrical Features will be changed by a delta taken from the selected measurement. If an Object Point is a Feature Point and is associated with a Circle, the associated Circle Size will be updated. The feature size (mesh size) is NOT updated when a Feature Point is selected.

Notes:

At least one point is required but multiple points can be used. All points used in the object field will produce the same size. Even when different measurements are added, only the first measurement will be used. All other measurements will be ignored.

This move routine will take measurements at the time the move is executed. This routine does not change any model geometry location.

Input:

•Measurements are required.

•Value - If the user adds a value = 1 then the simulation will only collect the data for the builds within the spec limit. This input can be used to eliminate the assemblies that have out-of-spec results.

Output:

•The selected measurements will remember the calculated values at the time this move was executed. Please notice that if a measure is used as condition or interference checking in a move after this current move, the measured value will be re-calculated at the last move execution time.

Special rules:

If a TakeMeasValues move is used, the nominal value calculation happens at the move execution.

If multiple TakeMeasValues moves are used for the same measurement, the first TakeMeasValues move will calculate the nominal value for the measurement.

Notes:

The Take-Measure Routine can use most measure types within 3DCS; however, it's not recommended to use the Combination Measure within the Take-Measure routine.

See also...

Trajectory Variation Analysis

Engine Compression Ratio Variation Study

This routine deviates the object features based on the deviation of the target features. The deviation includes both position and size with options. This routine is a move-deviating routine, which is deviating both positions and sizes associated with object features instead of moving the components (Move Parts.)

Input:

Object Features: At least one object feature is required.

Target Features: At lease one target feature is required. (Needs the same amount of points that is in the Object Features list to deviate the points in Object Features list).

Values:

oFirst Value: Position Scale - Can be positive, negative, or zero. When Position Scale is zero, no action is taken for the position deviation.

oSecond Value:  Size Scale - Can be positive, negative, or zero. When Size Scale is zero, no action is taken for the size deviation.

oThird Value: Target Calculation Flag - Can be 0 or 1. Indicates whether the target position and size should be combined or not. If Target Calculation Flag is zero (default), the target positions and sizes are averaged and applied on the object features. If Target Calculation Flag is 1, the target positions and sizes are applied by pairing each target and object feature with the same index.

Output:

•The object feature position will be deviated by the target feature deviation with the Position-Scale if Position-Scale is non-zero.

•The object size will be deviated by the target feature size deviation with the Size-Scale if Size-Scale is non-zero.

•The routine only functions properly after the nominal build to get the correct target nominal positions and sizes.

•If multiple target features are selected:

o(1) When the target-calculation-flag is zero, the average values (position or size) are used.

o(2) When the target-calculation-flag is 1, the deviation of target position and size will be applied on the paired object feature with the same index. If an object feature or a target feature is not a feature-of-size, the size deviation will be ignored.

This routine identifies the closest position on two features (surface or edge) using two points. (Relocated from dcu_constraint.dll) The routine is used for translating a slider in touch with a cam.

Input:

•Object Features: Require two coordinate points.

•Target Features require two features.

•Direction: One direction is optional. When a direction is added, this routine will use the direction to project the points to the closest surface.

•Value or Constant:

oThe user will need to specify how many features will correspond to the first feature in the Object list. For example, if the Value1 = 3, the first set of 3 surfaces in the Target list will correspond to the first feature in the Object part. The rest of features will correspond to the second feature.

oIf no Value is applied, or if the Value = 0, this will automatically correspond the first feature in the Target list with the first feature in Object list by default.

Output:

•The point Point1 is located to the closest position on Feature1; the point Point2 is located to the closest position on Feature2.  If the selected features interfere, the points will move to the estimated maximum amount of interference. The estimate is the same as the one used by the Feature measure.

Note:

This routine will require the Enhanced Feature Measure license or the Mechanical license.

For this routine, a Feature Set is a number of features, surface(s)or edge(s), selected from the same part. The routine is used to calculate the rotation position of one part’s Feature Set, Feature1,  to another fixed part’s Feature Set, Feature2. The calculation determines the rotation so the true distance between the Features sets is minimized. Next the routine moves the two points, Point1 and Point2 correspondently, to calculate the closest true distance location between the Feature Sets. The Parts do not move after executing, only the selected points. This move routine may be followed by a Line Angle measure and a Transform rotation move to rotate one gear so the teeth touch between the two gears.

Input:

•Object Features: Requires two coordinate points. (Point 1 and Point 2)

•Target Features:

oRotating Center of the Feature1, cylinder or point

oFeature1: Rotation features corresponding to Point1

oFeature2: Fixed features corresponding to Point2

•Components: Ignored

•Direction: Direction is required as the Rotating Axis of the rotating Features, this generally corresponding with the Rotating Center..

•Value: One value at most is listed.

oValue1 (=Group1) is the group number for features as Feature1( features listed under the Rotating Center feature); rest of features will be as Feature2; If no value or value1 = 0, Group1 = 1 by default.

Output:

•Point1 is located to the closest position on Feature1; Point2 is located to the closest position Feature2. The closest location is calculated minimal distance between Feature1 and Feature2 after rotating Feature2 around the Rotating Center about the Rotating Axis.  The Point Angle Line measure uses: 1) Line1 - Point1 and the Rotating Center; 2) Line2 – Point2  and the  Rotation Center; and 3) Direction – Rotating Axis.  The Transform move rotation uses 1) Rotation Center; 2)Feature1 part; and 3) Direction – Rotating Axis.

Warning: The furthest point is given if the points are reversed.

Translates two points to the intersection line of two planes. This routine enables the feature move to support the case when primary plane and secondary plane have a non-90-degree angle.

Input:

•Object Features: Requires two points.

•Target Features: Requires two or three features:

oFeature1 always defines the plane.

oFeature2 and Feature3 can be points or CADSurfs and will define the line.  If Feature3 is not added, then Feature2 must be a CadEdge.

•Components: Ignored

•Direction: Ignored.

Output:

•Point1 and Point2 are translated to the intersection line of two target planes.

Translates one point to the intersection of plane and line. This routine enables the feature move to support the case when secondary plane and tertiary plane have a non-90-degree angle.

Input:

•Object Features: Requires one point.

•Target Features: Requires three features: Feature1 - Plane (Surface); Feature2 and Feature3 - Two Points to make a Line.

•Components: Ignored

•Direction: Ignored.

Output:

•Point1 is translated to the intersection of plane and line.

Please use the example model from the folder below to understand the userdll move.

C:\Users\Public\Public Documents\DCS\3DCS_V5_8_1_0_4\3DCS CAD & Example Models\Reference Models\Moves\Translate Pt to Plane Line

Translates two points to the LSQ Position and Direction as well as the size if applicable.

Input:

•Object Features: Requires two points.

•Target Features: Requires a set of features.

•Components: Ignored

•Direction: Ignored.

•Value: is the feature combining option:

oNo Combination if Value1 = 0;

oAll Target Features are combined as one Plane if Value1 = 1;

oAll Target Features are combined as one Axis if Value1 = 2. (Enhanced 09/09/13/YZ)

Output:

•If Target Features are all circles (cylinder, circle edge, point-based circle), Point1 and Point2 are translated to the least-squared axis with the minimum size.

•Otherwise, Point1 is translated to the Least-Squared Plane Position and Point2 is translated to the Least-Squared Plane Direction. The distance between Point1 and Point2 is kept as before the action.

Transforms components by rotating and translating with a random value input. The random value provides the translating amount. It can simulate a motion if random value input is set as the 'Step' distribution over multiple steps.

Input:

•Object Features: ignored

•Target Features: two features are required:

o1st feature (circle or cylinder) for rotating center and direction and it must provide the rolling diameter;

o2nd feature for translating direction

•Components: required

•Direction (optional): two directions

o1st direction for rotating direction;

o2nd direction is for translating direction.

•Random Parameter: One Random required for translating amount

•Values (optional - one value):

o0 => rolling, both rotating and translating; 1 => rotating only; 2 => translating only)

Output:

•The components will be rotated and translated based on the random value. HLM Analysis is supported.

Locates Points to the Torus Minor Centers. The routine deals with a Torus surface. It's a point-locating routine. The routine can be used with the Measure Routine, 'dcsMsDistFrCrToPt', to measure the Profile deviation on a Torus.

Input:

•Object Features: Object Points to be re-located, required to be a Coordinate point with a Circle Size.

•Target Features: Each point should be a Feature-Point associated with a Torus.

•Move Parts: ignored

•Direction: ignored.

Output:

•Each Object Point will be relocated to the corresponding Torus Minor Center. The Object Point direction is updated by the Torus Minor Circle direction. If an Object Point is associated with a circle, the circle Radius will be equal to the Torus Minor radius.

Description:

Translate two points to indicate the evaluating point positions used in a measurement with measure type: Two-Point-List, Feature-Measure, and Circle-Interference.

User Input:

Object Points: two points.

Measure List: the first measure is used

Output:

Position 1st and 2nd Object Points as two evaluating point used in the selected measure with supported measure types.

Description:

Used for testing GD&T Measurements. Translates points to a surface to indicate the points used to evaluate the GD&T Measurement when the surface is selected as the measurement feature. The surface must be planar or cylindrical (holes and pins).

Planar Surfaces

Input:

Object Features: Four points

Target Features: One planar surface

Output:

Point 1 is translated to the Feature Locating Point (the center of the surface). Points 2, 3, and 4 are translated to the extreme points of the surface.

Cylindrical Surfaces (Hole or Pin)

Input:

Object Features: 11 points

Target Features: One cylindrical surface (hole or pin)

Output:

Point 1 is translated to the Feature Locating Point (the center of the cylinder at the middle of the axis). Points 2 and 3 are translated to the center of the cylinder at the ends of the axis. Points 4, 5, 6, and 7 are translated to the surface of the feature in a circle around Point 2 spaced 45° apart. Points 8, 9, 10, and 11 are translated to the surface of the feature in a circle around Point 3 spaced 45° apart.

Requires a pair of points on two adjacent features. This type of move will deviate the paired points as one zipped surface, or as a corner. This will also be required to create a closed polyhedron which will be used with the Closed Volume measure.Translate paired points to the common position calculated from corresponding deviated positions. This routine provides the function for visually zip two deviated surfaces together. This routine has the same effect as  CopyDeviation function twice.

Description:

Translate paired points to the common position calculated from corresponding deviated positions. This routine provides the function for visually zip two deviated surfaces together.

Input:

Object Features: At least one object point is required.

Target Features: At lease one target point is required.

Output:

Translate each paired points to the common position calculated from deviated position.

Notes:

Some parts may require to add the surface in the Object Feature list and the Target Feature list. For example, zipping or sewing a cylindrical feature, the cylinder surface will be used in the Object field x2 and the Target field after the top surface, if considering a pin-type feature.

Translate object features to paired target features. This routine provides the function for visually zip or sew two deviated surfaces together across the parts.

Input:

•Object Points: object features.

•Target Points: target features

•Directions: one direction required for linking plane normal direction

Output:

Translate each paired points to the target position.