Biospherical Instruments Inc MER-2040 Software User Manual

Moorable reflectance radiometer
Table of Contents

Advertisement

Quick Links

MER-2040/2041/2050
Moorable Reflectance Radiometer
Software
User's Manual
Biospherical Instruments Inc.
5340 Riley Street
San Diego, CA 92110
(619) 686-1888
FAX (619) 686-1887
Version 003110UB.DOC
04/18/00
Date Printed:

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the MER-2040 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Biospherical Instruments Inc MER-2040

  • Page 1 MER-2040/2041/2050 Moorable Reflectance Radiometer Software User's Manual Biospherical Instruments Inc. 5340 Riley Street San Diego, CA 92110 (619) 686-1888 FAX (619) 686-1887 Version 003110UB.DOC 04/18/00 Date Printed:...
  • Page 2 This document contains proprietary information that is protected by copyright. All rights are reserved. No part of this document may be photocopied, reproduced, or translated into another language without the prior written consent of Biospherical Instruments Inc. Copyright © 1998 by Biospherical Instruments Inc.
  • Page 3 Should this Product fail to be in good working order at any time during the above stated warranty period, Biospherical Instruments Inc. will, at its option, repair or replace this Product at no additional charge except as set forth below. Repair parts and replacement Products will be furnished on an exchange basis and will be either reconditioned or new.
  • Page 4: Table Of Contents

    MER-204X Software Instruction Manual 003110UB.DOC TABLE OF CONTENTS 1.0 INTRODUCTION ...................6 1.1 SOFTWARE DESIGN ..................6 1.2 SOFTWARE REQUIREMENTS ...............7 2.0 M24-PROF: DATA ACQUISITION PROGRAM..........8 2.1 M24-PROF PROGRAM OPERATION..............8 2.3 M24-PROF PROGRAM OPTIONS..............12 3.0 M24-READ: DATA ANALYSIS PROGRAM..........13 3.1 M24-READ PROGRAM OPERATION............13 3.2 M24-READ MISCELLANEOUS AND DISPLAY OPTIONS ......14 <?>: QUICK HINTS .................14 <ESC>: RETURN TO MAIN MENU ............14...
  • Page 5 MER-204X Software Instruction Manual 003110UB.DOC <V> ALL CHANNELS IN VOLTS.............28 <W> WRITE A BINARY FILE..............28 <X>: EXIT SYSTEM ................28 <Z>: WRITE A COMMA SEPARATED FILE..........28 5.0 M24SETUP: AN EDITOR FOR DEFAULTS.CFG ........29 5.1 MENU 1: CALIBRATION FILE EDITING............29 5.2 MENU 2: SETUP OPTIONS................29 5.3 MENU 3: ADDITIONAL SETUP OPTIONS ...........32 5.4 PRINTER CONTROL CODE SEQUENCES ..........33 6.0 CALIBRATION FILES ..................34...
  • Page 6: Introduction

    686-1888 and inquire about custom software or make the changes yourself using a Microsoft compiler for Professional Basic Version 7.1. This manual offers instructions for editing the ASCII files and for operating the four MER-2040 programs. For your convenience, we have included a sample data file so that you can practice using M24-PROF and M24-READ before attempting to connect your MER system.
  • Page 7: Software Requirements

    MER. The MER-2040 programs are written in Professional Basic Version 7.1. The source codes for the programs are provided for two reasons: (1) to help you understand exactly what goes on in the data analysis, and (2) to enable you to modify the programs to better suit your purposes.
  • Page 8: M24-Prof: Data Acquisition Program

    MER-2040 Software Instruction Manual 003110UB.DOC M24-PROF: DATA ACQUISITION PROGRAM The program titled "M24-PROF" is provides acquisition of data during a vertical profile. This program is designed to execute rapidly and it documents the conditions of the profile by recording a "castcard". It records data in a packed binary format that follows exactly the format of the data transmitted from the MER and optional deck sensors.
  • Page 9 MER-2040 Software Instruction Manual 003110UB.DOC screen, as shown in Figure 2.1. The parameters to be displayed in are designated in the DEFAULTS.CFG file. Figure 2.1. M24-PROF Selected Parameters Screen. The next step is to set up the castcard file by pressing the <F4> key. As shown in Figure 2.2, the M24-PROF program will automatically assign a filename by which to record data.
  • Page 10 MER-2040 Software Instruction Manual 003110UB.DOC Figure 2.2 M24-PROF Data File Opening Section . Figure 2.3. M24-Prof Cast Card Parameters. At the end of the castcard dialogue, you will be asked to approve its contents <Y> and will be prompted to choose between a graphics display <G> and a numerical display. The graphics option can be used only if you have a graphics monitor.
  • Page 11 MER-2040 Software Instruction Manual 003110UB.DOC mode, choose Option <4>. You will see the file "DEMOPLOT.PLT" listed. Select this file and press <ENTER>. After making all necessary changes to the plotting parameters, press <ENTER> and you will be returned to the Selected Parameters window shown in Figure 2.1.
  • Page 12: M24-Prof Program Options

    MER-2040 Software Instruction Manual 003110UB.DOC Figure 2.5. M24-PROF Plot Example. M24-PROF PROGRAM OPTIONS The following are the options in the M24-PROF program which are listed at the bottom of the Selected Parameters screen (Figure 2.1) and Plotting screen (Figure 2.5). As each operation is initiated, it is annotated in the castcard file.
  • Page 13: M24-Read: Data Analysis Program

    MER-2040 Software Instruction Manual 003110UB.DOC M24-READ: DATA ANALYSIS PROGRAM The data analysis program supplied by Biospherical Instruments is the program M24-READ. This program is used to read binary data files that have been previously recorded using the program M24-PROF. M24-READ will provide you with several options for plotting your data and creating ASCII files usable by other software.
  • Page 14: M24-Read Miscellaneous And Display Options

    MER-2040 Software Instruction Manual 003110UB.DOC Figure 3.1. M24-READ Master Menu. M24-READ MISCELLANEOUS AND DISPLAY OPTIONS The following are general functions that apply in almost any menu of the program: <?>: QUICK HINTS Offers a quick preview of all key assignments <ESC>:...
  • Page 15: A>: Display All Channels

    MER-2040 Software Instruction Manual 003110UB.DOC <A>: DISPLAY ALL CHANNELS This will initiate a display of all MER channels in calibrated units (see Figure 3.2). The display will indicate the calibration constants, as well as the format (position of the decimal point) and label (e.g., "Depth") that are specified in the calibration file.
  • Page 16: H>: Hard Copy Report Format

    MER-2040 Software Instruction Manual 003110UB.DOC A method for displaying one channel of data at a time is to select the <E> option. You will be presented with a list of available channels (Figure 3.3). Select the appropriate instrument number and channel numbers from the list that is presented. For instance, entering <1,4> will select channel 4 from instrument 1, the 507-nm downwelling irradiance channel.
  • Page 17 MER-2040 Software Instruction Manual 003110UB.DOC Figure 3.3. M24-READ Available Channels. Figure 3.4. M24-READ Standard Deviation Analysis. IOSPHERICAL NSTRUMENTS...
  • Page 18: I>: Print The Castcard

    MER-2040 Software Instruction Manual 003110UB.DOC <I>: PRINT THE CASTCARD The M24-PROF data acquisition program creates a "castcard" file to accompany each binary data file. Option <I> will read the castcard files and print them. These files are ASCII files, so they can also be edited with most word processors and can be printed in DOS using the "PRINT"...
  • Page 19: R>: Raw Data In Hex

    MER-2040 Software Instruction Manual 003110UB.DOC <R>: RAW DATA IN HEX This option is helpful in "debugging" problems in data files, or in examining exactly how data is transmitted from the MER. The display shows, in hexadecimal, each byte that is recorded in the data file.
  • Page 20: F> Open A Binary Data File

    MER-2040 Software Instruction Manual 003110UB.DOC <F> OPEN A BINARY DATA FILE To stop reading the data file currently in use, select the <F> option and enter the name of a new file. You will then be returned to the main menu with the file pointer positioned at the beginning of the file.
  • Page 21 MER-2040 Software Instruction Manual 003110UB.DOC <2> Graphics Device. Select the code for the graphics device that will be used. Permissible values are: HPGL Pen Plotter. 200*640 medium resolution one color display (usable with the <PRNTSCRN> key for printer dumps, or with monochrome displays, and no graphics card).
  • Page 22: L> Letter A Pen Plot

    MER-2040 Software Instruction Manual 003110UB.DOC <L> LETTER A PEN PLOT After you have plotted data using the pen plotter, you may wish to add text to the plot. This can be accomplished by selecting the <L> option from the main menu and following the instructions.
  • Page 23 MER-2040 Software Instruction Manual 003110UB.DOC Figure 3.6. M24-READ Pen Plotter Parameters. Figure 3.7. Spectral Distribution vs. Depth Plot. IOSPHERICAL NSTRUMENTS...
  • Page 24: W> Write A Csv Data File

    MER-2040 Software Instruction Manual 003110UB.DOC <W> WRITE A CSV DATA FILE This option of M24-READ is designed to translate a binary data file to an ASCII data file in which the readings for each channel will appear in engineering units. This translation process uses the formats specified in the calibration file, and separates each reading using the delimiter specified in the DEFAULTS.CFG file.
  • Page 25: M24-Test

    MER-2040 Software Instruction Manual 003110UB.DOC M24-TEST M24-TEST is a program that is designed to test your MER to confirm that it is operational. This module has the ability to perform real-time data acquisition and storage in addition to reading binary data files that have been previously stored using the "M24-PROF" or this program, M24- TEST.
  • Page 26: C> Select Another Calibration File

    MER-2040 Software Instruction Manual 003110UB.DOC Figure 4.1. M24-TEST Main Menu. <C> SELECT ANOTHER CALIBRATION FILE If you wish to change the calibration file being used to decode the recorded data, select the <C> option. Here you will have a chance to select among the available data files.
  • Page 27: H> Hard Copy Dump

    MER-2040 Software Instruction Manual 003110UB.DOC <H> HARD COPY DUMP This option will print selected parameters in engineering units on your printer. The selected channels are those specified in the DEFAULTS.CFG file. Other printed dumps of all channels can be obtained using the <PRTSCRN> key function during the desired CRT display.
  • Page 28: V> All Channels In Volts

    MER-2040 Software Instruction Manual 003110UB.DOC host computer buffer that have not yet been collected for display. This is meaningful when operating in the non-handshake mode where the MER is freely transmitting data. If the host computer is fast enough to capture data, calculate values, and check the checksum, the buffer pointer should stay low (less than 150).
  • Page 29: M24Setup: An Editor For Defaults.cfg

    M24SETUP: AN EDITOR FOR DEFAULTS.CFG The MER software is designed to support Biospherical Instruments' Series 204X and 2050 Spectroradiometers. It is also designed to work with several types of display devices. To avoid having an extensive dialogue about system configuration each time a program is run, we have created a file called "DEFAULTS.CFG"...
  • Page 30 MER-2040 Software Instruction Manual 003110UB.DOC The next screen (Figure 5.2) lists all setup parameters. Line 1 contains a flag noting whether or not you normally have a printer connected. If this is set to 1, then the program M24-PROF will automatically dump to the printer at various stages in its operation.
  • Page 31 MER-2040 Software Instruction Manual 003110UB.DOC Line 6 contains the code for the CRT graphics device that will be used. Permissible values are: No device, no graphics displays. 200*640 medium resolution one color display (usable with the <PRTSCRN> key for printer dumps, or with monochrome displays). Printer dumps first require executing “Graphics"...
  • Page 32: Menu 3: Additional Setup Options

    MER-2040 Software Instruction Manual 003110UB.DOC you have a four-channel deck sensor, then pair the channels at the same wavelength. In selecting these channel numbers, DO NOT simply use channel numbers from the examples in this manual! Line 16 states the type of plotter.
  • Page 33: Printer Control Code Sequences

    MER-2040 Software Instruction Manual 003110UB.DOC PRINTER CONTROL CODE SEQUENCES Figure 5.4 shows you the final menu in M24SETUP. This will allow you to define printer control code sequences used during most printer outputs. Figure 5.4. M24SETUP Printer Control Code Sequences.
  • Page 34: Calibration Files

    CALIBRATION FILES A complete instrument description is found in the calibration file. This file must end in ".CFL" and it must match the format specified here. You may have more than one calibration file present on the operating disk (such as one for each cruise or each instrument calibration), but only one can be active.
  • Page 35 MER-2040 Software Instruction Manual 003110UB.DOC Default maximum voltage. "dnwell irr uW/cm²/nm" The units label for the calibrated data. Keep this line brief, or only part of it will be printed or displayed by a program. "###.####" The numeric format that will be used in the displays. Do not change the length of this, or the formatted displays will not be pretty.
  • Page 36: Appendix A: Glossary Of Terms Used

    APPENDIX A: GLOSSARY OF TERMS USED ASCII - American Standard Code for Information Interchange. Such files can be examined using an editor or a word processor in the non-document mode or other method. BAUD RATE - The number of signal level changes per second in a serial Transmission. Data Rate (e.g.9600, 1200, 300 baud).
  • Page 37 MER-2040 Software Instruction Manual 003110UB.DOC PATH - Searches specified directories for commands or batch files that were not found by a search of the current directory. PLOTTER - An external graphic device. For the MER programs, it must use the Hewlett- Packard Graphics Language ("HPGL") and must be a plotter for one of the DOS recognized...
  • Page 38: Appendix B: Rs-232 Cable And Connector

    MER-2040 Software Instruction Manual 003110UB.DOC APPENDIX B: RS-232 CABLE AND CONNECTOR B.1 RS-232 CABLE CONSTRUCTION WARNING: Dangerous voltages, capable of causing death, are present in this instrument. Use caution when handling, testing, and adjusting. Table B.1. Cables for IBM-PC type computers with 25 PIN CONNECTOR (DB-25).
  • Page 39: Rs-232 Connector Configuration

    MER-2040 Software Instruction Manual 003110UB.DOC B.2 RS-232 CONNECTOR CONFIGURATION Table B.2. Pins and Pin Functions. Function Protective Ground Output data (DTE) or Input data (DCE) Input data (DTE) or Output data (DCE) not connected * not connected * not connected *...
  • Page 40 MER-2040 Software Instruction Manual 003110UB.DOC Table B.4. DB25 versus DB9 connectors. PLOTTER (male RS- IBM-PC 232) (female) DB-25-P DB-9-S FG 1-| |-9 RI TD 2 2 RD RD 3 RTS 4 8 CTS CTS 5 7 RTS DSR 6; DCD 8...
  • Page 41: Appendix C: Software Installation

    MER-2040 Software Instruction Manual 003110UB.DOC APPENDIX C: SOFTWARE INSTALLATION 1. Make at least one copy of all of the software using the DISKCOPY command (consult your DOS manual for instructions). 2. Create a directory for the MER software called "MERPROG" by typing <md MERPROG>.
  • Page 42: Appendix D: Programmers' Notes

    MER-2040 Software Instruction Manual 003110UB.DOC APPENDIX D: PROGRAMMERS' NOTES This section is for the use of computer programmers who wish to understand the structure of the programs comprising Biospherical Instruments software MER software package. The programs are written in a variant of MICROSOFT BASIC called "Professional Basic". We have chosen this compiler because it is fast, relatively structured (no line numbers required, etc.) for...
  • Page 43 MER-2040 Software Instruction Manual 003110UB.DOC 1. U$(Inst%, CHAN%): The string carrying the description of the units for a particular channel on an instrument (e.g., "uW/cm²/nm" or "degrees") C(Inst%, CHAN%) is the calibration constant for that channel. This is defined in the calibration file.
  • Page 44 MER-2040 Software Instruction Manual 003110UB.DOC 14. DELIMITER$: A character defined in the DEFAULTS.CFG file to delimit individual values in an ASCII data file that is being written to disk. The most frequent value here is a comma, which will create a comma separated value (.CSV) file.
  • Page 45: Software End User License Agreement

    This is the entire agreement between the parties, and any modification hereto must be in writing and signed by an officer of Biospherical Instruments Inc. California law shall govern this license, except as to copyright matters that are covered by Federal laws, and is deemed entered into at San Diego, San Diego County, CA, by both parties.

This manual is also suitable for:

Mer-2041Mer-2050

Table of Contents