spmd/split/SplittableResource.java

package appl.parallel.spmd.split;

import java.awt.Rectangle;

import org.w3c.dom.css.Rect;

import appl.data.DataLoader;

/**
 * A resource that is splittable must provide some information to work with {@link SplitMap}s.
 * Important is the with and the height of the resource to be splitted.
 *
 *
 * @author Dominik Appl
 */
public interface SplittableResource extends DataPartition {
        /**
         * Should return a unique ID for this resource. Standard implementation
         * would be returning the {@link Object#hashCode() hashcode} of the object.
         *
         * @return a ID which is unique for this client
         *
         */
        public int getRootID();

        /**
         * Returns the loader which is responible for loading the data. This loader should be
         * independet from the current system. This means that, e.g. for a loader which
         * loads a grid from filesystem, that all paths should be relative (and not
         * absolute), so that a possibly remote resource can load the data from its local
         * filesystem, if the data is stored in the same position relative to the home
         * directory.
         *
         * @return a loader for this resource.
         */
        public DataLoader getLocalLoader();

        /**
         * @return the splittable is splitted according to its splitHeight (example: the height of a raster)
         * */
        public int getSplitHeight();

        /**
         * @return the splittable is splitted according to its splitWidth  (example: the width of a raster or the length of an array)
         * */
        public int getSplitWidth();
}
1	mojays	2	package appl.parallel.spmd.split;
2
3			import java.awt.Rectangle;
4
5			import org.w3c.dom.css.Rect;
6
7			import appl.data.DataLoader;
8
9			/**
10			* A resource that is splittable must provide some information to work with {@link SplitMap}s.
11			* Important is the with and the height of the resource to be splitted.
12			*
13			*
14			* @author Dominik Appl
15			*/
16			public interface SplittableResource extends DataPartition {
17			/**
18			* Should return a unique ID for this resource. Standard implementation
19			* would be returning the {@link Object#hashCode() hashcode} of the object.
20			*
21			* @return a ID which is unique for this client
22			*
23			*/
24			public int getRootID();
25
26			/**
27			* Returns the loader which is responible for loading the data. This loader should be
28			* independet from the current system. This means that, e.g. for a loader which
29			* loads a grid from filesystem, that all paths should be relative (and not
30			* absolute), so that a possibly remote resource can load the data from its local
31			* filesystem, if the data is stored in the same position relative to the home
32			* directory.
33			*
34			* @return a loader for this resource.
35			*/
36			public DataLoader getLocalLoader();
37
38			/**
39			* @return the splittable is splitted according to its splitHeight (example: the height of a raster)
40			* */
41			public int getSplitHeight();
42
43			/**
44			* @return the splittable is splitted according to its splitWidth (example: the width of a raster or the length of an array)
45			* */
46			public int getSplitWidth();
47			}