eu.slipo.athenarc.triplegeo.extra

Class SyntheticDataGenerator

java.lang.Object

eu.slipo.athenarc.triplegeo.extra.SyntheticDataGenerator

public class SyntheticDataGenerator
extends java.lang.Object

Auxiliary utility that creates a synthetic dataset based on a given CSV dataset by translating geometries, modifying names, and randomly erasing attribute values. It can be used to create synthetic spatial data, by inflating and modifying a input dataset given as seed. IMPORTANT! This utility does NOT apply over RDF data; it handles CSV files only that may be accepted by TripleGeo for transformation to RDF. LIMITATION: Most parameters for the synthetic data generation are hard-coded (referring to OSM-based input data). Please modify and recompile, if necessary. USAGE: Execution command over JVM: java -cp target/triplegeo-2.0-SNAPSHOT.jar eu.slipo.athenarc.triplegeo.extra.SyntheticDataGenerator ARGUMENTS: (1) Path to input CSV file containing the spatial entities and their thematic attribute values. (2) is the max displacement on the x-axis (longitude) to be applied on each geometry. (3) is the max displacement on the y-axis (latitude) to be applied on each geometry. (4) User-defined string that will suffix each generated identifier.

Version:

2.0

Author:

Kostas Patroumpas

Field Summary

Fields

Modifier and Type	Field and Description
private static java.lang.String	colGeom
private static java.lang.String	colID
private static java.lang.String[]	colKeep
private static java.lang.String	colLat
private static java.lang.String	colLon
private static java.lang.String	colName
private static java.lang.String	colTranslit
private static org.apache.commons.csv.CSVFormat	csvFormat
private static java.lang.String[]	csvHeader
private static char	DELIMITER
private static double	dx
private static double	dy
private static java.lang.String	encoding
(package private) static Assistant	myAssistant
private static java.lang.String	part
private static char	QUOTE
private static int	srid

Constructor Summary

Constructors

Constructor and Description
SyntheticDataGenerator()

Method Summary

Modifier and Type	Method and Description
private static java.util.Iterator<org.apache.commons.csv.CSVRecord>	collectData(java.lang.String filePath) Loads the CSV file from the configuration path and returns an iterable feature collection.
static java.lang.String[]	CSV2Array(org.apache.commons.csv.CSVRecord rec) Convert a CSV record as array for manipulating its constituent values.
static void	main(java.lang.String[] args)
static void	modifyCSVFile(java.lang.String inFile, java.lang.String outFile) Creates a synthetic dataset from an input CSV file containing spatial entities and their thematic attributes.
static int	pickRandomInt(java.lang.Integer[] objects) Pick a random value from an array of integers.
private static int	pickRandomPos(int min, int max) Pick a random position within a range [min..max]
static void	print(org.apache.commons.csv.CSVPrinter printer, java.lang.String[] s) Print array of values as a record to output CSV file.
private static boolean	tossCoin() Flip a coin and determine a boolean value.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DELIMITER

private static char DELIMITER

QUOTE

private static char QUOTE

srid

private static int srid

colID

private static java.lang.String colID

colGeom

private static java.lang.String colGeom

colLon

private static java.lang.String colLon

colLat

private static java.lang.String colLat

colName

private static java.lang.String colName

colTranslit

private static java.lang.String colTranslit

colKeep

private static java.lang.String[] colKeep

encoding

private static java.lang.String encoding

csvHeader

private static java.lang.String[] csvHeader

csvFormat

private static org.apache.commons.csv.CSVFormat csvFormat

dx

private static double dx

dy

private static double dy

part

private static java.lang.String part

myAssistant

static Assistant myAssistant

Constructor Detail

SyntheticDataGenerator

public SyntheticDataGenerator()

Method Detail

collectData

private static java.util.Iterator<org.apache.commons.csv.CSVRecord> collectData(java.lang.String filePath)

Loads the CSV file from the configuration path and returns an iterable feature collection.

Parameters:

filePath - The path to the CSV file containing data features.

Returns:

Iterator over the collection of CSV records that can be streamed into the transformation process.

pickRandomPos

private static int pickRandomPos(int min,
                                 int max)

Pick a random position within a range [min..max]

Parameters:

min - The lower bound of the range.

max - The upper bound of the range.

Returns:

The randomly chosen position in the range.

pickRandomInt

public static int pickRandomInt(java.lang.Integer[] objects)

Pick a random value from an array of integers.

Parameters:

objects - An array of integer values.

Returns:

The randomly chosen integer from the array.

tossCoin

private static boolean tossCoin()

Flip a coin and determine a boolean value.

Returns:

The boolean value.

modifyCSVFile

public static void modifyCSVFile(java.lang.String inFile,
                                 java.lang.String outFile)
                          throws java.lang.Exception

Creates a synthetic dataset from an input CSV file containing spatial entities and their thematic attributes.

Parameters:

inFile - The input CSV file with the spatial entities.

outFile - The output CSV file with the spatial entities having their attributes (spatial and thematic) modified in a random fashion.

Throws:

java.lang.Exception

CSV2Array

public static java.lang.String[] CSV2Array(org.apache.commons.csv.CSVRecord rec)

Convert a CSV record as array for manipulating its constituent values.

Parameters:

rec - A CSV record with attribute values

Returns:

The array of same values.

print

public static void print(org.apache.commons.csv.CSVPrinter printer,
                         java.lang.String[] s)
                  throws java.lang.Exception

Print array of values as a record to output CSV file.

Parameters:

printer - The CSV printer to be used for issuing results to the output file.

s - An array of attribute values to write as a new record in the file.

Throws:

java.lang.Exception

main

public static void main(java.lang.String[] args)