[GRASS-SVN] r36854 - in grass-addons/raster/mcda: r.mcda.electre r.mcda.fuzzy r.mcda.regime r.roughset

svn_grass at osgeo.org svn_grass at osgeo.org
Tue Apr 21 18:04:18 EDT 2009


Author: gianluca
Date: 2009-04-21 18:04:18 -0400 (Tue, 21 Apr 2009)
New Revision: 36854

Modified:
   grass-addons/raster/mcda/r.mcda.electre/description.html
   grass-addons/raster/mcda/r.mcda.fuzzy/description.html
   grass-addons/raster/mcda/r.mcda.regime/description.html
   grass-addons/raster/mcda/r.roughset/description.html
Log:
better description

Modified: grass-addons/raster/mcda/r.mcda.electre/description.html
===================================================================
--- grass-addons/raster/mcda/r.mcda.electre/description.html	2009-04-21 19:09:23 UTC (rev 36853)
+++ grass-addons/raster/mcda/r.mcda.electre/description.html	2009-04-21 22:04:18 UTC (rev 36854)
@@ -1,25 +1,14 @@
 <H2>DESCRIPTION</H2>
 <P><em>r.mcda.electre</em> 
-is the implementation of the ELECTRE multicriteria algorithm in GRASS GIS environment. It
-is one of the available tools in the r.mcda suite. It requires as an
-input the list of rasters representing the criteria to be assessed in
-the multicriteria evaluation and the vector of weights to be
-assigned. Every single cell of the GRASS region is considered as one
-of the possible alternatives to evaluate and it is described with the
-value assumed for the same cell by the rasters used as criteria.
-There are two output files. One represents the spatial distribution
-of the concordance index, the other one of the discordance index. The
-optimal solution is the one presenting the maximum concordance value
-and the minimum discordance value at the same time.</P>
+is the implementation of the ELECTRE multicriteria algorithm in GRASS GIS environment. It is one of the available tools in the r.mcda suite. It requires as an input the list of raster representing the criteria to be assessed in the multicriteria evaluation and the vector of weights to be assigned. Every single cell of the GRASS region is considered as one of the possible alternatives to evaluate and it is described with the value assumed for the same cell by the raster used as criteria. There are two output files. One represents the spatial distribution of the concordance index, the other one of the discordance index. The optimal solution is the one presenting the maximum concordance value and the minimum discordance value at the same time.
+</P>
 <BR>
 <H2>NOTES</H2>
-<P>The module does not standardize the raster-criteria. Therefore, they must be prepared before by
-using, for example, r.mapcalc. The weights vector is always normalized so that the sum of the weights is 1.</P>
+<P>The module does not standardize the raster-criteria. Therefore, they must be prepared before by using, for example, r.mapcalc. The weights vector is always normalized so that the sum of the weights is 1.
+</P>
 <BR>
 <H2>REFERENCE</H2>
-<P>Roy, B. (1971) Problem and
-methods with multiple objective functions Mathematical programming 1,
-239-266.</P>
+<P>Roy, B. (1971) Problem and methods with multiple objective functions Mathematical programming 1, 239-266.</P>
 <P>Roy, B. (1990): The outranking approach and the foundations of Electre methods , Document du LAMSADE, Paris.</P>
 <P>Janssen R. (1994) - Multiobjective decision support for environmental management, Kluwer Academic Publishers.</P>
 <P>GRASS Development Team (2008)</P>
@@ -32,4 +21,4 @@
 <BR>Department of Economics and Appraisal - University of Perugia - Italy 
 </P>
 <p>
-<i>Last changed: $Date: 2009-02-1 23:16:42 +0200 (Sun, 2 Feb 2009) $</i>
+<i>Last changed: $Date: 2009-04-23 23:16:42 +0200 (Tue, 22 Apr 2009) $</i>

Modified: grass-addons/raster/mcda/r.mcda.fuzzy/description.html
===================================================================
--- grass-addons/raster/mcda/r.mcda.fuzzy/description.html	2009-04-21 19:09:23 UTC (rev 36853)
+++ grass-addons/raster/mcda/r.mcda.fuzzy/description.html	2009-04-21 22:04:18 UTC (rev 36854)
@@ -1,27 +1,13 @@
 <H2>DESCRIPTION</H2>
 <P><em>r.mcda.fuzzy </em> 
-is the implementation of the FUZZY multicriteria algorithm proposed by
-Yager R., in GRASS GIS environment. It is one of the available tools
-in the r.mcda suite. It requires as an input the list of rasters
-representing the criteria to be assessed in the multicriteria
-evaluation and the vector of linguistic modifiers to be assigned.
-Every single cell of the GRASS region is considered as one of the
-possible alternatives to evaluate and it is described with the value
-assumed for the same cell by the rasters used as criteria. It is
-possible to get three different output files as the result of the
-intersection operator, the union operator and the &ldquo;ordered
-weighted averaging&rdquo; (OWA) operator.</P>
-<BR>
+is the implementation of the FUZZY multicriteria algorithm proposed by Yager R., in GRASS GIS environment. It is one of the available tools in the r.mcda suite. It requires as an input the list of raster representing the criteria to be assessed in the multicriteria evaluation and the vector of linguistic modifiers to be assigned. Every single cell of the GRASS region is considered as one of the possible alternatives to evaluate and it is described with the 
+value assumed for the same cell by the raster used as criteria. It is possible to get three different output files as the result of the intersection operator, the union operator and the ordered weighted averaging (OWA) operator. </P>
+<BR
 <H2>NOTES</H2>
-<P>The module does not standardize the raster-criteria.Therefore, they must
-be prepared before by using, for example, r.mapcalc. The linguistic
-modifiers vector is always normalized so that the sum of the weights
-is 1.</P>
+<P>The module does not standardize the raster-criteria. Therefore, they must be prepared before by using, for example, r.mapcalc. The linguistic modifiers vector is always normalized so that the sum of the weights is 1.</P>
 <BR>
 <H2>REFERENCE</H2>
-<P>Yager R. (1977) - Multiple objective
-decision making using fuzzy set, International Journal of Man-Machine
-Studies, 12, 299-322;</P>
+<P>Yager R. (1977) - Multiple objective decision making using fuzzy set, International Journal of Man-Machine Studies, 12, 299-322;</P>
 <P>GRASS Development Team (2008)</P>
 <BR>
 <H2>SEE ALSO</H2>
@@ -32,4 +18,4 @@
 <BR>Department of Economics and Appraisal - University of Perugia - Italy 
 </P>
 <p>
-<i>Last changed: $Date: 2009-02-1 23:16:42 +0200 (Sun, 2 Feb 2009) $</i>
+<i>Last changed: $Date: 2009-04-23 23:16:42 +0200 (Tue, 22 Apr 2009) $</i>

Modified: grass-addons/raster/mcda/r.mcda.regime/description.html
===================================================================
--- grass-addons/raster/mcda/r.mcda.regime/description.html	2009-04-21 19:09:23 UTC (rev 36853)
+++ grass-addons/raster/mcda/r.mcda.regime/description.html	2009-04-21 22:04:18 UTC (rev 36854)
@@ -1,18 +1,8 @@
 <H2>DESCRIPTION</H2>
-<em>r.mcda.regime </em> is
-the implementation of the REGIME multicriteria algorithm in GRASS GIS
-environment. It is one of the available tools in the r.mcda suite. It
-requires as an input the list of rasters representing the criteria to
-be assessed in the multicriteria evaluation and the vector of weights
-to be assigned. Every single cell of the GRASS region is considered
-as one of the possible alternatives to evaluate and it is described
-with the value assumed for the same cell by the rasters used as
-criteria.</P>
+<em>r.mcda.regime </em> is the implementation of the REGIME multicriteria algorithm in GRASS GIS environment. It is one of the available tools in the r.mcda suite. It requires as an input the list of raster representing the criteria to be assessed in the multicriteria evaluation and the vector of weights to be assigned. Every single cell of the GRASS region is considered as one of the possible alternatives to evaluate and it is described with the value assumed for the same cell by the raster used as criteria. </P>
 <BR>
 <H2>NOTES</H2>
-<P>The module does not standardize the raster-criteria. Therefore, they must
-be prepared before by using, for example, r.mapcalc. The weights
-vector is always normalized so that the sum of the weights is 1.</P>
+<P>The module does not standardize the raster-criteria. Therefore, they must be prepared before by using, for example, r.mapcalc. The weights vector is always normalized so that the sum of the weights is 1.</P>
 <BR>
 <H2>REFERENCE</H2>
 <P>Janssen R. (1994) - Multiobjective decision support for environmental management, Kluwer Academic Publishers;</P>
@@ -26,4 +16,4 @@
 <BR>Department of Economics and Appraisal - University of Perugia - Italy 
 </P>
 <p>
-<i>Last changed: $Date: 2009-02-1 23:16:42 +0200 (Sun, 2 Feb 2009) $</i>
+<i>Last changed: $Date: 2009-04-23 23:16:42 +0200 (Tue, 22 Apr 2009) $</i>

Modified: grass-addons/raster/mcda/r.roughset/description.html
===================================================================
--- grass-addons/raster/mcda/r.roughset/description.html	2009-04-21 19:09:23 UTC (rev 36853)
+++ grass-addons/raster/mcda/r.roughset/description.html	2009-04-21 22:04:18 UTC (rev 36854)
@@ -1,50 +1,14 @@
 <H2>DESCRIPTION</H2>
-<em>r.roughset</em> è un modulo che consente l'applicazione della 
-rough set theory [1,2] a database geografici in ambiente GRASS GIS. 
-L'input è costituito da due gruppi di dati: <BR>1. gli attributi geografici che costituiscono il
-sistema informativo della rough set analisys e che si ritiene siano
-sufficienti a descrivere un determinato fenomeno naturale,
-sociale od economico (<B>attributes</B>=<EM>string[,string,...]</EM>);<BR> 2.
-il tematismo nel quale sono identificate le aree per cui il fenomeno
-da studaire si è presentato con una certa modalità
-(<B>decision</B>=<EM>string</EM>). Il valore non nullo di ogni cella
-di questo raster va a riempire l'ultima colonna del sistema
-informativo mentre le corrispondenti celle dei raster nel campo
-<B>attributes </B><SPAN STYLE="font-weight: normal">completano le
-altre colonne. </SPAN>
+<em>r.roughset</em> is the implementation of the rough set theory [1,2] in GRASS GIS environment. It requires the following input:
+<BR>1. the geographical attributes constituting the information system for the rough set analysis; they have to describe environmental, economic or social issues(<B>attributes</B>=<EM>string[,string,...]</EM>);<BR> 2.the theme in which areas with the issues to be studied are identified (<B>decision</B>=<EM>string</EM>).
 </P>
-<P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm">Il sistema informativo
-cos&igrave; generato viene trattato con le funzioni esposte dalla
-versione 2 delle rough set library (RSL, ver. 2.0) [3] secondo
-una delle strategie decisionali disponibili con l'opzione
-<B>strgy</B>=<EM>string.</EM></P>
-<P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><EM><SPAN STYLE="font-style: normal">La
-scelta della strategia di classificazione, </SPAN></EM><EM><SPAN STYLE="font-style: normal"><B>clssfy</B></SPAN></EM><EM>=string
-</EM><EM><SPAN STYLE="font-style: normal"> è indispensabile per
-generare una mappa sulla base dei criteri descritti con gli attributi
-(attributes) e le regole decisionali generate. Le opzioni sono 3:
-</SPAN></EM><EM><I>Classify1,Classify2,Classify3</I></EM><EM> </EM><EM><SPAN STYLE="font-style: normal">e
-ognuna corrisponde a tre differenti algoritmi [3]. </SPAN></EM><BR><BR>L'output
-è costituito da tre differenti files di cui due di tipo testo<EM>
-</EM>ed uno raster:</P>
-<P ALIGN=JUSTIFY>a. <I>file testo</I> strutturato secondo lo standard
-suggerito dalla rough set library, contraddistinto dallo stesso nome
-indicato nel campo <B>outTXT</B><I><SPAN STYLE="font-weight: normal">=string</SPAN></I>
-senza ulteriori suffissi; è necessario nel caso in cui le
-regole decisionali generate per un contesto geografico debbano essere
-applicate in un'altra location, sulla base di raster di attributi e
-decisionali con lo stesso significato e lo stesso range di valori. In
-questo caso il campo sample=string dovrà contenere il nome
-completo di un file outTXT precedentemente generato e il campo
-<EM><SPAN STYLE="font-style: normal"><B>decision=</B></SPAN></EM><EM><I><SPAN STYLE="font-weight: normal">string</SPAN></I></EM><EM>
-</EM><EM><SPAN STYLE="font-style: normal"><SPAN STYLE="font-weight: normal">può
-essere tralasciato</SPAN></SPAN></EM> Il file può anche essere
-utilizzato con implementazioni delle le RSL al di fuori dall'ambiente
-GIS;</P>
-<P STYLE="margin-bottom: 0cm"><I>NAME: nome del sistema informativo</I></P>
-<P STYLE="margin-bottom: 0cm"><I>ATTRIBUTES: 4 (numero degli
-attributi)</I></P>
-<P STYLE="margin-bottom: 0cm"><I>OBJECTS: 8 (numero degli oggetti)</I></P>
+<P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm">An information system is generated and the functions of version 2 of rough set library (RSL, ver. 2.0) [3] are applied, following one of the decision strategies available with the option<B>strgy</B>=<EM>string.</EM></P>
+<P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><EM><SPAN STYLE="font-style: normal">The choice of the classification strategy, </SPAN></EM><EM><SPAN STYLE="font-style: normal"><B>clssfy</B></SPAN></EM><EM>=string
+</EM><EM><SPAN STYLE="font-style: normal"> is necessary to generate a map based on the attributes and the decision rules. Three options are available:</SPAN></EM><EM><I>Classify1,Classify2,Classify3</I></EM><EM> </EM><EM><SPAN STYLE="font-style: normal">each of them is referred to a different algorithm. [3]. </SPAN></EM><BR><BR>It is possible to get three different output files; two of them are text files, the third is a raster file: </P>
+<P ALIGN=JUSTIFY>a. <I>text file</I> structured following the standard of the rough set library, having the name registered in the  <B>outTXT</B><I><SPAN STYLE="font-weight: normal">=string</SPAN></I> without any additional extension. The file can be used as well with RSL implementation out of GIS environment.</P>
+<P STYLE="margin-bottom: 0cm"><I>NAME:  name of the information system </I></P>
+<P STYLE="margin-bottom: 0cm"><I>ATTRIBUTES: 4 (number of attributes) </I></P>
+<P STYLE="margin-bottom: 0cm"><I>OBJECTS: 8 (number of objects)</I></P>
 <P STYLE="margin-bottom: 0cm"><I>0 0 0 0 </I>
 </P>
 <P STYLE="margin-bottom: 0cm"><I>1 0 1 1</I></P>
@@ -61,39 +25,18 @@
 <P STYLE="margin-bottom: 0cm"><I>0 0 1 1 </I>
 </P>
 
-<P ALIGN=JUSTIFY>Il numero degli attributi è pari a quello dei
-raster dati come input al parametro <B>attributes</B>=<EM>string[,string,...]
-</EM><EM><SPAN STYLE="font-style: normal">pi&ugrave; il raster
-decisionale </SPAN></EM><EM>(</EM><EM><SPAN STYLE="font-style: normal"><B>decision</B></SPAN></EM><EM>=string)
-</EM><EM><SPAN STYLE="font-style: normal">che per convenzione occupa
-l'ultima colonna del sistema informativo.</SPAN></EM></P>
-<P ALIGN=JUSTIFY>b. <I>file testo</I>, contraddistinto dal prefisso
-definito in <B>outTXT</B><I><SPAN STYLE="font-weight: normal">=string</SPAN></I>
-e dal suffisso .<I>out</I>, contenente le regole decisionali estratte
-dal sistema informativo geografico, oltre che il core e&nbsp;&nbsp;i
-ridotti; le regole decisionali sono nella forma: &nbsp;<I>if ... then
-</I>e sono facilmente leggibili ed interpretabili dall'analista per
-finalit&agrave; descritive del fenomeno oggetto di studio;<BR>c.
-<I>raster, </I><SPAN STYLE="font-style: normal">contraddistinto dal
-nome indicato nel campo</SPAN> <SPAN STYLE="font-style: normal"><B>outMAP</B></SPAN><I>=string,
-</I><SPAN STYLE="font-style: normal">ottenuto dall'applicazione delle
-regole decisionali generate dal sistema informativo geografico
-secondo una delle strategie di classificazione in </SPAN><EM><SPAN STYLE="font-style: normal"><B>clssfy</B></SPAN></EM><EM>=string.
-</EM><EM><SPAN STYLE="font-style: normal">Le regole da applicare
-possono derivare da un sistema informativo generato dai valori
-inseriti in </SPAN></EM><EM><SPAN STYLE="font-style: normal"><B>attributes</B></SPAN></EM><EM><SPAN STYLE="font-style: normal">=</SPAN></EM><EM>string
-</EM><EM><SPAN STYLE="font-style: normal">e</SPAN></EM><EM>
+<P ALIGN=JUSTIFY>The number of attributes is the number of raster given as input at <B>attributes</B>=<EM>string[,string,...]
+</EM><EM><SPAN STYLE="font-style: normal"> plus the decision raster </SPAN></EM><EM>(</EM><EM><SPAN STYLE="font-style: normal"><B>decision</B></SPAN></EM><EM>=string) </EM><EM><SPAN STYLE="font-style: normal">located in the last column of the information system, by default. </SPAN></EM></P>
+<P ALIGN=JUSTIFY>b. <I>text file</I>, having the name defined in  <B>outTXT</B><I><SPAN STYLE="font-weight: normal">=string</SPAN></I>
+and the .<I>out</I>, extension. It contains the decision rules extracted from the geographic information system; decision rules are expressed as: 
+&nbsp;<I>if ... then </I> and they are easy to read and to be interpreted by the user; <BR>c. <I>raster, </I><SPAN STYLE="font-style: normal">having the name defined in the field </SPAN> <SPAN STYLE="font-style: normal"><B>outMAP</B></SPAN><I>=string,
+</I><SPAN STYLE="font-style: normal"> resulting from the application of the decision rules generated by the geographic information system following one of the classification strategies in  </SPAN><EM><SPAN STYLE="font-style: normal"><B>clssfy</B></SPAN></EM><EM>=string.
+</EM><EM><SPAN STYLE="font-style: normal"> Rules to apply can derive from an information system generated from the data entered in </SPAN></EM><EM><SPAN STYLE="font-style: normal"><B>attributes</B></SPAN></EM><EM><SPAN STYLE="font-style: normal">=</SPAN></EM><EM>string
+</EM><EM><SPAN STYLE="font-style: normal">and</SPAN></EM><EM>
 </EM><EM><SPAN STYLE="font-style: normal"><B>decision</B></SPAN></EM><EM>=string
-</EM><EM><SPAN STYLE="font-style: normal">oppure da un file testuale
-generato da un precedente elaborazione. In questo caso la struttura
-del file deve essere rigidamente quella indicata in box 1.</SPAN></EM></P>
+</EM><EM><SPAN STYLE="font-style: normal">or from a text file generated from a previous processing stage. In this case the file structure must be as the one reported in box 1. </SPAN></EM></P>
 <H2>NOTES</H2>
-<P ALIGN=JUSTIFY>Il modulo è in grado di trattare raster di
-tipo CELL e le elaborazioni vengono eseguite
-tutte su variabili di tipo intero (int). Questo è un vincolo 
-imposto dalle rough set library. Le regole decisionali,
-conseguentemente, restituiscono informazioni esclusivamente di tipo
-intero.</P>
+<P ALIGN=JUSTIFY>The module can process CELL raster, and calculations can be made only with integer (int) variables. This is a constraint imposed by the rough set library. The decision rules, therefore, provide only integer information. </P>
 <H2>REFERENCE</H2>
 <OL>
 	<LI><P ALIGN=JUSTIFY>Pawlak Z. Rough Sets, International Journal of
@@ -113,9 +56,7 @@
 <P><EM>r.mcda.fuzzy, r.mcda.electre, r.mcda.regime</EM></P>
 
 <H2>AUTHORS</H2>
-Antonio Boggia - Gianluca Massei&nbsp;<BR>Dipartimento
-di Scienze Economico Estimative e degli Alimenti - Universit&agrave;
-di Perugia - Italy</P>
-
-<p>
-<i>Last changed: $Date: 2009-02-1 23:16:42 +0200 (Sun, 2 Feb 2009) $</i>
+<P>Antonio Boggia - Gianluca Massei
+<BR>Department of Economics and Appraisal - University of Perugia - Italy 
+</P>
+<i>Last changed: $Date: 2009-04-23 23:16:42 +0200 (Tue, 22 Apr 2009) $</i>



More information about the grass-commit mailing list