; **************************************************************************************
; These notes describe how to add a user defined telegraphed instrument to this
; UserDefinedInstruments.ini file.  Do not move this file from the directory into which
; it was installed.  After editing, save this file in plain text format.
; --------------------------------------------------------------------------------------
; Copyright, 1997 Axon Instruments
; All rights reserved.
; **************************************************************************************

;
; Explanation of the format:
;
; Each instrument is defined in a single contiguous section of this file.  These
; sections must be numbered sequentially as '[Instrument0]', '[Instrument1]', etc.
; A blank line marks the end of the section.
;
; Each instrument section contains these items:
;
;    'Name='            The name of the instrument.
;    'Attributes='      Any special attributes.
;    'Settings0_xxx='   The first group of settings.
;    'Settings1_xxx='   The second group of settings and so on.
;
; ** Name
;
; The name of the instrument will be visible to the user in the application's
; telegraphed-instrument configuration dialog box.
;
; ** Attributes
;
; The attributes field contains a comma delimited list of parameters specific to
; each device.  For Clampex 7 the only valid attribute is for membrane capacitance (Cm):
;
;    CMNeg              The conversion factor for negative CM values
;    CMPos              The conversion factor for positive CM values
;
; Here is an example attribute field:
;
;    Attributes="CMNeg=-100,CMPos=10"
;
; This tells the telegraph system that negative Cm telegraph values should be multiplied
; by -100 to convert the voltage to pF.  And that positive Cm telegraph values
; should be multiplied by 10 to convert the voltage to pF.
;
; NOTE: The attribute field should be left blank if none of the attributes
; apply.
;
; ** Settings
;
; Settings are the lists of conversion between telegraph voltages and gain
; or frequency values.  All of the settings for a single group start with a
; a prefix (i.e., 'Settings0_' or 'Settings1_').  The first item in the 
; settings group is the name, the name should either be 'gain' or 'frequency'.
;
; Then the conversion values are given.  Starting at 0 you give the voltage value,
; followed by a comma, and the converted value.  Here is an example of an
; instrument setting definition:
;
;    Settings0_Name=gain
;    Settings0_0=0.0,100
;    Settings0_1=1.0,200
;    Settings0_2=2.0,300
;    Settings0_3=3.0,400
;    Settings0_4=4.0,500
;
; Here we are setting the gain field (because the 'Name' item is 'gain'.)
; The first conversion is zero volts to a gain of 100.  Then one volt to
; a gain of two-hundred, and so on.
;
; NOTE: Settings values must always ascend in voltage.  You must put the smallest
; voltage value first and continue to the largest voltage value in ascending
; sorted order.
;
; ** Complete example
;
; This is an example of a complete instrument:
;
;    [Instrument0]
;    Name=New microelectrode amplifier
;    Attributes="CMPos=10,CMNeg=-10"
;    Settings0_Name=gain
;    Settings0_0=0.0,100
;    Settings0_1=1.0,200
;    Settings0_2=2.0,300
;    Settings0_3=3.0,400
;    Settings0_4=4.0,500
;    Settings1_Name=frequency
;    Settings1_0=0.0,1000
;    Settings1_1=1.0,2000
;    Settings1_2=2.0,3000
;    Settings1_3=3.0,4000
;    Settings1_4=4.0,5000
;
; This is the first instrument in the list (as signified by '[Instrument0]').
; The name that will appear in the Configure Telegraph dialog is
; "New microelectrode amplifier" (as signified by the 'Name' field.) 
; The 'Attributes' field tells us that the device has a CM telegraph
; and that one volt (in either the positive or negative direction)
; on the telegraph equal ten pF.
;
; There are two lists of settings on the device.  The first is gain, the second
; is frequency (defined by the 'Name' fields.)
;
; The conversion chart for gains on this device is:
;
;    Voltage            Gain
;    -------            ----
;    0 V                100
;    1 V                200
;    2 V                300
;    3 V                400
;    4 V                500
;
; The conversion chart for frequencies on this device is:
;
;    Voltage            Frequency
;    -------            ---------
;    0 V                1000 Hz
;    1 V                2000 Hz
;    2 V                3000 Hz
;    3 V                4000 Hz
;    4 V                5000 Hz
;

; Important Notes:
;
; 1) The UserDefinedInstruments.INI file is read at the start of
;    of Clampex and not afterwords.  If you want to have the file
;    re-read then you need to exit and restart Clampex.
;
; 2) If no UserDefinedInstruments.INI file is found in the \axon\libs
;    directory no error will be reported, and no user defined
;    instruments will be included in the telegraphed instruments list.
;
; 3) If the name block (i.e, [Instrument0, Instrument1]) is renamed
;    incorrectly then no errors will be reported and the instrument
;    will not be included in the telegraphed instruments list.

[Instrument0]
Name=User Defined (#1)
Attributes=
Settings0_Name=gain
Settings0_0=0.0,100
Settings0_1=1.0,200
Settings0_2=2.0,300
Settings0_3=3.0,400
Settings0_4=4.0,500
Settings1_Name=frequency
Settings1_0=0.0,1000
Settings1_1=1.0,2000
Settings1_2=2.0,3000
Settings1_3=3.0,4000
Settings1_4=4.0,5000

[Instrument1]
Name=User Defined (#2)
Attributes=
Settings0_Name=gain
Settings0_0=0.0,100
Settings0_1=1.0,200
Settings0_2=2.0,300
Settings0_3=3.0,400
Settings0_4=4.0,500
Settings1_Name=frequency
Settings1_0=0.0,1000
Settings1_1=1.0,2000
Settings1_2=2.0,3000
Settings1_3=3.0,4000
Settings1_4=4.0,5000

[Instrument2]
Name=User Defined (#3)
Attributes=
Settings0_Name=gain
Settings0_0=0.0,100
Settings0_1=1.0,200
Settings0_2=2.0,300
Settings0_3=3.0,400
Settings0_4=4.0,500
Settings1_Name=frequency
Settings1_0=0.0,1000
Settings1_1=1.0,2000
Settings1_2=2.0,3000
Settings1_3=3.0,4000
Settings1_4=4.0,5000