Link to USGS home
Surface Water Information--Data Scripts

showtx

This script is not yet supported (and may never be), but is provided in the interim because many users may find it valuable. Questions about this script should be referred to the script author. The status of the script is noted.

Name:
showtx - A utility to quickly display the last 8 hours of raw transmitted data for a station/DCP with an option to convert "pseudo binary" transmissions to readable integers.

Status:

Automated pseudo-binary conversion will likely only work for Sutron DCP's with this initial version. Other manufacturer's standard pseudo-binary transmission formats could not easily be found by the author. If you have information on standard pseudo-binary transmission formats for other DCP manufacturers, please provide them to the author. It's not supported at this point largely due to that limitation and the inherent complications, but if folks really find this useful it could be supported. Let us know.

Information:

This script prompts for a station ID or DCP ID and retrieves the latest data from approximately the last 8 hours of transmissions and displays them to the user. The user then has the option of converting any displayed three character 'pseudo binary' code into readable integers (only standard Sutron 3-characters pseudo-binary transmissions are converted - note that decimals are not included). Pseudo binary is the compressed data format used by many data collection platforms transmitting via GOES satellite.

To run the script, simply download it, make it executable (chmod +x showtx) and run it. Station ID or DCP ID can be provided on the command line or it will be prompted for.

Usage: showtx DCPorStationID

where DCPorStationID is a valid DCP or Station ID (note that the script relies on a USGS/NWS cross-reference available
here: http://www.nws.noaa.gov/oh/hads/USGS/CO_USGS-HADS_SITES.txt for finding DCP ID's when a station ID is entered. That list is sometimes not updated or correct for a given station - if that's the case, the user must enter the correct DCP ID.) User is prompted for the information if not provided on the command-line.

Example Output:

nwisdcolka:/home/walker> showtx 07103700
Running in temp directory...
/home/walker/.showtx_tmp_walker


Version 1.0
******************************************************************
*                                                                * 
*                          showtx                                *
*                                                                *
* Quickly show raw Tx data for a given DCP or station ID and     *
* convert pseudo binary Tx's into readable integers if necessary *
*                                                                *
* Please address comments, questions, bug reports, etc... to:    *
* GS_W_OSW_Scripts@usgs.gov                                      *
******************************************************************




Using DCP ID DD78F63E assigned to station 07103700...



Last 8 hours of raw transmissions for DCP DD78F63E (if any):
 Most recent Tx's first.

bB1K@EE@EE@EE@ED@ED@EE@ED@EE@EE@ED@ED@EE@EE@EF@EE@EEO 
bB1K@ED@EE@ED@EE@EE@ED@ED@EE@EE@EF@EE@EE@EE@EE@EE@EEL 
bB1K@EE@ED@ED@EE@EE@EF@EE@EE@EE@EE@EE@EE@EE@ED@EE@EEM 
bB1K@EE@EF@EE@EE@EE@EE@EE@EE@EE@ED@EE@EE@ED@ED@ED@EDO 
bB1K@EE@EE@EE@EE@EE@ED@EE@EE@ED@ED@ED@ED@ED@ED@ED@EDN 
bB1K@EE@ED@EE@EE@ED@ED@ED@ED@ED@ED@ED@ED@EE@EE@EE@EEP 
bB1K@ED@ED@ED@ED@ED@ED@ED@ED@EE@EE@EE@EE@EE@EE@EE@EEM 
bB1K@ED@ED@ED@ED@EE@EE@EE@EE@EE@EE@EE@EE@EE@EE@EE@EEJ 


Convert pseudobinary values to readable integers? (CR=Y):     

Converting pseudobinary values for self timed and random Tx's...



Last 8 hours of any self timed transmitted values for dcp:
  Most recent values and Tx's first...

325 325 325 324 324 325 324 325 325 324 324 325 325 326 325 325 15 
 324 325 324 325 325 324 324 325 325 326 325 325 325 325 325 325 12 
 325 324 324 325 325 326 325 325 325 325 325 325 325 324 325 325 13 
 325 326 325 325 325 325 325 325 325 324 325 325 324 324 324 324 15 
 325 325 325 325 325 324 325 325 324 324 324 324 324 324 324 324 14 
 325 324 325 325 324 324 324 324 324 324 324 324 325 325 325 325 16 
 324 324 324 324 324 324 324 324 325 325 325 325 325 325 325 325 13 
 324 324 324 324 325 325 325 325 325 325 325 325 325 325 325 325 10 
 
Note that decimals are not inserted and last few values
  may not be correct if appending BatV or lat long, etc...


No random Tx's detected in last 8 hours.

Finished running showtx.

Exiting showtx...

 

Script Language:
ksh

Requirements:
The script requires two websites be up and operational to work properly: http://www.nws.noaa.gov/oh/hads/USGS/CO_USGS-HADS_SITES.txt and http://water.usgs.gov/cgi-bin/lrgs/lrgsData (note that the 2nd website contains similar functionality, but requires the user to know a bit about the transmission format before you can convert the pseudo binary).

Author(s): (for unsupported scripts, please address questions/comments to the author)
Original author Wade Walker (walker@usgs.gov), Colorado WSC (stealing code from Bubba Brossett/Barry Jackson's bb script [a simplified update of the pb script...])

Known Problems/Limitations/Need Improvements:
Pseudo binary decoding likely won't work with anything but Sutron DCP's. Sometimes the NWS/USGS station cross-reference used to get the DCP ID when a station ID is entered is out of date and the script won't find the DCP ID corresponding to a station. You have to enter the DCP ID directly if that's the case.

Scripts:

Version 1.0 (Posted 12/19/11):
(initial release)
showtx download (Zip file = 3.8K)

Back to Scripts
[an error occurred while processing this directive]