TTS Adjuster FAQ

Can you use either the beginning or ending date of the TTS raw file in the filename?

Does the program require observer records for each data dump at a station?

How many fields does the Station Information file require, and do the stage fields need to be in the same order as the observer stage readings?

What happens if a dump number is skipped in the field?

What do you enter for a missing staff plate reading in an observer record?

Does an observer record have to match the ending of the data dump?

What does it mean when I am appending raw files and I get an error “unparseable date”?

Can you undo an adjustment in the FLO file after you have saved the file?

How do you correct a staff plate reading in the OR file after the raw files have been appended?

Exactly what happens during appending?

How does the program decide what to append?

What happens when a data file includes data from more than one water year?

Why won't the program append my data file?

Are extra data fields permitted for measurements extraneous to TTS?

How do I open a file for editing in NotePad when its file extension is not TXT?

How do I start a new FLO file?

Why does the program seem to hang sometimes when I return to it from another window?

Can a corrected segment be coded as good or questionable?

If multiple alterations are done to a segment, how is the segment coded?

Can I print out a scatterplot?

Can I alter fonts or colors on the plots?

Why does the program sometimes ignore my attempts to adjust the data?

Why does the program not show a blue line at the bottom when I replaced stage data with missing values?

How can I tell what data dump I am looking at?

Can you use either the beginning or ending date of the TTS raw file in the filename?

By default, the program expects the beginning date in the data logger filename. However, if a file is encountered that uses the ending date in the filename, the program will ask whether that was intentional and, if you wish, you can use that convention for the remainder of the session.

Does the program require observer records for each data dump at a station?

No, but if there is no OR file, you will get a popup message indicating that it was not found.

How many fields does the Station Information file require, and do the stage fields need to be in the same order as the observer stage readings?

Only 3 fields are required if there are no staff plate readings: station name, watershed area, and stage units. Staff plate types follow, if any are used at the site. The ordering of staff plates in stationinfo.txt should match the ordering of staff plate readings in the OR file.

What happens if a dump number is skipped in the field?

The program will prompt you for the correct dump number. It is OK to skip a dump number and that may be the prudent course because the dump numbers in the lab data must match those in the appended data. It is important to make sure that the physical bottle labels reflect any changes in the dump numbering.

What do you enter for a missing staff plate reading in an observer record?

Enter NA in place of the stage. No quotes.

Does an observer record have to match the ending of the data dump?

No. (That was a requirement of an earlier processing program used at Redwood Sciences Lab)

What does it mean when I am appending raw files and I get an error “unparseable date” (it tries to read one more record past the end of the file)?

It means the program is trying to read a date and it is either in the wrong format or the line is blank. This commonly happens when extra line delimiters are left at the end of a file after a NotePad editing session.

Can you undo an adjustment in the FLO file after you have saved the file?

Yes.

How do you correct a staff plate reading in the OR file after the raw files have been appended?

Use NotePad or any text editor to edit the OR file. The next time you open that segment in Adjuster, the new ORs will appear. Be sure NOT to insert blank lines at the end of the OR file. Trailing blank lines will cause the program to report ‘Error reading OR file at line xx: Unparseable date’.

Exactly what happens during appending?

Dates are reformatted, turbidity and threshold codes are converted to alphanumeric codes, corrected stage and turbidity are inserted by copying the raw data values, and discharge is inserted as NA. (Discharge is calculated only when data are saved from the plot window, and only where the stage has been accepted or edited by the user). Stage and turbidity codes are initially inserted as “-1”. Small gaps of no more than two records are filled by interpolation of the raw stage and turbidity, in which case the stage and turbidity codes are set to the value “5”. This is the only situation in which BOTH the raw and corrected values are interpolated, and this is the only situation in which discharge will be calculated without any action by the user other than saving the interpolated segment from the plot window.

How does the program decide what to append?

When the user chooses to append to an existing FLO file, the program looks to see if there are any data files in the corresponding raw directory. The files are ordered alphanumerically by file name. Appending begins with the first file that begins after the end of the selected FLO file. If there are no more files to append, and if there are files in the following year’s raw directory, the user will be prompted to start a new FLO file.

What happens when a data file includes data from more than one water year?

When appending from a data file that extends into the next water year, the append process is terminated at the end of the current water year.

When starting a new FLO file, the program sorts the files in LAST year’s raw directory alphanumerically by name, and looks in the last file for any data in the current water year. If it contains data from the current water year, those data begin the new FLO file. The dump number for those data is set to zero, in order to maintain an ascending sequence of dump numbers. However, there is an undesirable side effect, i.e. dump numbers of corresponding samples in the lab data need to be manually changed to zero in order to show them on scatterplots or use them in subsequent analyses.

Why won't the program append my data file?

Some sort of error has probably been detected in the data. If the program does not tell you the nature of the error, please contact Jack Lewis (jlewis01@fs.fed.us). The most common error that the program catches is a sequence error, in which the time between two data records is not either (1) the nominal wakeup interval, or (2) a positive multiple of the nominal wakeup interval. Such a situation can only be remedied by (1) editing the raw data, or (2) if the time interval has permanently changed, processing the data for each wakeup interval in separate FLO files (i.e. process one wakeup interval, rename the FLO file, move the processed data out of the raw directory, and then process the other wakeup interval).

Are extra data fields permitted for measurements extraneous to TTS?

Yes. Any extra data fields will be copied to the FLO file without alteration.

How do I open a file for editing in NotePad when its file extension is not TXT?

Right-click on the file in Windows Explorer and select 'Open With ...'. Then select 'NotePad' or 'Choose Program'. If you select 'Choose Program', you can check the box 'Always use this program to open these files', in which case you can simply double-click to open that type of file in the future. Alternatively, you can associate any extension with any application via the Tools ... Folder Options ... File Types dialog in Windows Explorer.

How do I start a new FLO file?

First put the new data in the new raw file directory. Then, in the TTS File Dialog, select the most recent appended FLO file. Click on the APPEND button. If the most recent FLO file is up-to-date, you will be prompted to start a new FLO file.

Why does the program seem to hang sometimes when I return to it from another window?

If, in a Windows operating system, you leave the Adjuster window (to access another application) when a message popup or file dialog is displayed, the program will seem to hang when you come back to it. That's because the popup or file dialog is blocking the main plot window. You must complete the dialog before you can continue. The difficulty is in finding the dialog. Activating the Adjuster Window from the Task Bar brings you to the (blocked) main plot window. This is a documented Java bug (ID 4255200). The solution is to activate the Adjuster Window by pressing Alt-Tab until the Java icon is selected. This will bring you to the popup or file dialog, so you can complete the dialog and then proceed.

Can a corrected segment be coded as good or questionable?

No. The "good" and "questionable" codes pertain only when the raw data are accepted. When you click on "Code Raw Data as Good" or "Code Raw Data as Questionable", then all raw data in the selected segment will be recoded, but any corrected data will remain unaltered.

If multiple alterations are made to a segment, how is the segment coded?

The segment will be coded according to the last operation that was performed. For example a shift followed by an interpolation will be coded as an interpolation, even though both operations influence the final result.

Can I print out a scatterplot?

Not directly. However you could do a screen capture with a utility such as SnagIt.

Can I alter fonts or colors on the plots?

Not directly. However you could export the plot using File ... Export EPS, then edit the plot in Adobe Illustrator or another application (let me know if you find one) that can work with PostScript graphs. The Export EPS menu item saves only the main plot window.

Why does the program sometimes ignore my attempts to adjust the data?

This can happen if you have used "Replace bad data with missing" on the segment being corrected. Corrections cannot be made to missing data or on any segment with missing data at the endpoints. If you have inserted missing data then you must use "replace with raw data" before corrections can be made.

This may also appear to happen if the data have already been adjusted at the segment boundary on which you are clicking. No adjustment occurs when you click at the value of the adjusted data. This happens when you have forgotten to nudge the boundary over to the next uncorrected point before adjusting.

Why does the program not show a blue line at the bottom when I replaced stage data with missing values?

This sometimes appears to happen because the blue line is hidden beneath the red line shown for missing turbidity data. To confirm that this is the case, remove the red line, by selecting Format from the Edit menu and unclicking the "Line" radio button for corrected turbidity

How can I tell what data dump I am looking at?

The easiest way, if samples have been collected, is to choose Format from the Edit Menu and change the bottle label to "Dump".