VIEWLOG for Windows: Additional Installation Notes Note: This document covers VIEWLOG Version 1.0 (not Version 2 or later) Welcome, and thank you for choosing VIEWLOG! Should you require assistance installing or running VIEWLOG, please contact: Dirk Kassenaar VIEWLOG Systems, 71 Cranbrooke Ave., Toronto, Ontario, M5M 1M3 Canada Tel. (416) 481-6287 Fax. (416) 481-0069 email: dirk@viewlog.com World Wide Web: (for program information and updates) http://www.viewlog.com/~dirk/viewlog.html ------------------------------------------------------------------------------ Contents: VIEWLOG for Windows: Additional Installation Notes 1. Installation Notes 2. Demo Program Installation 3. Version Upgrade Notes (New Features and Bug Fixes) 4. Know VLW Problems 5. Uninstalling VIEWLOG 6. Detailed Installation Instructions (Excerpt from Manual and Help file) ------------------------------------------------------------------------------ 1. Installation Notes The enclosed program files can be used to install VIEWLOG for Windows under Windows 3.1, Windows 95 and Windows NT. Once installed, the program will be fully operational if a valid VIEWLOG software key is detected. If not, VIEWLOG will operate in Demo Mode (see Demo Program Installation, below). For normal program operation, changes are required in either the Windows System.ini file (for Win 3.1 and Win95) or Windows NT Registry. (These changes are not required for Demo Mode operation.) These changes are automatically made during Setup. Window NT Installation Notes: Additional installation and configuration notes for Windows NT are included in the file readme.nt. It is important to note that NT Administrator rights are required for a VIEWLOG Installation. You may need to logon as Administrator prior to installing VIEWLOG. (Administrator rights are not required for Demo Mode Installation, as no changes to the NT Registry are required for the demo.) Aside: 32 Bit Operation VIEWLOG for Windows Version 1 operates under all versions of Windows because it is a hybrid 32 bit program. Internally, VLW contains native 32 bit optimized code (it requires, at minimum, Win 3.1 386 Enhanced mode to operate), however, parameter passing is performed in 16 bit mode. This design offers much of the performance of a full 32 bit program, while offering maximum compatibility between versions of Windows. ------------------------------------------------------------------------------ 2. Demo Program Installation The enclosed files can be used for both full program operation or Demo Mode operation. VIEWLOG automatically operates in Demo Mode if a software key is not detected on the parallel port. Demo Mode allows you to try all of the VIEWLOG functions, including loading and processing your own data. Under Demo Mode, however, the file save and print functions are disabled. Demo Mode Installation Options: The "Demo Mode Install" checkbox option is included in the Setup program. When this option is selected only a partial installation is performed, and NO changes are made to the Windows configuration or NT registry files. The advantage of using this checkbox option is that uninstalling the program is easier. Uninstalling the Demo: If the Demo Mode Install checkbox is selected during installation, uninstalling the demo requires only the following steps: 1. Delete the VLW directory and all files within it 2. Select each icon in the VIEWLOG Demo program group, then press the delete key to remove the icon 3. Once all icons have been removed, press the Delete key to remove the VIEWLOG Demo program group ------------------------------------------------------------------------------ 3. Version Upgrade Notes (New Features and Bug Fixes) This section contains information on changes made to VLW. Prior to upgrading from an earlier version of VLW, please see the section entitled "Before you install", in the VIEWLOG documentation. This section lists files which you may have customized (ie. log calculation equations, format templates, etc.), and may wish to back up prior to re-installation. In addition to backing up your customized files, you may wish to disable the installation of the following groups of files during re-installation or upgrading: - Templates/Symbols/Borders and Equation files - Tutorial Data Files Unchecking these options will preserve your customized log format settings, user drawn lithology symbols, user modified map borders, custom log calculation equations and modified tutorial data files. (Note: these files must have been previously installed for proper VIEWLOG upgrade operation.) ----------------------- VLW Version 1 Build 104 Upgrade Notes New Features: - On-screen editing of left and right log scale margin value is now supported. When in Log Edit mode (with no edit function selected), clicking on the left or right margin value (printed below the log name) allows on-screen editing of the scale value. Hint: Once the margin value is selected for editing, the mouse can still be used to review the log scale values. Bug Fixes: - Fixed a problem which caused a floating point error in the dynamic link libraries. In some instances this would happen if the Depth Format or Log Display menus were selected after import or file merge but before printing or preview modes had been selected. - Fixed a bug applying log templates to sonic log data. - Fixed a bug with the 1:xxx scaling options in the Depth format Menu ----------------------- VLW Version 1 Build 103 Upgrade Notes New Features: - New drag and drop of log track position. When in Log Edit mode (with no edit function selected), clicking on a log name and dragging the mouse into a new log track moves the log into the new track position. This is useful for quickly repositioning logs. Note that the origin and destination mouse clicks must be in the log name area at the top of the screen. Logs can only be moved between existing log tracks. - New depth scale options have been added to the Format Depth Menu. A new drop-down list box has been added, allowing the user to either enter or select from a list of commonly used scale values (e.g. 1:200, 1:500, etc.). The old method of scale definition is still supported. In addition, the new Reset button in the Format Depth menu can be used to automatically select an appropriate grid, label and tick increment value for the currently defined depth scale. - User control over grid line formats on log plots. The grid line color, style and thickness can now be set in the Format Log Display dialog box (Track tab). Note that, due to internal limitations in Windows, some combinations of line styles and colors will not be represented on all output devices. For example, some color printers can only render thin lines (1 pixel wide) in a limited range of colors. - Added a drop down list box with suggested line thicknesses in the Format Log Display dialog box. - Added support for OYO-RG Normal/SP/gamma and Water quality log data formats. Water quality logs are typically spanned across multiple files. When spanned, select all the files in the Log Data Import File Selection dialog box in the order collected. The spanned data will then be linked into one log. - Added support for OYO-RG Suspension-170 log format. This sonic log has one transmitter and two receivers, and produces 6 full waveform logs. Since the raw ORG files contain only one depth measurement set per file, all suspension log files collected in a borehole need to be selected at one time in the Log Data Import File Selection dialog box. Note: to reverse the polarity of the traces when overlaying suspension logs results for S-wave analysis simply enter a negative sonic amplitude scale in the Log Display dialog box. Bug Fixes: - Update of the on-line user manual - Fixed a problem with the scrolling of full waveform sonic data - Fixed a problem plotting logs over 9 pages in length - Fixed a bug with the drawing of the feet/metres labels. - Refined the position and spacing of log names on output. - Improved alignment of the depth column labels. - Fixed a bug importing Mt. Sopris full waveform sonic logs which have been depth resampled - Fixed a bug importing Mt. Sopris compensated density log files. The new code automatically detects the non-standard header (unquoted log names). ----------------------- VLW Version 1 Build 102 Upgrade Notes Bug Fixes: - Fixed a problem with importing Auslog multiplexed data formats. - Fixed a bug in the preview of long format logs (>32 inches). - Fixed a bug that caused long format logs to be aligned to the bottom of the last page, as opposed to aligned to the top of the first page (of the multi-page printout). This caused some long format logs to begin part way down the first page of the printout. ----------------------- VLW Version 1 Build 101 Upgrade Notes New Additions: - Support for the OYO Sonic Log 170, a 4-channel full waveform sonic log. To import, select the [OYO Geologger Mark I and II] data format in the Log Data Import: File Selection dialog box. - Two new options in the Export Text menu allow the well name and well location to be included at the beginning of the output file. Bug Fixes: - Fixed a problem with the Windows Regional Settings affecting the Depth Format parameters. The problem occured when a comma was used as a decimal seperator in the Depth Format dialog box. - Fixed a bug in the Text Export menu. - Fixed a bug which caused a crash when the Line Attributes dialog box was opened when a borehole was selected. ----------------------- VLW Version 1 Build 100 Upgrade Notes - Added automatic spanning of long format plots across multiple pages. - Fixed import problems with very large Robertson files. - Improved error handling of ASCII file import and conversion. ----------------------- VLW Version 1 Build 99a Upgrade Notes - Build 99a fixes a bug in the page template file system. This bug (introduced in Build 99) prevented the correct reading of page templates. ----------------------- VLW Version 1 Build 99 Upgrade Notes New Features: - New control over well header The Header Menu has been redesigned to allow more user control over the information and display. Check boxes are now displayed beside each element in the "Primary Header" (Well Name, Location, Elevation, etc.). Check boxes exist beside both the data entry field, as well as the field caption. To display the field and caption, check both boxes. (Note: the caption will not display unless the field is also displayed) The "Box" options in the header menu can be used to display a box around the header portion of the plot. The Well Comments section of the header has also been improved. Sections of the comments can now be aligned in columns by inserting the | character (vertical line) within the comments. The number of columns equals the number of | characters plus one. For example, entering the following: Drilling Date: 10/10/96 |Drilling Method: Hollow stem auger will left align the "Drilling date" and place the "Drilling Method" text at the center of the header (ie. in column 2). Note: All of these new options are fully backward compatible with the existing page template system. - New Page Setup Option: WMF Background files merged on output While it has always been possible to plot a log to the VLW Drawing Editor for further customization, it is now possible to merge a Windows metafile (WMF) into the existing plot, saving some output steps. A typical application of this new option is to quickly merge a standard plot border or company logo onto the final output. WMF background files can be created in the VLW Drawing Editor. To insert the WMF drawing, perform the following: 1. Create the background image or plot surround in the VLW drawing editor. 2. Create a WMF file by "printing" the drawing to a WMF file. (Select File, Print, then change the output device to Windows Metafile) 3. Select Format Page/Global settings, and enter the file name in the Background WMF file box (or use the "select" button to select the file) 4. Position of the WMF file by adjusting the x and y offset. Preview the position by selecting View Preview 5. The WMF file will now be displayed on all subsequent output. To remove the WMF file, simply delete the file name from the Page/Global settings dialog box. Notes: 1. Merged WMF background images will be displayed in Preview mode and on printer output, however they will not appear on other output options such as DXF. For more advanced drawing annotation, "plotting" to the VLW Drawing Editor is still the recommended approach. 2. If creating the WMF in another application, be sure to export it as a "placeable metafile". Improvements/Bug Fixes - Redesign of the output engine. The method by which output is sent to Windows printers has been changed, providing better interaction with the printer settings. While the user will not see many changes, the program can now automatically generate multiple copies of the output (if the printer driver supports that option). In addition, VIEWLOG no longer automatically changes the Windows default printer settings. Should the user wish to change the page defaults (including those seen by other applications), simply check the "Save page settings" checkbox prior to selecting the Page Setup button. These changes apply to both the Log Editor and Drawing Editor print routines. - A bug related to conversion between inches/cm units in the View Page Setup dialog box has been fixed. Thanks to AM for pointing out this perplexing bug! ----------------------- VLW Version 1 Build 98 Upgrade Notes New Features: - Full Waveform Sonic (FWS) Log Processing, with first break picking. The FWS log display option includes Wiggle trace display, along with VDL (Variable Density Log), Color Spectrum VDL and Custom color VDL display. FWS logs can presently be imported from either Auslog or Mt. Sopris binary data format. Three first break picking algorithms are included in the Interpret Sonic Pick Menu, along with a routine to calculate the transit time from the P-wave first break pick logs. - Interval Log Format: Interval logs are designed to represent borehole measurements taken over a specified interval. For example, core measurements or hydraulic conductivity test results. Interval logs can be used in all log calculations and cross plotting functions (but not presently in the log stats, because intervals can overlap). To load this type data, simply specify "Interval" data type in the ASCII or Lotus File Import menu, and load a file with the following format: Depth_from Depth_to Log_Value - Integrated Log Display Menu (Tabbed dialog box). The Log Display and Log Comments menus have been integrated into on comprehensive menu, with menu tabs to select the groups of options. - Long text descriptions are now allowed, with auto word-wrap within text columns - Named Text columns with full Import/Export of text description and contact locations - Log symbols can now be added - Simple Deviated Well Conversion (switch back and forth between depth and distance for straight boreholes) - Support for Windows NT 4.0. One installation program works on all versions of Windows. - Conditional expressions have now been implemented in the LogCalc function. - A new "All intervals" option has been added to the Statistics grid window. The well name has also been added to the grid output. ----------------------- VLW Version 1 Build 96 Upgrade Notes - Fixed a number of bugs related to operation under Windows NT Version 4.0 ----------------------- VLW Version 1 Build 92 Upgrade Notes New Features: - Support for Windows NT VIEWLOG has now been tested for operation under Windows NT Version 3.51. The VLW Setup program has been modified to automatically detect NT and make the necessary changes to the NT Registry. Detailed install and uninstall notes are included in the file readme.nt. Readme.nt can be found in the root directory of VLW Disk1, or, after installation, in the vlw\sysutil\nt directory. Running VLW under WinNT offers some advantages over other versions of Windows. One advantage it that there are no System Resource limitations under NT. Bug Fixes: - Fixed a problem related to the import of LAS files. In some cases LAS conversion appeared to work, but no logs appeared. The bug was introduced in V1 Build 91. - Update of the SSIACT.386 and NT device drivers. In rare cases under Win 3.1 the software key was not properly recognized on start-up of the program. (A retry on the recognition usually worked.) The driver update fixes this problem. - Fixed a problem related to printing images greater than 32 inches in length. Print size is now limited only by the Windows Printer driver. This also solves a related problem which occured when creating a new map file with the default page size larger then 32 inches. - Revision A (8/27/96): Fixed a problem when loading the Drawing Layer Control Menu. - Revision B (9/7/96): Fixed a problem with auto scale selection when importing Century PCL files. - User Manual Additions: The VIEWLOG Help file (accessed by pressing F1 during program operation) contains a complete and up to date copy of the VIEWLOG printed documantation. Manual revisions are documented below: ------------------------------------------------------------------------------ 4. Know VLW Problems The following problems have been identified in VLW, and are presently under review. Installation Problems: --------------- "Vlw1.dll is presently in use" If you encounter an error message stating "Vlw1.dll is presently in use" during RE-installation of VLW, simply restart Windows prior to re-installing the program. "Commdlg.dll is in use. Please close all applications and reattempt setup" This warning message may appear when installing VLW in Non-english versions of Windows. This message can be ignored if it arise during installation. Simply continue with the installation process. Operation Problems: ---------------- Problem: Exporting MAP files containing external WMF files to the Windows Clipboard Externally created WMF files, embedded within a VLW MAP file, may be incorrectly scaled when exported to the Windows clipboard. For example, a company logo, created in Corel Draw and saved as a WMF file, can be placed in a VLW map file. The logo will display on screen and print correctly. However, when the MAP file is exported to the Windows Clipboard (or printed to a WMF file), the embedded logo may be incorrectly scaled. The problem does not occur with WMF files created by VLW. Solution: A few options are available: 1. Use the DXF file import routines to import company logos or other external information. Importing the data as a DXF file offers the added advantage that the object can be further edited within VLW. 2. Draw the logo in VLW, and save it as a MAP file (map files can be merged without problem). 3. Draw the logo in VLW, and print the logo to a WMF file. WMF files created by VLW do not exhibit the problem. Win95 Problems: ---------------- Problem: Horizontal lines may appear when scrolling logs screen, if: - VIEWLOG is maximized - The Win95 taskbar is in "Auto-hide" mode, and is located on the bottom of the screen. Solution: Move the task bar to the side or top of screen, or turn off the Auto-Hide function. ------------------------------------------------------------------------------ 5. Uninstalling VIEWLOG The following are instructions for removing VIEWLOG from your computer. (Note to Demo System users: Please see the simplified steps outlined above.) Windows 3.1, Win95 and Win NT: 1. Remove the program files from the VLW directory. A complete listing of all the VIEWLOG files installed to your hard drive is included in the file setup.ins, located on VLW Disk 1. The vast majority of files are installed to the VLW subdirectory, and can be removed simply by deleting the directory. 2. Select each icon in the VIEWLOG program group, then press the delete key to remove the icon. Once all icons have been removed, press the Delete key to remove the VIEWLOG program group window. Windows 3.1, Win95 ONLY: 3. Remove the following lines (if they exist) from the System.ini file: Device=C:\WIN\SYSTEM\ssiact.386 SSI_LPT=2 The second line will only have been added if the software key was installed on LPT2. Note: the following files are added to the Windows System directory by VIEWLOG: COMMDLG.DLL CMDIALOG.VBX GRID.VBX SSIACT.386 We DO NOT recommend removing them because they may be used by another program. Windows NT ONLY: To remove VIEWLOG from a Windows NT installation, first, remember to log on as Administrator (so as to allow changes to the NT Registry). Use the techniques outlined in steps 1 and 2 (above) to remove the program files and icons. Instructions for removing the Registry settings are outlined in the file Readme.NT ------------------------------------------------------------------------------ 6. Detailed Installation Instructions (Excerpt from Manual and Help file) The following is an excerpt from the VLW documentation. Once the program is installed press F1 to access the context sensitive help system. Installing VIEWLOG Installation Overview Included in this section is a checklist of things to review before installing VIEWLOG. This will insure that your installation goes smoothly and you are up and running immediately. System Components Included in the VIEWLOG package are: 1. VIEWLOG System disks 2. VIEWLOG Parallel Port Hardware Key 3. VIEWLOG Documentation Demo Program Package The VIEWLOG Demo program contains the complete software system, with the exception of the hardware key. If the hardware key is not detected on start-up, the program will operate in Demo Mode. File save, data export and printing functions are disabled when operating in Demo Mode. All other data input and analysis functions are available, allowing you to experiment with the software. Before You Install Back Up Program Disks Write protect and make backup copies of your original program disks. Use these copies to install VIEWLOG. Check the VLReadme.txt File Before proceeding, look at the file named VLReadme.txt on disk #1. This file may contain updated program information that was not available when this manual was printed. The file is copied to the VIEWLOG directory during installation. If installing VIEWLOG on Windows NT, please see, in addition, the file readme.nt on disk #1. Notes for Upgraders First of all, do not attempt to upgrade VIEWLOG while the program is running. It is recommended that you exit and restart Windows prior to re-installing VIEWLOG. Prior to upgrading from a previous version of VIEWLOG for Windows, you may wish to back-up selected files containing user customized parameters from the VLW Directory. The following files might be saved: File Name Description Viewlog.pgt User defined page templates Viewlog.lgt User defined log format templates Viewlog.lsm Lithology symbols Viewlog.eqn User defined log equations Viewlog.ini Last file list and screen layout Border*.map Default map borders Default.cfg LAS file import defaults Newhdr Default header information In addition to backing up your customized files, you may wish to disable the installation of the following groups of files during re-installation: - Templates/Symbols/Borders and Equation files - Tutorial Data Files Unchecking these options in the Setup program will preserve your customized log format settings, user drawn lithology symbols, user modified map borders, custom log calculation equations and modified tutorial data files. (Note: these files must have been previously installed for proper VIEWLOG upgrade operation.) Compatibility with VIEWLOG for DOS Both VIEWLOG for DOS and VIEWLOG for Windows can be installed on the same computer at the same time, however they should be installed in different directories. Both program can be run simultaneously. VIEWLOG for Windows will transparently read files created by VIEWLOG for DOS Versions 4 and 5, however, VIEWLOG for Windows will automatically save those files in the new Version 6 file format. Version 6 files can be identified by the "VL 6.0" text string at the beginning of the HDR file. The Log File Export functions in VIEWLOG for Windows allow you to convert information back to Version 5 or 4. Note that some log formatting information may be lost, and other data volume limitations may prevent full backward compatibility. VIEWLOG for DOS Version 5 file is limited to 30 logs with 32000 data points each and 3 facies text columns. Software Installation The installation of VIEWLOG is fully automated. Windows 3.1 and 3.11 1. Start Windows. 2. Insert program disk #1 into the A: drive of your computer. 3. From the File Manager in Windows Program Manager, select Run. 4. In the Run Dialog, type the following command line: a:\setup ...then click OK. ( Type b:\setup if the diskette is in Drive B:) 5. The Setup Welcome screen appears, then follow the prompts to proceed with the installation. Windows 95 1. Start Windows. 2. Insert program disk #1 into the A: drive of your computer. 3. Click on the Start button on the Windows 95 task bar and select Run 4. At the prompt, type the following command line: a:\setup ...then click OK. ( Type b:\setup if the diskette is in Drive B:) 5. The Setup Welcome screen appears, then follow the prompts to proceed with the installation. Windows NT 1. Start Windows, and logon as Administrator. (Administrator rights are needed for Registry changes). 2. Insert program disk #1 into the A: drive of your computer. 3. From the File Manager in Windows Program Manager, select Run. 4. In the Run Dialog, type the following command line: a:\setup ...then click OK. ( Type b:\setup if the diskette is in Drive B:) 5. The Setup Welcome screen appears, then follow the prompts to proceed with the installation. 6. For additional information on NT configuration, see the file readme.nt on Disk #1, or check the \vlw\sysutil\nt directory. VIEWLOG Hardware Key Installation To run the VIEWLOG program, the Hardware Key must be plugged into the parallel printer port of the computer. The printer cable can be plugged into the other end of the software key. The key will not interfere with the operation of the printer or print spooler. It is not necessary that a printer be installed for the key to operate. The key is not required to run the demo program. By default, The key must be plugged into parallel port 1, however, the following steps can be used if you need to plug it into another port. Windows 3.1 and Windows 95 Add the following line into the [386Enh] section in file SYSTEM.INI: SSI_LPT=n where n=1, 2 or 3 Windows NT To change the parallel port settings in the Win NT Registry, the SSIREGI.EXE and SSIREGM.EXE utility programs can be used. These programs are located in the \vlw\sysutil\nt directory. Perform the following steps: 1. Stop the SSI Driver with the following command: ssiregi stop 2. Change the port setting using the following command: ssiregm Lptport=n Where n is the port number in the range of 1 through 9 3. Re-start the driver using the following command: ssiregi restart Starting VIEWLOG Once VIEWLOG is installed, a Windows 3.1 Program Manager Group will be created containing the VIEWLOG Icon. To start the program simply double click on the icon. Advanced users can. optionally, append the name of a VIEWLOG Header file (*.hdr) (containing log data) or a Map file (*.map) to the VLW.EXE command line to have VIEWLOG automatically load a data file on startup.