数据子包
Profile 必须先创建并附加到 profile 库之后,才能作为对象属性值使用。要创建新的 profile,请使用 prg_profile_create_bt()。您也可以通过合并两个已有的 profile 来创建新的 profile,使用 prg_profiles_merge_bt()。要将 profile 附加到库,请使用库子包函数 prg_profile_lib_profile_add()。
Profile 作为对象属性值是间接指派的,即通过 profile 规格(profile specification) 完成。profile 规格是一个包含访问该 profile 所需信息的字符串。要将 profile 指派给对象属性,先使用 prg_profile_spec_get() 获取规格,然后使用内核过程 op_ima_obj_attr_set() 进行指派。
要访问 profile 的数据,必须先将其加载到内存中。如果该 profile 是某个对象属性值,使用 op_ima_obj_attr_get() 内核过程之一获取该 profile 的规格(作为字符串读入),然后使用 prg_profile_load() 加载该 profile。您也可以使用库子包函数 prg_profile_lib_profile_named_load() 或 prg_profile_lib_profile_nth_load() 直接从 profile 库加载 profile。当不再需要访问已加载的 profile 时,使用 prg_profile_unload() 解除对其的引用。
要释放您创建的 profile 所占用的内存,请使用 prg_profile_destroy()。
要从 profile 中检索信息和数据,请使用以下函数:
- prg_profile_name_get() 获取 profile 的名称。
- prg_profile_x_units_get() 和 prg_profile_y_units_get() 获取 x 和 y 数据的单位。
- prg_profile_data_length_get_bt() 获取 profile 中数据条目的数量。
- prg_profile_data_entry_get_bt() 从 profile 中检索一个数据条目。
- prg_profile_all_data_entries_get_bt() 检索 profile 中的所有数据条目。
- prg_profile_earliest_time_get() 和 prg_profile_latest_time_get() 分别检索 profile 数据条目中的最早时间和最晚时间。
- prg_profile_duration_get() 检索 profile 中最早时间与最晚时间之差。
- prg_profile_start_time_get() 获取 profile 的起始时间。
您可以使用 prg_profile_start_time_set() 设置 profile 的起始时间。
您可以使用 prg_profile_scale() 对 profile 中的数据进行缩放。
Profile 有时会在数据值中出现不期望的波动。要消除这些毛刺(glitch),请使用 prg_profile_data_glitch_remove()。