edu.bonn.xulu.plugin.model.mrv
Class MultipleResolutionValidation
java.lang.Object
AbstractNamedObject
edu.bonn.xulu.model.AbstractXuluModel
edu.bonn.xulu.model.AbstractStepModel
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:
- Number of Steps (
steps
): Because this plugin is built as a step model, the number of (time) steps always has to be 1.
- Reference Map (
referenceMap
): A raster containing the reference (observed) land cover.
- Simulation Map (
simulationMap
): A raster containing the simulated land cover.
Furthermore the following outputs are created:
- Actual Validation (@code actualValidation): A raster containing the actual resolution grid with the fraction correct in every cell
- Out Step (
outStep
): A Grid List containing a grid (Actual Validation) for every resolution.
- Out Results (
outResults
): A list containing the total agreement for every resolution.
Other important values are written to the status output window!
- Version:
- 1.0
- Author:
- Roland Goetzke
- See Also:
MultipleResolutionValidationContentManager
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 |
contManager
protected MultipleResolutionValidationContentManager contManager
- Saves the ContentManager for the model.
- See Also:
MultipleResolutionValidationContentManager
MultipleResolutionValidation
public MultipleResolutionValidation()
- Creates a new model instance.
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)