XITRON XT2640 - Creating and Importing an ASCII Harmonics Limits File; Creating and Importing an ASCII Custom Screen Definition File

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