OnWorks favicon

m.nviz.scriptgrass - Online in the Cloud

Run m.nviz.scriptgrass in OnWorks free hosting provider over Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator

This is the command m.nviz.scriptgrass that can be run in the OnWorks free hosting provider using one of our multiple free online workstations such as Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator



m.nviz.script - Creates fly-through script to run in NVIZ.


miscellaneous, graphics, raster, raster3d, vector, visualization


m.nviz.script --help
m.nviz.script [-fckoe] input=name output=name [name=string]
[route=east,north[,east,north,...]] dist=float ht=float frames=integer [start=integer]
[--overwrite] [--help] [--verbose] [--quiet] [--ui]

Full render -- Save images

Fly at constant elevation (ht)

Include command in the script to output a KeyFrame file

Render images off-screen

Enable vector and sites drawing

Allow output files to overwrite existing files

Print usage summary

Verbose module output

Quiet module output

Force launching GUI dialog

input=name [required]
Name of input raster map

output=name [required]
Name of output script

Prefix of output images (default = NVIZ)

Route coordinates (east,north)

dist=float [required]
Camera layback distance (in map units)

ht=float [required]
Camera height above terrain

frames=integer [required]
Number of frames

Start frame number (default=0)


The m.nviz.script program allows the user to easily create a script that can be run in
NVIZ to fly through a terrain. The NVIZ flight path can be chosen interactively from the
GRASS monitor (-i) or supplied on the command line as comma separated coordinates. The
program optionally allows a KeyFrame file to created (after running the script). This
KeyFrame file can be loaded into the Keyframe Animation panel for fine tuning or editing.

The script generated by m.nviz.script can be run from the NVIZ command line (nviz
script=script_name) or after NVIZ is started by selecting Scripting->Play Script.


Intercative mode
The user selects the camera path from the GRASS monitor by clicking the left mouse
button along the route. Click the right mouse button to finish.

Full render
The script will draw all loaded NVIZ data and save scene to PPM image.

Flay at constant elevation
With this flag the camera will be set to an elevation given by the ht= parameter. The
default is to fly at ht= above the topography (i.e. camera height = elevation + ht)

Output KeyFrame file
Generate a KeyFrame file that can be loaded from the NVIZ Keyframe Animation panel.
The KeyFrame file is automatically assigned the script name with a .kanimator

Render the animation in an off-screen context

Enable vector and sites drawing

The name of the GRASS raster map with elevation data.
This should be the same file that will be loaded in NVIZ.

The name of the NVIZ script to create.

The prefix for output images if running in full render mode (-f).
The defulat preifix is NVIZ (eg. NVIZ0000.ppm).

The distance of the camera behind the center of view.

The height of the camera above the center of view.
If the the -c flag is set, the height represents the actual camera height.

The number of frames in the animation.

The starting frame number (default = 0).
This option may be useful in full render mode when creating an animation in sections.
For example the user may wish to start at frame number 2000.

The comma separated geographic coordinates for keyframe locations.
The interactive flag (-i) overrides this option.


To interactively create an NVIZ animation from raster elev.rast with 500 frames and the
camera set to 50 meters above and 250 meters behind the scene, run the following:
g.region raster=elevation.dem
d.rast elevation.dem
m.nviz.script -ik input=elevation.dem output=nviz.script dist=2400 ht=1220 frames=1000
In the above the example the user is prompted to select the route from the GRASS monitor.
The output script, ’nviz.script.nvscr’, can then be run in NVIZ:
nviz elevation=elevation.dem script=nviz.script.nvscr


The user must select at least four key-frame locations (points) otherwise an error is

If the GRASS region is changed the m.nviz.script command must be re-run.

The current GRASS region and the user supplied parameters are included as a comment at the
top of the output script. This information can be used to easily re-create the animation.

The camera position is calculated backwards from the supplied position(s). It is possible
that the camera position will lie outside the current window, in which case a non-fatal
error is generated (Error: selected point is outside region). This error can result in
jerky movements during the animation. To correct this problem reduce the dist= parameter
or increase the current region.

Loading the script into NVIZ
The user can run the script at arbitrary resolution. To re-run it at higher spatial
resolution or different settings, the user first loads the surface and sets the
resolution, lighting, etc. Then internally the script generated by m.nviz.script is run.
Alternatively, the user can run nviz with a previuosly saved state and the m.nviz.script
generated script:
nviz state=saved.state script=nviz.script.nvscr

Keyframe animator script
Running the script generated by m.nviz.script within NVIZ, a new script for kanimator
(keyframe animator) is created. The kanimator panel offers fine tuning of the speed (frame
rate) as well as editing individual frames or inserting new frames. This new kanimator
script has to be loaded from the Kanimator panel in NVIZ. In the Kanimator panel there are
Save and Load button which allow the user to save and re-load a kanimator script. Once
loaded, the key frames will appear in the GUI and can then be edited there.

Use m.nviz.scriptgrass online using onworks.net services

Free Servers & Workstations

Download Windows & Linux apps

  • 1
    Phaser is a fast, free, and fun open
    source HTML5 game framework that offers
    WebGL and Canvas rendering across
    desktop and mobile web browsers. Games
    can be co...
    Download Phaser
  • 2
    VASSAL Engine
    VASSAL Engine
    VASSAL is a game engine for creating
    electronic versions of traditional board
    and card games. It provides support for
    game piece rendering and interaction,
    Download VASSAL Engine
  • 3
    OpenPDF - Fork of iText
    OpenPDF - Fork of iText
    OpenPDF is a Java library for creating
    and editing PDF files with a LGPL and
    MPL open source license. OpenPDF is the
    LGPL/MPL open source successor of iText,
    Download OpenPDF - Fork of iText
  • 4
    SAGA - System for Automated
    Geoscientific Analyses - is a Geographic
    Information System (GIS) software with
    immense capabilities for geodata
    processing and ana...
    Download SAGA GIS
  • 5
    Toolbox for Java/JTOpen
    Toolbox for Java/JTOpen
    The IBM Toolbox for Java / JTOpen is a
    library of Java classes supporting the
    client/server and internet programming
    models to a system running OS/400,
    i5/OS, o...
    Download Toolbox for Java/JTOpen
  • 6
    D3.js (or D3 for Data-Driven Documents)
    is a JavaScript library that allows you
    to produce dynamic, interactive data
    visualizations in web browsers. With D3
    Download D3.js
  • More »

Linux commands