| file | the hdf file to update |
| sds_name | the name of the new dataset (sds: scientific dataset) to add |
| sds_type | the hdf type code of the new dataset, e.g. DFNT_UINT16, DFNT_FLOAT32... (see HDF documentation for valid type codes) |
| rank | the rank (number of dimensions) of the new dataset to create |
| dimensions | a pointer to the array of dimensions of the new dataset |
| cal | the calibration factor linked to the new dataset (also named slope); relation between calibrated and uncalibrated data is: cal_data = cal*(uncal_data - offset) |
| offset | the offset factor linked to the new dataset; relation between calibrated and uncalibrated data is: cal_data = cal*(uncal_data - offset) |
| cal_err | error on the calibration factor (unused for the time being) |
| off_err | error on the offset (unused for the time being) |