[GRASSweb-list]markus: web/grass51 attrib_storage.html,1.4,1.5 geom_storage.html,1.4,1.5 tutorial.html,1.2,1.3

Tue Dec 17 12:21:06 EST 2002

Author: markus

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

Modified Files:
	attrib_storage.html geom_storage.html tutorial.html 
Log Message:
slightly extended

Index: attrib_storage.html
===================================================================
RCS file: /grassrepository/web/grass51/attrib_storage.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -d -r1.4 -r1.5

--- attrib_storage.html	17 Dec 2002 16:51:31 -0000	1.4
+++ attrib_storage.html	17 Dec 2002 17:21:03 -0000	1.5
@@ -24,24 +24,39 @@
 <a href="examples.html">Usage Examples</a>
 <hr>
 
-
+<i><b>README:</b>
 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.
-<p>
-
-<i><b>Disclaimer:</b> These examples described here may work or
-        not. You are kindly invited to send us further examples and/or
-        code bugfixes/enhancements.</i>
+and improve GRASS 5.1. Knowing this, please read on.</i><br>
+<i>
+These examples described here may work or not. You are kindly invited to
+send us further examples and/or code bugfixes/enhancements.</i>
 <P>
 
-To get debug information, set variable (set to 0 for debug silence) to
-      1..5:
-<pre>
-export GRASS_DEBUG_LEVEL=5
-</pre>
 
+The attribute management was completely changed in GRASS 5.1 to achieve
+multi-attribute capabilities managed within external databases. The former
+dig_cats/ files are not used any more and all vector attributes are stored
+in external database. Connection with database is done through DBMI library
+(DataBase Management Interface) with its integrated drivers. At time of this
+writing following DBMI drivers for attribute storage are available: 
+
+<ul>
+<li>DBF file
+<li>ODBC connected RDBMS (e.g. Oracle, mySQL, PostgreSQL etc)
+<li>PostgreSQL database
+<li>mySQL database
+</ul>
+
+The connection of a vector map to an attribute table is defined in the
+<tt>DB</tt> file. This file is currently a text file (ASCII) and must
+be created in the MAPSET subdirectory. Each line in the DB file refers
+to a map. Wildcards and inheritance from previous lines is implemented.
+See some <tt>DB</tt> file details <a href="http://freegis.org/cgi-bin/viewcvs.cgi/~checkout~/grass51/doc/vector/vector.html#attr">here</a>.
+
+
+<hr>
 <ol>
 <li><a href="#DBF">Attributes stored in DBF table</a>
 <li><a href="#ODBC">Attributes stored in external database (PostgreSQL)
@@ -52,6 +67,11 @@
         directly connected</a>
 </ol>
 
+To get debug information, set variable (set to 0 for debug silence) to 1..5:<pre>
+export GRASS_DEBUG_LEVEL=5
+</pre>
+
+
 <p><table width="100%" cellpadding="3" border="0">
 <tr><td align="left" bgcolor="#B0F0B0"><font color="#00000"><big><b>
 <a name="DBF"></a>
@@ -73,6 +93,15 @@
 
 Now the table name 'markveggy' should be printed which is the DBF file.
 
+You can also check the vector map itself concerning a current link to a
+table:
+
+<pre>
+v.db.connect markveggy.shp
+</pre>
+
+which should print the database connection to DBF file.
+
 <p><table width="100%" cellpadding="3" border="0">
 <tr><td align="left" bgcolor="#B0F0B0"><font color="#00000"><big><b>
 <a name="ODBC"></a>
@@ -208,6 +237,15 @@
 
 Note that you can also connect mySQL, Oracle etc. through ODBC to GRASS 5.1.
 
+You can also check the vector map itself concerning a current link to a
+table:
+
+<pre>
+v.db.connect markveggy.shp
+</pre>
+
+which should print the database connection through ODBC to the defined RDBMS.
+
 <p><table width="100%" cellpadding="3" border="0">
 <tr><td align="left" bgcolor="#B0F0B0"><font color="#00000"><big><b>
 <a name="PostgreSQL"></a>
@@ -235,6 +273,14 @@
 Doesn't work? Check with 'psql -l' if the PostgreSQL
 connection is really established.
 
+You can also check the vector map itself concerning a current link to a
+table:
+
+<pre>
+v.db.connect markveggy.shp
+</pre>
+
+which should print the database connection to PostgreSQL.
 
 <p><table width="100%" cellpadding="3" border="0">
 <tr><td align="left" bgcolor="#B0F0B0"><font color="#00000"><big><b>

Index: geom_storage.html
===================================================================
RCS file: /grassrepository/web/grass51/geom_storage.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -d -r1.4 -r1.5
--- geom_storage.html	17 Dec 2002 16:51:31 -0000	1.4
+++ geom_storage.html	17 Dec 2002 17:21:03 -0000	1.5
@@ -24,30 +24,58 @@
 <a href="examples.html">Usage Examples</a>
 <hr>
 
-
+<i><b>README:</b>
 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.
-<p>
-
-<i><b>Disclaimer:</b> These examples described here may work or
-        not. You are kindly invited to send us further examples and/or
-        code bugfixes/enhancements.</i>
+and improve GRASS 5.1. Knowing this, please read on.</i><br>
+<i>
+These examples described here may work or not. You are kindly invited to
+send us further examples and/or code bugfixes/enhancements.</i>
 <P>
 
-To get debug information, set variable (set to 0 for debug silence) to
-      1..5:
-<pre>
-export GRASS_DEBUG_LEVEL=5
-</pre>
 
+In GIS the vector data model is used for geographic phenomena which may be
+represented by geometric entities (primitives) like points, lines, and
+areas. In GRASS 5.1 the vector data model includes the description of
+topology, where besides the coordinates describing the location of the
+points, lines, boundaries and centroids also their spatial relations are
+stored. In general topological GIS require a data structure, where common
+boundary between two adjacent areas is stored as a single line, simplifying
+the map maintenance. 
+
+The new GRASS 5.1 vector architecture overcomes the vector limitations of
+GRASS 4.x-5.0 by extending the vector support with attributes stored in
+external relational databases and by new 3D capabilities. Besides internal
+file based storage the geometry may alternatively be stored in PostGIS
+database. This enables users to maintain large data sets with simultaneous
+write access. External GIS formats such as SHAPE-files may be used directly
+without necessity of format conversion.
+
+There are various possibilities to store vector geometry in GRASS 5.1:
+
+<ul>
+<li>native format (default)
+<li>SHAPE format
+<li>PostGRASS format (using PostgreSQL/PostGIS)
+<li>OGR supported formats (under development)
+</ul>
+
+See some vector API details <a href="http://freegis.org/cgi-bin/viewcvs.cgi/~checkout~/grass51/doc/vector/vector.html">here</a>.
+
+
+<hr>
 <ol>
 <li><a href="#native">Geometry stored in native format</a>
 <li><a href="#SHAPE">Geometry stored in SHAPE file: Registration of a map in
 SHAPE format</a>
 <li><a href="#PostGRASS">Geometry stored in external database (PostGRASS)</a>
 </ol>
+
+To get debug information, set variable (set to 0 for debug silence) to 1..5:<pre>
+export GRASS_DEBUG_LEVEL=5
+</pre>
+
 
 <p><table width="100%" cellpadding="3" border="0">
 <tr><td align="left" bgcolor="#B0F0B0"><font color="#00000"><big><b>

Index: tutorial.html
===================================================================
RCS file: /grassrepository/web/grass51/tutorial.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -d -r1.2 -r1.3
--- tutorial.html	17 Dec 2002 16:51:31 -0000	1.2
+++ tutorial.html	17 Dec 2002 17:21:03 -0000	1.3
@@ -30,10 +30,24 @@
 </ol>
 
 <hr>
+References:<p>
+
+R. Blazek, M. Neteler, and R. Micarelli. The new GRASS 5.1 vector
+architecture. In Open source GIS - GRASS users conference 2002, Trento,
+Italy, 11-13 September 2002. University of Trento, Italy, 2002. <a
+target="top"
+href="http://www.ing.unitn.it/~grass/proceedings/proceedings/pdfs/Blazek_Radim.pdf">http://www.ing.unitn.it/~grass/proceedings/proceedings/pdfs/Blazek_Radim.pdf</a>
+<p>
+
 <b>Further Links:</b>
 
 <ul>
-<li><a href=index.html>GRASS 5.1 main page</a>
+<li><a href=index.html>GRASS 5.1 main page</a></li>
+<li><a href="http://mpa.itc.it/markus/grass51/index.html">GRASS 5.1 Draft
+    Programmer's Manual</a></li>
+<li> Implementation of new <a
+ href="http://freegis.org/cgi-bin/viewcvs.cgi/~checkout~/grass51/doc/vector/vector.html">GRASS
+ 5.1 vector API</a> (3D vectors, DBMS support, optional 64bit support)</li>
 </ul>
 
 <!-- FOOTER -->



