Home

Welcome to POVwanderings wiki!

Object

Data visualization of books and series with POV (point of view) characters. Characters time lines, trips displayed on maps.

Main script and library are written in python, using matplotlib for displaying figures.

Examples

see an application on "A Song of Ice and Fire" by G.R.R. Martin

Usage

POVwanderings: plots lives, movings and deaths of POV characters.

USAGE:

./POVwanderings.py [options] configuration_file
[Ex: ./POVwandering.py ASongOfIceAndFire.cfg]

OPTIONS

--help or -h
display this doc

--log or -l
redirect stdout to log file (POVwanderings.log)

--mode MODE or -m=MODE
MODE is one of:
all: all modes [default]
chapters: characters VS chapter index
map: character moving along a map

DESCRIPTION OF CONFIGURATION FILE

configuration file is a text file containing section ([section])
followed by option=values. This format is handled by ConfigParser python package

Exemple:

# required section
[General]

# name of the series (required)
series=title_of_the_series


# required section
[volumes]

# list separated by comma (required)
list=title_of_volume_one,title_of_volume_two


# required section
# describe the column-wise text files containing
# the name and the place of each character
# in chronological sorting
# the name of these files will be constructed by
# title_of_volume (from list in volumes section, all blanks removed)
# + extension (from option in volume_file_format section)
# example:
# title_of_volume='A Song Of Ice and Fire'
# extension= csv
# => filename = ASongOfIceandFire.csv (case NOT sensitive, asongoficeandfire.CSV ok as well)

[volume_file_format]

# file extension
# (required)
extension = csv

# description of each column, separated by comma
# (required)
# "name" and "place" tags are required
# "chapter", "region", "aka" are optionnal
column_format = chapter,name,region,place,aka

# required for map MODE (see usage)
[location]
#name_of_the_place=position_x,positiony (in [0,1] for each)
place1_name=xlocation,ylocation
place2_name=xlocation,ylocation

.