NaoGICO and NaoGICOBACK

NAOGICO

1.History
GICO is a code calculating the transport of ion through ion-optics system. It was developed by the group of Prof. Wollnik in the University of Giessen. [user manual for GICO by H.Wollnik (1990). ] I think it is a best ion-optical calculation program, because it takes into account third-order abbrations, gives good graphical outputs, and easily provides a set of matrices for MOCADI, and so on. However its man-machine interface is inconvenient. GICO needs three terminal windows for editing and ion-optical calculating applications, for controlling plotting-applications, and for sending DCL command for printing its graphical output.

Nao made a command procedure (called as NaoGICO) for improving its man-machine interface without any change on GICO. The NaoGICO command procedure produces a subprocess for plotting graphics (GIPLOT). The subprocess was controlled by a mailbox (as same as pipe in UNIX). NaoGICO needs only one terminal window. In addition, any DCL command can be used from the NaoGICO prompt. Sometimes, it is helpful for finding, copying, deleting files and so on.

I would like to thank K. Itahashi for his improvement on the error handling routines of NaoGICO. I thank S. Shimoura for his suggestion on handling the mailbox.

NaoGICO is completely free (GICO is not free. Ask Achim Magel.) Please let me know if you have problems, questions and suggestions.

2.How to start NaoGICO
In this section, I wrote how to use NaoGICO in the alpha cluster at GSI. First, you should get the permission on executing GICO. Please ask Achim Magel to give you the permission.

You should once execute the setup command-procedure ``@kp2$root:[iwasa.gico]setup'' on a terminal window for building environment of NaoGICO. (I propose to write the command in your login.com file. Then you don' take care of the setup procedure.)
GICO needs two file, GIOSFF.DAT and GICOFF.DAT, on the current directory. Please copy the files from the KP2$ROOT:[IWASA.GICO.FRS] directory.
Type ``NaoGICO'' in the DCL prompt. When you don't define display, NaoGICO ask the name of your display. (If you type wrong name, define the display, modify it by using the DCL command ``set display /cre/node=....[/trans=tcpip]'' again.)

---------------------------------------------------------------------------
X605:IWASA_FTA1910$ NAOGICO

RGT started GICO Test version
GIPLOT zeigt GICO-Plots auf Workstation mit GKS

DISPLAY ? : XWTEU

Lock file is checked.

GICO %
---------------------------------------------------------------------------

3. Commands of NaoGICO
type ``?'' in the NaoGICO prompt, then you will see a following command list.

************** GICO ****************
Edit : edit gico input file
Run : calculate optics
File : change input file
STAtus : Show current status
Quit : exit
EXit : exit
ENd : exit
HElp : help
H : hardcopy(Postscript)
L : hardcopy(LN3)
1-10 : plot graphic
\command : dcl command
Most of usual DCL commands are available without preceding

An basic routine is continuously for editing input file and executing ion optics as follows

  1. Type ``Edit filename'', then the LSE editor will be started. Don't mind if you forget filename, then NaoGICO take the latest edited or executed input filename. If there are no latest filename, NaoGICO ask you which file do you want to edit. If you prefer another editor, you denote it in the sys$login:naogicoinit.com file as

    $ gicoeditor == "edit"

    where edit is command to execute the editor program.

  2. Type ``Run'', then calculate ion optics by using the latest edited input file. After the calculation, a graphical window with GKS is opened and NaoGICO plots a graphical output of the present calculation. If you wan to see another output, type '2', '3', and so on, then you will see 2nd, 3rd,... graphical output.

    When you want to print graphical output in a postscript printer, type ``H'' and specify printer name.
    ---------------------------------------------------------------------------
    GICO % H
    PostScript printer : p13
    Job GIPLOT (queue P13, entry 539) started on P13
    ---------------------------------------------------------------------------
    When you want to print graphical output in a LN3 printer, type ``L'' and specify printer name.
    ---------------------------------------------------------------------------
    GICO % L
    LN3 printer : p13
    Job GIPLOT (queue P13, entry 540) started on P13
    ---------------------------------------------------------------------------
    Sometimes following warning messages are seen, but forget it, please. ---------------------------------------------------------------------------
    %SYSTEM-W-ACCONFLICT, file access conflict
    \giplot.temp2\
    %DCL-I-SUPERSEDE, previous value of SYS$ERROR has been superseded
    ---------------------------------------------------------------------------

  3. goto 1

Status of NaoGICO is plotted as follows.
If you have problem, check status of NaoGICO first. The status information and file GIPLOT.ERR (log of giplot process) may be good tools to know the status.

GICO % sta
Child process :MAILBOX_1 running MAILBOX_* should be exist
Child process :GIPLOT_1 running GIPLOT_* should be exist if META.DAT file exists
Mailbox is active it should be appeared
There is no current input file
Current directory is: [IWASA.GICO.FRS]
Current lockfile is: sys$login:gico_LOCKF.tmpiwasa containing
AXP605::30402BCE

NaoGICOBACK

1.History
To Confirm correctly ion-optical setting loaded is one of the most important jobs on experiments with fragment separators. An application program to calculate ion-optics from estimated magnetic fields of dipole-, quadrupole-, and sextapole- magnets is useful for confirming ion-optical system. GICOback was developed for this aim on beamlines at GSI by H. Irnich and K. H. Behr. In GSI, magnetic fields are controlled by the ALICE VAX/VMS cluster. Several sets of magnets are grouped by beam lines. Groups are called by virtual accelerator number. GICOBACK works on AXP alpha-VAX/VMS cluster. Therefore GICOBACK sends ALICE workstation a command to make a file where a set of magnetic fields for a selected beamline is written. Then GICOBACK calculates present ion-optics by using the files. Because of its complex system, GICOBACK can be execute only on Behr's account in the AXP cluster. Sometimes problems on network connection happens. We must solve the problems case-by-case.

NaoGICOBACK was developed by corpolating GICOBACK and NaoGICO. We made input files for checking ion-optics for the fragment separator (FRS: TA-S4), FRS-Cave B, and FRS-Cave C beam lines. In NaoGICO, the network problems are not solved. Please check gico-output files sometimes and take care of correct calculation.

2.How to use GICOBACK (note that output is written in German)
1) open two terminal window in your X-terminal.
2) change directory to US1$ROOT:[Behr.GICO.GICOBACK] for the both window
3) execute the ``defgicotest'' command in the both windows
4) execute the ``@CHECK_OPTICS_1'' command in a window
5) select a beam line and a virtual accelerator number in the window
6) execute the ``giplot'' command in the other window
7) select the ``Decwindow''.
8) wait calculation in the gicoback window is finished, then type ``N'' and ``1'' in the giplot window.
9) goto 8

AXP605::Behr% @check_optics_1

Beamline selection
-------------------
1 - SISTSHFS (7.5 DEGREE WEDGE)
2 - SISTSHFS (9.1 DEGREE WEDGE)
3 - SISTSHTC (7.5 DEGREE WEDGE)
4 - SISTSHTC (9.1 DEGREE WEDGE)
5 - SISTSESR
6 - SISTSHTB

BEAMLINE_SELECT: 1
Auswahl des virtuellen Beschleunigers
Angabe von 1-16
VIRT_ACC: 8

3. How to use NAOGICOBACK
1) open a terminal window in your X-terminal
2) change directory to US1$ROOT:[Behr.GICO.FRS.CAVC.PROG]
3) execute the ``@GICOBACK'' command
4) select a beam line and a virtual accelerator number in the window
5) wait a moment! When finish the GICO calculation, graphical output is automatically replaced.

AXP604::Behr% @gicoback

RGT started GICO Test version
GIPLOT zeigt GICO-Plots auf Workstation mit GKS

Beam-line selection
-------------------
1 - FRS
2 - FRS to ESR
3 - FRS to CAVE B
4 - FRS to CAVE C

Beamline ? : 1
virtual accelerator number(0-16) ? : 8
gicoback % :

4. Commands of NAOGICOBACK
type ``?'' in the NaoGICOBACK prompt, then you will see a following command list.

********* GICO BACK ***********
B : change beamline
H : hardcopy(Postscript)
L : hardcopy(LN3)
1-10 : plot graphic
sta : show status
C : show logfile of GICOBACK
E : exit
Q : quit

By using the ``B'' command, beam line can be selected again.
By using the ``C'' command, status of recent GICO calculation can be read.

If NaoGICOBACK does not work properly, check status of NaoGICO.

gicoback % : sta
Child process :MAILBOX_1 running should be exist
Child process :GIPLOT_1 running should be exist: plot subprocess
Child process :OPTICS_1 running should be exist: calculion subprocess
Mailbox is active
There is no current input file
Current directory is: [BEHR.GICO.FRS.CAVC.PROG]

The plot-process log-file, [.plot]giplot.err, and the calculation-process log-file, GICOBACK.LOG, may be helpful to solve the problem

If you want to change GICO input files (by changing drift length etc.) Please edit following files.
1 FRS FRS_BACK.DAT
2 FRS to ESR ESR_BACK.DAT
3 FRS to CAVE B CAVE_B_BACK.DAT
4 FRS to CAVE C CAVE_C_BACK.DAT