org.universAAL.ontology.location.position
Class Point

java.lang.Object
  org.universAAL.middleware.rdf.Resource
      org.universAAL.middleware.rdf.FinalizedResource
          org.universAAL.middleware.owl.ManagedIndividual
              org.universAAL.middleware.owl.ComparableIndividual
                  org.universAAL.middleware.owl.supply.AbsLocation
                      org.universAAL.ontology.location.Location
                          org.universAAL.ontology.location.position.Point

All Implemented Interfaces:

Comparable

public class Point
extends Location

Ontological representation of an exact point in a geometric coordinate system. Methods included in this class are the mandatory ones for representing an ontological concept in Java classes for uAAL. Usually it includes getters and setters for most of its properties.

Author:

chwirth

Field Summary

static double	EARTH_QUADRATIC_MEAN_RADIUS
static int	INTERSECTING
static String	MY_URI
static int	NOT_COMPUTABLE_DISTANCE
static String	PROP_COORDINATE_SYSTEM
static String	PROP_X
static String	PROP_Y
static String	PROP_Z

Fields inherited from class org.universAAL.ontology.location.Location

PROP_CONTAINS, PROP_HAS_NAME, PROP_IS_ADJACENT_TO, PROP_IS_CONNECTED_TO, PROP_IS_CONTAINED_IN

Fields inherited from class org.universAAL.middleware.owl.ComparableIndividual

NON_COMPARABLE_INDIVIDUALS

Fields inherited from class org.universAAL.middleware.owl.ManagedIndividual

OWL_NAMESPACE, TYPE_OWL_INDIVIDUAL, TYPE_OWL_THING

Fields inherited from class org.universAAL.middleware.rdf.Resource

ANON_URI_PREFIX, blockAddingTypes, isXMLLiteral, ns_delim_index, PROP_RDF_FIRST, PROP_RDF_REST, PROP_RDF_TYPE, PROP_RDFS_COMMENT, PROP_RDFS_LABEL, PROP_SERIALIZATION_FULL, PROP_SERIALIZATION_OPTIONAL, PROP_SERIALIZATION_REDUCED, PROP_SERIALIZATION_UNDEFINED, PROP_uAAL_INVOLVED_HUMAN_USER, props, RDF_EMPTY_LIST, RDF_NAMESPACE, RDFS_NAMESPACE, TYPE_RDF_LIST, TYPE_RDFS_CLASS, uAAL_NAMESPACE_PREFIX, uAAL_SERVICE_NAMESPACE, uAAL_VOCABULARY_NAMESPACE, uri

Constructor Summary

Point()
Constructor just for usage by de-serializers.

Point(double x, double y, CoordinateSystem system)

Point(double x, double y, double z, CoordinateSystem system)

Point(String uri)
Constructor just for usage by de-serializers.

Point(String uri, double x, double y, CoordinateSystem system)
Point constructor.

Point(String uri, double x, double y, double z, CoordinateSystem system)
Point constructor.

Method Summary

void	castTo3D() ensures a valid z value
double[]	get2DCoordinates()
double[]	get3DCoordinates()
String	getClassURI() Get the class URI for this ManagedIndividual.
CoordinateSystem	getCoordinateSystem()
float	getDistanceTo(Location other) Both points have to be in the same CoordinateSystem If the System is WGS84, a point in latitude/longitude is assume If not, the euclidean distance is returned.
Point	getInHigherCoordinateSystem() if the point is in a OriginedMetric, the point will be transformed to the next higher system A 2d point gets transformed to a 3d point, because all non local coordinate systems are 3d
Point	getInHigherCoordinateSystem(CoordinateSystem system) if the point is in a OriginedMetric, the point will be transformed to the given higher system A 2d point gets transformed to a 3d point, because all non local coordinate systems are 3d
int	getPropSerializationType(String propURI) Answers if the given property has to be considered when serializing this individual in a minimized way, and if not ignore-able, whether its value should be presented in its full form or can be reduced.
double	getX()
double	getY()
double	getZ()
boolean	is2D()
boolean	isWellFormed() Returns true, if the state of the resource is valid, otherwise false.
void	set2DCoordinates(double x, double y)
void	set3DCoordinates(double x, double y, double z)
void	setCoordinateSystem(CoordinateSystem system)
void	setZ(double z)
String	toString() Get a String representation of this Resource; returns the URI.

Methods inherited from class org.universAAL.ontology.location.Location

addAdjacentLocation, addConnectedLocation, addContainedLocation, clearAdjacentLocations, clearConnectedLocations, clearContainedLocations, clearContainingLocations, compareTo, getAdjacentLocations, getConnectedLocations, getContainedLocations, getContainingLocation, getDistanceTo, getNext, getPrevious, hasConnectionTo, isAdjacentTo, ord, removeAdjacentLocation, removeConnectedLocation, removeContainedLocation, setContainingLocation, setProperty

Methods inherited from class org.universAAL.middleware.owl.ComparableIndividual

equal, getClassMaximum, getClassMaximum, getClassMinimum, getClassMinimum, getMaximum, getMinimum, greater, greaterEqual, less, lessEqual

Methods inherited from class org.universAAL.middleware.owl.ManagedIndividual

checkCompatibility, checkMembership, copy, deepCopy, getClassRestrictionsOnProperty, getInstance, getNonAbstractSuperClasses, getNonabstractSuperClasses, getOntClassInfo, getTypeURI, isRegisteredClassURI, setPropertyPathFromOffset, toManagedIndividual

Methods inherited from class org.universAAL.middleware.rdf.FinalizedResource

addType, getLocalName, getNamespace, getProperty, getPropertyURIs, getType, getTypes, getURI, hasQualifiedName, isAnon, numberOfProperties

Methods inherited from class org.universAAL.middleware.rdf.Resource

addMultiLangProp, asList, asList, asRDFList, changeProperty, equals, generateAnonURI, getDefaultLang, getFilename, getMultiLangProp, getOrConstructLabel, getResource, getResourceComment, getResourceLabel, getStaticFieldValue, hashCode, hasProperty, isAnon, isBlockingAddingTypes, isClosedCollection, isQualifiedName, literal, representsQualifiedURI, serializesAsXMLLiteral, setPropertyPath, setPropertyPath, setResourceComment, setResourceLabel, toStringRecursive, toStringRecursive, unliteral

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

MY_URI

public static final String MY_URI

See Also:

Constant Field Values

PROP_X

public static final String PROP_X

See Also:

Constant Field Values

PROP_Y

public static final String PROP_Y

See Also:

Constant Field Values

PROP_Z

public static final String PROP_Z

See Also:

Constant Field Values

PROP_COORDINATE_SYSTEM

public static final String PROP_COORDINATE_SYSTEM

See Also:

Constant Field Values

NOT_COMPUTABLE_DISTANCE

public static final int NOT_COMPUTABLE_DISTANCE

See Also:

Constant Field Values

INTERSECTING

public static final int INTERSECTING

See Also:

Constant Field Values

EARTH_QUADRATIC_MEAN_RADIUS

public static final double EARTH_QUADRATIC_MEAN_RADIUS

See Also:

Constant Field Values

Constructor Detail

Point

public Point()

Constructor just for usage by de-serializers. Do not use this constructor within applications as it may lead to incomplete instances that cause exceptions.

Point

public Point(String uri)

Constructor just for usage by de-serializers. Do not use this constructor within applications as it may lead to incomplete instances that cause exceptions.

Point

public Point(String uri,
             double x,
             double y,
             double z,
             CoordinateSystem system)

Point constructor.

Parameters:

uri - The ontological object URI

x -

y -

z -

system - the coordinate system of the point

Point

public Point(double x,
             double y,
             double z,
             CoordinateSystem system)

Point

public Point(double x,
             double y,
             CoordinateSystem system)

Point

public Point(String uri,
             double x,
             double y,
             CoordinateSystem system)

Point constructor.

Parameters:

uri - The ontological object URI

x -

y -

system - the coordinate system of the point

Method Detail

getClassURI

public String getClassURI()

Description copied from class: ManagedIndividual

Get the class URI for this ManagedIndividual. All non-abstract subclasses MUST overwrite this method!

Overrides:

getClassURI in class Location

Returns:

The class URI.

See Also:

ManagedIndividual.getClassURI()

getPropSerializationType

public int getPropSerializationType(String propURI)

Description copied from class: ManagedIndividual

Answers if the given property has to be considered when serializing this individual in a minimized way, and if not ignore-able, whether its value should be presented in its full form or can be reduced. The return value must be one of Resource.PROP_SERIALIZATION_OPTIONAL, Resource.PROP_SERIALIZATION_REDUCED, or Resource.PROP_SERIALIZATION_FULL. It can be assumed that the given property is one of those returned by FinalizedResource.getPropertyURIs(). Decision criterion should be if the value of this property is absolutely necessary when this resource is being sent to a remote node. If the subclass rates it as unlikely that the receiver side would need this info, the answer should be PROP_SERIALIZATION_OPTIONAL in favor of lower communication traffic and higher performance even at risk of a possible additional query on the receiver side for fetching this info. With the same rationale, if a property should be included in the process of serialization, it is preferable to include it in a reduced form; in this case the return value should be PROP_SERIALIZATION_REDUCED, otherwise PROP_SERIALIZATION_FULL can be returned.

Overrides:

getPropSerializationType in class Location

get3DCoordinates

public double[] get3DCoordinates()

Returns:

the double array {x, y, z}.If the point z property is missing the method assumes that it is zero.

get2DCoordinates

public double[] get2DCoordinates()

Returns:

the double array {x, y}

getZ

public double getZ()

getX

public double getX()

getY

public double getY()

set2DCoordinates

public void set2DCoordinates(double x,
                             double y)

set3DCoordinates

public void set3DCoordinates(double x,
                             double y,
                             double z)

setZ

public void setZ(double z)

setCoordinateSystem

public void setCoordinateSystem(CoordinateSystem system)

getCoordinateSystem

public CoordinateSystem getCoordinateSystem()

isWellFormed

public boolean isWellFormed()

Description copied from class: Resource

Returns true, if the state of the resource is valid, otherwise false.

Subclasses should overwrite this methods as the default implementation returns always true.

Overrides:

isWellFormed in class ManagedIndividual

See Also:

Resource.isWellFormed()

getDistanceTo

public float getDistanceTo(Location other)

Both points have to be in the same CoordinateSystem If the System is WGS84, a point in latitude/longitude is assume If not, the euclidean distance is returned.

getInHigherCoordinateSystem

public Point getInHigherCoordinateSystem()

if the point is in a OriginedMetric, the point will be transformed to the next higher system A 2d point gets transformed to a 3d point, because all non local coordinate systems are 3d

Returns:

the point

getInHigherCoordinateSystem

public Point getInHigherCoordinateSystem(CoordinateSystem system)

if the point is in a OriginedMetric, the point will be transformed to the given higher system A 2d point gets transformed to a 3d point, because all non local coordinate systems are 3d

Parameters:

system - the target system

Returns:

the point or null if the target system is not part of the higher coordinate systems chain

toString

public String toString()

Description copied from class: Resource

Get a String representation of this Resource; returns the URI.

Overrides:

toString in class Resource

is2D

public boolean is2D()

Returns:

true, if the point is defined by only two values

castTo3D

public void castTo3D()

ensures a valid z value