Diplomarbeit_Paul_Werner: /u/ia02/s51068/local/projects/release/programme/util.h-Dateireferenz

int compareStringList	(	char **	list1,
		int	list1Count,
		char **	list2,
		int	list2Count
	)

Vergleich zwei Listen aus Strings. Wenn alle Strings aus list1 in list2 vorkommen und alle Strings aus list2 in list1 vorkommen, dann liefert die Funktion 1, ansonsten 0.

Parameter:

	list1	erste Stringliste
	list1Count	Groesse der ersten Stringliste
	list2	zweite Stringliste
	list2Count	Groesse der zweiten Stringliste

float* concatFloatVectors	(	float *	vec1,
		int	size1,
		float *	vec2,
		int	size2
	)

Verbindet zwei Flieskomma-Vektoren miteinander. Die Dimension (Groesse) des resultierenden Vektors ist die Dimension (Groesse) des ersten Vektors + Dimension (Groesse) des zweiten Vektors. Der Rueckgabewert ist ein Zeiger auf den resultierenden Vektor.

Parameter:

	vec1	erster Vektor
	size1	Groesse des ersten Vektors
	vec2	zweiter Vektor
	size2	Groesse des zweiten Vektors

int* concatIntVectors	(	int *	vec1,
		int	size1,
		int *	vec2,
		int	size2
	)

Verbindet zwei Ganzzahl-Vektoren miteinander. Die Dimension (Groesse) des resultierenden Vektors ist die Dimension (Groesse) des ersten Vektors + Dimension (Groesse) des zweiten Vektors. Der Rueckgabewert ist ein Zeiger auf den resultierenden Vektor.

Parameter:

	vec1	erster Vektor
	size1	Groesse des ersten Vektors
	vec2	zweiter Vektor
	size2	Groesse des zweiten Vektors

char** copyStringList	(	char **	list,
		int	size
	)

Kopiert eine String-Liste (Vektor aus Strings). Es wird der Zeiger auf den neuen Vektor aus Strings zurueckgegeben.

Parameter:

	list	der zu kopierende Vektor aus Strings.
	size	die Groesse des zu kopierenden Vektors.

float cosDirection	(	int *	vec1,
		float *	vec2,
		int	size
	)

Berechnet den Richtungskosinus aus einem Fliesskomma-Vektor und einem ganzahligen Vektor.

Parameter:

	vec1	erster Vektor (int)
	vec2	zweiter Vektor (float)
	size	Groesse des ersten und zweiten Vektors

int countLines ( char * filename )

Zaehlt die Anzahl der Zeilen einer Datei

Parameter:

filename

Pfad zur Datei, dessen Zeilen gezaehlt werden sollen.

void emptyStringAtListPos	(	char **	list,
		int	size,
		int	pos
	)

void extractData	(	char *	line,
		float **	data,
		int *	vecSize,
		char **	name,
		char	del
	)

Diese Funktion extrahiert aus einer Zeile aus dem Wort- oder Rollenbuch, die numerischen kodierten Features in Form eines Vektors und der dazu passende Name des Features.

Parameter:

	line	Ist eine Zeile aus dem Woerter- oder Rollenbuch. Zum Beispiel 00000010000:max
	data	Rueckgabewert. Der Vektor aus den kodierten Zahlenwerten.
	vecSize	Rueckgabewert. Die Groesse des Vektors der Zahlenwerte
	name	Rueckgabewert. Der Name des Features.
	del	Das Trennzeichen zwischen kodierten Werten und Feature-Name

int extractTokens	(	char *	source,
		char	del,
		char ***	retval
	)

Zerteilt einen String in mehrere Teilzeichenketten an einem Trennzeichen.

Parameter:

	source	String der zerteilt werden soll.
	del	Trennzeichen, an dem der String geteilt werden soll.
	retval	Rueckgabewert. Der Vektor aus den Teilzeichenketten.

int findIntInList	(	int *	list,
		int	size,
		int	integer
	)

Ermittelt die Position eines ganzzahligen Wertes innerhalb eines ganzzahligen Vektors. Der Rueckgabewert ist der Index des Wertes oder -1, wenn der Wert nicht gefunden wurde.

Parameter:

	list	Vektor aus ganzzahligen Werten, welcher durchsucht werden soll.
	size	Groesse des Vektors
	integer	Wert, nachdem im Vektor gesucht werden soll.

int findStringInList	(	char **	list,
		int	size,
		char *	string,
		int *	relativePos
	)

Liefert die relative Position einer Zeichenkette innerhalb eines Vektors (dabei werden mit NULL belegte Elemente nicht beachtet) und die absolute Position der Zeichenkette (dabei werden NULL-Elemente beachtet und mitgezÃ¤hlt). Der unmittelbare Rueckgabewert ist die absolute Position.

Parameter:

	list	Vektor aus Zeichenketten
	size	Groesse des Vektors aus Zeichenketten
	string	Zeichenkette, dessen Position zurueckgegeben werden soll.
	relativePos	zweiter Rueckgabewert. Die relative Position der Zeichenkette

int getFeatureNameByVector	(	keyword *	cb,
		int	cbSize,
		int *	vector,
		int	vectorSize,
		char ***	names
	)

Ermittelt die Namen von Features anhand ihres kodierten orthonormalen numerischen Vektors (float). Diese Funktion liefert 1, wenn ein oder mehrere Namen gefunden wurden, ansonsten 0.

Parameter:

	cb	Das Woerter- oder Rollenbuch, welches uebergeben wird.
	cbSize	Die Groesse des Woerter- oder Rollenbuches
	vector	Der numerische Vektor, fuer den die Feature-Namen ermittelt werden sollen.
	vectorSize	Die Groesse des numerischen Vektors.
	names	Rueckgabewert. Die Feature-Namen, welche auf den Vektor passen.

int getFirstOutUnitNr ( int unitType )

Ermittelt den Index des ersten Neurons eines bestimmten Typs unitType.

Parameter:

unitType

Legt den Neuron-Typ fest, dessen Index des ersten Neurons zurueckgegeben werden soll.

int getIndexByKey	(	char **	list,
		int	size,
		char *	key
	)

Liefert die Position einer Zeichenkette innerhalb eines Vektors

Parameter:

	list	Vektor aus Zeichenketten
	size	Groesse des Vektors aus Zeichenketten
	key	Zeichenkette, dessen Position zurueckgegeben werden soll.

int getIntVectorByName	(	keyword *	cb,
		int	cbSize,
		char *	name,
		int **	vector
	)

Ermittelt den kodierten orthonormalen numerischen Vektor (int) anhand des Feature-Namens. Diese Funktion liefert 1, wenn ein Vektor gefunden wurde, ansonsten 0.

Parameter:

	cb	Das Woerter- oder Rollenbuch, welches uebergeben wird.
	cbSize	Die Groesse des Woerter- oder Rollenbuches
	name	Der Name, dessen numerischer Vektor zurueckgegeben werden soll.
	vector	Rueckgabewert. Hier wird der numerische Vektor geschrieben.

int getIntVectorByNames	(	keyword *	cb,
		int	cbSize,
		char **	names,
		int	namesCount,
		int **	vector
	)

Ermittelt den kodierten orthonormalen numerischen Vektor (int) anhand mehrerer Feature-Namen. Diese Funktion liefert 1, wenn ein Vektor gefunden wurde, ansonsten 0.

Parameter:

	cb	Das Woerter- oder Rollenbuch, welches uebergeben wird.
	cbSize	Die Groesse des Woerter- oder Rollenbuches
	names	Die Namen, dessen numerischer Vektor zurueckgegeben werden soll.
	namesCount	Die Groesse des Vektors names
	vector	Rueckgabewert. Hier wird der numerische Vektor geschrieben.

int getOutUnitCount ( int unitType )

Ermittelt die Anzahl der Neuronen fuer einen Neuronentyp unitType.

Parameter:

unitType

Legt den Neuronentyp fest, dessen Anzahl der Neuronen ermittelt werden soll.

int getPhraseMatch	(	humanOutput *	human,
		int	humanCount,
		testOutput *	test,
		int	testCount,
		char **	roles,
		int	roleCount,
		int **	retval,
		int **	retvalCounts
	)

int getRealMatch	(	humanOutputList *	outList,
		testContent *	testList,
		int	count,
		char **	roles,
		int	roleCount,
		int **	retval,
		int **	retvalCounts,
		int **	problemIndex
	)

int getVectorByName	(	keyword *	cb,
		int	cbSize,
		char *	name,
		float **	vector
	)

Ermittelt den kodierten orthonormalen numerischen Vektor (float) anhand des Feature-Namens. Diese Funktion liefert 1, wenn ein Vektor gefunden wurde, ansonsten 0.

Parameter:

	cb	Das Woerter- oder Rollenbuch, welches uebergeben wird.
	cbSize	Die Groesse des Woerter- oder Rollenbuches
	name	Der Name, dessen numerischer Vektor zurueckgegeben werden soll.
	vector	Rueckgabewert. Hier wird der numerische Vektor geschrieben.

float innerProduct	(	int *	vec1,
		float *	vec2,
		int	size
	)

Berechnet das Skalarprodukt aus einem Flieskomma-Vektor und einem ganzzahligen Vektor

Parameter:

	vec1	erster Vektor (int)
	vec2	zweiter Vektor (float)
	size	Groesse des ersten und zweiten Vektors.

float meanFromList	(	float *	list,
		int	size,
		int	exclude
	)

Berechnet den Mittelwert aus einer Menge (Vektor) an Fliesskommawerten. Dabei kann ein Element des Vektors bei der Berechnung ausgeschlossen werden.

Parameter:

	list	Der Vektor, dessen Elemente gemittelt werden sollen.
	size	Groesse des Vektors
	exclude	Indes des Vektors, welche Komponente bei der Berechnung des Mittelwertes.

float normFloat	(	float *	vec1,
		int	size
	)

Normiert einen Vektor aus Fliesskommawerten.

Parameter:

	vec1	Der Vektor aus Fliesskommawerten.
	size	Die Groesse des Vektors.

float normInt	(	int *	vec1,
		int	size
	)

Normiert einen Vektor aus ganzzahligen Werden

Parameter:

	vec1	Der Vektor aus ganzzahligen Werden
	size	Die Groesse des Vektors.

void printStringList	(	char **	list,
		int	size
	)

Gibt eine Liste aus Strings auf einer Zeile aus.

Parameter:

	list	Liste aus Strings, die ausgegeben werden sollen.
	size	Groesse der Liste aus Strings.

int readCodebook	(	char *	filename,
		keyword **	keywords
	)

Liest ein Woerter- oder Rollenbuch und fuellt die Datenstruktur keywords mit den Eintraegen.

Parameter:

	filename	der Pfad zum Woerter- oder Rollenbuch.
	keywords	Rueckgabewert. Wird mit den Features befuellt.

int vectorEqual	(	int *	v1,
		float *	v2,
		int	size,
		float	threshold
	)

PrÃ¼ft, ob ein ganzzahliger Vektor Ã¤hnlich zu einem Fliesskomma-Vektor ist. Dabei dÃ¼rfen die Komponenten der Vektoren um einen Bereich threshold abweichen. Wenn alle Komponenten der Vektoren (unter Beachtung des unscharfen Bereiches) gleich sind, dann liefer die Funktion 1, ansonsten 0.

Parameter:

	v1	ein ganzzahliger Vektor
	v2	ein Vektor aus Fliesskommawerten
	size	Die jeweilige Groesse der beiden Vektoren.
	threshold	Der Grenzbereich


Datenstrukturen
struct	keyword
struct	humanOutput
struct	humanOutputList
struct	testOutput
struct	testContent
Funktionen
void	extractData (char line, float data, int vecSize, char **name, char del)
int	readCodebook (char filename, keyword *keywords)
int	countLines (char *filename)
int	extractTokens (char source, char del, char **retval)
int	getRealMatch (humanOutputList outList, testContent testList, int count, char roles, int roleCount, int retval, int retvalCounts, int problemIndex)
int	getPhraseMatch (humanOutput human, int humanCount, testOutput test, int testCount, char roles, int roleCount, int retval, int **retvalCounts)
int	compareStringList (char list1, int list1Count, char list2, int list2Count)
void	printStringList (char **list, int size)
int	getFeatureNameByVector (keyword cb, int cbSize, int vector, int vectorSize, char ***names)
int	getVectorByName (keyword cb, int cbSize, char name, float **vector)
int	getIntVectorByName (keyword cb, int cbSize, char name, int **vector)
int	getIntVectorByNames (keyword cb, int cbSize, char names, int namesCount, int *vector)
int	getFirstOutUnitNr (int unitType)
int	getOutUnitCount (int unitType)
float	normFloat (float *vec1, int size)
float	normInt (int *vec1, int size)
float	innerProduct (int vec1, float vec2, int size)
float	cosDirection (int vec1, float vec2, int size)
float *	concatFloatVectors (float vec1, int size1, float vec2, int size2)
int *	concatIntVectors (int vec1, int size1, int vec2, int size2)
float	meanFromList (float *list, int size, int exclude)
int	vectorEqual (int v1, float v2, int size, float threshold)
int	getIndexByKey (char *list, int size, char key)
int	findStringInList (char *list, int size, char string, int *relativePos)
char **	copyStringList (char **list, int size)
int	findIntInList (int *list, int size, int integer)
void	emptyStringAtListPos (char **list, int size, int pos)

/u/ia02/s51068/local/projects/release/programme/util.h-Dateireferenz

Datenstrukturen

Funktionen

Dokumentation der Funktionen