edu.bonn.xulu.plugin.model.mrv
Class MultipleResolutionValidation

java.lang.Object
  extended by AbstractNamedObject
      extended by edu.bonn.xulu.model.AbstractXuluModel
          extended by edu.bonn.xulu.model.AbstractStepModel
              extended by edu.bonn.xulu.plugin.model.mrv.MultipleResolutionValidation
All Implemented Interfaces:
StepModel, XuluModel

public class MultipleResolutionValidation
extends AbstractStepModel

MULTIPLE RESOLUTION COMPARISON
The Multiple Resolution Comparison is a Xulu-plugin that can be used in order to validate modelling results. In general, the Multiple Resolution Comparison is a method to quantify the agreement between two maps, whereby it averages neighbouring pixels of both maps into coarser pixels in order to quantify the agreement between maps at coarser resolutions. The percent correct tends to rise at coarser resolutions, because it reduces the effect of error due to location. By comparing the results with a Multiple Resolution Comparison of a NULL-Model (no change has taken place between t1 and t2), the NULL-Resolution can be identified, which indicates the resolution at which the modelling result is more accurate than the NULL-Model.
For details refer to:
Costanza,R. (1989): Model Goodness of Fit - A Multiple Resolution Procedure. In: Ecological Modelling, vol. 47, no. 3-4, pp. 199-215.
Pontius Jr, R.G. (2002): Statistical Methods to Partition Effects of Quantity and Location During Comparison of Categorical Maps at Multiple Resolutions. In: Photogrammetric Engineering & Remote Sensing, vol. 68, no. 10, pp. 1041-1049.
Pontius Jr, R.G., Huffaker, D. & K. Denman (2004): Useful Techniques of Validation for Spatially Explicit Land-Change Models. In: Ecological Modelling, vol. 179, no. 4, pp. 445-461.
The following input parameters/images are required:

Furthermore the following outputs are created:
Other important values are written to the status output window!

Version:
1.0
Author:
Roland Goetzke
See Also:
MultipleResolutionValidationContentManager

Field Summary
protected  MultipleResolutionValidationContentManager contManager
          Saves the ContentManager for the model.
 
Fields inherited from class edu.bonn.xulu.model.AbstractStepModel
stepCount
 
Fields inherited from class edu.bonn.xulu.model.AbstractXuluModel
disposed, events, initialised, listeners, modelResourceProvider, running, statusOut, stopped
 
Constructor Summary
MultipleResolutionValidation()
          Creates a new model instance.
 
Method Summary
 void performModelDispose()
          like in every model: frees the resources
 void performModelInit()
          Initializes the model.
 void performModelStep(int stepNo)
          Performs the MRV.
 
Methods inherited from class edu.bonn.xulu.model.AbstractStepModel
fireModelStepFinished, fireModelStepStarted, getStepCount, performModelStart
 
Methods inherited from class edu.bonn.xulu.model.AbstractXuluModel
addModelListener, checkBreakingCommands, determineCaption, disposeModel, fireModelDisposed, fireModelEvent, fireModelInitialised, fireModelStarted, fireModelStopped, getContentManager, getEvents, getModelSpecificGUI, getResourceProvider, getStatusOut, initModel, isDisposed, isInitialised, isRunning, isStopped, performError, releaseAccess, removeModelListener, resetCaptions, setStatusOut, startModelling, stopModelling
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface edu.bonn.xulu.model.XuluModel
addModelListener, disposeModel, getContentManager, getEvents, getModelSpecificGUI, getResourceProvider, getStatusOut, initModel, isDisposed, isInitialised, isRunning, isStopped, performError, removeModelListener, setStatusOut, startModelling, stopModelling
 

Field Detail

contManager

protected MultipleResolutionValidationContentManager contManager
Saves the ContentManager for the model.

See Also:
MultipleResolutionValidationContentManager
Constructor Detail

MultipleResolutionValidation

public MultipleResolutionValidation()
Creates a new model instance.

Method Detail

performModelInit

public void performModelInit()
Initializes the model. Like in the init method of every XuluModel the resources are initalized.

Specified by:
performModelInit in class AbstractXuluModel

performModelDispose

public void performModelDispose()
like in every model: frees the resources

Specified by:
performModelDispose in class AbstractXuluModel

performModelStep

public void performModelStep(int stepNo)
Performs the MRV. The function is implemented as a Xulu Step Model, but actually does not need any time steps. So the stepNo MUST always be 1. The steps of the coarsening procedure are defined inside of the function. When using a MRV parameter file simply use 1 for the number of steps.

Specified by:
performModelStep in interface StepModel
Specified by:
performModelStep in class AbstractStepModel
Parameters:
stepNo - Nummer des Modellschritts (beginnend bei 1)