-------------------------------------------------------------------------------

Surfer(R) Version 8.02 ReadMe File 9-28-02

Copyright (c) 2002 Golden Software, Inc.

All rights reserved.
-------------------------------------------------------------------------------

System Requirements
===================
- Windows 98, Me, 2000, XP or higher.
- Windows 95 and NT are not specifically disallowed, but are no longer
supported.
- 800 X 600 or higher monitor resolution with support for at least 256 colors
- 20 MB of free hard disk space in the Windows drive.
- 13 MB of free hard disk space.
- At least 8 MB RAM above the Windows requirement for simple data sets.
At least 128 MB of RAM above the Windows requirement for large bitmaps
and surface maps recommended.

Changes and Bug Fixes in Surfer 8.02

====================================
- Creating a periodogram from some unusual grids can cause a crash (fixed).
- Fixed an internal error when calculating the kriging standard deviation grid.
- Fixed a problem with post map label lines being drawn incorrectly.
- Fixed an issue with slow save times in the worksheet.
- Bitmaps sometimes draw upside down (fixed).
- Two small memory leaks were fixed in the bitmap export code.
- Fixed some problems with the SYLK import/export to make it faster when there
are a lot of cell formats present.
- Exporting an "empty" plot to a GSB or MIF file resulted in an invalid file
(fixed).
- Fixed an internal error when saving the worksheet to SLK format.
- Fixed a problem reading some LVL files that resulted in a "Bad format" message.
- The EMF import filter reported an "Internal Inconsistency" error with some
metafiles (fixed).
- Metafiles sometimes lose the right and bottom edges when drawn (fixed).
- Updated the symbols.srf example to use the latest symbol sets.
- Fixed an internal error message during gridding. This was caused by an out of
memory condition that was not correctly reported due to a Microsoft bug.
- Increased the precision of polynomial regression. This allows a few marginal
cases with large orders to proceed to completion.
- Worked around several printer issues related to printing bitmaps. Most of
these problems were related to poorly written HP printer drivers that do not
implement the required functionality or report incorrect information
to the program.
- Fixed a bug in the Inverse Distance Gridding algorithm that resulted in
incorrect grids if there are no faults and the power is not equal to 2.0.
- Some metafiles produced by Surfer could not be read by non-Golden Software
apps due to incorrect information in the metafile header (fixed).
- Fixed a bug that caused imported GSI files to import at 1,000,000 times the
correct size.
- Modified the base map font scaling to NOT scale text when the base map is
scaled. This allows the font size displayed in the base map dialog to
accurately reflect the physical size in the drawing, and emulates the Surfer
7 behavior. A similar modification was made for symbols in base maps.
- Fixed a minor bug that caused the Y axis title on variograms from being
updated when the estimator was changed.
- Fixed a floating point exception that was triggered by setting the in-line
label font height to 0.0.
- Added an error message if an attempt is made to digitize a map with
perspective projection. This is no longer allowed due to accuracy issues.
Change the map to orthographic projection before digitizing.
- The MIF import filter has been improved to handle rotated text better.
- Line width in surface plots was not correct at various zoom levels or when
printed (fixed).

Changes and Bug Fixes in Surfer 8.01

====================================
- Fixed a redraw issue caused by showing/hiding the rulers
- Clipped image maps were extrapolating colors beyond the grid limits (fixed)
- Includes the latest version of Sax BASIC (change list not available)
- Disabled F1 Help in Internet Update
- Added the requested size of the bitmap to the error message when a bitmap
cannot be created
- Disabled unused ID fields in some output option dialogs (like SHP)
- Resolved conflicting hotkeys in the Map menu
- Fixed an issue when reading CSV files (blanks were interpreted as delimiters)
- Added the XLS extension to the "Files of Type" list in the File Open dialog
- Fixed a bug that resulted in a very long grid report when breaklines were used
- Improved error messages when bitmap output fails
- Fixed an internal error that resulted from vector pattern names longer than
29 characters.
- Fixed an issue with the Scripter help window always being on top
- Added a better error message when a standard deviation grid is completely
blanked
- Help | Feedback | Problem Report now does a better job distinguishing the OS
and version number
- The worksheet has been modified to correctly read BLN files with space delimiters
- Surfer 8 now closes unclosed polygons in BLN files
- Now shipping and installing MSVCP60.DLL
- Fixed an issue with class limits when the maximum data value is exactly 0.0
- The WMF import filter has been altered to work around a problem with bad
PolyPolygon data in some metafiles
- Worked around a Microsoft bug that failed to output carriage returns in
reports saved in TXT format
- Changing the worksheet columns in the Grid Data dialog resulted in several
errors when the columns contained data in disjoint rows (fixed)
- Fixed an issue that prevented validation of the serial information when
executed by a non-Administrator account
- Worked around an issue when printing custom bitmap patterns on Postscript
printers
- Fixed a bug that caused all 3D OpenGL text to be output in bold
- Modified the printer output code to reduce the output file size and increase
the speed. Most of these issues were related to true-color bitmaps
- Surfer was ignoring the nugget effect when kriging (fixed)
- The GSB export filter has been fixed (it would occasionally write an invalid
file).
- Dithering has been improved when exporting to bitmap formats.
- The SHP import filter now correctly recognizes "No Data" values.
- Image map resolution has been improved when exporting to bitmap formats. See
the new MaxImageMapRes setting below for additional information.
- Worksheet Cell Properties dialog now displays the proper cell type when an
entire column is selected.
- Surfer no longer opens two copies of worksheet files when the data files are
double clicked from the shell.
New Features in Surfer 8.0
==========================
- Color rendered surface maps.
- Overlay raster and vector maps on surface maps.
- Grid Mosaic to combine adjacent grids into a single grid file.
- Cross-validation to assess the quality of a gridding method.
- New Filters and smoothing methods, including user-defined filters.
- Map Delaunay Triangles used by Triangulation and Natural Neighbor
gridding methods.
- Use up to 1 billion data points in the worksheet and when gridding,
subject to memory and Windows version requirements.
- Retain faults in blanked grids.
- Display bitmap and metafile information.
- Generate data and grid statistics reports.
- Rotate and tilt raster maps (bitmap base maps, image maps, shaded relief
maps).
- SRF files are compressed with new bitmap compression routines.
- New gridding methods: Moving Average, Local Polynomial.
- Data Metrics to calculate spatial data statistics.
- New variogram models: Cubic, Pentaspherical.
- Specify Z scale factor in volume calculations when Z units differ from
XY units.
- Faster loading for large data files by postponing sorting and duplicate
checking until gridding begins.
- New import formats: Enhanced Metafile EMF, Golden Software Interchange GSI,
ESRI Arc/INFO Export E00.
- New export formats: Enhanced Metafile EMF, Golden Software Interchange GSI,
MapInfo Interchange Format MIF, Golden Software Boundary GSB.
- ANOVA statistics in gridding and variogram reports.
- Trackball tool for easier rotating, tilting, and perspective changes.
- Pan tool for dragging the view without using the scroll bars.
- Zoom Realtime tool.
- Elimination of the 32 inch page size in Windows 98, Me.
- Check for Update to download program updates.
- Modeless object properties dialog box stays open when you select
different objects.

Installing Surfer
=================
Golden Software does not recommend installing Surfer 8 over any previous
version of Surfer (e.g., Surfer 7) or in the same directory as an older
version. Surfer 8 can co-exist with older versions as long as they are
in different directories.

Prior to installing Surfer 8, uninstall any previous versions of Surfer 8

using the Control Panel | Add/Remove Programs menu. Select Surfer 8 from
the list under the Install/Uninstall tab. Click the Add/Remove button to
uninstall Surfer. Versions prior to Surfer 7 will not appear in the Add/Remove
Programs list.

To install Surfer 8 under Windows 2000 and XP, you need to have permissions
as a local Administrator for that machine.

Network Installation
====================
An administrative install may be performed in order to install files to a
network server. Once installed on the network server, individual workstation
installations can be performed. The server software must support long
filenames.

*** ATTENTION: You may use Surfer on a networked system provided that the
*** number of Surfer users on the network at one time does not exceed the
*** number of licensed copies of Surfer.

To install Surfer on the server:

1. Log on to the file server with administrator rights.
2. Click Start | Run.
3. Enter the path to Setup.exe followed by /a. For example,
r:\Setup.exe /a
4. When Setup asks for a destination folder, choose one on the file server
(e.g. x:\SurferServer). This should be a new empty directory. Setup copies
the Surfer files to the server drive.
5. We recommend flagging the server folder contents as read-only.

Next, install Surfer at each of the workstations:

1. Log on to the file server from each workstation that will run Surfer.
2. Start Windows and double-click on the "Surfer 8.msi" file located on
the server. Specify the desired local or network drive and path.

Enter the Surfer serial number the first time Surfer is run on each workstation.

NOTE: If you wish to run Surfer on a Windows server itself, you will need to
run setup again without the /a switch and install Surfer normally to a
new directory.

Surfer must be installed directly at each workstation. It cannot be installed

from a remote computer over the network because the installation involves
editing the computer's registry. Certain parts of the registry cannot be
edited from a remote computer.

Installation Troubleshooting
============================
If you are experiencing errors with the installation, install Surfer and
create an installation log:

1. Go to Start | Run.

2. For a local installation, type

"[drive letter]:\[path]\setup.exe" /V"/L* [drive letter]:\[path]\S8.log"

For a network installation, type

"[drive letter]:\[path]\setup.exe" /a /V"/L* [drive letter]:\[path]\S8.log"

Replace the [drive letter] and [path] with a drive letter and path
on your computer. The path to the log file cannot contain spaces.
Use the "shortname" version of the path if it contains spaces or is
longer than eight characters. To display the shortname in a DOS window
type dir /x in the next higher directory.
Longname
c:\program files\
Shortname
c:\progra~1\
3. Click OK. After the installation process terminates, the log file is
created in the path you specify. Please send the log file to technical
support along with the installation message text.

Sample Files
============
Several sample files are included in the Samples directory. The samples
include interesting maps, data files, and some scripts that can be used
to automate Surfer.

Script1.bas Script to create a contour map for each gridding method

Script2.bas Script to create a contour map and wireframe map
Script3.bas Script to create contour maps from multiple Z data columns
Client.cpp Example C++ program to Automate Surfer
Script4.js Creates a relief map using Windows Scripting Host and JScript
Script5.vbs Creates a relief map using Windows Scripting Host and VBScript
AngledBlack.clr Color Spectrum File - black, gray ,white twice
Blusteel.clr Color Spectrum File - black, blue, gray
BrownYellow.clr Color Spectrum File - brown to yellow
BrownBlue.clr Color Spectrum File - brown to blue
Bywaves.clr Color Spectrum File - alternating blue, yellow
Carnival.clr Color Spectrum File - green, yellow, cyan, red
Cold.clr Color Spectrum File - blue, cyan, white, cyan, blue
Colors1.clr Color Spectrum File - bright blue, green, red, magenta, orange
Colors2.clr Color Spectrum File - bright blue, green yellow, red, magenta,
orange
CottonCandy.clr Color Spectrum File - pastel green, yellow, red, blue
CyanBands.clr Color Spectrum File - alternating blue/cyan/black to red
Dirt.clr Color Spectrum File - brown, white
Electric.clr Color Spectrum File - bright blue, purple, yellow, green, red
Forest.clr Color Spectrum File - mostly green and black
GrassWhite.clr Color Spectrum File - alternating brown, green, white
Grayscale.clr Color Spectrum File - black to gray to white
Greens.clr Color Spectrum File - light to dark greens
HighPoints.clr Color Spectrum File - green, yellow, red, black
HighPoints2.clr Color Spectrum File - black, blue, yellow, red
Land.clr Color Spectrum File - green, brown, pale yellow, white
LandArid.clr Color Spectrum File - dull green, yellow, brown
Landsea.clr Color Spectrum File - black, blue, cyan, brown, yellow
Midnight.clr Color Spectrum File - dark blues, purple, some green, red
Mist.clr Color Spectrum File - mostly dark blues and purples
Pastel1.clr Color Spectrum File - pastel rainbow spectrum
Pastel2.clr Color Spectrum File - pastel yellow, green, cyan, blue, magenta
PinkPea.clr Color Spectrum File - pink to green
PurpleBands.clr Color Spectrum File - alternating dark and light purples
PurpleGreen.clr Color Spectrum File - purple to white to green
Rainbow.clr Color Spectrum File - violet, blue, green, yellow, orange, red
Rainbow2.clr Color Spectrum File - black, blue, cyan, yellow, red, white
RedHot.clr Color Spectrum File - red, yellow
RedZebra.clr Color Spectrum File - alternating black, white, red
Swamp.clr Color Spectrum File - mostly green and blue
Taffy.clr Color Spectrum File - bright green, blue, pink
Terrain2.clr Color Spectrum File - brown, green yellow, blue, tan
TieDie.clr Color Spectrum File - alternating bright rainbow colors
USflag.clr Color Spectrum File - red, white, blue
USzebra.clr Color Spectrum File - alternating blue, white, red
Zebra.clr Color Spectrum File - alternating black, gray ,white
Demogrid.dat Sample data file for DEMOGRID.GRD
Sample3.dat Sample data used in scripts
Tutorws.dat Used in Lesson 2 and 5 of the Tutorial
Tutorws2.dat Used in Lesson 1 of the Tutorial
Vario1.dat Sample data file for creating variograms
Demogrid.grd Sample Grid file
Helens2.grd Sample Grid file from Mount St. Helens DEM
DemoRect.bln Sample BLN file for blanking demogrid
DemoSlice.bln Sample BLN file for slicing demogrid
Ca.gsb Golden Software boundary file - California Counties
Nv.gsb Golden Software boundary file - Nevada Counties
Sample1.srf Wireframe map - Colorado Front Range
Sample2.srf Stacked Wireframe and Contour map - Morrison Colorado
Sample3.srf Filled Contour map - Sagebrush Hills Idaho
Sample4.srf Filled Contour map - Grand Canyon Arizona
Sample5.srf Image map - Colorado Counties
Sample6.srf Contour/Shaded Relief map - Mt. St. Helens
Sample7.srf Vector/Contour map of the earth
Sample8.srf Classed Post map - Antarctic temperatures
Symbols.srf Post map of symbols and numeric values
Tutorial.srf Used in Lesson 5 of the Tutorial

Help Script Examples

--------------------
ApplicationObjectProperties.bas
ApplicationObjectMethods.bas
DocumentsCollection.bas
PlotDocumentObject.bas
PlotWindow.bas
RulerObject.bas
ShapeObject.bas
ShapesCollection.bas
VariogramObject.bas
Windows.bas

Surfer.ini Settings
===================
The following advanced settings can be specified under the [Settings] section
of SURFER.INI. In general, these settings should not be changed unless there
is a very good reason to do so:

PlotSize=240 ;Plot size in inches (10 to 2000)

DitherScaleColors=1 ;Set to a non-zero value to enable dithering of the

;color scale colors. This allows the color scale to
;better match the line color used in wireframe plots
;when printing on printers that dither lines.

ErrFlags=147 ;This controls error message display. The value is the

;sum of the desired options:
; 1 Display Errors
; 2 Display Warnings
; 16 Display errors in a dialog box
; 128 Beep on errors
; 256 Display Module, File, and Line info

EditReturn=0 ;Set to a non-zero value to allow the edit control in

;the Text Properties dialog accept the Enter key to
 ;begin a new line. A value of 0 causes the Enter key
;to shut down the dialog.

MaxReportedDups=100 ;Maximum number of duplicate data to report in the

;gridding and variogram report.

MaxReportedExcl=100 ;Maximum number of excluded data to report in the

;gridding and variogram report.

ScrollPercent=10 ;Percentage of the grid editor window size to scroll

;when the arrow buttons are pressed.

ScrollPageSize=90 ;Percentage of the plot window size to scroll when the

;page up/down portion of the scroll bar is clicked.

ScrollLineSize=10 ;Percentage of the plot window size to scroll when the

;arrow buttons are pressed.

ZoomMargin=100 ;The margin around the window after Zoom Page.

;Measured in mils (thousandths of an inch)

ShowMapDlg = 1 ;Enables display of initial map dialog, similar to

;Surfer 7 and older versions.

MaxImageMapRes=3000 ;Maximum resolution in pixels when outputting image

;maps to the printer or export file. Must be greater
;or equal to 100.

Known Issues and Limitations

============================
- Gridding is much slower when faults or breaklines are specified.

- Complex faults (many line segments) are much slower than simple faults.

- Most PostScript printer device drivers are NOT 100% Microsoft Windows
compliant when it comes to imaging complex polygons. Under rare circumstances
(mostly in filled contour maps) this can result in stray lines appearing
when they shouldn't. We have worked around this in our software, but the
modification makes PostScript printing 3 to 5 times slower. If you want
to speed up PostScript printing, but at the risk of an occasional stray line
when printing complex filled contour maps, you may do so by placing a
semi-colon character (";") in front of the following line in SURFER.INI:

DecomposePrinterPolygons=2

- HP LaserJet 4 problems:
When printing on a LaserJet 4 (or 4M non-PostScript), TrueType text blocks
can be wider than requested or character spacing can be incorrect. This has
been fixed in version 31.V1.35 of the LaserJet 4 driver. You can get this
driver from Hewlett Packard at www.hp.com.

If you are unable to get the new driver, using the LaserJet III driver can
resolve problem.

- HP LaserJet Series II and III problems:

Single characters in the axis labels, axis titles, and text blocks may not
print with some drivers. In the Control Panel | Printers menu, select the
printer, and choose Printer | Properties. Turn on the option to "Print
 TrueType as Graphics" to solve the problem.

- HP DeskJet problems:
The last character in text strings may not print. In the Surfer.ini file
remove the semi-colon from the beginning of the line listed below:

[GSIMAGE]
;Windows Picture:Printer:Text=0x8000

Save the changes, then restart Surfer.

- Video Problems:
On some video cards (ATI & Trident), the last character in text blocks is not
displayed; however, printing does not seem to be affected.

Solution 1: Remove the semi-colon from the beginning of the line listed below
in the Surfer.ini file:

[GSIMAGE]
;Windows Picture:Window:Text=0x8000

Save the changes, then restart Surfer.

Solution 2: Change video driver to use "plain" VGA.

- Additional Surfer.Ini settings:

There are several additional settings related to polygon decomposition that
can be customized within the Surfer.ini file. These are fairly obscure and
should not be needed for normal operation. However, if you are experiencing
problems when outputting large polygons to a display device or metafile, you
may want to take a look at the comments within Surfer.ini.

- Toolbar positions are not saved when Surfer is maximized:

The position of the toolbars is based on the NON-maximized window size. If
you find the toolbar positions are not being saved when you restart Surfer
with a maximized window, follow these steps:

1. Start Surfer, UN-maximize the main window

2. Resize the main Surfer window so it almost fills the entire screen
3. Position the toolbars as desired
4. Re-Maximize the main window again
5. The toolbar positions should now be saved correctly

Program Troubleshooting and Error Logging

=========================================
Surfer has an error logging facility that may help us resolve problems.
Run Surfer from the Start | Run menu with the following command line:

d:\path\surfer.exe /L

where d:\path is the drive and path for Surfer 8. By default, Surfer 8
is installed in the "c:\Program Files\Golden Software\Surfer8\" directory.
Include the double-quotes around the path and program name. Attempt to
duplicate the problem, and document the steps prior to the occurrence of
the problem. Surfer writes information about the state of the program and
your system to the file Surfer.msg to the Surfer directory. Zip this file
and e-mail it to technical support (surfersupport@goldensoftware.com) with
a description of the problem and the steps necessary to duplicate it.
Resources: FAQ, Support Forums
==============================
The Golden Software web site contains resources to help answer your questions.

- The Surfer FAQ consists of frequently asked questions about the program:
www.goldensoftware.com/faq/surfer-faq.shtml

- The Surfer Support Forums are open message boards for the discussion of
the program and how to perform various tasks:
www.goldensoftware.ws/forum/

Uninstalling Surfer
====================
To uninstall Surfer, go to Add/Remove programs in the Control Panel. Select
Surfer 8 from the list under the Install / Uninstall tab. Click the Add/Remove
button to uninstall Surfer.

Contacting Golden Software

==========================
Please report Surfer problems to Golden Software at:

Golden Software, Inc.

809 14th Street
Golden, CO 80401-1866 USA

phone: 303-279-1021
fax: 303-279-0909
e-mail: surfersupport@goldensoftware.com
web: http://www.goldensoftware.com

Golden Software business hours are 8:00AM to 5:00PM Mountain Time

Monday through Friday (excluding U.S. holidays).

Check the Golden Software web page for FAQ's, Support Forums and
for additional information about our products.

### end of Readme.txt ###