GitHub - jontodd/r.refine: GIS: Raster to TIN simplification (Standalone and GRASS support)

Branches Tags

Name		Name	Last commit message	Last commit date
Latest commit History 1 Commit
OBJ.powerpc-apple-darwin8.11.0/.svn		OBJ.powerpc-apple-darwin8.11.0/.svn
Gmakefile		Gmakefile
Makefile		Makefile
Makefile.linux		Makefile.linux
Makefile.mac		Makefile.mac
README		README
constants.h		constants.h
copyright.txt		copyright.txt
geom_tin.c		geom_tin.c
geom_tin.h		geom_tin.h
geom_tin.o		geom_tin.o
grass.c		grass.c
grass.h		grass.h
grid.c		grid.c
grid.h		grid.h
grid.o		grid.o
main.c		main.c
main.o		main.o
mem_manager.c		mem_manager.c
mem_manager.h		mem_manager.h
mem_manager.o		mem_manager.o
point.h		point.h
pqelement.c		pqelement.c
pqelement.h		pqelement.h
pqelement.o		pqelement.o
pqheap.c		pqheap.c
pqheap.h		pqheap.h
pqheap.o		pqheap.o
qsort.c		qsort.c
qsort.h		qsort.h
qsort.o		qsort.o
queue.c		queue.c
queue.h		queue.h
queue.o		queue.o
r.refine		r.refine
r.refine.html		r.refine.html
refine_tin.c		refine_tin.c
refine_tin.h		refine_tin.h
refine_tin.o		refine_tin.o
render_tin.c		render_tin.c
render_tin.h		render_tin.h
render_tin.o		render_tin.o
rtimer.c		rtimer.c
rtimer.h		rtimer.h
rtimer.o		rtimer.o
tin.c		tin.c
tin.h		tin.h
tin.o		tin.o
triangle.h		triangle.h

Repository files navigation

<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
<html> <head>
<title>r.refine</title>
</head>

<body>
<!-- <img src="grass.smlogo.gif"> -->


<h2>Name</h2>
<B><tt>r.refine</tt></B>: scalable raster-to-TIN simplification.  

<p><h2>Description</h2>
<tt>r.refine</tt> takes as input a grid DEM and an error margin and
simplifies it to the desired accuracy into a TIN. The resulting TIN is
guaranteed to be within error epsilon from the grid.



<H2>SYNOPSIS</H2>
<pre>
r.refine -help
Description:
 r.refine: scalable raster-to-TIN simplification.

Usage:
 r.refine [-dnr] grid=name [epsilon=value] [tin=name]
   [output_sites=name] [output_vect=name] [memory=value]

Flags:
  -d   Do NOT use Delaunay triangulation
  -n   Include nodata points (in simplification)
  -r   Render TIN in OpenGL

Parameters:
          grid   Input raster
       epsilon   Error threshold, in percentage of max elevation
                 default: 1.0
           tin   Output TIN file
                 default: output.tin
  output_sites   Name of output sites file.
                 default: NULL
   output_vect   Name of output vector file.
                 default: NULL
        memory   Main memory size (in MB)
                 default: 500
</pre>

<p>The user has to specify an error (<tt>epsilon=xxx</tt>); by default
this is 1. Point are be dropped from the grid so that the output TIN
approximates the grid within error <tt>epsilon</tt>. The smaller the
epsilon, the bigger, and more accurate, the TIN.

<p>The output TIN is output in internal TIN format (the name of the
tin can be set by the user with <tt>tin=xxx</tt>); It can be also
output as sites, if the user specifies a sites filename
(<tt>output_sites=xxx</tt>), or as a vector
(<tt>output_vect=xxx</tt>).

<p> The user can specify a main memory size (in MB) to be used by
<tt>r.refine</tt>. The program will at all times use this much memory,
and the virtual memory system will not be in use.  In practice the 
<tt>mem=value</tt> should be an underestimate of the amount of available
(free) main memory on the machine.



<H2>Examples</H2>
<pre>
r.refine grid=xxx.elev eps=10 tin=xxx.tin output_vect=xxx.vect  mem=600
</pre>



<H2>NOTES</H2>

The folder comes with several Makefiles, including a GMakefile for
Grass 5.3.  It can be compiled standalone, or under GRASS. To compile
standalone:
<pre>
cd r.refine
make -f Makefile.mac
</pre>
Then run from the command line:
<pre>
./r.refine
</pre>

<p>To compile under GRASS:
<pre>
/path/to/gmake
</pre>





<hr>
<address></address>
<!-- hhmts start --> Last modified: Fri Sep 21 14:21:29 EDT 2007 <!-- hhmts end -->
</body> </html>