The File menu provides commands for creating new files, opening existing files, saving files, printing files, export to and import from other platforms, and exiting the application. It also allows recalling one of four recently used files.
The File|New command creates the main, untitled window, makes it the active window, and inserts a simple template to begin a new lattice. The application prompts you to name untitled documents when they are closed. Only one main window can be open in the program. Therefore File|New and File|Open menus are grayed if the main window is already opened.
The File|Open command displays the Open a File dialog box so you can select a file to load into a new document window. Only one main window can be open in the program. Therefore File|New and File|Open menus are grayed if the main window is already opened.
The File|New Text command creates empty text window. Arbitrary number of text windows can be created.
Opens a text file and puts its contents into a text window. This window cannot be the main window. This command should be used to open any text file for reference or editing. Arbitrary number of text windows can be created.
To perform conversion from DIMAD file the program uses DIMAD output file to simplify parsing of the lattice. The program asks a name of the DIMAD output file (by default the file extension is .out but other extensions can be used as well) and writes a converted structure into a file with the same name and extension .opt. The program informs user about conversion results. To create a DIMAD output file which can be read by the program the following DIMAD commands should be used in the same sequence:
use,machine dimat machine 1 2 1 0 1 1 1 BetaXin AlfaXin DispXin DispPrimeXin BetaYin AlfaYin DispYin DispPrimeYin 0, layout s x y z tetaX tetaY 1 0, hardware Energy s x y z tetaX tetaY 1 0; stop
Here BetaXin, AlfaXin, DispXin, DispPrimeXin, BetaYin, AlfaYin, DispYin and DispPrimeYin are beta-functions, dispersions and their derivatives at the beginning of lattice, Energy is the beam initial energy; s, x, y and z are the initial path length and the initial coordinates of the local coordinate frame in the global coordinate frame, tetaX and tetaY are the initial angles of the local coordinate frame relative to the global coordinate frame. Distances are measured in meters, and energy is measured in GeV (note that DIMAD uses the total energy of the particle, gmc**2 while OptiM uses the kinetic energy). Definitions of RF cavities in OptiM and DIMAD are different. There is no simple transformation from one kind of cavities to another and therefore OptiM does not convert DIMAD cavity to OptiM cavity. Accelerating cavities are substituted by drifts, and, consequently, the field values of all magnets located downstream of the first cavity will be calculated incorrectly and must be substituted manually together with cavity parameters. Search|Replace1MUS7LF menu is useful instrument for performing such edition.
Converts a RESOLVE type file into OptiM format. The program asks name of the RESOLVE type file (by default the file extension is .res but other extensions can be used too) and writes a converted structure into a file with the same name and extension .opt. The program informs user about conversion results in a new opened text window.
Compresses the lattice description from a source OptiM file to a destination OptiM file. The output file will have the same name as the input file name but with extension .opc. If a file with such a name does already exist the dialog box for determining a file name is popped-up. The program looks through the source OptiM file and rewrites it to the destination file so that all adjusting drifts will be combined in one longer drift. A higher degree of compression can be achieved if other non-focusing elements are requested to be removed. Corresponding dialog window appears after the file dialog window and allows one to choose instrumentation, correctors and a few other elements to be removed if necessary. Chosen types of elements will be considered as drifts and, consequently, will be eliminated. This dialog window sets also the offset which is used for naming of new drifts. The names of drifts will start from letters "oD" and then number of the drift will follow. Enumeration of the drifts starts from the offset. Drifts of the same length will have the same name so that the name of the first encountered drift of given length is used. Note that all text variables used to describe the element sequence will be explicitly replaced by corresponding sequence of element names. One can also choose to remove all variables from definition of elements. While math header still will be present in the file it will not have any connection to the rest of the file and can be safely removed if required. This option also copies all information from #include files into the main file and, consequently, removes all #include statements. Often such a procedure allows one to compress the source file significantly which, consequently, accelerates computations. If necessary the integral strengths of elements can be also updated in the source file using Read Field Integral command.
Convert an OptiM file located in the main window into a MAD input file. Taking into account that MAD and DIMAD use very similar languages this command can be used to generate a DIMAD file.
Convert an OptiM file located in the main window into a DIMAD input file with name conversions necessary to support the CEBAF Model Server. The following element renaming takes place:
oM... removed magnet converted into drift M
oI... removed instrumentation converted into drift I
kM... corrector with BdL converted into corrector M
KM... corrector disconnected from power
supply converted into drift M
kaM... special corrector
(no BdL like: 30 Hz, fast, feedback system, Hall A parity experiment)
converted into monitor M
kyM... auxiliary corrector
(no BdL like: 30 Hz, fast, feedback system, Hall A parity experiment)
converted into monitor M
krR... RF separator, raster converted into sbend R
iI... instrumentation (must have zero length)
converted into monitor I
II... currently disconnected instrumentation
converted into drift I
qMQ... quad converted into quad MQ
QMQ... disconnected from power supply quad
converted into drift MQ..
bM... dipole converted into dipole M
beMQ... extraction line quad (listed as dipole)
converted into quad MQ
For other elements the first letter of name is cut and element type is assigned in accordance with the first letter. Elements which name starts from a capital letter will be converted into drifts. Note that elements which are converted to MONITORs (kaM, kyM and iI) have to have zero or sufficiently small length because element MONITOR has zero length in DIMAD.
Convert an OptiM file located in the main window into RESOLVE input file
The File|Save command saves the document in the active window to disk. If the document is unnamed, the Save File As dialog box is displayed so you can name the file, and choose where it is to be saved.
The File|Save As command allows you to save a document under a new name, or in a new location. The command displays the Save File As dialog box. You can enter the new file name, including the drive and directory. If you choose an existing file name, you are asked if you want to overwrite the existing file.
The File|Execute command executes a list of commands located in the current (chosen) text window. Commands must be in a form of simple *.bat file. Each parameter in the line can be put in quotation marks like an example in the following line starting MSWord with file Text.doc, C:\Program files\MSOffice\Winword\Winword.Exe E:\documents\Text.doc Such format allows one to use spaces in file names.
The File|Get File Name command inserts a file name into the current text window at cursor position. To get a file name the standard windows open file dialog box is used. This command is designed to obtain references to external files (see Input language description) and making command files (see Execute).
Shows a print preview of selected window. It works for both text and graphical windows. To close File Preview, click the left mouse button at the close window button (a cross at the top left corner of the window).
The standard Windows dialog to choose a setup of printing, the paper orientation and the printer.
The File|Exit command exits OptiM. If you have modified documents without saving, you'll be prompted to save before exiting.