NovaStar Program Reference / Database / nsdbrecalibrate

• Overview
• Command Line Usage
• Examples
• Scheduling
• Troubleshooting

---

Overview

The nsdbrecalibrate program recalibrates point data (computes scaled value from raw value). Data is calibrated by default when filed, but may need to be recalibrated if the calibration changes, or if data reports are edited. In those cases, nsdbrecalibrate can be used to run the calibration again.

Command Line Usage

The command line syntax is:

nsdbrecalibrate...

Optional values are shown in square brackets. Command line parameters are as follows.

nsdbrecalibrate Command Line Parameters

Parameter	Description	Default
-c #	Calibrate using the provided calibration ID.	Calibrate using the currently active calibration.
-d[#]	Increase (-d) or set (-d#) diagnostic message display level.
-D #	Display # digits for the scaled value in the nsdbrecalibrate output.	Use the point type parameter.
-help --help	Print this usage.
-q	Quiet - no messages.
-r	Recompute rating after calibration done.
-R #	Display # digits for the raw value in the nsdbrecalibrate output.	Use the point type parameter.
-te DateTime	Ending time of report, where DateTime is: YYYY/MM/DD-HH:MM:SS where / can be [/+-.,] and : can be any non digit. +#[smhd...] - time offset added to current time. -#[smhd...] - time offset subtracted from current time.	Current time.
-ts DateTime	Start time of report (see -te for syntax).	1980-01-01T00:00:00
-v	Revalidate data after calibration finished.	Do not revalidate.
--version	Print the program version.

Examples

To recalibrate data from 1980-01-01 00:00:00 to now from the point with point numid 123 using the calibrations in the database:

nsdbrecalibrate 123

To recalibrate data for the year 2000 from the point with point numid 123:

nsdbrecalibrate -ts 2000/01/01-00:00:00 -te 2000/12/31-24:00:00 123

To recalibrate and verify data for the year 2000 from the point with point numid 123:

nsdbrecalibrate -ts 2000/01/01-00:00:00 -te 2000/12/31-24:00:00 -v 123

To recalibrate data and calculate ratings for the year 2000 from the point with point numid 123:

nsdbrecalibrate -ts 2000/01/01-00:00:00 -te 2000/12/31-24:00:00 -r 123

To recalibrate data for the year 2000 from the point with point numid 123 using the calibration 456:

nsdbrecalibrate -ts 2000/01/01-00:00:00 -te 2000/12/31-24:00:00 -c 456 123

Scheduling

nsdbrecalibrate is not run on a schedule by default. It can be added to the scheduler. However, there is not much reason to run it on a schedule - data is calibrated when filed by default, and changes that would affect calibration, such as a new calibration or data edits, are done by hand, and nsdbrecalibrate can hence be done manually at that time.

Troubleshooting

If nsdbrecalibrate is taking a long time to run, check that a start time was provided - by default it will process back to 1980, which may take a long time.

If the results are unexpected, check the calibration effective times.