DCP
Technical Reference
 
Table of Contents
  1. Introduction
  2. System Requirements
  3. Logical Unit Numbers
  4. Common Event Flags
  5. Memory Mapped Objects
  6. The TABLE array
  7. The Parameter Storage File (PSF)
  8. References

See also DCP Users Guide

 
Ravi Kochhar
Department of Physiology
University of Wisconsin
Madison, Wi. 53706
 
Technical Report no. 18
Mar. 6, 2002
Rev. 1.010, May 12, 2004
 
Back to Computing Page

Introduction

These are the technical notes for the program DCP, which is one of the main data collection programs used in the Auditory Physiology Lab at the Univ. of Wisconsin. The word "DCP" is an acronym for "Data Collection Program", even though DCP by itself collects no data. Instead, it acts as a "front end" to many of the other data collection programs used in the Lab, such as RA, TH etc.

One of the goals of DCP is to make data collection easier and faster. This is achieved primarily by the use of command macros. The user can, in effect, specify his/her experimental paradigm in advance by constructing appropriate macros, and then, during the experiment, start data collection by invoking these macros from DCP.

DCP includes commands to start other programs. This allows the user to start a series of data collection programs in succession. Available soon will be the facility to start other programs asynchronously, i.e. control returns to DCP immediately upon starting the other program. This will allow, for example, data analysis programs to run in parallel with data collection.

Back to Top

System Requirements

(a) Hardware

DCP was originally written for a Harris (Datacraft) 6024/5 computer with the D.M.S. operating system, and ran on that system from approx. 1977 to 1987. In 1987 it was converted to run on a MicroVAX-II computer with a RAMTEK color graphics display and the VAX/VMS operating system. It currently runs on a Digital VAXstation 3200 using the built in VWS graphics display and OpenVMS V5.5-2. Most recently (2002) it is in the process of being converted to run on the Windows/NT/2000/XP operating system.

(b) Software

DCP is written in Fortran, using the Digital Fortran compiler for OpenVMS. The DSS routines are also written in Fortran.

It is expected that the new version of DCP (for Windows) will be written in a combination of C++ (using the Microsoft Visual C++ compiler) and Fortran (using Compaq Visual Fortran).

Back to Top

Logical Unit Numbers

The following is the assignment of Logical Unit Numbers (LUN's) currently used by DCP:

           LUN         Used for
           ---         --------
             1         Data File (EDF)
             2         PSF (DCPF)
             3         CSF (Calibration Storage File)
             4         STBF (Status Table File)
             5         Keyboard input
             6         Terminal (console) output
             7         Mailbox MAIL_UET
             8         Mailbox MAIL_DIS
             9         IC Mailbox (DCP -> DCIC)
            10         IC Mailbox (DCIC -> DCP)
            11         Waveform storage file
            12         Mailbox MAIL_GWI
            13         Error message file
            14         Mailbox MAIL_DCPRA
            15         Mailbox MAIL_DCTH
            16         Mailbox MAIL_DCPSER
            17         Mailbox DCPFF
            18         Mailbox DCPBC
            19         Menu Item-list file (menu_dcp.txt)

Back to Top

Common Event Flags

DCP runs in parallel with other programs (such as RA, TH etc.) and make extensive use of VMS Common Event Flags to synchronize activity between them. The following is a list of all common event flags used by DCP and associated programs. (Note: Local Event Flags, those with numbers below 64, are not listed here).

         Flag #         Used by/for
         ------         -----------
           65           RA and DCUET (or DCSORT)
           66           RA and DCDIS
           67           DCDIS and DCUET (or DCSORT)
           68           RA and DCIC
           69           RA and DCGWI
           70           RA and DCCAM
           71           TH and THUET
           72           TH and THDIS
           73           THUET and THDIS
           74           TH and THIC
           75           available?
           76           available?
           77           FF and FFUET
           78           available?
           79           available?
           80           available?
           81           DCP and "current program" (RA,TH,BC,FF,etc.)
           82           available?
           83           available?
           84           available?
           85           available?
           86           available?
           87           available?
           88           available?
           89           available?
           90           available?
           91           BC and BCUET
           92           BC and BCDIS
           93           BCUET and BCDIS
           94           BC and BCIC
           95           BC and BCLVR
           96           BC and BCLIT
           97           BC and BCLVR
           98           BC and BCLVR
           99           BC and BCLIT
          100           COM and COMSER
          101           RA and DCAD
          102           DCAD and DCDIS
          103           RA and DCGWFL

Back to Top

Memory Mapped Objects

Memory Mapped Objects (or File-mapped Objects) are used to transfer data between the many co-programs (data collection programs) that comprise the Windows version of DCP. These objects are just blocks in virtual memory that can be mapped (and hence shared) by the various co-programs.

The following file-mapped objects are in use at the moment:

(1) DCPMM1

Used to share data between DCP and the "currently active" data collection program (e.g. RA). Size = 5120 bytes. Allocation as follows:

        Location (32-bit)     Contents
        ----------------      --------
              1               if=1 then co-program initiated by DCP
           129-256            Array TABLE

Back to Top

The TABLE array

The array "TABLE" in DCP holds the values of most internal variables within DCP that define the program state. When DCP launches another program, TABLE is written out to the PSF, and then read back from the PSF when DCP resumes execution. TABLE is an array of 128 integers (32-bits each). The following are the contents of TABLE.

Loc     Contents
---     --------
(1)    MFLG         Macro Flag
                     0=Input from terminal
                     1=Input from macro at level-1
                     2=Input from macro at level-2
                     3=Input from macro at level-3

(2)    MTN          Total number of records in macro at level-1

(3)    MCN          Current record no. in macro at level-1

(4)    MTN2         Total no. of records in macro at level-2

(5)    MCN2         Current record no. in macro at level-2

(6)    MTN3         Total no. of records in macro at level-3

(7)    MCN3         Current record no. in macro at level-3

(8)    MODE         Program mode for parameter specification
                     1=RA
                     2=TH

(9)    IFRF         Frame selection flag
                     1=Frames as specified
                     2=All frames

(10)]
  : ]  MASK         ID mask (12 characters)
(13)]

(14)   IDF          ID flag
                     0=Query user for DSID
                     1=Use ID directly from PSF

(15)   EXTF         EXTYP flag
                     0=Let program set the experiment type code
                     1=Use EXTYP as stored in PSF

(16)   DSAVE        Data save flag
                     0=Save data after collection
                     1=Do not save data

(17)   DSAVC        Current data save flag
                     0=Save data after collection
                     1=Do not save data

(18)   NRVAR        No. of currently defined real variables

(19)   NCVAR        No. of currently defined character variables

(20)   IANY         If=1 then one or more data collection programs
                    is currently initiated

(21)   IRA          If=1 then program RA is currently running

(22)   ITH          If=1 then program TH is currently running

(23)   NGWC         If=1 then use window specified for GW SPL computation
                    If=0 then use entire window

(24)   ISER         If=1 then program SER is currently running

(25)   IFF          If=1 then program FF is currently running

(26)   OPSF         If=1 then PSF is currently open

(27)   NWIN         Workstation Windows type
                      0=No windows
                      1=DECwindows
                      2=VWS windows

(28)   IBC          if=1 then program BC is currently running

(29)   IRF          if=1 then program RF is currently running

(30)   MLVL         Message Level (0=None, 1=Brief, 2=Long, 3=Full)

(31)   IDIAG        Diagnostic Level (0=No, 1=Yes)

(32) ]
  :  ]  -----------avail----------------
(128)]

Back to Top

The Parameter Storage File - PSF

The Parameter Storage File (PSF) is a file used by DCP and all related programs (RA, TH etc.) to store parameters that need to persist after the programs are done running. For example, when the user specifies certain RA parameters, such as number of reps or duration time, the program saves them in the PSF and retrieves them automatically the next time RA is started.

It is also used for some inter-process communication. For example, the program NEUCAL passes certain parameters to its sub-programs via blocks 7 and 8 of the PSF.

The PSF that is used by DCP (and related programs) is always named DCPF.PSF. It resides in directory D: on VMS systems, and on Windows systems the PSF for DCP resides in folder "APPDATA\Audstuff\DCP" where APPDATA is the file system directory that serves as a common repository for application-specific data (as defined by Windows). Thus, typically, on a Win/2000/XP system, DCPF.PSF may reside in the directory "C:\Documents and Settings\UserName\Application Data\Audstuff\DCP" where "UserName" is the name of currently logged in user.

Thus, in VMS the same PSF is shared by all users, while in Windows there is a separate PSF for each user. The exact location (or even the existence) of the PSF is generally not known to the user. On Windows systems, the PSF is created automatically the first time that DCP runs (if it does not already exist).

The PSF (DCPF.PSF) is a binary file, logically divided into blocks of 128 32-bit words each (i.e. 512 bytes/block). Since it is shared by several programs, its use is regulated by the following convention.

                 Parameter Storage File (DCPF.PSF)
                     Allocation of blocks
                     --------------------

       Block #         Contents
       -------         --------

         1-8           Communications
         9-10          Common Parameters
        11-13          RA
          14           PIN
        15-18          RA
        19-20          NEUCAL
        21-22          TH (Tuning Curve)
        23-24          LINC (Waisman Ctr)
          25           Data Storage Status (Waisman)
        26-29          Reserved for Waisman Center Use
          30           SWP
          31           DCP
          32           SER
          33           EP
          34           SER (default)
        35-36          RA
          37           BC
        38-39          RA
          40           Spike sorter (John Oghalai)
        41-103         Macro at level-1
       104-166         Macro at level-2
       167-229         Macro at level-3
       230-233         Defined Real variable names (DCP)
          234          Defined Real variable values (DCP)
       235-236         Defined Character variable names (DCP)
       237-244         Defined Character variable values (DCP)
          245          Temp. variable (real) values (DCP)
       246-253         Temp. Character variable values (DCP)
       254-259         RA
          260          FF
       261-264         RA
          265          COILC
       266-267         RA
       268-269         SERCOM
       270-272         RA

The following is a detailed list of how the contents of each block of the PSF are used. (Note: I*2 means 16-bit).

      PSF - Block # 7
      ---------------

    Word # (I*2)        Contents
    ------------        --------
         1              FLAG      Communication Flag written by NEUCAL
                                  and associated programs. It's value
                                  indicates which program was run last.
                                  1 = NEUCAL, 2 = CALBRT, 3 = CORECT
                                  4 = DISPLA, 5 = PRTAB
        2-129           IFOLD     Folder name where NEUCAL is installed
      129-256           ---------avail---------

      PSF - Block # 8
      ---------------

    Word # (I*2)        Contents
    ------------        --------
        1-100           TABLE     Array TABLE as defined in NEUCAL
                                  Used to pass TABLE between NEUCAL and
                                  associated programs.
      101-256           ---------avail---------


      PSF - Block # 9
      ---------------

    Word # (I*2)        Contents
    ------------        --------
        1-6             DSID      Data set ID (12 characters)
        7-28            FNAME     Data file name (40 chars, plus 4 zero bytes)
       29-60     -----avail-------
       61-62            EXTYP     Experiment Type code (4 chars)
       63-256    -----avail-------


      PSF - Block # 11
      ----------------

    Word # (I*2)        Contents
    ------------        --------
         1              Present tones from DSS-1 (Y/N)
         2              Present tones from DSS-2 (Y/N)
         3              Present tones from DSS-3 (Y/N)
         4              Present tones from DSS-4 (Y/N)
         5              Master DSS number (integer)
         6        -----avail-----
        7-8             Stimulus duration for Master DSS (milisecs)
        9-10            Stimulus duration for Slave DSS (milisecs)
       11-12            Repetition interval for Master DSS (millisecs)
       13-14            Rep. interval for Slave DSS (msecs)
        15              No. of reps for Master DSS
        16              No. of reps for Slave DSS
       17-20            X-variable name (8 char string)
       21-24            Y-variable name (8 char string)
       25-26            X-variable low value (real)
       27-28            X-variable high value (real)
       29-30            X-variable increment (real)
       31-32            X-var steps/octave (real)
       33-34            Y-variable low value (real)
       35-36            Y-var high value (real)
       37-38            Y-var increment (real)
       39-40            Y-var steps/octave (real)
        41              Collect UET data (Y/N)
        42              UET time base (microsecs)
        43              Collect A/D data (Y/N)
        44              Collect Multiunit (Sorted) data (Y/N)
        45     -----avail-----
        46              Display spike count/rate vs. X-variable (Y/N)
        47              Display spike count/rate vs. Y-variable (Y/N)
        48              Display PST histogram (Y/N)
        49              Display Inter-spike interval histogram (Y/N)
        50              Display cycle histogram (Y/N)
        51              Latency Dot display (Y/N)
        52              Display Sync. coeff. vs. X-variable (Y/N)
        53              Display Sync. coeff. vs. Y-variable (Y/N)
        54              Display sampled analog data (Y/N)
        55              Display spike rate vs. Y-var (#2) (Y/N)
        56              Display spike rate vs. Y-var (#3) (Y/N)
        57              Display spike rate vs. Y-var (#4) (Y/N)
        58              Cumulative latency dot display (Y/N)
       59-69     -----avail-----
        70              Randomize X-var (Y/N)
        71              Randomize Y-var (Y/N)
        72              Randomize Z-var (Y/N)
       73-74            LIN or LOG increment for X-var (4 chars)
       75-76            LIN or LOG increment for Y-var (4 chars)
       77-78            LIN or LOG increment for Z-var (4 chars)
       79-80     ------avail-----
        81              Pure tone for master DSS  (TONE) (Y/N)
        82              AM stimulus for master DSS (AM) (Y/N)
        83              Shifted GEWAB stimulus for master DSS (FM) (Y/N)
        84              General waveform for master DSS (GW) (Y/N)
        85              Masked stimulus (tone+gw) for master DSS (Y/N)
        86              GEWAB-AM (tone modulates GW) (GWAMTONE) (Y/N)
                           (for master DSS)
        87              GEWAB-AM (GW modulates tone) (GWAMGW) (Y/N)
                           (for master DSS)
        88              ZIP-AM for master DSS (Y/N)
        89              Click pairs for master DSS (CP) (Y/N)
        90              GEWAB pairs for master DSS (GWPAIR) (Y/N)
        91              Computed AM for master DSS (CAM) (Y/N)
        92              Virtual Space waveforms for master DSS (VS) (Y/N)
        93              Synthetic notch waveforms for master DSS (SYN) (Y/N)
        94              Computed noise waveforms for master DSS (CNOIS) (Y/N)
        95              Pure tone for slave DSS  (TONE) (Y/N)
        96              AM stimulus for slave DSS (AM) (Y/N)
        97              Shifted GEWAB stimulus for slave DSS (FM) (Y/N)
        98              General waveform for slave DSS (GW) (Y/N)
        99              Masked stimulus (tone+gw) for slave DSS (Y/N)
       100              GEWAB-AM (tone modulates GW) (GWAMTONE) (Y/N)
                           (for slave DSS)
       101              GEWAB-AM (GW modulates tone) (GWAMGW) (Y/N)
                           (for slave DSS)
       102              ZIP-AM for slave DSS (Y/N)
       103              Click pairs for slave DSS (CP) (Y/N)
       104              GEWAB pairs for slave DSS (GWPAIR) (Y/N)
       105              Computed AM for slave DSS (CAM) (Y/N)
       106              Virtual Space waveforms for slave DSS (VS) (Y/N)
       107              Synthetic notch waveforms for slave DSS (SYN) (Y/N)
       108              Computed noise waveforms for slave DSS (CNOIS) (Y/N)
      109-110     -----avail-----
      111-112           Fixed Carrier Freq. for AM (master DSS) (Hz)
      113-114           Fixed Modulation Freq. for AM (master DSS) (Hz)
      115-116           Fixed Modulation depth for AM (master DSS) (0 to 1)
      117-118           Fixed SPL for AM (master DSS) (dB)
      119-120     -----avail-----
      121-122           Fixed Carrier Freq. for AM (slave DSS) (Hz)
      123-124           Fixed Modulation Freq. for AM (slave DSS) (Hz)
      125-126           Fixed Modulation depth for AM (slave DSS) (0 to 1)
      127-128           Fixed SPL for AM (slave DSS) (dB)
      129-130     -----avail-----
      131-136     -----avail-----
      137-138           Fixed SPL for GW for master DSS (dB)
      139-140           Fixed SPL for GW for slave DSS (dB)
      141-155           Waveform filename for master DSS
      156-161           Waveform ID for master DSS (12 chars)
      162-176           Waveform filename for slave DSS
      177-182           Waveform ID for slave DSS (12 chars)
      183-184           Fixed Freq. for pure tone (master DSS) (Hz)
      185-186           Fixed SPL for pure tone (master DSS) (Hz)
      187-188           Fixed initial phase for pure tone (master DSS) (0-1)
      189-190           X-min for latency dot plot (millisecs) (def=-999999)
      191-192           X-max for latency dot plot (millisecs) (def=-999999)
      193-194           X-min for PST plot (millisecs) (def=-999999)
      195-196           X-max for PST plot (millisecs) (def=-999999)
      197-198           X-min for IST plot (millisecs) (def=-999999)
      199-200           X-max for IST plot (millisecs) (def=-999999)
      201-202     -----avail-----
      203-204           Fixed freq. for pure tone (slace DSS) (Hz)
      205-206           Fixed SPL for pure tone (slave DSS) (dB)
      207-208           Fixed initial phase for pure tone (0-1)
      209-214     -----avail-----
       215              Normal VS stimulus (Y/N)
       216              Zero-ITD VS stimulus (Y/N)
       217              Zero-ILD VS stimulus (Y/N)
       218              Zero-ISD VS stimulus (Y/N)
       219              Delta-ITD VS stimulus (Y/N)
       220              Delta-ILD VS stimulus (Y/N)
       221              Delta-ISD VS stimulus (Y/N)
      222-230     -----avail-----
       231              Cycle histogram binned on FREQ (Y/N)
       232              Cycle histogram binned on FMOD (Y/N)
       233              Cycle histogram binned on FCARR (Y/N)
       234              Cycle histogram binned on a fixed frequency (Y/N)
      235-236           Fixed Freq. at which cyc. histogram binned (real) (Hz)
       237              Cycle histogram binned on FCARR+FMOD (Y/N)
       238              Cycle histogram binned on FCARR-FMOD (Y/N)
       239              Cycle histogram binned on AFREQ (Y/N)
       240              Cycle histogram binned on TFREQ (Y/N)
       241              1st RA plot (spikes vs. RA-var) (Y/N)
       242              UET channel # for 1st RA plot
       243              2nd RA plot (Y/N)
       244              UET channel # for 2nd RA plot
       245              3rd RA plot (Y/N)
       246              UET channel # for 3rd RA plot
       247              4th RA plot (Y/N)
       248              UET channel # for 4th RA plot
      249-256     -----avail-----
      

      PSF - Block # 12
      ----------------

    Word # (I*2)        Contents
    ------------        --------
        1-2             Rise/Fall envelope for Master DSS (4 chars)
                        (TRAP, COS, GAUS)
        3-4             Fixed Rise time for Master DSS (msecs)
        5-6             Fixed Fall time for Master DSS (msecs)
        7-8             Fixed Initial Delay for Master DSS (microsecs)
        9-20     -----avail-----
       21-22            Rise/Fall envelope for Slave DSS (4 chars)
                        (TRAP, COS, GAUS)
       23-24            Fixed Rise time for Slave DSS (msecs)
       25-26            Fixed Fall time for Slave DSS (msecs)
       27-28            Fixed Initial Delay for Slave DSS (microsecs)
       29-40     -----avail-----
        41              Sync. Coeff. binning freq = FREQ (Y/N)
        42              Sync. Coeff. binning freq = FMOD (Y/N)
        43              Sync. Coeff. binning freq = FCARR (Y/N)
        44              Sync. Coeff. binning freq = User specified (Y/N)
       45-46            User specified binning Freq (Hz) (real)
        47              Sync. Coeff. binning Freq = FCARR+FMOD (Y/N)
        48              Sync. Coeff. binning Freq = FCARR-FMOD (Y/N)
        49              Sync. Coeff. binning Freq = AFREQ (Y/N)
        50              Sync. Coeff. binning Freq = TFREQ (Y/N)
       51-60     -----avail-----
       61-62            Fixed DELAY2 for masked stimulus (Master DSS) (usecs)
       63-64            Fixed Duration-2 for masked stim. (Master DSS) (msecs)
       65-66            Fixed TONLVL for masked stim. (Master DSS) (0 to 1)
       67-68            Fixed GWLVL for masked stim. (Master DSS) (0 to 1)
       69-70            Fixed Freq. for masked stimulus (Master DSS) (Hz)
       71-72            Fixed SPL for masked stim. (Master DSS) (dB)
       73-87            Wave. file name for masked stim (Master DSS) (30 char)
       88-93            Waveform ID for masked stim (Master DSS) (12 char)
        94              Masking stimulus (Tone/GW)
       95-100    -----avail-----
      101-102           Fixed DELAY2 for masked stimulus for slave DSS (usecs)
      103-104           Fixed Duration-2 for masked stim for slave DSS (msecs)
      105-106           Fixed TONLVL for masked stim for slave DSS (0 to 1)
      107-108           Fixed GWLVL for masked stim for slave DSS (0 to 1)
      109-110           Fixed Freq. for masked stimulus for slave DSS (Hz)
      111-112           Fixed SPL for masked stimulus for slave DSS (dB)
      113-127           Waveform file name for masked stim for slave DSS 
                        (30 characters)
      128-133           Waveform ID for masked stim. for slave DSS (12 chars)
       134              Masking Stimulus (Tone/GW)
      135-140           reserved
      141-150    -----avail-----
      151-166           Fixed Freq. for pure tone for master DSS (Hz)
      167-182           Fixed SPL for pure tone for Master DSS (dB)
      183-198           Fixed Phase for pure tone for Master DSS (0 to 1)
       199              Fixed speaker number for pure tone for master DSS
       200       -----avail-----
      201-216           Fixed Freq. for pure tone for slave DSS (Hz)
      217-232           Fixed SPL for pure tone for slave DSS (dB)
      233-248           Fixed Phase for pure tone for slave DSS (0 to 1)
       249              Fixd speaker number for pure tone for slave DSS
      250-256    -----avail-----


      PSF - Block # 13
      ----------------

    Word # (I*2)        Contents
    ------------        --------
        1-16            Inter-stimulus delay (msecs)
       17-32            Inter-Xvar delay (msecs)
       33-36            Rise-time envelope shape for master DSS (TRAP/COS/GAUS)
       37-52            Rise-time for master DSS (msecs)
       53-56            Fall-time envelope shape for master DSS (TRAP/COS/GAUS)
       57-72            Fall-time for master DSS (msecs)
       73-76            Rise-time envelope shape for slave DSS (TRAP/COS/GAUS)
       77-92            Rise-time for slave DSS (msecs)
       93-96            Fall-time envelope shape for slave DSS (TRAP/COS/GAUS)
       97-112           Fall-time for slave DSS (msecs)
      113-128           Stimulus Duration time for master DSS (msecs)
      129-144           Repetition time for master DSS (msecs)
      145-160           Number of reps for master DSS
      161-176           Initial Delay for master DSS (microsecs)
      177-192           Stimulus Duration time for slave DSS (msecs)
      193-208           Repetition time for slave DSS (msecs)
      209-224           Number of reps for slave DSS
      225-240           Initial Delay for slave DSS (microsecs)
      241-256    -----avail-----


      PSF - Block # 14
      ----------------

    Word # (I*2)        Contents
    ------------        --------
      (Reserved for use by PIN)


      PSF - Block # 15
      ----------------

    Word # (I*2)        Contents
    ------------        --------
        1-16            Carrier Freq. for AM for master DSS (Hz)
       17-32            Modulation Freq. for AM for master DSS (Hz)
       33-48            Modulation Depth for AM for master DSS (0 to 1)
       49-64            SPL for AM for master DSS (0 to 1)
       65-80            Carrier phase for AM for master DSS (0 to 1)
       81-96            Modulation phase for AM for master DSS (0 to 1)
       97-128    -----avail-----
      129-144           Carrier Freq. for AM for slave DSS (Hz)
      145-160           Modulation Freq. for AM for slave DSS (Hz)
      161-176           Modulation Depth for AM for slave DSS (0 to 1)
      177-192           SPL for AM for slave DSS (0 to 1)
      193-208           Carrier phase for AM for slave DSS (0 to 1)
      209-224           Modulation phase for AM for slave DSS (0 to 1)
      225-256    -----avail-----


      PSF - Block # 19
      ----------------

    Word # (I*2)        Contents
    ------------        --------
        1-2             Starting Freq (Hz) (Neucal) (real)
        3-4             End Freq (Hz) (Neucal) (real)
        5-6             Freq. increment (Hz) (Neucal) (real)
         7              Number of Harmonics (Neucal)
         8              DSS number (Neucal)
         9              Correct for Probe Tube (Y/N) (Neucal)
        10        ------avail-------
       11-16            Correction Curve ID (12 chars) (Neucal)
       17-30      ------avail-------
        31              Amplitude Plot (Y/N) (Neucal)
        32              Phase Plot (Y/N) (Neucal)
       33-34            X-axis (LOG/LIN) (Neucal)
        35              Autoscale (Y/N) (Neucal)
       36-39      -------avail-------
        40              Print Amplitude Table (Y/N) (Neucal)
        41              Print Phase Table (Y/N) (Neucal)
        42              Number of columns in table (Neucal)
        43              Save Amplitude Table (Y/N) (Neucal)
        44              Save Phase Table (Y/N) (Neucal)
        45              Phone number to save table for (Neucal)
        46              Attenuator Auto-Adjust (Y/N) (Neucal)
        47              Initial Attenuation (dB) (Neucal)
        48              Attenuator Fixed (Y/N) (Neucal)
        49              Fixed attenuator setting (dB) (Neucal)
        50          ------avail-------
       51-52            X-min for plots (Hz) (Neucal) (real)
       53-54            X-max for plots (Hz) (Neucal) (real)
       55-56            Y-min for Amplitude plot (dB) (Neucal) (real)
       57-58            Y-max for Amplitude plot (dB) (Neucal) (real)
       59-60            Y-min for Phase plot (cycles) (Neucal) (real)
       61-62            Y-max for Phase plot (cycles) (Neucal) (real)
       63-256       ---------avail--------


      PSF - Block # 20
      ----------------

    Word # (I*2)        Contents
    ------------        --------
        1-128           Folder name where Neucal is installed (255 chars)
      129-256        ----------avail----------


      PSF - Block # 31
      ----------------

    Word # (I*2)        Contents
    ------------        --------
        1-256           Array TABLE for DCP (see above for contents of TABLE)


      PSF - Block # 36
      ----------------

    Word # (I*2)        Contents
    ------------        --------
        1-6             GWID for first waveform (GWpair expt) for master DSS
        7-22            Duration of first waveform (GWpair expt) for master DSS
                         (in millisecs)
       23-28            GWID for second waveform (GWpair expt) for master DSS
       29-44            Duration of second waveform (GWpair expt) (master DSS)
                         (in millisecs)
       45-60            ICD for GWpair (silent interval) in millisecs
                         (master DSS)
       61-76            Fixed SPL (db) for first waveform (GWpair) (master DSS)
       77-92            Fixed SPL (db) for second waveform (GWpair) (master DSS)
         93             Compute Effective SPL for GWP (Y/N) (master DSS)
       94-128           ---available---
      129-134             GWID for first waveform (GWpair expt) for slave DSS
      135-150           Duration of first waveform (GWpair expt) for slave DSS
                         (in millisecs)
      151-156           GWID for second waveform (GWpair expt) for slave DSS
      157-172           Duration of second waveform (GWpair expt) (slave DSS)
                         (in millisecs)
      173-188           ICD for GWpair (silent interval) in millisecs
                         (slave DSS)
      189-204           Fixed SPL (db) for first waveform (GWpair) (slave DSS)
      205-220           Fixed SPL (db) for second waveform (GWpair) (slave DSS)
        221             Compute Effective SPL for GWP (Y/N) (slave DSS)
      222-256           ---available---



      PSF - Block # 39
      ----------------

    Word # (I*2)        Contents
    ------------        --------
        1-16            Free-field transfer function (STATPK) file name
                         (for master DSS)
       17-20            Compute Server node name (e.g. MVF::) for master DSS
       21-24            Waveform type (CLICK or GW) for master DSS
       25-40            GW file name (for master DSS)
       41-46            GW waveform ID (for master DSS)
       47-62            Azimuth (degrees) (master DSS)
       63-78            Elevation (degrees) (master DSS)
       79-94            SPL (dB) (master DSS)
       95-128           ---available---
      129-144           Free-field transfer function (STATPK) file name
                         (for slave DSS)
      145-148           Compute Server node name (e.g. MVF::) for slave DSS
      149-152           Waveform type (CLICK or GW) for slave DSS
      153-168           GW file name (for slave DSS)
      169-174           GW waveform ID (for slave DSS)
      175-190           Azimuth (degrees) (slave DSS)
      191-206           Elevation (degrees) (slave DSS)
      207-222           SPL (dB) (slave DSS)
        223             Gaussian Filter for VS level determination (Y/N)
      224-239           Center Freq. of Filter (Hz)
      240-255           3-dB bandwidth for Filter (octaves)
        256             ---available---



      PSF - Block # 256
      -----------------

    Word # (I*2)        Contents
    ------------        --------
        1-16            Upper Freq. cutoff (Hz) (for master DSS)
                         (for Gaussian computed noise)
        17              Bandpass filter (Y/N) (for master DSS)
                         (for Gaussian computed noise)
       18-33            Filter CF (Hz) (for master DSS)
                         (for Gaussian computed noise)
       34-35            Bandwidth units (HZ or OCT) (for master DSS)
                         (for Gaussian computed noise)
       36-51            Bandwidth (for master DSS)
                         (for Gaussian computed noise)
       52-128      ------avail------
      129-144           Upper Freq. cutoff (Hz) (for slave DSS)
                         (for Gaussian computed noise)
       145              Bandpass filter (Y/N) (for slave DSS)
                         (for Gaussian computed noise)
      146-161           Filter CF (Hz) (for slave DSS)
                         (for Gaussian computed noise)
      162-163           Bandwidth units (HZ or OCT) (for slave DSS)
                         (for Gaussian computed noise)
      164-179           Bandwidth (for slave DSS)
                         (for Gaussian computed noise)
      180-256      ------avail------



      PSF - Block # 257
      -----------------

    Word # (I*2)        Contents
    ------------        --------
        1-16            Upper Freq. cutoff (Hz) (for master DSS)
                         (for Modulated computed noise)
        17              Bandpass filter (Y/N) (for master DSS)
                         (for Modulated computed noise)
       18-33            Filter CF (Hz) (for master DSS)
                         (for Modulated computed noise)
       34-35            Bandwidth units (HZ or OCT) (for master DSS)
                         (for Modulated computed noise)
       36-51            Bandwidth (for master DSS)
                         (for Modulated computed noise)
       52-67            Modulation Freq. (Hz) (for Master DSS)
                         (for Modulated computed noise)
       68-83            Modulation Depth (0 to 2) (for Master DSS)
                         (for Modulated computed noise)
       84-99            Modulation Initial Phase (0 to 1) (for Master DSS)
                         (for Modulated computed noise)
      100-128      ------avail------
      129-144           Upper Freq. cutoff (Hz) (for slave DSS)
                         (for Modulated computed noise)
       145              Bandpass filter (Y/N) (for slave DSS)
                         (for Modulated computed noise)
      146-161           Filter CF (Hz) (for slave DSS)
                         (for Modulated computed noise)
      162-163           Bandwidth units (HZ or OCT) (for slave DSS)
                         (for Modulated computed noise)
      164-179           Bandwidth (for slave DSS)
                         (for Modulated computed noise)
      180-195           Modulation Freq. (Hz) (for slave DSS)
                         (for Modulated computed noise)
      196-211           Modulation Depth (0 to 2) (for slave DSS)
                         (for Modulated computed noise)
      212-227           Modulation Initial Phase (0 to 1) (for slave DSS)
                         (for Modulated computed noise)
      228-256      ------avail------



      PSF - Block # 258
      -----------------

    Word # (I*2)        Contents
    ------------        --------
        1-16            Upper Freq. cutoff (Hz) (for master DSS)
                         (for Tone+Modulated computed noise)
        17              Bandpass filter (Y/N) (for master DSS)
                         (for Tone+Modulated computed noise)
       18-33            Filter CF (Hz) (for master DSS)
                         (for Tone+Modulated computed noise)
       34-35            Bandwidth units (HZ or OCT) (for master DSS)
                         (for Tone+Modulated computed noise)
       36-51            Bandwidth (for master DSS)
                         (for Tone+Modulated computed noise)
       52-67            Modulation Freq. (Hz) (for Master DSS)
                         (for Tone+Modulated computed noise)
       68-83            Modulation Depth (0 to 2) (for Master DSS)
                         (for Tone+Modulated computed noise)
       84-99            Modulation Initial Phase (0 to 1) (for Master DSS)
                         (for Tone+Modulated computed noise)
      100-115           Delay between Noise and Tone onset (microsecs)
                         (Master DSS) (for Tone+Modulated computed noise)
      116-131           Tone Duration (millisecs) (for Master DSS)
                         (for Tone+Modulated computed noise)
      132-147           Tone Level (dB up from noise) (dB) (for Master DSS)
                         (for Tone+Modulated computed noise)
      148-163           Tone Frequency (Hz) (for Master DSS)
                         (for Tone+Modulated computed noise)
      164-256      ------avail------



      PSF - Block # 259
      -----------------

    Word # (I*2)        Contents
    ------------        --------
        1-16            Upper Freq. cutoff (Hz) (for slave DSS)
                         (for Tone+Modulated computed noise)
        17              Bandpass filter (Y/N) (for slave DSS)
                         (for Tone+Modulated computed noise)
       18-33            Filter CF (Hz) (for slave DSS)
                         (for Tone+Modulated computed noise)
       34-35            Bandwidth units (HZ or OCT) (for slave DSS)
                         (for Tone+Modulated computed noise)
       36-51            Bandwidth (for slave DSS)
                         (for Tone+Modulated computed noise)
       52-67            Modulation Freq. (Hz) (for Slave DSS)
                         (for Tone+Modulated computed noise)
       68-83            Modulation Depth (0 to 2) (for Slave DSS)
                         (for Tone+Modulated computed noise)
       84-99            Modulation Initial Phase (0 to 1) (for Slave DSS)
                         (for Tone+Modulated computed noise)
      100-115           Delay between Noise and Tone onset (microsecs)
                         (Slave DSS) (for Tone+Modulated computed noise)
      116-131           Tone Duration (millisecs) (for Slave DSS)
                         (for Tone+Modulated computed noise)
      132-147           Tone Level (dB up from noise) (dB) (for Slave DSS)
                         (for Tone+Modulated computed noise)
      148-163           Tone Frequency (Hz) (for Slave DSS)
                         (for Tone+Modulated computed noise)
      164-256      ------avail------



      PSF - Block # 260
      -----------------

    Word # (I*2)        Contents
    ------------        --------
        1-2             Echo source location Azimuth (degs)   (FF)
        3-4             Echo source location Elevation (degs) (FF)
        5-6             Echo intensity (dB rel. to source)    (FF)
        7-8             Echo delay rel. to source (millisecs) (FF)
        9-10            Display Window Start (millisecs) (FF)
       11-12            Display Window End (millisecs) (FF)
       13-16            Compute Server name (e.g. CORTEX::) (char string)(FF)
       17-32            GW file name (32 chars) (FF)
       33-34            User specified grid resolution (degs) (real) (FF)
        35              No. of steps for Saltatory stimulus (FF)
        36              No. of Repeats of saltatory stimulus (FF)
       37-38            Inter-repeat delay for saltatory stimulus
       39-256     -----avail-----



      PSF - Block # 261
      -----------------

    Word # (I*2)        Contents
    ------------        --------
        1-16            Upper Freq. cutoff (Hz) (for master DSS)
                         (for Tone+2band computed noise)
       17-32            Filter CF (Hz) for Band-1 (for master DSS)
                         (for Tone+2band computed noise)
       33-48            Bandwidth for Band-1 (for master DSS)
                         (for Tone+2band computed noise)
       49-64            Modulation Freq. (Hz) for Band-1 (for Master DSS)
                         (for Tone+2band computed noise)
       65-80            Modulation Depth (0 to 2) for Band-1 (for Master DSS)
                         (for Tone+2band computed noise)
       81-96            Modulation Initial Phase (0 to 1) for Band-1 
                         (for Master DSS) (for Tone+2band computed noise)
       97-112           Delay between Noise and Tone onset (microsecs)
                         (Master DSS) (for Tone+2band computed noise)
      113-128           Tone Duration (millisecs) (for Master DSS)
                         (for Tone+2band computed noise)
      129-144           Tone Level (dB up from noise) (dB) (for Master DSS)
                         (for Tone+2band computed noise)
      145-160           Tone Frequency (Hz) (for Master DSS)
                         (for Tone+2band computed noise)
      161-256      ------avail------



      PSF - Block # 262
      -----------------

    Word # (I*2)        Contents
    ------------        --------
        1-16            Upper Freq. cutoff (Hz) (for slave DSS)
                         (for Tone+2band computed noise)
       17-32            Filter CF (Hz) for Band-1 (for slave DSS)
                         (for Tone+2band computed noise)
       33-48            Bandwidth for Band-1 (for slave DSS)
                         (for Tone+2band computed noise)
       49-64            Modulation Freq. (Hz) for Band-1 (for Slave DSS)
                         (for Tone+2band computed noise)
       65-80            Modulation Depth (0 to 2) for Band-1 (for Slave DSS)
                         (for Tone+2band computed noise)
       81-96            Modulation Initial Phase (0 to 1) for Band-1 
                         (for Slave DSS) (for Tone+2band computed noise)
       97-112           Delay between Noise and Tone onset (microsecs)
                         (Slave DSS) (for Tone+2band computed noise)
      113-128           Tone Duration (millisecs) (for Slave DSS)
                         (for Tone+2band computed noise)
      129-144           Tone Level (dB up from noise) (dB) (for Slave DSS)
                         (for Tone+2band computed noise)
      145-160           Tone Frequency (Hz) (for Slave DSS)
                         (for Tone+2band computed noise)
      161-256      ------avail------



      PSF - Block # 263
      -----------------

    Word # (I*2)        Contents
    ------------        --------
        1-16            Filter CF (Hz) for Band-2 (for Master DSS)
                         (for Tone+2band computed noise)
       17-32            Bandwidth for Band-2 (for Master DSS)
                         (for Tone+2band computed noise)
       33-48            Modulation Freq. (Hz) for Band-2 (for Master DSS)
                         (for Tone+2band computed noise)
       49-64            Modulation Depth (0 to 2) for Band-2 (for Master DSS)
                         (for Tone+2band computed noise)
       65-80            Modulation Initial Phase (0 to 1) for Band-2
                         (for Master DSS) (for Tone+2band computed noise)
       81-96            Band-2 Level (dB up from Band-1) (dB) (for Master DSS)
                         (for Tone+2band computed noise)
       97-256      ------avail------



      PSF - Block # 264
      -----------------

    Word # (I*2)        Contents
    ------------        --------
        1-16            Filter CF (Hz) for Band-2 (for Slave DSS)
                         (for Tone+2band computed noise)
       17-32            Bandwidth for Band-2 (for Slave DSS)
                         (for Tone+2band computed noise)
       33-48            Modulation Freq. (Hz) for Band-2 (for Slave DSS)
                         (for Tone+2band computed noise)
       49-64            Modulation Depth (0 to 2) for Band-2 (for Slave DSS)
                         (for Tone+2band computed noise)
       65-80            Modulation Initial Phase (0 to 1) for Band-2
                         (for Slave DSS) (for Tone+2band computed noise)
       81-96            Band-2 Level (dB up from Band-1) (dB) (for Slave DSS)
                         (for Tone+2band computed noise)
       97-256      ------avail------



      PSF - Block # 265
      -----------------

    Word # (I*2)        Contents
    ------------        --------
        1-8             Coil ID (16 chars) (COILC)
        9-24            STATPK file name
        25              A/D channel number for X (COILC)
        26              A/D channel number for Y (COILC)
        27              Master DSS number (1 or 2) (COILC)
        28              Click Width (microsecs)
        29              Master DSS attenuation (dB)
        30              Slave DSS attenuation (dB)
        31              Speaker # for Master DSS (0 to 15)
        32              Speaker # for Slave DSS (0 to 15)
       33-34            Inter-click delay (millisecs) (real) (COILC)
       35-256      ------avail------



      PSF - Block # 266
      -----------------

    Word # (I*2)        Contents
    ------------        --------
        1-16            GW file name for master DSS
                         (for shifted GEWAB stimulus - SHFTGW)
       17-22            GW ID for master DSS (for SHFTGW)
       23-38            ITDRATE for master DSS (for SHFTGW)
       39-54            GW SPL for master DSS (for SHFTGW)
         55             Compute Effective SPL for master DSS (Y/N)
         56             Unfrozen Noise for master DSS (Y/N)
       57-58            Starting compute window for eff. SPL 
                        computation for master DSS (millisecs)
       59-60            Ending compute window for eff. SPL 
                        computation for master DSS (millisecs)
       61-96       ------avail------
       97-112            ITD1 of slave DSS (SHFTGW) (usecs)
      113-128            ITD2 of slave DSS (SHFTGW) (usecs)
      129-144            GW file name for slave DSS
                         (for shifted GEWAB stimulus - SHFTGW)
      145-150           GW ID for slave DSS (for SHFTGW)
      151-166            ITDRATE for slave DSS (for SHFTGW)
      167-182            GW SPL for slave DSS (for SHFTGW)
        183             Compute Effective SPL for slave DSS (Y/N)
        184             Unfrozen Noise for slave DSS (Y/N)
      185-186           Starting compute window for eff. SPL 
                        computation for slave DSS (millisecs)
      187-188           Ending compute window for eff. SPL 
                        computation for slave DSS (millisecs)
      189-224      ------avail------
      225-226           Unfrozen noise step for SHFTGW (master DSS) (real)
      227-228           Unfrozen noise step for SHFTGW (slave DSS) (real)
      229-256      ------avail------



      PSF - Block # 267
      -----------------

    Word # (I*2)        Contents
    ------------        --------
        1-16            Sampling rate for A/D converter (samples/sec)
       17-32            Sampling Time for A/D converter (millisecs)
         33             Averaging Flag for A/D samples (Y/N)
         34             Channel-0 Select for A/D converter (Y/N)
         35             Channel-1 Select for A/D converter (Y/N)
         36             Channel-2 Select for A/D converter (Y/N)
         37             Channel-3 Select for A/D converter (Y/N)
         38             Channel-4 Select for A/D converter (Y/N)
         39             Channel-5 Select for A/D converter (Y/N)
         40             Channel-6 Select for A/D converter (Y/N)
         41             Channel-7 Select for A/D converter (Y/N)



      PSF - Block # 270
      -----------------

    Word # (I*2)        Contents
    ------------        --------
        1-4             Compute server for Synthesized Single Formant (SSF)
                         stimulus (for master DSS)
        5-8             Adapter Waveform Type for SSF (e.g. TONE or GW)
                         (for master DSS)
        9-24            Adapter Frequency for master DSS (Hz) (SSF)
       25-40            Adapter duration for master DSS (msecs) (SSF)
       41-56            Adapter SPL for master DSS (dB) (SSF)
       57-72            Silent Interval for master DSS (msecs) (SSF)
       73-128      ------avail------
      129-132           Compute server for Synthesized Single Formant (SSF)
                         stimulus (for slave DSS)
      133-136           Adapter Waveform Type for SSF (e.g. TONE or GW)
                         (for slave DSS)
      137-152           Adapter Frequency for slave DSS (Hz) (SSF)
      153-168           Adapter duration for slave DSS (msecs) (SSF)
      169-184           Adapter SPL for slave DSS (dB) (SSF)
      185-200           Silent Interval for slave DSS (msecs) (SSF)
      201-256      ------avail------



      PSF - Block # 272
      -----------------

    Word # (I*2)        Contents
    ------------        --------
        1-16            Klatt Filter CF for master DSS (Hz)
                         (for GEWAB stimulus - GW)
       17-32            Klatt Filter BW for master DSS (Hz)
                         (for GEWAB stimulus - GW)
       33-80            -----avail-----
       81-96            Klatt Filter CF for slave DSS (Hz)
                         (for GEWAB stimulus - GW)
       97-112           Klatt Filter BW for slave DSS (Hz)
                         (for GEWAB stimulus - GW)
      113-179           -----avail-----
         180            Number of Stim. points to exclude
      181-220           10 pairs of Stim. points to exclude (X,Y) (flt. pt.)
      221-256           -----avail-----

Back to Top

References

(1) "RA - Response Area Program", R.Kochhar, Dept. of Physiology.

(2) "DAFLIB - Data File Structure and Data Storage and Retrieval Routines" R.Kochhar, Dept. of Physiology, Tech report # 12, June 1993.

(3) "DSSLIB - Stimulus Generation and Data Acquisition Routines", R.Kochhar and J.Sekulski, Dept. of Physiology, Tech. Report # 10, Sept. 1988.

Back to Top

If you have questions or suggestions about this document, please send them by e-mail to kochhar@physiology.wisc.edu

Back to DCP Users Guide
Back to the Documentation Page
Back to the Computing Page
This page last modified on : May 12, 2004