EASY-ROB™ Kernel
v8.606
|
Method for collision free path planning. More...
#include <erk_capi.h>
Static Public Member Functions | |
static DLLAPI char *ER_STDCALL | AutoPathVer (void) |
AutoPath Version. More... | |
static DLLAPI int ER_STDCALL | AutoPathSetMem (AutoPath_ConfigurationSpace *apcs) |
allocate memory for AutoPath_ConfigurationSpace data depending on nConfig see example AutoPathInit() More... | |
static DLLAPI int ER_STDCALL | AutoPathInit (AutoPath_ConfigurationSpace *apcs) |
Initialize AutoPath Call this functions to setup the autopath configuration space Parameter apcs defines the complete configuration for all used devices, such asnumber of configurations up to AUTOPATH_SDK_KIN_DOFS, device handle for each configuration, device axis index, etc. call AutoPathSetMem() first. More... | |
static DLLAPI int ER_STDCALL | AutoPathFreeMem (AutoPath_ConfigurationSpace *apcs) |
free memory of AutoPath_ConfigurationSpace data see example AutoPathInit() More... | |
static DLLAPI int ER_STDCALL | AutoPathTerminate (AutoPath_ConfigurationSpace *apcs) |
Terminate AutoPath call AutoPathFreeMem() first, see example AutoPathInit() More... | |
static DLLAPI int ER_STDCALL | AutoPath_SetCallback_CheckConstraints (BOOL(*ptr_CheckConstraints)(int, void *)) |
Defines a callback function to check constraints during AutoPath calculation The callback function is called with two parameters Parameter action in Callback_API_CheckConstraints() is a bitwise inclusive OR operator (|) ofAUTOPATH_SDK_CHK_CONSTRAINT_UNDEF, AUTOPATH_SDK_CHK_CONSTRAINT_START, AUTOPATH_SDK_CHK_CONSTRAINT_DEST, AUTOPATH_SDK_CHK_CONSTRAINT_COLLISION, AUTOPATH_SDK_CHK_CONSTRAINT_SWE, AUTOPATH_SDK_CHK_CONSTRAINT_CART_SPACE, AUTOPATH_SDK_CHK_CONSTRAINT_ISCFREE Parameter vapcs in Callback_API_CheckConstraints() defines the autopath configuration space AutoPath_ConfigurationSpacesee example AutoPathInit() More... | |
static DLLAPI int ER_STDCALL | SetPoseStart (double *pose_start) |
Set start configuration Remarks This pose must be valid - collision free, based on callback function "ptr_CheckConstraints" to check constraints. More... | |
static DLLAPI int ER_STDCALL | SetPoseEnd (double *pose_end) |
Set end configuration Remarks This pose must be valid - collision free, based on callback function "ptr_CheckConstraints" to check constraints. More... | |
static DLLAPI int ER_STDCALL | FindPath (void) |
Start motion planner, find a collision free path between start and end pose In each step, the callback function "ptr_CheckConstraints" is called, to check constraints If the target is reached, the callback function is called with action parameter AUTOPATH_SDK_STATUS_MP_SUCCESS. More... | |
static DLLAPI double *ER_STDCALL | GetConfigurationPose (void) |
current configuration pose during FindPath Process return pointer, size nConfig More... | |
static DLLAPI double *ER_STDCALL | GetStartPose (void) |
Get Start Pose return pointer, size nConfig. More... | |
static DLLAPI double *ER_STDCALL | GetEndPose (void) |
Get End Pose return pointer, size nConfig. More... | |
static DLLAPI double *ER_STDCALL | GetAxisConstraintsMin (void) |
Get minimum axis constraints return pointer, size nConfig. More... | |
static DLLAPI double *ER_STDCALL | GetAxisConstraintsMax (void) |
Get maximum axis constraints return pointer, size nConfig. More... | |
static DLLAPI int ER_STDCALL | AbortPlanning (void) |
Abort path planning use GetPlanningStatus() More... | |
static DLLAPI int ER_STDCALL | GetPlanningStatus (void) |
Get path planning status The planning status is one of AUTOPATH_SDK_STATUS_MP_IDLE AUTOPATH_SDK_STATUS_MP_RUNNING. More... | |
static DLLAPI int ER_STDCALL | GetNumberOfWayPoints (void) |
Get number of calculated way points, including start and end pose call this method after FindPath() succeeded. More... | |
static DLLAPI int ER_STDCALL | GetWayPointDof (void) |
Get dof of calculated way points. More... | |
static DLLAPI double *ER_STDCALL | GetWayPoint (int idx) |
Get way point. More... | |
static DLLAPI int ER_STDCALL | ClearAllWayPoints (void) |
Clear all way points. More... | |
static DLLAPI int ER_STDCALL | SetAccuracy (UINT accuracy) |
Set accuracy. More... | |
static DLLAPI int ER_STDCALL | SetAxisConstraints (int axisBit=AUTOPATH_SDK_AXIS_BIT_DOF6, int setting=0, double qConstraintMin=0, double qConstraintMax=0) |
Set axis constraints Parameter setting is a bitwise inclusive OR operator (|) of AUTOPATH_SDK_CONSTRAINT_RESET, AUTOPATH_SDK_CONSTRAINT_MIN, AUTOPATH_SDK_CONSTRAINT_MAX. More... | |
static DLLAPI int ER_STDCALL | SetAxisPriority (int axisBit, int priority) |
Set axis priority. More... | |
static DLLAPI int ER_STDCALL | SetAxisEnable (int axisBit, int enable) |
Set axis enable. More... | |
static DLLAPI int ER_STDCALL | SetParameter (int ap_option, int ap_value) |
Set parameter Paramter ap_option is one ofAUTOPATH_SDK_PARAMETER_DYNADJUST AUTOPATH_SDK_PARAMETER_ALGORITHM AUTOPATH_SDK_PARAMETER_NTREES AUTOPATH_SDK_PARAMETER_MIN_NUM_WAYPOINTS AUTOPATH_SDK_PARAMETER_FORCE_DETERM_BEHAVIOR AUTOPATH_SDK_PARAMETER_LIMIT_REVOLUTE_JNT_CSPACE AUTOPATH_SDK_PARAMETER_THREAD_PRIORITY AUTOPATH_SDK_PARAMETER_THREAD_EXECUTION AUTOPATH_SDK_PARAMETER_SEED_VALUE. More... | |
static DLLAPI int ER_STDCALL | GetParameter (int ap_option) |
Get parameter Paramter ap_option is one of AUTOPATH_SDK_PARAMETER_DYNADJUST AUTOPATH_SDK_PARAMETER_ALGORITHM AUTOPATH_SDK_PARAMETER_NTREES AUTOPATH_SDK_PARAMETER_MIN_NUM_WAYPOINTS AUTOPATH_SDK_PARAMETER_FORCE_DETERM_BEHAVIOR AUTOPATH_SDK_PARAMETER_LIMIT_REVOLUTE_JNT_CSPACE AUTOPATH_SDK_PARAMETER_THREAD_PRIORITY AUTOPATH_SDK_PARAMETER_THREAD_EXECUTION AUTOPATH_SDK_PARAMETER_SEED_VALUE. More... | |
static DLLAPI int ER_STDCALL | GetResults (int ap_result) |
Get results Paramter ap_result is one of AUTOPATH_SDK_RESULT_CHECKS AUTOPATH_SDK_RESULT_SECONDS AUTOPATH_SDK_RESULT_CPS AUTOPATH_SDK_RESULT_CFREE AUTOPATH_SDK_RESULT_COBSTACLE AUTOPATH_SDK_RESULT_CDENSITY AUTOPATH_SDK_RESULT_DSECONDS AUTOPATH_SDK_RESULT_SEED_VALUE AUTOPATH_SDK_RESULT_QUALITY_INDEX AUTOPATH_SDK_RESULT_QUALITY_INDEX_STD_DEV. More... | |
Additional Inherited Members | |
Static Public Attributes inherited from ERK_CAPI | |
static ERK_CAPI_ADMIN | erk_capi_admin |
Method class to administrate this Robotics Simulation Kernel. More... | |
static ERK_CAPI_DEVICES | erk_capi_devices |
Method class to create, attach, update devices, for kinematics calculations and for motion planning and -execution. More... | |
static ERK_CAPI_SIM | erk_capi_sim |
Method class for simulation settings. More... | |
static ERK_CAPI_AUTOPATH | erk_capi_autopath |
Method class for collision free path planning. More... | |
static ERK_CAPI_TARGETS | erk_capi_targets |
Method class for paths and tags. More... | |
static ERK_CAPI_GEO | erk_capi_geo |
Method class to handle 3D Geometry Data. More... | |
static ERK_CAPI_SYS | erk_capi_sys |
Method class for mathematical calculations, simulation status, units. More... | |
Method for collision free path planning.
|
static |
Abort path planning
use GetPlanningStatus()
0 | - AUTOPATH_SDK_OK |
1 | - AUTOPATH_SDK_ERROR |
|
static |
Defines a callback function to check constraints during AutoPath calculation
The callback function is called with two parameters
Parameter action
in Callback_API_CheckConstraints() is a bitwise inclusive OR operator (|) of
AUTOPATH_SDK_CHK_CONSTRAINT_UNDEF, AUTOPATH_SDK_CHK_CONSTRAINT_START, AUTOPATH_SDK_CHK_CONSTRAINT_DEST, AUTOPATH_SDK_CHK_CONSTRAINT_COLLISION, AUTOPATH_SDK_CHK_CONSTRAINT_SWE, AUTOPATH_SDK_CHK_CONSTRAINT_CART_SPACE, AUTOPATH_SDK_CHK_CONSTRAINT_ISCFREE
Parameter vapcs
in Callback_API_CheckConstraints() defines the autopath configuration space AutoPath_ConfigurationSpace
see example AutoPathInit()
[in] | ptr_CheckConstraints | (int) callback function pointer |
0 | - Ok |
1 | - Error |
|
static |
free memory of AutoPath_ConfigurationSpace data
see example AutoPathInit()
[in] | apcs | autopath configuration space AutoPath_ConfigurationSpace |
0 | - AUTOPATH_SDK_OK - OK |
1 | - AUTOPATH_SDK_ERROR - Error, AutoPath initialization failed |
|
static |
Initialize AutoPath
Call this functions to setup the autopath configuration space
Parameter apcs
defines the complete configuration for all used devices, such as
number of configurations up to AUTOPATH_SDK_KIN_DOFS, device handle for each configuration, device axis index, etc.
call AutoPathSetMem() first.
[in] | apcs | autopath configuration space AutoPath_ConfigurationSpace |
0 | - AUTOPATH_SDK_OK - OK |
1 | - AUTOPATH_SDK_ERROR - Error, AutoPath initialization failed |
2 | - AUTOPATH_SDK_INVALID_LICENSE - Error, AutoPath not licensed |
|
static |
allocate memory for AutoPath_ConfigurationSpace data depending on nConfig
see example AutoPathInit()
[in] | apcs | autopath configuration space AutoPath_ConfigurationSpace |
0 | - AUTOPATH_SDK_OK - OK |
1 | - AUTOPATH_SDK_ERROR - Error, AutoPath initialization failed |
|
static |
Terminate AutoPath
call AutoPathFreeMem() first, see example AutoPathInit()
[in] | apcs | autopath configuration space AutoPath_ConfigurationSpace |
0 | - AUTOPATH_SDK_OK - OK |
1 | - AUTOPATH_SDK_ERROR - Error, AutoPath initialization failed |
|
static |
AutoPath Version.
version | AutoPath version number |
|
static |
Clear all way points.
0 | - AUTOPATH_SDK_OK |
1 | - AUTOPATH_SDK_ERROR |
|
static |
Start motion planner, find a collision free path between start and end pose
In each step, the callback function "ptr_CheckConstraints" is called, to check constraints If the target is reached, the callback function is called with action parameter AUTOPATH_SDK_STATUS_MP_SUCCESS.
0 | - AUTOPATH_SDK_OK |
1 | - AUTOPATH_SDK_ERROR |
|
static |
Get maximum axis constraints return pointer, size nConfig.
|
static |
Get minimum axis constraints return pointer, size nConfig.
|
static |
current configuration pose during FindPath Process return pointer, size nConfig
|
static |
Get End Pose return pointer, size nConfig.
|
static |
Get number of calculated way points, including start and end pose
call this method after FindPath() succeeded.
number | of way points |
|
static |
Get parameter Paramter ap_option
is one of
AUTOPATH_SDK_PARAMETER_DYNADJUST
AUTOPATH_SDK_PARAMETER_ALGORITHM
AUTOPATH_SDK_PARAMETER_NTREES
AUTOPATH_SDK_PARAMETER_MIN_NUM_WAYPOINTS
AUTOPATH_SDK_PARAMETER_FORCE_DETERM_BEHAVIOR
AUTOPATH_SDK_PARAMETER_LIMIT_REVOLUTE_JNT_CSPACE
AUTOPATH_SDK_PARAMETER_THREAD_PRIORITY
AUTOPATH_SDK_PARAMETER_THREAD_EXECUTION
AUTOPATH_SDK_PARAMETER_SEED_VALUE.
[in] | ap_option | - autopath option |
0 | - AUTOPATH_SDK_OK |
1 | - AUTOPATH_SDK_ERROR |
|
static |
Get path planning status
The planning status is one of
AUTOPATH_SDK_STATUS_MP_IDLE
AUTOPATH_SDK_STATUS_MP_RUNNING.
planning | status |
|
static |
Get results Paramter ap_result
is one of
AUTOPATH_SDK_RESULT_CHECKS
AUTOPATH_SDK_RESULT_SECONDS
AUTOPATH_SDK_RESULT_CPS
AUTOPATH_SDK_RESULT_CFREE
AUTOPATH_SDK_RESULT_COBSTACLE
AUTOPATH_SDK_RESULT_CDENSITY
AUTOPATH_SDK_RESULT_DSECONDS
AUTOPATH_SDK_RESULT_SEED_VALUE
AUTOPATH_SDK_RESULT_QUALITY_INDEX
AUTOPATH_SDK_RESULT_QUALITY_INDEX_STD_DEV.
[in] | ap_result | - autopath result |
0 | - AUTOPATH_SDK_OK |
1 | - AUTOPATH_SDK_ERROR |
|
static |
Get Start Pose return pointer, size nConfig.
|
static |
Get way point.
[in] | idx | [0.. number of way points-1] |
pointer |
|
static |
Get dof of calculated way points.
dof | of way points |
|
static |
Set accuracy.
[in] | accuracy | [1..100] |
0 | - AUTOPATH_SDK_OK |
1 | - AUTOPATH_SDK_ERROR |
|
static |
Set axis constraints
Parameter setting
is a bitwise inclusive OR operator (|) of AUTOPATH_SDK_CONSTRAINT_RESET, AUTOPATH_SDK_CONSTRAINT_MIN, AUTOPATH_SDK_CONSTRAINT_MAX.
[in] | axisBit | - a bitwise inclusive OR operator (|) of AUTOPATH_SDK_AXIS_BIT_1 ... AUTOPATH_SDK_AXIS_BIT_24 |
[in] | setting | |
[in] | qConstraintMin | - size of nConfig |
[in] | qConstraintMax | - size of nConfig |
0 | - AUTOPATH_SDK_OK |
1 | - AUTOPATH_SDK_ERROR |
|
static |
Set axis enable.
0 | - AUTOPATH_SDK_OK |
1 | - AUTOPATH_SDK_ERROR |
|
static |
Set axis priority.
[in] | axisBit | |
[in] | priority | [1..50..100] |
0 | - AUTOPATH_SDK_OK |
1 | - AUTOPATH_SDK_ERROR |
|
static |
Set parameter Paramter ap_option
is one of
AUTOPATH_SDK_PARAMETER_DYNADJUST
AUTOPATH_SDK_PARAMETER_ALGORITHM
AUTOPATH_SDK_PARAMETER_NTREES
AUTOPATH_SDK_PARAMETER_MIN_NUM_WAYPOINTS
AUTOPATH_SDK_PARAMETER_FORCE_DETERM_BEHAVIOR
AUTOPATH_SDK_PARAMETER_LIMIT_REVOLUTE_JNT_CSPACE
AUTOPATH_SDK_PARAMETER_THREAD_PRIORITY
AUTOPATH_SDK_PARAMETER_THREAD_EXECUTION
AUTOPATH_SDK_PARAMETER_SEED_VALUE.
[in] | ap_option | - autopath option |
[in] | ap_value | - autopath value |
0 | - AUTOPATH_SDK_OK |
1 | - AUTOPATH_SDK_ERROR |
|
static |
Set end configuration
Remarks
This pose must be valid - collision free, based on callback function "ptr_CheckConstraints" to check constraints.
[in] | pose_end | pointer to start pose, maximum size AUTOPATH_SDK_KIN_DOFS |
0 | - AUTOPATH_SDK_OK |
1 | - AUTOPATH_SDK_ERROR |
|
static |
Set start configuration
Remarks
This pose must be valid - collision free, based on callback function "ptr_CheckConstraints" to check constraints.
[in] | pose_start | pointer to start pose, maximum size AUTOPATH_SDK_KIN_DOFS |
0 | - AUTOPATH_SDK_OK |
1 | - AUTOPATH_SDK_ERROR |