---

gnn_random_order.h File Reference

#include <gsl/gsl_permutation.h>
#include "gnn_dataset.h"
#include "gnn_input.h"

Include dependency graph for gnn_random_order.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	_gnn_random_order
Typedefs
typedef _gnn_random_order	gnn_random_order
	The datatype for a random order sampler.
Functions
gnn_dataset *	gnn_random_order_new (gnn_dataset *data)
	Builds a new random order sampler.
gnn_dataset *	gnn_random_order_from_inputs_new (gnn_input *inputs, gnn_input *outputs, gnn_input *weightsFile)
	Builds a new random sampler from gnn_inputs.
gnn_dataset *	gnn_random_order_from_file_new (const char *inputsFile, const char *outputsFile, const char *weightsFile)
	Builds a new random order sampler from text files.
gnn_dataset *	gnn_random_order_get_dataset (gnn_dataset *set)
	Returns a pointer to the internal gnn_dataset.

---

Function Documentation

gnn_dataset* gnn_random_order_from_file_new (  const char *    inputsFile, const char *    outputsFile, const char *    weightsFile )

This functions creates a new random order sampler from two or three text files containing the patterns. The text files should be ASCII-formatted, and should contain matrices where the number of columns corresponds to the size of the vectors, and the row number to the number of patterns. Obviously, it is illegal to provide matrices of different row sizes. Also, the weights file should have only one column. If the weights file is omitted (i.e. it is a pointer to NULL), the the weights are assumed to be 1. It is basically a shorthand for building the dataset from gnn_input : Reading and handling of sets of vectors. structures which themselves should be built from text files. Parameters: inputs  The name of the file containing the input examples. outputs  The name of the file containing the output examples (targets). weights  The name of the file containing the vector with the weights for each pattern, or NULL if they should all be 1. Returns: Returns a pointer to a new gnn_random_order : A random order sampler. dataset. Definition at line 299 of file gnn_random_order.c.

gnn_dataset* gnn_random_order_from_inputs_new (  gnn_input *    inputs, gnn_input *    outputs, gnn_input *    weights )

This functions creates a new random order sampler from two or three input samplers. The first two correspond to the input pattern and output pattern samplers, wich should contain the same amount of patterns. The third is the pattern weight sampler, which, if given, should also be of the same size. If omitted (that means it is a NULL pointer), then all weights are assumed to be 1. Note: Internally, a gnn_random_order : A random order sampler. sampler created this way contains a gnn_simple_set : A simple implementation of datasets. dataset. Parameters: inputs  The input sampler, a gnn_input : Reading and handling of sets of vectors. object. outputs  The target sampler, a gnn_input : Reading and handling of sets of vectors. object. weights  The weight sampler, a gnn_input : Reading and handling of sets of vectors. object. Returns: Returns a pointer to a new gnn_random_order : A random order sampler. dataset. Definition at line 263 of file gnn_random_order.c.

gnn_dataset* gnn_random_order_get_dataset (  gnn_dataset *    set )

This function returns a pointer to the internal gnn_dataset : Datasets for Training. structure, which is used as source. Parameters: set  A pointer to a gnn_random_order : A random order sampler. dataset. Returns: Returns a pointer to the internal dataset. Definition at line 320 of file gnn_random_order.c.

gnn_dataset* gnn_random_order_new (  gnn_dataset *    data )

This functions creates a new random order sampler from a given dataset. It will create a new random sampling permutation (i.e. it will shuffle) on each call on gnn_dataset_reset, so that a sequential pattern retrieval from pattern will return them in a random order. Parameters: data  The gnn_dataset : Datasets for Training. which should serve as pattern source. Returns: Returns a pointer to a new gnn_random_order : A random order sampler. dataset. Definition at line 184 of file gnn_random_order.c.

---