Detail/Summary Scripts Readme

These detail/summary scripts are designed as add-on pages for the WD-AJAX-PHP-USA package 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 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.

Version 3 of the detail and summary reports is now available. Additional options have been added to the existing Temperature, Rain, Wind, and Snow reports. Also now available are Barometric Pressure, Degree Days, Dew Point, Wetbulb, Sunshine Hours, Solar Energy, UV, and Snow Depth detail and summary reports.

A change that is common to all of the detail/summary files is the addition of two include files. 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).

A new 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, 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 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.

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.

VERSION History:

  • 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