Topology Editor

News

This program permits you to edit topologies specified in the input file as it is accepted by the program Diana.

You can change and save changings:
the shape (coordinates of vertices and of the middle line points);
the coordinates of the labels;
numbering of lines/vertices;
directions of the lines;
momenta on each line.

In order to automatically start the Topology Editor just after Diana generates topologies, the user must uncomment line SET _TOPOLOGYEDITORNAME = teDiana in files create.folders / create.nofolders contained in Diana's examples.
Here is the screenshot of the main window together with several auxiliary controls.

Brief description

The main window consists of five editors. Each of them can be used to edit certain parameters of the topology.

Shape Editor is used to change the shape, i.e., the coordinates of vertices and lines. Move mouse pointer on one of the hot points (thick points inside the small rectangles) - cursor will be changed. Then press LEFT button and drag the vertex or line. If more then one of the hot points appear are under the cursor, click left button again without moving the mouse. Right click on line marks will call the pull down menu to flip or stight the line.

Note, the Shape Editor shifts labels together with points. The corresponding UNDO operation is available under the Labels Editor.

Labels Editor permits you to set the position for all lines/vertices labels. Move mouse pointer on one of the rectangles - the cursor will be changed. Then press LEFT button and drag the vertex or the line label mark to the new position. If more then one of rectangles are under the cursor, click left button again without moving the mouse. In this Editor you can also change the positions of vertices and lines (thick points inside rectangles) but changing the vertex/line coordinates will NOT lead to changing in the label position as it was in Shape editor. Note, in this case the UNDO operation will be available from the Shape Editor.

Numbers Editor permits you to change the numbering of some lines or vertices. Move mouse pointer on one of the rectangles - the cursor will be changed. Then press LEFT button and drag the vertex/line label mark - pull down menu appears. Select the new number you prefer. If more then one of rectangles are under the cursor, click left button again without moving the mouse. You may also press RIGHT mouse button instead of the left one. In this case the pull down menu appears immediately without dragging.

Note, you cannot change numbering of the external lines and vertices, and internal vertices connected with the external ones.

Directions Editor permits you to change the directions of the internal lines. Move mouse pointer on one of the hot points (arrows in the rectangles) - the cursor will be changed. Then press LEFT button to select the line you need. Change the line direction by clicking RIGHT mouse button while the left button is pressed. If more then one of the hot points are under the cursor, click left button again without moving the mouse.

Note, you cannot change directions of the external lines.

Momenta Editor permits you to edit integration momenta on the lines. Move mouse pointer on one of the hot points (arrows in the rectangles) - the cursor will be changed. Then press LEFT button and drag the line mark - the Momenta Editor Dialog appears. If more then one of the hot points are under the cursor, click left button again without moving the mouse. You may also press RIGHT mouse button instead of the left one. In this case the Momenta Editor Dialog appears immediately without dragging.

To understand how to use the Momenta Editor Dialog you can look at its help.

Use 'WhatIsThis' button (the last toolbox button) to get the help information about various controls. Push it: the cursor will be changed. Then point to the object you are interesting in, and click any mouse button.

Topologies and momenta

Topologies are represented in terms of ordered pairs of numbers like (fromvertex, tovertex):

All external legs have negative numbers. These are supposed to begin with -1. First one attaches all the numbers for the ingoing particles, and then for the outgoing ones. External legs must be connected with vertices of smallest possible identifying number. The number of an internal line corresponds to its position in the chain of pairs and the direction from the first to the second number in the pair:

Knowing thus the topology we can assign momenta. Their distribution according to the figure above, e.g.,is added like
topology A = (-2,2)(-1,1)(5,1)(1,3)(3,4)(4,2)(2,5)(5,6)(3,6)(4,6):
p1,p2,p3,p4,p5,p6,p7,p8;

This fixes directions and values of all momenta on internal lines. External lines must be known from the process definition. By convention the external lines must start with the highest negative number.

coordinates <topologyname>=
   ev x,y,x,y ... :
   evl x,y,x,y .... :
   iv x,y,x,y ... :
   ivl x,y,x,y .... :
   el x,y,x,y ... :
   ell x,y,x,y.... :
   il x,y,x,y ... :
   ill x,y,x,y ....;

• ev - external vertices,
• evl - external vertices labels,
• iv - internal vertices,
• ivl - internal vertices labels,
• el - external lines,
• ell - external lines labels,
• il - internal lines,
• ill - internal lines labels.

Coordinates may be omitted. In this case the Topology Editor will try to distribute coordinates itself. The user can re-set coordinates by clicking the tool button "optimize" ().

Number of external legs can be defined from the topology, while their directions remain to be undefined. To define the direction it is necessary to set the number of outgoing legs. The user can specifies this number by the command line option -out_lines or use the command outlines in the input file.

outlines = 1
topology A =
   (-2,2)(-1,1)(5,1)(1,3)(3,4)(4,2)(2,5)(5,6)(3,6)(4,6):
   p1,p2,p3,p4,p5,p6,p7,p8;
coordinates A =
   ev 332.1,128.5,25.5,128.5:
   evl 337.8,155.3,13.9,115.0:
   iv 69.3,128.5,288.3,128.5,100.0,51.8,256.2,50.4,178.8,238.0,178.8,128.5:
   ivl 79.4,136.7,248.2,127.4,92.1,38.9,254.5,36.8,188.9,264.1,189.5,138.5:
   el 310.2,128.5,47.4,128.5:
   ell 306.6,114.3,47.0,112.5:
   il 113.1,216.1,78.4,84.1,179.3,16.1,278.8,79.7,244.5,216.1,178.8,183.2,139.4,
   90.2,217.5,89.4:
   ill 111.4,214.3,51.9,78.7,171.4,1.3,286.4,76.7,254.6,236.0,196.9,190.8,138.3,
   79.1,194.1,70.3;

screenshot

System rquirements

To use graphics topology editor for Diana you need the X Window System and the Qt GUI Toolkit version 1.x (developed and tested on versions 1.43 and 1.44)

The topology editor is written on C++, so you need some c++ compiler, preferably GNU g++ compiler.

Download

Binary distribution for Linux Intel x86 is available now (statically linked executable ELF files, 1053827 bytes).

c++ sources of the topology editor.