Package Overview
The Profile package allows you to create and manipulate profiles and profile libraries. It comprises two sub-packages:
Profiles store the data referenced by object attributes of type profile, such as traffic flows. A profile contains one or more entries (pairs of x-y values, usually representing a time-value pair), plus labels (units) for each axis. Profiles also contain a start time for the data. The start time allows profiles to be placed correctly in time relative to other profiles and to the calendar time of a simulation.
Each entry in a profile is a structure of the following type:
/* Single profile data entry */
typedef struct PrgT_Profile_Data_Entry
{
double x;
double y;
const char * const_string_ptr;
} PrgT_Profile_Data_Entry;
In this structure, x and y are the x-y values of the profile data point and const_string_ptr is a pointer to an optional string containing user-defined information related to the data point. In most cases, this is PRGC_NIL.
Profiles indicate gaps in data and the end of data with the y value PRGC_PROFILE_DATA_VALUE_UNDEFINED.
Note: Beginning with release 11.0, several old Profile package functions were replaced with similar functions that have names ending in _bt. Although existing code using the old functions will still work, it will ignore the date and time specified in the new profile format. Thus, profiles with different start times might overlap incorrectly. To avoid this potential problem, you should review code that merges or compares multiple profiles and modify it to use the new functions.