Detail/Summary Scripts Readme

These detail/summary scripts are designed as add-on pages for the PHP template packages available from Saratoga Weather. These pages use the NOAA report files created by Cumulus, WeatherLink, VWS, or wview.

Requirements:

  • You need to be uploading the monthly NOAA report files to your website.
  • PHP5 on your website

The wxreport-settings.php file has settings that are common to all of the detail/summary files such as the paths to the NOAA report files. It also has settings as to which links to other detail/summary reports are to be displayed on the various reports. If you do not want a link to a specific report to show, set the show link option for that page to false.

If you rename any of the detail/summary files, update the appropriate filename settings to the new filename or the links will not work.

The wxreportinclude.php file contains the logic as to which (if any) link buttons to display on the detail/summary reports based on the settings you made in the wxreport-settings.php file. There are no settings to make in wxreportinclude.php.

A common css file (wxreports.css) is now used. But if you want to use different color schemes for different reports, you can use a different css file. Just update the $css_file setting in the appropriate detail/summary file(s).

An option available in the existing (and new) detail/summary files is to allow changing the number of possible colorbands to be displayed up to a maximum of 30. Change the $increment setting in the individual detail/summary file as needed. The default setting is 11 increments which provides 13 colorbands (one  below the first increment and one over the last increment). If you do increase the increments setting to more than 11, you will need to edit the css file to add the additional colorbands yourself

NOTE: There is no option to change increments in the wind reports. The wind reports are matched to the beaufort scale.

Each of the reports (except wind) also have a option to set the values between increments manually. This allows the increments to be non-linear (.1, .5, 1, 3, 5, 10, 15, etc). This is primarily useful for rain which can have large variations.

The units of measurements used by the  detail/summary scripts depends on the settings made in the settings.php  of the template set.
$SITE['uomTemp'] = '°F';
$SITE['uomBaro'] = ' inHg';
$SITE['uomWind'] = ' mph';
$SITE['uomRain'] = ' in';
These need to be set to match whatever units you are using.
$SITE['latitude'] should be positive if you are north of the equator and negative if you are south of the equator.

If you have missing or incorrect data in your NOAA Reports and cannot or do not wish to add/correct the data in your weather program, you can manually provide the data in a csv file. Open the sample wxreportsmmyyyy.csv file included in the zip download in a spreadsheet. Enter the necessary data in the appropriate column. You only need to add data for the values you wish to add or correct. Do not make any changes to the header row. Save the updated file as wxreportmmyyyy.csv where mm is the month number (2 characters) and yyyy is the year (i.e. wxreports062012.csv for June 2012). Upload to the same folder where the NOAA reports are located. If you have bad data for an item but do not know what the correct value should be, you can enter a 'D' (without the quote marks) for that item and day and the scripts will ignore the data for that day.

VERSION History:

  • 4.03 - Mar 11, 2015 - Updated wxwinddirectionxxx scripts and wxreportinclude.php files to handle invalid wind direction data.
  • 4.01 - Nov 8, 2014 - Added Wind Direction Scripts.
  • 3.82 - Apr 7, 2013 - Added support for wview.
  • 3.81 - Sep 28, 2012 - Added option to ignore bogus NOAA data.
  • 3.8 - Aug 26, 2012 - Added check for manually provided NOAA data in csv file format.
  • 3.7 - May 12, 2012 - Update for Weatherlink users.
  • 3.6 - Dec 27, 2011 - Added support for Cumulus, WeatherLink, and VWS generated NOAA reports.
  • 3.53 - Nov 28, 2011 - Corrected table heading text in Dew Point and Wet Bulb season summary scripts.
  • 3.16 - May 17, 2011 - Wind Run detail/summary scripts added.
  • 3.15 - May 9, 2011 - Added option to wxwinddetail and wxwindsummary scripts to round windspeed to nearest integer.
  • 3.14 - Mar 9, 2011 - Fix to temp detail script to remove leading zero on single digit temps in the monthly low row.
  • 3.13 - Feb 11, 2011 - Fix for wrong month displaying on trend mouseover on rain summary script when using a seasonal year.
  • 3.07 - Jan 6, 2011 - Added seasonal year option to rain summary script.
  • 3.01 - Nov 27,2010 - Changed colspan setting for IE problem