Once you unzip it you will see these files.

Main.cpp  Makefile  USHCN.cpp  USHCN.exe  USHCN.h

USHCN.exe is a Windows executable. Makefile is a Gnu makefile. If you aren’t a C++/STL programmer, you will probably have a difficult time understanding how it works.

In order to run it, you will need two files in the same directory as the executable.

http://cdiac.ornl.gov/ftp/ushcn_daily/ushcn-stations.txt

and any one of the the data files below. You will have to unzip the data file after you download it using gunzip.

Usage is : ushcn.exe USHCN_DATA_FILE_NAME [month=0-12] [max] [min]

Examples. Open up a command prompt window. Navigate to the directory with USHCN.exe, ushcn-stations.txt, and state41_TX.txt

ushcn.exe state41_TX.txt  > Texas.csv   – dumps out csv information for Texas to file Texas.csv

ushcn.exe state08_FL.txt  month=5 max > Florida_May_Max.csv   – dumps out csv information for Florida May maximum temperatures

ushcn.exe us.txt > US.csv – dumps out all US information

The code makes no attempt to do any adjustments or corrections. All it does is find all valid temperature recordings for all stations on all days, calculates averages – and finds min/max records per day of year for each station. There is no time bias. Earlier years are neither favored nor disadvantaged.

The reason I don’t do any corrections is because I am assuming a Monte Carlo distribution of error, which is the normal way that real scientists handle large data sets. There is no valid reason to believe that a huge data set created by thousands of observers over 130 years would have any systematic time-dependent bias to it – other than UHI. People read thermometers the same way in 1980 as they did in 1934.

If you mess the code up, take responsibility for it and don’t try to blame your mistakes on me.

	state01_AL.txt.gz	23-Apr-2012 14:21	2.1M
	state02_AZ.txt.gz	23-Apr-2012 14:21	2.9M
	state03_AR.txt.gz	23-Apr-2012 14:21	2.3M
	state04_CA.txt.gz	23-Apr-2012 14:21	6.8M
	state05_CO.txt.gz	23-Apr-2012 14:21	3.8M
	state06_CT.txt.gz	23-Apr-2012 14:21	521K
	state07_DE.txt.gz	23-Apr-2012 14:21	598K
	state08_FL.txt.gz	23-Apr-2012 14:21	2.8M
	state09_GA.txt.gz	23-Apr-2012 14:21	3.3M
	state10_ID.txt.gz	23-Apr-2012 14:21	3.9M
	state11_IL.txt.gz	23-Apr-2012 14:21	6.3M
	state12_IN.txt.gz	23-Apr-2012 14:21	5.4M
	state13_IA.txt.gz	23-Apr-2012 14:21	4.2M
	state14_KS.txt.gz	23-Apr-2012 14:21	5.0M
	state15_KY.txt.gz	23-Apr-2012 14:21	2.0M
	state16_LA.txt.gz	23-Apr-2012 14:21	2.6M
	state17_ME.txt.gz	23-Apr-2012 14:21	1.7M
	state18_MD.txt.gz	23-Apr-2012 14:21	1.9M
	state19_MA.txt.gz	23-Apr-2012 14:21	1.5M
	state20_MI.txt.gz	23-Apr-2012 14:21	4.0M
	state21_MN.txt.gz	23-Apr-2012 14:21	5.2M
	state22_MS.txt.gz	23-Apr-2012 14:21	4.4M
	state23_MO.txt.gz	23-Apr-2012 14:21	3.9M
	state24_MT.txt.gz	23-Apr-2012 14:21	6.1M
	state25_NE.txt.gz	23-Apr-2012 14:21	7.5M
	state26_NV.txt.gz	23-Apr-2012 14:21	1.8M
	state27_NH.txt.gz	23-Apr-2012 14:21	812K
	state28_NJ.txt.gz	23-Apr-2012 14:21	1.8M
	state29_NM.txt.gz	23-Apr-2012 14:21	3.8M
	state30_NY.txt.gz	23-Apr-2012 14:21	8.5M
	state31_NC.txt.gz	23-Apr-2012 14:21	4.4M
	state32_ND.txt.gz	23-Apr-2012 14:21	3.8M
	state33_OH.txt.gz	23-Apr-2012 14:21	4.7M
	state34_OK.txt.gz	23-Apr-2012 14:21	6.1M
	state35_OR.txt.gz	23-Apr-2012 14:21	5.7M
	state36_PA.txt.gz	23-Apr-2012 14:21	3.6M
	state37_RI.txt.gz	23-Apr-2012 14:21	363K
	state38_SC.txt.gz	23-Apr-2012 14:21	4.2M
	state39_SD.txt.gz	23-Apr-2012 14:21	4.1M
	state40_TN.txt.gz	23-Apr-2012 14:21	2.5M
	state41_TX.txt.gz	23-Apr-2012 14:21	6.4M
	state42_UT.txt.gz	23-Apr-2012 14:21	5.4M
	state43_VT.txt.gz	23-Apr-2012 14:21	1.2M
	state44_VA.txt.gz	23-Apr-2012 14:21	2.7M
	state45_WA.txt.gz	23-Apr-2012 14:21	6.0M
	state46_WV.txt.gz	23-Apr-2012 14:21	1.6M
	state47_WI.txt.gz	23-Apr-2012 14:21	4.0M
	state48_WY.txt.gz	23-Apr-2012 14:21	3.8M
	station_file_format.txt	07-Jul-2009 16:17	2.9K
	us.txt.gz	23-Apr-2012 14:21	178M