[GRASSweb-list]markus: web/grass51/tutorial demo.html,NONE,1.1

Tue Dec 31 10:03:59 EST 2002

Author: markus

Update of /grassrepository/web/grass51/tutorial
In directory doto:/tmp/cvs-serv19870

Added Files:
	demo.html 
Log Message:
5.1 demo tour

--- NEW FILE: demo.html ---
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
   <DEFANGED_meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
   <DEFANGED_meta name="Author" content="Markus Neteler">
   <DEFANGED_link rel="stylesheet" type="text/css" href="../../sitestyle.css">
   <title>GRASS 5.1: A quick demo tour</title>
</head>
<body>

<!-- HEADER -->
<table width=100%><tr><td width=80>
<A HREF="index.html">
<DEFANGED_IMG src="../../images/grass.smlogo.gif" alt="HOME" border="0" align=middle></A>
</td><td><H1>
GRASS 5.1: A quick demo tour
</H1></td></tr></table>
<!-- END OF HEADER -->

<hr>
<a href="index.html">Tutorial HOME</a> |
<a href="demo.html">Demo LOCATION</a> |
<a href="geom_storage.html">Geometry management</a> |
<a href="attrib_storage.html">Attribute management</a> |
<a href="examples.html">Usage Examples</a>
<hr>

README:
GRASS 5.1 is currently under development. It is neither complete (it still
contains only a few modules) nor it is intended to productional usage. 
Development releases are provided for people who want to help test, debug,
and improve GRASS 5.1. Knowing this, please read on. 

These examples described here may work or not. You are kindly invited to
send us further examples and/or code bugfixes/enhancements.

<h2>A quick demo tour</h2>

First download the <a href="http://mpa.itc.it/radim/g51/">Sample GRASS 5.1
LOCATION</a> which is used throughout this tutorial.

The sample LOCATION "g51test" contains a script which demonstrates most
features of the new vector engine. To run this demo, start GRASS 5.1 with
the sample LOCATION "g51test-X" (X is the current version of the data set)
and the mapset "test". In the LOCATION directory you will find the
<tt>./tour</tt> shell script (example):

<div class="code"><pre>    
grass51 /home/username/grassdata51/g51test-8/test/
</div></pre>

After entering GRASS, change into the LOCATION directory and start the demo
tour:

<div class="code"><pre>
cd /home/username/grassdata51/g51test-8/
g.region -dp
./tour
</div></pre>

The README file in this directory contains descriptions of the sample maps.

Note: If the tour fails at a certain step, the version of the "g51test-X"
LOCATION does not correspond to current GRASS 5.1 version as installed on
your computer. Be sure to use latest code and sample data set. If this
doesn't help: congratulations, you have found a bug. Please report it to the
development team.

<h2>Further tests</h2>

Further tests can be done with following scripts in the same directory:

<ul>
<li><tt>./io</tt><br>
- imports 'mcat' and 'multi' ascii files from PERMANENT mapset to current
mapset, export again and compare with original files. Original and exported
files should be identical.</li>

<li><tt>./genet</tt><br>
- creates a 2D vector network "net" with attributes stored in a DBF file.
 Display it with:
 <div class="code"><pre>
 d.vect net
 nviz el=dem vect=net
 v.db.connect net
 v.info net
 </div></pre></li>

<li><tt>./gen.big</tt><br>
- generate big ascii file. Usage:
 <div class="code"><pre>
 ./gen.big output=name [n=value] [type=] [attr=value] [ver=value] [shape=value]
 </div></pre>
with: <br>
<i> &nbsp;&nbsp; n: number of rows and columns (def.: 10) <br>
 &nbsp;&nbsp; type: primitive type (def.: "plbc", point, line, boundary, centroid) <br>
 &nbsp;&nbsp; attr: y/n write attributes (def.: y) <br>
 &nbsp;&nbsp; ver: GRASS 5/4 version (def.: 5) <br>
 &nbsp;&nbsp; shape: area shape: r - rectangles, s - suns (def.: r)
</i>
<br>
 Example (takes a while, generates 100 * 100 = 10000 lines with 10000 areas
 with circle shape and 10000 islands):
 <div class="code"><pre>
 ./gen.big output=bigmap n=100 shape=s
 v.in.ascii in=bigmap out=bigmap
 v.info bigmap
 d.vect bigmap
 d.zoom
 d.vect bigmap display=shape,cat lcolor=green
 </div></pre></li>

<li><tt>./gen.long</tt><br>
- generates a long line (curve)
 <div class="code"><pre>
 ./gen.long output=name [npoints=value]
 </div></pre>
with: <br>
<i> &nbsp;&nbsp; npoints: number of vertices (def.: 1000000)
</i>
<br>
 Example:
 <div class="code"><pre>
 ./gen.long output=longcurve npoints=10000
 v.in.ascii in=longcurve out=longcurve
 v.info longcurve
 v.db.connect longcurve
 g.region vect=longcurve -p
 d.erase
 d.vect longcurve
 d.zoom
 </div></pre></li>

<li><tt>./bench</tt><br>
- comparison between two formats: native x PostGRASS (using PostGIS)
<br>
Example: todo.
</li>
</ul>

The other scripts stored in the LOCATION directory are internally used by
some demo scripts.

<!-- FOOTER -->
<p>
<hr>
<DIV ALIGN=right>&copy; 2002 Markus Neteler<br>
<a href="mailto:weblist at grass.itc.it">Comments</a> about this page | <a href="../../faq/index.html">FAQ</a> | <a href="../../download.html">Download</a> | <a href="../../support.html">Support</a> | <a href="../../gdp/index.html">Docs</a>  | <a href="../../grassdevel.html">Programming</a> | Back <a href=index.html>5.1 Tutorial Home</a><br>
<i>Last change:
$Date: 2002/12/31 15:03:57 $
</i></DIV>

</body>
</html>