1xganim(1) Grass User's Manual xganim(1)
2
6 xganim
7
9 xganim is a tool for animating a series of GRASS raster files. At
10 startup, a graphics window is opened containing VCR-like button con‐
11 trols for: rewind, reverse play, step back, stop, step forward, forward
12 play, loop, swing, slower, faster, show filenames, current frame num‐
13 ber, and Exit. The image is displayed above or to the left of the con‐
14 trols. Each raster map is read into memory, then the animation is
15 played once beginning to end. The user may then replay the series or
16 play continuous animation by using the buttons.
17 The user may define up to four "views", or sub-windows, to animate
19 simultaneously. e.g., View 1 could be rainfall, View 2 flooded areas,
20 View 3 damage to bridges or levees, View 4 other economic damage, all
21 animated as a time series. There is an arbitrary limit of 400 files per
22 view (400 animation frames), but the practical limit may be less
23 depending on the window size and amount of available RAM.
24 The environment variable XGANIM_SIZE is checked for a value to use as
26 the dimension, in pixels, of the longest dimension of the animation
27 window. If XGANIM_SIZE is not set, the animation size defaults to the
28 rows & columns in the current GRASS region, scaling if necessary to a
29 default minimum size of 600 and maximum of 900. The resolution of the
30 current GRASS region is maintained, independent of window size. Resiz‐
31 ing the window after the program is running will have no effect on the
32 animation size.
33 UNIX - style wild cards may be used with the command line version in
35 place of a raster map name, but it must be quoted.
36 If the number of files differs for each view, the view with the fewest
38 files will determine the number of frames in the animation.
39
41 export XGANIM_SIZE=800
43 xganim view1="rain[1-9]","rain1[0-2]" view2="temp*"
44
47 For wildcard matching, xganim understands whatever the shell under‐
48 stands (as it invokes "ls" via the shell to expand wildcards). E.g., a
49 user can use "rast[0-9][0-9]" to match "rast00" through "rast99" inclu‐
50 sive. If the maps if interest have varying numbers of digits, multiple
51 patterns can be combined, e.g.:
52 export XGANIM_SIZE=1000
53 xganim view1=rast[0-9],rast[1-9][0-9]
54 to match rast0 through rast99 inclusive.
55
57 On some displays that need to use private colormaps, the interface but‐
58 tons may become difficult to see.
59
61 d.slide.show, gis.m: ANIMATE TOOL
62
64 Bill Brown, U.S. Army Construction Engineering Research Laboratories
65 Last changed: $Date: 2007-12-17 14:53:55 +0100 (Mon, 17 Dec 2007) $
67 Full index
69 © 2003-2008 GRASS Development Team
71GRASS 6.3.0 xganim(1)