XT2640 Operating Manual
13 July 2016
Page 123 of 187
23.6.2
CREATING
AND
IMPORTING
AN
ASCII
HARMONICS
LIMITS
FILE
You can create an ASCII format harmonics limits file for either voltage or current limits on a computer using a plain text editor such
as Windows Notepad.
The file must be named VHLIMIT.CSV to define the voltage harmonics limits, or AHLIMIT.CSV to define the current harmonics limits.
If present, these files are listed along with any binary harmonics files present on the drive when the HARMONIC LIMITS file type is
selected in the IMPORT area of the screen.
Each line of the file must contain the following fields in the order shown with the comma character separating each field –
1.
The letter H.
2.
A number of characters forming an integer between 1 and 500 inclusive which sets the harmonic for which a limit is being set by
this line.
The fundamental is harmonic 1.
If more than one line sets the limit for a harmonic, the last one is used.
The file does not need to define every harmonic; harmonics not included in the file are not checked against a limit.
3.
Either the character 1 if the limit is to be the highest of the percentage and level limits, or 2 if the limit is to be the addition of the
percentage and level limits.
4.
Either the character 0 if the percentage limit is to be the percentage of the fundamental amplitude or 1 if it is to be the
percentage of the total signal.
5.
A number of characters forming a floating number which is the percentage limit (in percent).
6.
A number of characters forming a floating number which is the level limit (in Volts or Amps).
The file may contain blank lines if desired.
A simple example of the contents of such a file is‐
H,2,1,0,0.1,1
H,3,2,1,0.2,2
This sets limits as follows –
1
st
line: For harmonic 2, the higher of 0.1% of fundamental or 1V or A
2
nd
line: For harmonic 3, the addition of 0.2% of signal and 2V or A
23.6.3
CREATING
AND
IMPORTING
AN
ASCII
CUSTOM
SCREEN
DEFINITION
FILE
You can create an ASCII format custom screen definition on a computer using a plain text editor such as Windows Notepad.
The file must be named CUSTOM.CSV.
If present, this file is listed along with any binary custom screen definition files present on the drive when the CUSTOM SCREEN file
type is selected in the IMPORT area of the screen.
A custom screen is like a spreadsheet composed of 57 cells arranged in 15 rows with row 0 (the topmost row) only having a single
column (column 0) and rows 1 through 14 having 4 columns (the leftmost column is 0, the rightmost is 3).
For cells other than the row 0 cell, for text sizes other than 12pix or 16pix the target cell is expanded to include surrounding cells as
follows –
22pix text size: includes the cell to the right of the target cell.
28pix and 36pix text sizes: includes the cell to the right of the target cell and also the cells immediately below both the
target cell and that to the right of it.
Note that the length of the text in a cell might cause the cell to be overrun into adjacent cells for any text height defined. You may
need to adjust your definition to obtain the desired format.
Each line of the file defines one cell in the custom screen and may be defined in any order in one of the following formats –
23.6.3.1
DEFINING
A
BLANK
CELL
Lines to define a blank cell are not needed as all custom screen cells always start as blank when reading the definition from a file,
however you may wish to include blank cell definitions for improved readability of the file.
This is defined by a line containing the following fields in the order shown with the comma character separating each field –
1.
The letter C.
2.
A number of characters forming an integer between 0 and 14 inclusive which sets which row the cell is in which this line
defines.
3.
A numeric character between 0 and 3 inclusive which sets which column the cell is in which this line defines.
23.6.3.2
DEFINING
A
CELL
WHICH
IS
TEXT
ONLY
This is defined by a line containing the following fields in the order shown with the comma character separating each field –
1.
The letter C.
2.
A number of characters forming an integer between 0 and 14 inclusive which sets which row the cell is in which this line
defines.
3.
A numeric character between 0 and 3 inclusive which sets which column the cell is in which this line defines.
4.
A numeric character which defines the character font size for this cell as follows –
0: Text which is 12pix high
