sr_sda_get_raw_snapshot_list_c
status.i4.v = sr_sda_get_raw_snapshot_list_c(num_devices.i4.v,
device_indices.i4a.r,
properties.i2a.r,
array_indices.u4a.r,
sda_usage.i1a.r,
file_number.i4.v,
case_number.i4.v,
subcase_number.i4.v,
max_points.i4.v,
num_points.i4a.r,
points.sa.r, errors.i2a.r
[,data_events.sa.r])
This routine retrieves raw snapshot plot data for a list of devices
from an SDA save set.
num_devices number of devices
device_indices device index or array of device indices
properties property index or array of property indices
(If the first value is less than zero, all devices
will be requested with a property index which is
equal to the absolute value of this argument.)
(constants are in dbprops)
array_indices array index or array of array indices
sda_usage null terminated SDA usage string
file_number file (shot) number from which to retrieve data
case_number SDA case number
subcase_number SDA subcase (set) number
max_points maximum number of points to return per device
num_points returned array of number of valid points per device
points returned raw data points
(allow "max_points" per device)
(array of structures of type SDA_RAW_SNAPSHOT_POINT)
errors array of ACNET status values
data_events returned data events on which the plots were taken
(array of DATA_EVENT_DATA structures)
This function returns status values as follows:
OK success
DIO_MEMFAIL memory allocation failure
DIO_NOLIST requested list does not exist
DIO_BADARG invalid number of points requested
DIO_PEND no new data is available
DIO_TIMEOUT no data has returned from a front end
in the timeout period, list cancelled
negative value ACNET format error indicating overall failure
positive value number of devices in error indicating partial
success
This function requires the following include files:
cnsparam_h, cns_data_structs_h, cbslib_h, acnet_errors_h
Related functions:
sr_sda_get_snapshot_list_c, sr_sda_get_snap_num_points_list_c,
sr_sda_get_ftp_list_c, sr_sda_get_raw_ftp_list_c,
sr_sda_get_ftp_num_points_list_c, sr_get_array_device_c,
sr_sda_cases_present_c, sr_sda_num_subcases_c,
sr_sda_subcases_present_c, sr_sda_case_times_c,
dio_get_snapshot_list_c, dio_build_snapshot_list_c,
dio_cancel_snapshot_list_c, dio_can_snapshot_c,
dio_snapshot_class_info_c
C/C++ usage:
satic const char sda_usage[] = "ColliderShot";
short properties = -PRREAD;
short errors[NUM_DEVICES];
int status;
int num_devices = NUM_DEVICES;
int device_indices[NUM_DEVICES] = {14430};
int file = 6216;
int case_number = SDA_CASE_CS_ACCELERATION;
int subcase_number = 0;
int max_points = MAX_POINTS;
int num_points[NUM_DEVICES];
unsigned int array_indices[NUM_DEVICES] = {0};
SDA_RAW_SNAPSHOT_POINT points[NUM_DEVICES*MAX_POINTS];
DATA_EVENT_DATA data_events[NUM_DEVICES];
status = sr_sda_get_raw_snapshot_list_c(num_devices,device_indices,
&properties,array_indices,
sda_usage,file,case_number,
subcase_number,max_points,
num_points,
(SDA_RAW_SNAPSHOT_POINT *) points,
errors,data_events);