GRAAL(1)

NAME
graal - symbolic layout editor

SYNOPSIS
graal [-l file_name] [-scale n] [-debug] [-xor] [-install]
      [-force]

DESCRIPTION
Graal is a hierarchical symbolic layout editor. All functionnalities can be accessed through different menus. Among them exists a design rule checker performing verifications inside a user defined window. Graal works under Motif and X11r6. When entering Graal, the main window appears and shows 7 different menus on the top bar.These menus can be entered by simply clicking on the mouse left button. The main window is sensitive to the mouse, and the mouse wheel can be used for scrolling up and down, left and right when <Shift> is pressed during wheel movement, and zooming in and out, when <Ctrl> is pressed while turning the wheel. Below is given the description of graal's menus.

File
    New : clean the entire window and save the current cell.
    Open : load an already existing cell.
    Save : save the current cell.
    Save as : rename and save the current cell.
    Quit : quit graal.

Edit
    Undo : undo the previous action.
    Copy : copy a selected object.
    Move : move a selected object.
    Delete : delete a selected object.
    Stretch : strech a selected object (transistor or segment length).
    Modify : modify the caracteristics of an object (name, width, etc...).
    Identify : identify a selected object.
    Search : search an object according to its type.

Window
    This menu allows user to perform the same actions than the previous menu Edit, not on an object but on a group of objects belonging to a defined window.The two opposite corner of the window are set by clicking on the mouse left button.

Create
    Instance : add a new instance in the current cell.
    Abutmentbox : define the abutment box of the current cell.
    Segment : add segments.
    Via : add vias or contacts.
    Connector : add connectors.
    Transistor : add transistors.
    Reference : add references.

View
    Zoom : perform zoom in, zoom out, center, fit, refresh on figure.
    Layer : select types of layers displayed.
    Map : show cursor position in the entire figure.
    Arrows : show arrows for moving at the grid step.
    Grid : Set the X,Y step of the grid if displayed.

Tools
    Equi : highlight all objects electrically connected to a given object.
    Flat : virtual hierarchy flattening of an instance (display all visible objects inside a given instance).
    UnFlat : undo the virtual flattening of an instance (done before with the Flat command)
    Peek : virtual hierarchy flattening (display all visible objects inside a given window).
    UnPeek : undo the virtual flattening of a window (done before with the Peek command)
    Druc : call the design rule checker in a given window.
    RealFlat : real hierarchy flattening of instances included in a window (this command can not be undone, and should be used very carefully)
    Hierarchy : navigate into the current figure hierarchy
    Load Error : load a real layout file and superpose it to the current figure.
    Message : display the last error messages

Setup
    Save or load a user defined configuration of default displayed menus.

ENVIRONMENT VARIABLES

MBK_CATA_LIB
    indicates the path to the read only libraries to be used.

MBK_WORK_LIB
    indicates the path to the read/write directory for the session.

MBK_IN_PH
    indicates the file format to be used for the leaf cells.

MBK_OUT_PH
    indicates the file format to be used for the generated figures.

GRAAL_TECHNO_NAME (optionnal)
    indicates the path to the techno name file used by Graal.

RDS_TECHNO_NAME (optionnal)
    indicates the path to the RDS configuration file used by Graal.

SEE ALSO
mbk(1), MBK_CATA_LIB(1), MBK_IN_PH(1), MBK_OUT_PH(1), RDS_TECHNO_NAME(1)