Overview

This is a couple of scripts to support creation of "synchron-optical nets" in relation with RELATRA Text analysis.

Basics

Relatra is a methode for text analysis and translataion. It is part of the translation triade of Mudersbach and Gerzymisch-Arbogast. (I am very sorry, but I do not know any resources about this translation preocedure on the web.)

Relatra is aimed to the analysis of semantical nets; it consists of two different types of nets:

With linear nets the relations are visualized each by itself; with synchron-optical nets all relations of a text are shown with their relationships among each others.

The tools here support creation of nets; they however cannot support with the more difficult earlier steps of the analysis:

Since the automatic generators here do not always produce a "perfect" output, we can generate .slang output, which can be finetuned with the "netz" configuration of NyktoOp 's graphical editor "nykditor". Alternatively there is a possbility to produce different graphical output formats, which can be fine-tuned with their office programs:

MIF (Framemaker interchange file format)

RTF (MS Word Rich text format)

FIG (xfig file format)

preconv

Read a textfile of a special form and convert it to a .rel file suitable for input to sonetze.

preconv options

none yet :)

preconv input files

The input file consits of different entries line by line;

The entries contain:

Relation nn ... Start a new relation
Ann ... Argument nn maybe followed by its verbose contents
nnA ... (alternative form)
(Ann) ... (alternative form)
(nnA) ... (alternative form)
Rnn ... Relator nn maybe followed by its verbose contents
nnR ... (alternative form)
(Rnn) ... (alternative form)
(nnR) ... (alternative form)
<SVR...>... "Sachverhachsrelator" a special connector between two Relators of one Relation.

Relations break a file into pieces, SVRs break relations into pieces; every piece may have exactly one relator. All arguments inside a piece which are named before the relator are connected to the relator with lines (arrows) pointing to the relator. All arguments named after the relator are connected with the relator by lines (arrows) pointing to the arguments. The lines from relator pointig to arguments are numbered starting with 0. In the graphical output the numbers are replaced by a bundle of thin lines at the middle of the line (arrow).

sonetze

read a ".rel" file and create a ".slang" or ".gfx" file from it

!!!!!!!!!! Look into the samples !!!!!!!!!!!

sonetze options

-maxgap=$PI/10.0 Maximum gap between rphi and aphi before we re-adjust the lower one.
-outmode="slang" output format; currently supported: 'slang' or 'gfx'.
-selection="" list of Relations, which shall be output; All if empty.
-distancefactor=0.9 muliplication factor for circles around distanciated center-arguments.
-interdist=1.0 approximated distance between two elements in one category =switch foreward for aphi and rphi
-reloffset=0.5 svr-connectors are not true centerlines. ...
-svroffset=0.8 ... Instead we move the a little bit aside.
-argcircle=160.0 the sizes for the different ...
-relcircle=80.0 ... circles around the main center-argument. ...
-svrcircle=100.0
-relationgap=0.0 additional gap between two relations

The default values are given as examples here.

sonetze input files

the ".rel" files are text files of a certain format; again they contain different entries one line each:

Relation ... Start a Relation
Around Ann The _previously_ started relation is to be put around Argument nn
Ann ... Argument nn
Rnn ... Relator nn
SVRnn ... "Sachverhaltsrelator" nn
Distant The _previous_ element is to be placed at the outer circle
Position x y phi fact The _previous_ element is to be placed at that position
Gap rphi=nn aphi=nn phi=nn make a gap either at both circles (phi=nn) or at one of the circles (aphi, rphi ...)
Ordering ... Place the named element now (regardless of the usual order inside the file)

Relations break a file into pieces, SVRs break relations into pieces; every piece may have exactly one relator. All arguments inside a piece which are named before the relator are connected to the relator with lines (arrows) pointing to the relator. All arguments named after the relator are connected with the relator by lines (arrows) pointing to the arguments. The lines from relator pointig to arguments are numbered starting with 0. In the graphical output the numbers are replaced by a bundle of thin lines at the middle of the line (arrow).

Synopsis

This is a sample call ... ;))))))))

% perl -w preconv.pl sample0.txt |\

perl -w sonetze.pl -outmode=gfx -interdist=0.2 -distancefactor=0.8 \

-maxgap=0.3 && (\

cd ../perl.dir/gfx2x.dir/ ;\

perl -w front.pl zoom=1.0 target=ps < ../../relatra.dir/out.gfx &&\

gv out.ps )

First prepare a .rel file from a .txt file, then run sonetze.pl to create a .gfx file; after that run the gfx converter and finally display the result in ghostview

Have a look at a sample netz picture .

Installation

Ahem ... these are just a little bunch of scripts; do You really ask me for that?

Ok, here are the details:

It still does not run? Oh no, I give up ...

Download

The recent version of this subproject may be found at my homepage via relatra.tar.gz .

Legal Stuff

For such information please have a look at './Disclaimer.txt'. If there is no such file, decide urself, if U want to think that GPL applies, of download Disclaimer.txt from my Homepage .

Author

Bernd Noll

SnailMail: Zu den Eichen 8; D-56567 Neuwied; Germany.
EMail: mailto:noll@noll.xsilon.de
WWW: http://noll.xsilon.de/

Credits

Thx to

History (of documentation)

For the progams' histories themself better look into the code.

00-10-12 noll - started documentation file.