Detail/Summary/Season Scripts Readme

These detail/summary/season scripts are designed as add-on pages for the PHP templates available from Saratoga Weather. These pages use the dailynoaareport*.htm and climatedataout*.html files created by Weather Display to display the output.

Requirements:

  • You need to be uploading the dailynoaareport*.htm and climatedataout*.html files to your website.
  • Need to know where the dailynoaareport*.htm and climatedataout*.html files are located (default normally would be in the web root)
  • PHP5 on your website
  • To use the Humidity detail/summary/season scripts, you need Weather Display 10.37R build 73 or later.
  • To use the Max Solar or UV detail/summary scripts, you need Weather Display 10.37P build 50 or later.
  • To use the Snow Depth detail/summary scripts, you need Weather Display 10.37Q build 28 or later.
  • To use the Solar kWh detail/summary scripts, you need Weather Display 10.37Q build 46 or later.
  • To use the Evapotranspiration detail/summary scripts, you need Weather Display 10.37R build 29 or later.

The wxreport-settings.php file has settings that are common to all of the detail/summary files such as the paths to the dailynoaareport and climatedataout 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.

If you want to change the text on one of the link buttons, update the appropriate button text setting.

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 and UV reports. The wind reports are matched to the beaufort scale and
the UV reports use the scale used by the EPA.

Each of the reports (except wind and UV) 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 snow which can have large variations.

If you will be using the snow, snow depth, sunshine hours, solar, soil temperature, ET, or UV scripts, update the $start_year, $start_month, and $start_day settings in those files to when you first started recording that type of data. The default setting is the date I started recording that data so you will need to update it with your information.

For those with solar and/or UV sensors, you will need to use a new template to include the solar, ET, and UV values in the climatedataout files. Copy the climatedatasolaruv.html (or climatedatasolaruvdepth.html)  to the webfiles subdirectory of Weather Display and rename to climatedata.html and recreate the detailed climate reports for the months that you have been using the solar/UV sensors.

If you do not have a solar or uv sensor, there is no point in displaying  the Sunshine Hours, Solar Energy, or UV reports as they will have no  data to display.

If you will be using the Snow Depth reports, you will need to use the climatedatasolaruvdepth.html template to include the snow depth values in the climatedataout files. Copy the climatedatasolaruvdepth.html  to the webfiles subdirectory of Weather Display and rename to climatedata.html and recreate the detailed climate reports for the required months.

If you will be using the Soil Temperature reports, you will need to use the climatedatasoil.html template to include the soil temperature values in the climatedataout files. Copy the climatedatasoil.html  to the webfiles subdirectory of Weather Display and rename to climatedata.html and recreate the detailed climate reports for the required months.

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';
$SITE['uomSnow'] = ' 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 or climatedataout files and cannot or do not wish to add/correct the data in Weather Display, 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 dailynoaareport and climatedataout files 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.01 - Nov 8, 2014 - Added Wind Direction scripts.
  • 4.0 - Sep 8, 2013 - Added Humidity detail/summary/season scripts.
  • 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 - Jun 6, 2012 - Evapotranspiration detail/summary scripts added. Update to rain scripts for rain on the first day of the current month not being included in the NOAA report until the third day of the month.
  • 3.6 - Dec 27, 2011 - Added Multilingual support.
  • 3.53 - Nov 28, 2011 - Corrected table heading text in Dew Point and Wet Bulb season summary scripts.
  • 3.52 - Nov 17, 2011 - Fix to dewpoint, wet bulb, and barometer season summary scripts for those that have no data for a season.
  • 3.51 - Nov 12, 2011 - Fix for soil temperature season color bands.
  • 3.5 - Nov 10, 2011 - New Soil Temperature scripts. New seasonal summary scripts.
  • 3.18 - Jul 7, 2011 - Fix for seasonal year to snow depth summary script.
  • 3.17 - Jun 12, 2011 - Solar kWh detail/summary scripts added.
  • 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 - Added separate max/avg/min tables to the summary files for snow depth, solar energy, dew point, wetbulb, barometric pressure, and UV.
    Fix for wrong month displaying on trend mouseover on rain and snow summary scripts when using a seasonal year.
  • 3.12 - Feb 2, 2011 - Snow Depth detail/summary scripts added
  • 3.11 - Jan 25, 2011 - Fix to barometer scripts for when $show_today = true and mb units in testtags are not  in the same units as $uomBaro.
  • 3.10 - Jan 9, 2011 - Added minmax table to snow, solar, uv summary scripts
  • 3.08 - Jan 7, 2011 - Fix to dewpoint summary for celcius users whose average dew point never gets above 0.
  • 3.07 - Jan 6, 2011 - Added seasonal year option to rain summary script.
  • 3.05 - Dec 5, 2010 - Removed some test code inadvertently left in snow detail script.
  • 3.04 - Dec 1, 2010 - Fix to snow detail for first day of month when using show_today and seasonal year
  • 3.03 - Nov 30, 2010 - Fix to barometer script for when today's value for baromentric pressure is in kPa units in testtags, but in hPa in the climatedataout file.
  • 3.02 - Nov 29, 2010 - Fix to snow detail script for firstyear not showing in dropdown menu when using calendar year
  • 3.01 - Nov 27,2010 - Changed colspan setting for IE problem