NOMBRE

r.mfilter - Filtra un mapa raster.
(GRASS Raster Program)

USO

r.mfilter
r.mfilter help
r.mfilter [-qpz] input=nombre output=nombre filter=nombre [repeat=valor] \ [TITLE="cadena"]

DESCRIPCION

r.mfilter filtra el mapa de entrada para producir el mapa de salida utilizando una matriz de filtrado. Esta matriz de filtrado puede ejecutarse varias veces (1 por defecto). Puede ejecutarse de modo interactivo o no interactivo.

Opciones:

-q

            Suprime la impresión de información sobre la ejecución del programa.
-z
El filtro se aplica solo a pixels con categorías distintas a cero. Los pixel con categoría igual a cero no cambian por lo tanto su valor. Para evitar problemas, esta opción debería utilizarse cuando el filtro va a ser pasado una sola vez.

Parametros:

input=nombre
Nombre del fichero raster de entrada.
output=nombre
              Nombre del fichero raster de salida
filter=nombre
Fichero ASCII conteniendo la definición de la matriz de filtrado tal como se describe en el siguiente apartado.
repeat=valor

              Número de veces que va a aplicarse el filtro al fichero de entrada (una por defecto)
TITLE="cadena"

              Título para el mapa de salida
 

FILTROS

El formato de los ficheros ASCII de filtrado es el siguiente: 
     TITLE      TITLE
     MATRIX     n
                  .
     n lines of n integers
                  .
     DIVISOR    d
     TYPE        S/P
TITLE
Título descriptivo del filtro
MATRIX
               La matriz (n x n) seguida de n lineas, con n enteros separados por al menos un espacio, cada una. El valor n debe ser un número impar igual o mayor que 3.
DIVISOR
El número por el que se va a dividir, si no se especifica el valor por defecto es 1. Si el valores cero, el denominador se calcula como la suma de los elementos de la matriz de filtrado.
TYPE
Filtro de tipo S significa que el filtro es secuencial mientras que el tipo P significa que es paralelo. En un filtro secuencial, los valores ya procesados se utilizan para procesar los siguientes, mientras que en un filtro paralelo los valores del mapa de entrada se conservan para realizar lo cálculos


Pueden especificarse diversos filtros en un fichero de filtros.

EJEMPLO DE FICHERO DE FILTRO

     TITLE     3x3 average, non-zero data only, followed by 5x5 average
     MATRIX    3
     1 1 1
     1 1 1
     1 1 1
     DIVISOR   0
     TYPE      P

     MATRIX    5
     1 1 1 1 1
     1 1 1 1 1
     1 1 1 1 1
     1 1 1 1 1
     1 1 1 1 1
     DIVISOR   25
     TYPE      P

Modo de funcionamiento de los filtros


El programa produce un nuevo valor para cada celdilla en el mapa de entrada. Este valor resulta de la suma de los valores de las celdillas vecinas multiplicadas por los correspondientes valores de la matriz de filtrado. Esta suma se divide por el denominador aportado por el usuario. Si este denominador es cero se calcula un denominador como la suma de los valores de la matriz de filtrado (media ponderada).

Si se especifica más de un filtro consecutivo (el valor de repetición es mayor de 1 o el fichero del filtro contiene más de una matriz) los pasos se ejecutan secuencialmente. Esto significa que el primer filtro se aplica a todo el mapa de entrada para producir un resultado intemedio, entonces se aplica el segundo filtro a ese resultado intermedio, y así sucesivamente hasta aplicar todos los filtros, momento en que se escribe el fichero de salida.

NOTES

La región activa debe coincidir con la región del mapa de entrada para que los resultados sean correctos.

VER

g.region
r.clump
r.neighbors
parser

AUTOR

Michael Shapiro, U.S.Army Construction Engineering Research Laboratory