fact.features.watershed

Class ClusterFellwalker

java.lang.Object

fact.features.watershed.ClusterFellwalker

All Implemented Interfaces:

stream.Processor

public class ClusterFellwalker
extends Object
implements stream.Processor

Field Summary

Fields

Modifier and Type	Field and Description
String	areaKey
String	arrivaltimePosKey
String	cogKey
int	minShowerpixel
String	morphologyKey
String	photonchargeKey
String	showerKey
String	sourcePositionKey

Constructor Summary

Constructors

Constructor and Description
ClusterFellwalker()

Method Summary

Modifier and Type	Method and Description
static double	boundAngleSum(FactCluster[] showerCluster)
static double	boundContentRatio(FactCluster[] showerCluster)
int	countAirPixel(ArrayList<Integer> gapPixel, int[] showerClusterID)
static double	distanceCenter(FactCluster[] showerCluster)
double	distanceCog(FactCluster[] showerCluster, double cogX, double cogY)
double	distanceSource(FactCluster[] showerCluster, CameraCoordinate sourcePosition)
int	findMaxChargeLargeNeighbour(int currentPixel, double[] photoncharge)
int	findMaxChargeNeighbour(ArrayList<CameraPixel> usableNeighbours, int currentPixel, double[] photoncharge)
void	findNeighbors(FactCluster[] showerSet, int[] showerClusterID)
static double	getChargeMaxCluster(FactCluster[] showerCluster)
static double	getMorphMaxCluster(FactCluster[] showerCluster)
static double	idealBoundDiff(FactCluster[] showerCluster)
static void	markBoundaryPixel(FactCluster[] clusterSet, int[] showerClusterID)
FactCluster	maxCluster(FactCluster[] showerCluster)
double	neighborClusterMean(FactCluster[] showerCluster)
int	NextStartPixel(int[] clusterID, int[] shower)
static void	pathToExistingCluster(int[] clusterID, ArrayList<Integer> aktuellerPfad, int clusterNum)
static void	pathToNewCluster(int[] clusterID, ArrayList<Integer> aktuellerPfad, int clusterNum)
stream.Data	process(stream.Data data)
FactCluster[]	removeCluster(FactCluster[] clusterSet, int minShowerpixel)
int	searchForCompactGroups(FactCluster[] showerCluster, int[] showerClusterID) Method to search for all neighbor clusters of all clusters in the camera image.
double	stdArrTime(FactCluster[] showerCluster, double[] arrivaltime)
static double	stdNumPixel(FactCluster[] showerCluster)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

minShowerpixel

@Parameter(required=false,
           description="Minimal number of pixels a cluster must contain to be labeled as \'showerCluster\'",
           defaultValue="2")
public int minShowerpixel

showerKey

@Parameter(required=true,
           description="Input key for pixel set (aka shower pixel). Used to keep/remove cluster if areaKey=null.")
public String showerKey

arrivaltimePosKey

@Parameter(required=false,
           description="Input key for arrivaltime positions",
           defaultValue="arrivalTimePos")
public String arrivaltimePosKey

photonchargeKey

@Parameter(required=false,
           description="Input key for calculated photon charge",
           defaultValue="photoncharge")
public String photonchargeKey

morphologyKey

@Parameter(required=false,
           description="Value chosen for clustering. Could be photoncharge, arrival times or mean correlation.",
           defaultValue="photoncharge")
public String morphologyKey

sourcePositionKey

@Parameter(required=false,
           description="Input key for soure position",
           defaultValue="sourcePositionKey")
public String sourcePositionKey

cogKey

@Parameter(description="Key to CameraCoordinate of the cog as calculated bei HillasParameters",
           defaultValue="cog")
public String cogKey

areaKey

@Parameter(required=false,
           description="Pixel set to cluster. If null, cluster all camera pixel; in that case decide which clusters should be kept via pixelSetKey",
           defaultValue="null")
public String areaKey

Constructor Detail

ClusterFellwalker

public ClusterFellwalker()

Method Detail

process

public stream.Data process(stream.Data data)

Specified by:

process in interface stream.Processor

NextStartPixel

public int NextStartPixel(int[] clusterID,
                          int[] shower)

findMaxChargeNeighbour

public int findMaxChargeNeighbour(ArrayList<CameraPixel> usableNeighbours,
                                  int currentPixel,
                                  double[] photoncharge)

findMaxChargeLargeNeighbour

public int findMaxChargeLargeNeighbour(int currentPixel,
                                       double[] photoncharge)

pathToNewCluster

public static void pathToNewCluster(int[] clusterID,
                                    ArrayList<Integer> aktuellerPfad,
                                    int clusterNum)

pathToExistingCluster

public static void pathToExistingCluster(int[] clusterID,
                                         ArrayList<Integer> aktuellerPfad,
                                         int clusterNum)

removeCluster

public FactCluster[] removeCluster(FactCluster[] clusterSet,
                                   int minShowerpixel)

markBoundaryPixel

public static void markBoundaryPixel(FactCluster[] clusterSet,
                                     int[] showerClusterID)

boundContentRatio

public static double boundContentRatio(FactCluster[] showerCluster)

idealBoundDiff

public static double idealBoundDiff(FactCluster[] showerCluster)

boundAngleSum

public static double boundAngleSum(FactCluster[] showerCluster)

distanceCenter

public static double distanceCenter(FactCluster[] showerCluster)

distanceCog

public double distanceCog(FactCluster[] showerCluster,
                          double cogX,
                          double cogY)

distanceSource

public double distanceSource(FactCluster[] showerCluster,
                             CameraCoordinate sourcePosition)

searchForCompactGroups

public int searchForCompactGroups(FactCluster[] showerCluster,
                                  int[] showerClusterID)

Method to search for all neighbor clusters of all clusters in the camera image. Two clusters are neighbors if there are no air pixels on the line between their cog's. "Air pixels" are the pixel on this line that don't belong to any shower-cluster. From the number of air-pixel one can conclude whether the clusters are neighbors, and, if not, how large the distance is between them. At the moment two clusters are marked as neighbors if there are no air-pixels between them. Keep in mind that currently clusters are marked as neighbors even if they are "indirect neighbors" (means they have a third cluster between them). In this case there are also no air pixel on the line between their cog's, because all pixel on this line belongs to a cluster. But maybe this is an opportunity to define another parameter for the whole image, something like "convexity". If there are no air pixel in the image at all, the group of clusters could be defined as convex. This makes sense probably only for images with more than two clusters. Returns the sum over all found air pixels as a parameter for convexity. Maybe it's not necessary to fill the distances between the clusters in lists... the resulting 'number of neighbors' from this method isn't really a number of neighbors (as found in findNeighbors); it's more like an estimation for the compactness of the clusters (how many clusters build a compact/connected group in the image). Therefore 'neighborDistance' and 'neighborClusters' could be misleading...

countAirPixel

public int countAirPixel(ArrayList<Integer> gapPixel,
                         int[] showerClusterID)

neighborClusterMean

public double neighborClusterMean(FactCluster[] showerCluster)

findNeighbors

public void findNeighbors(FactCluster[] showerSet,
                          int[] showerClusterID)

maxCluster

public FactCluster maxCluster(FactCluster[] showerCluster)

getMorphMaxCluster

public static double getMorphMaxCluster(FactCluster[] showerCluster)

getChargeMaxCluster

public static double getChargeMaxCluster(FactCluster[] showerCluster)

stdArrTime

public double stdArrTime(FactCluster[] showerCluster,
                         double[] arrivaltime)

stdNumPixel

public static double stdNumPixel(FactCluster[] showerCluster)