garfield 软件英文版使用手册

Garfield,adrift-chambersimulationprogramUser'sguideVersion4.2930November1993RobVeenhofGarfieldisacomputerprogramforthedetailedsimulationoftwo-dimensionaldriftchambers.Theprogramcanforinstancecalculatefieldmaps,x(t)relations,arrivaltimedistributions,inducedsignalsandthedriftvelocityanddiffusioningasmixtures.Garfieldcanalsoassistinoptimisingthepotentialsettings.Garfield,adrift-chambersimulationprogramUser'sguideVersion4.29Garfield,adrift-chambersimulationprogramUser'sguideVersion4.29Copyrightnotice©RobVeenhof,1993,allrightsreserved.Garfield,adrift-chambersimulationprogram,CERNProgramLibraryentryW5050Copyrightandanyotherappropriatelegalprotectionofthiscomputerprogramandassociateddocumentationreservedinallcountriesoftheworld.Thisprogramordocumentationmaynotbereproducedand/orredistributedbyanymethodwithoutpriorwrittenconsentoftheauthor.Permissionforthescientificusageofanyprogramsdescribedhereinisgrantedaprioritothosescientificinsti-tutesassociatedwiththeCERNexperimentalprogramorwithwhomCERNhasconcludedascientificcollab-orationagreement.Commercialutilisationrequiresexplicitaprioripermissionfromtheauthorandwillbesubjectedtopaymentofalicensefee.Submitter:M.MarquinaLanguage:FORTRANLibrary:POOL-W5050iiGarfield,adrift-chambersimulationprogramWhatisGarfield?Garfieldtriestosimulatethebehaviourofdrift-chambers:itcalculatesandplotstheelectrostaticfield,thedrift-linesofelectronsandionsandthecurrentsonthesensewiresresultingfromthepassageofachargedparticlethroughthechamber.Theprogramcanalsoassistyouinfindingoptimalpotentialsettingsundercertaincon-straints.Forcalibrationpurposes,Garfieldcancomputex(t)-relationsandarrivaltimedistributions.Theprogramisprimarilymeantforusewithchambersthatconsistonlyofthinwiresandinfiniteequipotentialplanes.Periodicity,magneticfieldsandcylindricalgeometryareallowed.Fancyelectrodescanonlybehandledbyapproximation.Garfieldcannotdealwiththree-dimensionalstructures.GarfieldcanberuninteractivelyandinbatchonmostoftheCERNcentralcomputers.Oneofthemainfeaturesoftheprogramisprobablyitsfriendliness;littleknowledgeaboutthecomputersystemandnoknowledgeatallaboutprogramminglanguagesisrequiredtobeabletorunit.WhatisGarfield?iiiivGarfield,adrift-chambersimulationprogramContents1.0Introduction....................................................1Whattheprogramcando1Whattheprogramcannotdo1Incaseofproblems23334481010121213131515161717181819212728283039434966737474747475757676767779872.0Runningtheprogram2.1Howtostarttheprogramoneachofthesystems2.1.1RunningonApolloandUnixsystems2.1.2RunningontheCray2.1.3RunningunderVM/CMSandCrayjobsubmission2.1.4RunningonVax/VMS2.2Terminaltypes...................................................2.3Datasets.......................................................2.3.1Garfieldoutputdatasets2.3.2Filenamingconventionsandinputfileformat2.4Errormessages...................................................2.4.1Garfieldmessages...............................................2.4.2GKSerrormessages2.4.3Fortranrun-timeerrormessages3.0Programinput3.1Inputformat....................................................3.2Controlstructures..................................................3.2.1Globalvariables................................................3.2.2IF-blocksandIF-lines3.2.3DO-loops...................................................3.2.4Procedurecalls................................................3.3Physicalunits....................................................3.4Thecellsection3.5Themagneticfieldsection3.6Thegassection3.6.1Built-ingasses.................................................3.6.2Enteringadescriptionofthegas3.7Theoptimisationsection3.8Thefieldsection3.9Thedriftsection3.10Thesignalsection3.11Thestopcommand3.12Instructionsvalidinallsections3.12.1Globaloptions................................................3.12.2Kernliberrormessages3.12.3Printingacomment3.12.4Commentlines................................................3.12.5Inputtranslationtables3.12.6Obtaininghelp................................................3.12.7Inputfromandoutputtodatasets3.12.8Shellcommands...............................................3.12.9Garfieldlibrarymanipulationcommands3.12.10Graphicsinstructions............................................3.12.11Thealgebrainstructionlisteditor4.0Descriptionofthephysicalmodel914.1Electrostatics,magnetostatics...........................................914.1.1Notation....................................................91Contentsv4.1.2Celltypes...................................................924.1.3Isolatedcharges(typeA)934.1.4Rowsofcharges(typesB1x,B1y,B2xandB2y)934.1.5Electrostaticfieldofadoublyperiodicwirearray954.1.6Isolatedchargesinatube(typeD1)1024.1.7Ringofchargesinatube(typeD2)1024.1.8Thecapacitanceequations,boundaryconditions1024.1.9Cylindricalgeometry,internalcoordinates1034.1.10Zerosoftheelectricfield1044.1.11Magneticfieldcalculation1054.2Mixinggasses..................................................1054.3Motionofelectronsandions1104.3.1Theequationofmotion1101114.3.2Numericalsolutionoftheequationofmotion4.3.3Calculationofx(t)-relations1124.4Signalsimulation.................................................4.4.1Trackgeneration..............................................4.4.2Driftoftheclusterstowardstheanode4.4.3Calculationoftheion-tail4.5Evaluationofsymbolicformulae4.5.1Guidelines..................................................4.5.2Detailsaboutthetranslationprocess5.0Compilingtheprogram5.1Obtainingthesourcefile5.1.1Distributionconditions...........................................5.1.2Filelocation.................................................5.1.3Sourcefilecontents5.2TheYPATCHYstep5.3Makingtheexecutableandrelatedfiles5.3.1UNIX....................................................5.3.2VM/CMS5.3.3Vax/VMS..................................................6.0Detailsabouttheprogram6.1I/Ounits......................................................6.2Debugging....................................................6.3Briefdescriptionofallroutines6.4Programhistory.................................................7.0Acknowledgments................................................Bibliography.....................................................Index..........................................................viGarfield,adrift-chambersimulationprogram1121121171231231261271291291411431471491141151161171231231231241261271291291.0Introduction1.1WhattheprogramcandoGarfieldoperatesondrift-chambersmadeupofthinwires,uptotwo,notnecessarilygrounded,planesatconstantxorranduptotwo,notnecessarilygrounded,planesatconstantyorφ.Infiniterepetitionofthecellinxandiny(orφ)canbetakenintoaccount.Radialrepetitionisnotsupportedfortechnicalreasons.ThedescriptionofthechambercaneitherbeinpolarorinCartesiancoordinatesandconsistsofalistingofthewirepositions,potentialsanddiameters,oftheplanepositionsandpotentials,oftheperiodicitiesandofthedielectrica.Whendoingdriftlinecalculations,theprogramfurtherneedsadetaileddescriptionofthegas.Thisdescriptioncanbeprovidedbytheuser,butsomefrequentlyusedgassesarebuiltintheprogram(CO2,methane,ethane,isobutane,argon-ethane,CO2-ethaneetc.).Garfieldcanalsocalculatethedriftvelocityandthediffusioningasmixtures.ThetasksGarfieldcanperform,includethefollowing:•Plottingof(almost)anyfunctionofthefieldasahistogram,avectorplot,asetofcontourlines,a3dimen-sionalsurfaceoragraph.Thefieldinagivenpartofthechamberandonthesurfaceofagroupofwirescanbetabulated.Acommandisprovidedthatchecksthatthepotentialandthefieldareconsistent,satisfyMaxwell'sequationsandsatisfytheboundaryconditions.Assistingyouinfindingoptimumpotentialsettingsunderavarietyofconstraints.Thedependencyofthefieldonthewirepotentialscanbeprinted.Calculationandplottingofelectronandiondrift-linesandequalarrivaltimecontours.Thedrift-linesmaystartatthewire-surface,attheedgeofauser-defineddrift-areaorfromauser-definedtrack.Inthelattercase,graphsofthedrift-time,themeandrift-speed,theintegrateddiffusionandofthemultiplicationfactoraremadeonrequest.Calculationofx(t)-relations,ifrequiredforinclinedtracks,optionallyestimatingthelongitudinaldiffusion.Thecaseyourequipmentcountselectronsbeforeittriggersisalsohandledbytheprogram.Garfieldcanproducedrift-timetables.Simulationofthesignalinducedonthesensewireswhenachargedparticletraversesthecell.Theeffectswhichcanbetakenintoaccountare:cluster-formation,longitudinaldiffusion,avalanchenearthewire-surface,electron-pulseandtheion-inducedcurrent.ThesimulatedsignalcanbeusedasaninputtotheelectronicscircuitrysimulationprogramsSpiceorSceptre.••••Avarietyofroutinestoobtaindataderivedfromfieldanddrift-linecalculationsisavailableanditshouldthereforenotbedifficultforausertowritehis/herownextensions.1.2WhattheprogramcannotdoThemajorlimitationsoftheprogramare:•Allcalculationsarecarriedoutinthethin-wireapproximation,hencethewire-spacingshouldbeatleast5-10timesthewireradius.Correctionssuchasdipoleandquadrupoletermsmightbeincludedinsomefutureversion.Stripsorline-electrodesoffinitelengthhavetobereplacedbyrowsofwiresofappropriatediameter.You'llhavetouseanotherprogramifsuchanapproximationisnotadequate.OnlyinfiniteslabsofdielectricmaterialwillbehandledbyGarfieldinafuturerelease.ProgramsusingfiniteelementmethodslikePoissonwillprobablysuityoubetterifdielectricaareanimportantcomponentofyourchamber.Theprograminputallowsonlyforsimple,uniformmagneticfieldsbutthedistortionofthemagneticfieldduetothedifferenceinsusceptibilitybetweenthegasandthewire-materialcanbetakenintoaccount.Thisisnotatruelimitationsincetheusermayprovideher/hisownroutinereturningthemagneticfieldifhe/shewishestodoso.•••Introduction1•Theprogramneglectslateraldiffusioninitspresentversion.Thisisnotafundamentallimitationanditisconceivablethatfutureversionswillknowaboutlateraldiffusion,shouldtherebesufficientinterest(pleasesendamessagetotheauthor).Thefield-calculationis2-dimensionalinanessentialway.Themainreasonforthislimitationisthatanalyticpotentialsforsuchsimpleconfigurationsastwocrossingwires,arenotknown.Oneshouldthereforeuseafiniteelementmethodprogram,suchasTOSCA,wheneverthechamberistruely3-dimensional.Extendingthedrift-lineroutinesto3-dimensionalsituationsistrivialandhasbeendonetosomeextentinthecurrentversion.Theprogramisnotnotedforitsspeed!Ifthenumberofwiresislarge(over1000)runningGarfieldmaynolongerbepracticable;againPoissonorsimilarprogramsmightbemorelikewhatyouneed.Sometimes,theefficiencycangreatlybeincreasedbymakingthechamberperiodic,atleastpartofit.Thenumberofwireskeptinmindwhilewritingtheprogram,isabout50.Testshavebeendoneupto1000wires.Onsomemachinesspecialcompilationsareavailablethatmakeeffectiveuseofthevectorfacilities,makingcomputationsonchamberswith1000wiresfeasibleagain.•••Theauthorcannotwarrantcorrectfunctioningofanypartoftheprogram,itisthedutyoftheusertocheckthattheaccuracyoftheresultsisadequateforher/hispurposes!1.3Incaseofproblems...Acommonsourceofproblemsistheuseofanoldmanualwithanewversionoftheprogram.Whilethismaysometimeswork,itshouldbekeptinmindthatGarfieldchangescontinuously,tryingtoadapttotheneedsofitsusers.Noattemptismadetomaintainbackwardscompatibility.Thebeststrategyistocontactmeifyouplantomakeextensiveuseoftheprogram.Thisallowsmetokeeptrackofthekindofthingtheprogramisusedforandtomaketheprogrambettersuitedforyourapplications.Icanthenalsowarnyouincaseaseriousbugisfound.Pleasetellmeifyouhavesuggestionsforimprovement.Greateffortshavebeenmadetomaketheprogramitselfunderstandablebecausebugsareboundtobepresent.However,evenifyoumanagetocorrectthem,pleasesendamessage.Myelectronicmailaddressesare:VM/CMSatCERN:CERNcentralVax:Conventionalmailcanbesentto:RobVeenhofCERN/PPE-divisionCH-1211Genève23Switzerland/Suissetel:+41227673897Fax:+4122783672RobVeenhof2,RueduReculetF-163StGenis-PouillyFrancetel:+335421784RJD@CERNVMVXCERN::VEENHOFG.A.Erskine,whocontributedessentialroutinesandideas,shouldnotbecalledwhenproblemsoccur.Thepersontocontactincaseofcontrol-CproblemsontheVax,isCarloMekenkamp.Igreatlyappreciatereceivingacopyofanynoteorpublicationforwhichthisprogramhasbeenused.2Garfield,adrift-chambersimulationprogram2.0RunningtheprogramIfyouarenotatCERN,youmayhavetocompileandlinkGarfieldyourselfbeforeyouproceed.InstructionsfordoingsocanbefoundinChapter5.0onpage123.Thischaperassumescompilationhasbeendoneanddescribeshowyoustarttheprogram.Othertopicsdiscussedaredatasetusageanderrormessages.2.1HowtostarttheprogramoneachofthesystemsAtCERN,andsomeothersites,youshouldnothaveanyinitialisationforGarfieldinyourprofile,logincommandprocedureetc.YoumayneedsomeprivateinitialisationforGKS.Thenumericalpartsoftheprogramareidenticalonallmachines;theplottingandI/Opartsaredefinitelynot.Theprogrambehaviourandappearanceoftheoutputcanthereforevarysomewhatbetweenthevarioussystems.Garfieldcanberuninteractivelyandinbatchonmostcomputers.Ifyouruntheprograminteractively,theprogramwillfirstdosomeinitialisationandthenwaitforyoutotypeacommand,executethecommandandwaitforthenext.Tostoptheprogram,youhavetoenterthe&STOPcommand.WhenGarfieldisrunninginbatch,thecommandsaretakenfromaninputfileandtheprogramstopsexecutingwhentheendoftheinputfileisreached.2.1.1RunningonApolloandUnixsystemsTheexecutablefilesforGarfieldarestoredintheusualCERNdirectories,nothingspecialhastobedonethereforetostarttheprogram.GarfieldusesGKSandyoumayneedtoperformGKSinitialisationasdescribedintheCERNcomputergraphicsguides.TheformatoftheGarfieldcommandisasfollows:$garfield[-terminal{typeT|GKS_idGconnection_idC}][-noterminal][-metafile{typeT|GKS_idGoffsetOnameF}][-nometafile][-nodebug|-debug][-noidentification|noidentification][-RNDM_initialisation|-noRNDM_initialisation]Note:alloptionsandvalueshavetobeenteredinthecaseshown.Theymaybeabbreviatedtosomeextent.terminalEitherspecifythetype,whichcanforinstancebeDN300_bw,DN3000_bw,DN3000_colour,DN550_colour,DN660_colourorX_windows_2forGTS-GRALcompilations.OrtheGKS_identifierandtheconnection_identifierbothofwhicharenumeric.Use-noterminalifyouwishtosuppressallgraphicsoutputonthescreen.metafileThekindofmetafileoutputcan,liketheterminaltype,bespecifiedeitherviatypeorviatheGKS_identifier,theoffset,whichisthedifferencebetweenthelogicalunitwhichthemetafileisopenedandtheconnectionidentifier,andthename,thenameofthemetafile.ThemetafileisbydefaultinPostScriptformat,thealternativesareEncapsulatedPostScript,aformatsuitableforinclusioninotherdocuments,andAppendix-Emetafile,aformatthatisconvenientforviewingthepicturesonaterminallateron.Requeststhatdebuggingmodeisinitiallyon,thatis,alsoduringinitialisation.ThisflagcanbeswitchedoffwhentheprogramisreadinginputbymeansoftheOPTIONcommand.Defaultis-nodebug.-debug-identificationRequeststhattracingisonfromthestartofprogramexecutiononwards,alsoduringinitialisation.Defaultis-noidentification.-RNDM_initialisationWhentheprogramstartsexecuting,itcallstheRNDMrandomgeneratoranumberoftimesthatdependsonthetimeoftheday.ThisensuresthatresultsforwhichMonte-Carlotechniquesareused,areproducedwithdifferentrandomnumbersequencesineachrun.Incaseyouwishtododebugging,thismaynotbedesirable;the-noRNDM_initialisationqualifiersuppressestheinitialisation.Runningtheprogram3TherearetwowaysonUnixtomakeGarfieldreadaninputfile:viatheprogram'sown<commandandviatheUnix<onthecommandline.Thereisanimportantdifferencebetweenthetwo:whenyoutype$garfieldMain:<inputallplotswillbedisplayedonthescreenand,unlesstheinputfileendsona&STOP,furtherinputcanbeenteredmanually.Ifontheotherhandyoutype$garfield<inputGarfieldbehavesasifrunninginbatch,andametafilewillbeproducedratherthanpicturesonthescreen.SurfaceplotsandsomecontourplotscannotbemadeonmostUnixmachines.2.1.2RunningontheCrayEitherlogontotheCrayandstarttheprogramthere:/cern/pro/exe/garfieldandsimilarlyfortheOLDandNEWversions,orsubmitaninputfilefromVM/CMStotheCray.Thelatteristhemoreconvenientmethod,seeSection2.1.3fordetails.KeepinmindthattheNAGgraphicslibraryhasnotbeencompiledonthismachineandthatsurfaceplotscanthereforenotbemade.2.1.3RunningunderVM/CMSandCrayjobsubmissionTypethefollowingtostartGarfieldinteractively:(loginsequence)GARFIELDThenewswillappearafterafewseconds.Youmayhavetoswitchtheterminalbacktoαmodeinordertoseeit.OnFalcoterminals,youhavetohitthereturnkey,oncetheterminalisswitchedtographicsmode.SubmittingajobtotheCrayisalmostassimple;giventheveryfastresponseoftheCERNCrayanditsexcellentnumericquality,runningontheCrayshouldbeaveryinterestingoption.FirstprepareaninputfilewithGarfieldcommands.NextcheckyourCrayuseridentifierbytyping:DEFAULTSSETGARFIELDCRAYHitreturnwhenyouareready.RunningontheCrayisdefaultfromnowon.TheoptionCRAYonthecommandlineisthereforenotrequired:GARFIELDyour_input_file(CRAY(waitfortheprompt)passcodeAfterawhile,theoutputandmetafilewillbereturnedtoyou.YoumayneedadditionalfilesfromVM,suchascelldescriptions,andyoumayalsowishtosenddatasetswrittenbytheprogrambacktoVM.Thiscanbeachievedbyrunningthefetchanddisposecommandsinaseparateshell(seealsoSection3.12.8onpage76).Intheexamplebelow,acelllibraryisfetchedfromVMandamemberofthefileisread.Next,anoutputfileforthefieldmapisopened,themapiswritten,thefileisclosedandsentbacktoVM.The-dPUoptionisonlyneededifthedatasetwillbereread.Youdon'thavetobotheraboutsendingfilestoVMinprinciplesinceallfilesaredisposedwhenthejobterminates.&CELL$fetchcell.data-t'fn=CELL,ft=LIBRARY'get"cell.data"DC1&FIELD>"field.map"printex,ey,e,v>$disposefield.map-dPU-t'fn=FIELD,ft=MAP'4Garfield,adrift-chambersimulationprogramIfyouwishtorunthesameinputfileinbatchonVM/CMS,type:GARFIELDyour_input_file(VM/CMSThesystemname(CrayorVM/CMS)isbydefaultthesystemforwhichyoulastupdatedthedefaults.TochangethedefaultsystembacktoVM,type:GARFIELD(SETVM/CMSNOPANELThecommandGARFIELDisbyitselfenoughtostarttheprogram.Asthefullcommanddescriptionbelowshows,severaloptionsnotdescribedaboveareatyourdisposal.Oneofthemoreusefulamongstthemisperhapstheterminaltype.Thetwomostcommonlyusedcommandformatsread:GARFIELD[fn[fm[ft]]][(options)]BATCHSUBMIT[(batchoptions)]GARFIELD[fn[fm[ft]]][(options)]options:TERMINAL([TYPEtype][GKS_IDgksid][CONNECTION_IDconid])NOTERMINALMETAFILE([TYPEtype][GKS_IDgksid][OFFSEToffset][NAMEname])NOMETAFILENODEBUG|DEBUGNOIDENTIFICATION|IDENTIFICATIONRNDM_INITIALISATION|NORNDM_INITIALISATIONPFKEYS|NOPFKEYS|USERPFKEYSVM/CMS|CRAYPRO|EXP|NEW|OLDSCALAR|VECTORLIST|SETPANEL|NOPANELTIME_LIMITmin[:sec]CRAAY_CCOUNTcray_useridCRAY_QUEUEcray_queueRECIPIENTrecipientPASSWORDpasswordThefirstformatismeantforinteractiveuseandforbatchjobsthatdonotrequirebatchsubmissionoptions.ThisisalsotheappropriateformatforsubmissiontotheCray.Thesecondformatpermitsyoutospecifybatchoptionsmanuallybutisnotrecommended.terminalTheprogramassumesyouaresittingbehindaPericomMontereyMG600graphicsterminal.Onotherterminals,youshouldspecifyyourterminaltype.ExamplesofrecognisedtypesareMG600,4014andPG7800.SomeoftheterminaltypesGarfieldrecognises,areperhapsnotknownbytheGKSonyoursystem;you'llseeaGKSerror23intheGKSERRORLOGfileifyouspecifyoneofthem.Yoursystemmanagershouldbeabletohelpyou.SeealsothegeneralremarksonterminalsinSection2.2onpage9.IncaseyourterminalisnotknownbyGarfield,youcanspecifytheterminalmodelviatheGKSidenti-fierofthedriver,gksid,andanappropriateconnectionidentifierconid.TheoptionNOTERMINALcanbeusedtosuppressallgraphicsoutputtothescreen.metafileGarfieldwillonmostcomputersbydefaultproduceaPostScriptformattedpicturefile,whenrunninginbatch.YoucanrequestAppendix-Emetafileformat(APPENDIX_E)andencapsulatedPostScriptinstead.ForthePostScriptformats,youhavethechoicebetweenblack&whiteorcolourandbetweenlandscapeandportrait.Themetafiletypecan,liketheterminaltype,alsobespecifiedthroughaGKSidentifier,thedifferencebetweenlogicalunitandconnectionidentifier,offset,andthenameofthepicturefilename.TheoptionNOMETAFILEcanbeusedtodisableproductionofapicturefile.DEBUGRequestsdebuggingoutputfromthestartofprogramexecutiononwards.Whenthisoptionisspecified,allerrormessagesareprintedforunderflow,overflow,dividebyzeroandendofrecord.IDENTIFICATIONRequeststracingoutputfromthestartofprogramexecutiononwards.Thisoptionisrarelyneededbythecasualuser.Runningtheprogram5RNDM_INITIALISATIONWhentheprogramstartsexecuting,itcallstheRNDMrandomgeneratoranumberoftimesthatdependsonthetimeoftheday.ThisensuresrunsusingMonte-Carlotechniques(mainlyinthesignalsection)usedifferentsequencesofrandomnumbers.Incaseyouwishtododebugging,thismaynotbedesirable;theNORNDM_INITIALISATIONoptionsuppressestheinitialisation.PFKEYSSetsthePFkeysasshownbelow;iftheprogramcompletesexecutionwithoutbeinginterrupted,theoriginalPFkeysarerestored.IfthisoptionisspecifiedinconjunctionwiththeSEToption,afurtherpanelwillbeshowninwhichthePFkeydefinitionscanbeedited.ThisoptionisignoredforrunninginVM/CMSbatchandontheCray.USERPFKEYSCallstheUSERPFEXECtosetPFkeydefinitions.TheEXECusuallyresidesontheuserdiskandcanfreelybecustomised.OneoftheadvantagesofUSERPFoverPFKEYSisthatappropriatekeysdefinitionsaresetwhenenteringSUBSETmode.TheoptionsUSERPFandPFKEYSaremutu-allyexclusive.VM/CMSRequestsGarfieldisrunonVM/CMS,eitherinbatchorinteractivelydependingonthecommandformat.CRAYSubmitsajobreadingtheinputfiletotheCray.Youwillbepromptedforyour'Passcode',thisisyour4digitidentificationcodefollowedbythe6digitcodecurrentlyshownonyourSecurIDcard.Addi-tionalinputfilesfromVMshouldbefetchedfromwithinthejob.Theoutput,themetafileandanyfileyoucreateinthejobarereturnedtoyourreaderwhenthejobfinishes.Impliesthecurrentmoduleisloaded.Thisistherecommendedfiletouse;PROisdefault.Takestheversiononthediskoftheauthor.Keepinmindthatthisfileisusedfordebuggingandsometimescontainsdeliberateerrors.Thediskthatcontainsthemoduleispasswordprotected,thepasswordbeingGarfield'sfavouritefood.ThisversionisnormallynotavailableoutsideCERN.WillreplacethepresentPROversionatthenextupdatecycle.Thisfilecanbereplacedbyanewercopyatanytimebutitshouldbereasonablybugfree.Loadsthemodulethatwastakenoutofuseatthelastprogramlibraryupdatecycle.It'sthereonlyforbackwardcompatibilitypurposes-notoneofthestrongpointsofGarfield!PROEXPNEWOLDSCALARSelectsamodulethatdoesnotaccessthevectorunits.Thismoduleisadequateformostpurposes.VECTORIncaseyourchamberhasalargenumberofwires(over1000),GarfieldconsumesprohibitiveamountsofCPUtimeifruninscalarmode.TheVECTORoptionselectsamodulecompiledandloadedforuse(only)underVM/XAusingtheIBM3090VFvectorunit