#include <GridGeoConstraint.h>

Inheritance diagram for functions::GridGeoConstraint:

Collaboration diagram for functions::GridGeoConstraint:

Public Types
enum	LatitudeSense { unknown_sense , normal , inverted }

enum	Notation { unknown_notation , pos , neg_pos }

Public Member Functions
Constructors
	GridGeoConstraint (libdap::Grid *grid)
	Initialize GeoConstraint with a Grid.

	GridGeoConstraint (libdap::Grid grid, libdap::Array lat, libdap::Array *lon)

virtual	~GridGeoConstraint ()

virtual void	apply_constraint_to_data ()

virtual libdap::Grid *	get_constrained_grid () const

Accessors/Mutators
char *	get_array_data () const

int	get_array_data_size () const

double *	get_lat () const

double *	get_lon () const

void	set_lat (double *lat)

void	set_lon (double *lon)

int	get_lat_length () const

int	get_lon_length () const

void	set_lat_length (int len)

void	set_lon_length (int len)

libdap::Array::Dim_iter	get_lon_dim () const

libdap::Array::Dim_iter	get_lat_dim () const

void	set_lon_dim (libdap::Array::Dim_iter lon)

void	set_lat_dim (libdap::Array::Dim_iter lat)

int	get_latitude_index_top () const

int	get_latitude_index_bottom () const

void	set_latitude_index_top (int top)

void	set_latitude_index_bottom (int bottom)

int	get_longitude_index_left () const

int	get_longitude_index_right () const

void	set_longitude_index_left (int left)

void	set_longitude_index_right (int right)

bool	is_bounding_box_set () const

bool	is_longitude_rightmost () const

void	set_longitude_rightmost (bool state)

Notation	get_longitude_notation () const

LatitudeSense	get_latitude_sense () const

void	set_longitude_notation (Notation n)

void	set_latitude_sense (LatitudeSense l)

set< string >	get_coards_lat_units () const

set< string >	get_coards_lon_units () const

set< string >	get_lat_names () const

set< string >	get_lon_names () const

void	set_bounding_box (double top, double left, double bottom, double right)

Protected Member Functions
virtual LatitudeSense	categorize_latitude () const

Notation	categorize_notation (const double left, const double right) const

void	find_latitude_indeces (double top, double bottom, LatitudeSense sense, int &latitude_index_top, int &latitude_index_bottom) const

void	find_longitude_indeces (double left, double right, int &longitude_index_left, int &longitude_index_right) const

virtual void	flip_latitude_within_array (libdap::Array &a, int lat_length, int lon_length)

virtual bool	is_bounding_box_valid (const double left, const double top, const double right, const double bottom) const

virtual void	reorder_data_longitude_axis (libdap::Array &a, libdap::Array::Dim_iter lon_dim)

virtual void	reorder_longitude_map (int longitude_index_left)

void	transform_constraint_to_pos_notation (double &left, double &right) const

virtual void	transform_longitude_to_neg_pos_notation ()

virtual void	transform_longitude_to_pos_notation ()

virtual void	transpose_vector (double *src, const int length)

Friends
class	GridGeoConstraintTest

Detailed Description

Geographical constraint applied to a grid.

Author: James Gallagher

Definition at line 45 of file GridGeoConstraint.h.

Member Enumeration Documentation

◆ LatitudeSense

enum functions::GeoConstraint::LatitudeSense

inherited

Most of the time, latitude starts at the top of an array with positive values and ends up at the bottom with negative ones. But sometimes... the world is upside down.

Enumerator
unknown_sense
normal
inverted

Definition at line 106 of file GeoConstraint.h.

◆ Notation

enum functions::GeoConstraint::Notation

inherited

The longitude extents of the constraint bounding box can be expressed two ways: using a 0/359 notation and using a -180/179 notation. I call the 0/359 notation 'pos' and the -180/179 notation 'neg_pos'.

Enumerator
unknown_notation
pos
neg_pos

Definition at line 101 of file GeoConstraint.h.

Constructor & Destructor Documentation

◆ GridGeoConstraint() [1/2]

functions::GridGeoConstraint::GridGeoConstraint ( libdap::Grid * grid )

Initialize GeoConstraint with a Grid.

Parameters

grid	Set the GeoConstraint to use this Grid variable. It is the caller's responsibility to ensure that the value grid is a valid Grid variable.

Definition at line 58 of file GridGeoConstraint.cc.

◆ GridGeoConstraint() [2/2]

functions::GridGeoConstraint::GridGeoConstraint	(	libdap::Grid *	grid,
		libdap::Array *	lat,
		libdap::Array *	lon )

Definition at line 73 of file GridGeoConstraint.cc.

◆ ~GridGeoConstraint()

virtual functions::GridGeoConstraint::~GridGeoConstraint ( )

inlinevirtual

Definition at line 68 of file GridGeoConstraint.h.

Member Function Documentation

◆ apply_constraint_to_data()

void functions::GridGeoConstraint::apply_constraint_to_data ( )

virtual

Once the bounding box is set use this method to apply the constraint. This modifies the data values in the Grid so that the software in Vector::serialize() will work correctly. Vector::serialize() assumes that the BaseType::read() method is called after the projection is applied to the data. That is, the projection is applied, then data are read. but geogrid() first reads all the data values and then computes the projection. To make Vector::serialize() work, this method uses the projection information recorded in the Grid by set_bounding_box() to arrange data so that the information to be sent is all that is held by the Grid. Call this after applying any 'Grid selection expressions' of the sort that can be passed to the grid() function.

Note: Why do this here? The grid() function uses the standard logic in Vector and elsewhere to read data that's to be sent. The problem is that the data values need to be reordered using information only this object has. If this were implemented as a 'selection function' (i.e., if the code was run by ConstraintExpression::eval() then we might be able to better optimize how data are read, but in this case we have read all the data and may have already reorganized it). Set up the internal buffers so they hold the correct values and mark the Grid's array and lat/lon maps as read.

Implements functions::GeoConstraint.

Definition at line 264 of file GridGeoConstraint.cc.

◆ categorize_latitude()

GeoConstraint::LatitudeSense functions::GeoConstraint::categorize_latitude ( ) const

protectedvirtualinherited

Take a look at the latitude vector values and record whether the world is normal or upside down.

Returns: normal or inverted.

Definition at line 307 of file GeoConstraint.cc.

◆ categorize_notation()

GeoConstraint::Notation functions::GeoConstraint::categorize_notation	(	const double	left,
		const double	right ) const

protectedinherited

A private method that determines if the longitude part of the bounding box uses 0/359 or -180/179 notation. This class only supports latitude constraints which use 90/-90 notation, so there's no need to figure out what sort of notation they use.

Note: This function assumes that if one of the two values is negative, then the notation is or the -180/179 form, otherwise not. If the user asks for 30 degrees to 50 degrees (or 50 to 30, for that matter), there's no real way to tell which notation they are using.

Parameters

left	The left side of the bounding box, in degrees
right	The right side of the bounding box

Returns: The notation (pos or neg_pos)

Definition at line 97 of file GeoConstraint.cc.

◆ find_latitude_indeces()

void functions::GeoConstraint::find_latitude_indeces	(	double	top,
		double	bottom,
		LatitudeSense	sense,
		int &	latitude_index_top,
		int &	latitude_index_bottom ) const

protectedinherited

Scan from the top to the bottom, and the bottom to the top, looking for the top and bottom bounding box edges, respectively.

Parameters

top	The top edge of the bounding box
bottom	The bottom edge
sense	Does the array/grid store data with larger latitudes at the starting indices or are the latitude 'upside down?'
latitude_index_top	Value-result parameter that holds the index in the grid's latitude map of the top bounding box edge. Uses a closed interval for the test.
latitude_index_bottom	Value-result parameter for the bottom edge index.

Definition at line 261 of file GeoConstraint.cc.

◆ find_longitude_indeces()

void functions::GeoConstraint::find_longitude_indeces	(	double	left,
		double	right,
		int &	longitude_index_left,
		int &	longitude_index_right ) const

protectedinherited

Scan from the left to the right, and the right to the left, looking for the left and right bounding box edges, respectively.

Parameters

left	The left edge of the bounding box
right	The right edge
longitude_index_left	Value-result parameter that holds the index in the grid's longitude map of the left bounding box edge. Uses a closed interval for the test.
longitude_index_right	Value-result parameter for the right edge index.

Definition at line 184 of file GeoConstraint.cc.

◆ flip_latitude_within_array()

void functions::GeoConstraint::flip_latitude_within_array	(	libdap::Array &	a,
		int	lat_length,
		int	lon_length )

protectedvirtualinherited

Definition at line 358 of file GeoConstraint.cc.

◆ get_array_data()

char * functions::GeoConstraint::get_array_data ( ) const

inlineinherited

Definition at line 204 of file GeoConstraint.h.

◆ get_array_data_size()

int functions::GeoConstraint::get_array_data_size ( ) const

inlineinherited

Definition at line 205 of file GeoConstraint.h.

◆ get_coards_lat_units()

set< string > functions::GeoConstraint::get_coards_lat_units ( ) const

inlineinherited

Definition at line 242 of file GeoConstraint.h.

◆ get_coards_lon_units()

set< string > functions::GeoConstraint::get_coards_lon_units ( ) const

inlineinherited

Definition at line 243 of file GeoConstraint.h.

◆ get_constrained_grid()

virtual libdap::Grid * functions::GridGeoConstraint::get_constrained_grid ( ) const

inlinevirtual

Definition at line 72 of file GridGeoConstraint.h.

◆ get_lat()

double * functions::GeoConstraint::get_lat ( ) const

inlineinherited

Definition at line 207 of file GeoConstraint.h.

◆ get_lat_dim()

libdap::Array::Dim_iter functions::GeoConstraint::get_lat_dim ( ) const

inlineinherited

Definition at line 218 of file GeoConstraint.h.

◆ get_lat_length()

int functions::GeoConstraint::get_lat_length ( ) const

inlineinherited

Definition at line 212 of file GeoConstraint.h.

◆ get_lat_names()

set< string > functions::GeoConstraint::get_lat_names ( ) const

inlineinherited

Definition at line 245 of file GeoConstraint.h.

◆ get_latitude_index_bottom()

int functions::GeoConstraint::get_latitude_index_bottom ( ) const

inlineinherited

Definition at line 224 of file GeoConstraint.h.

◆ get_latitude_index_top()

int functions::GeoConstraint::get_latitude_index_top ( ) const

inlineinherited

Definition at line 223 of file GeoConstraint.h.

◆ get_latitude_sense()

LatitudeSense functions::GeoConstraint::get_latitude_sense ( ) const

inlineinherited

Definition at line 238 of file GeoConstraint.h.

◆ get_lon()

double * functions::GeoConstraint::get_lon ( ) const

inlineinherited

Definition at line 208 of file GeoConstraint.h.

◆ get_lon_dim()

libdap::Array::Dim_iter functions::GeoConstraint::get_lon_dim ( ) const

inlineinherited

Definition at line 217 of file GeoConstraint.h.

◆ get_lon_length()

int functions::GeoConstraint::get_lon_length ( ) const

inlineinherited

Definition at line 213 of file GeoConstraint.h.

◆ get_lon_names()

set< string > functions::GeoConstraint::get_lon_names ( ) const

inlineinherited

Definition at line 246 of file GeoConstraint.h.

◆ get_longitude_index_left()

int functions::GeoConstraint::get_longitude_index_left ( ) const

inlineinherited

Definition at line 228 of file GeoConstraint.h.

◆ get_longitude_index_right()

int functions::GeoConstraint::get_longitude_index_right ( ) const

inlineinherited

Definition at line 229 of file GeoConstraint.h.

◆ get_longitude_notation()

Notation functions::GeoConstraint::get_longitude_notation ( ) const

inlineinherited

Definition at line 237 of file GeoConstraint.h.

◆ is_bounding_box_set()

bool functions::GeoConstraint::is_bounding_box_set ( ) const

inlineinherited

Definition at line 233 of file GeoConstraint.h.

◆ is_bounding_box_valid()

bool functions::GeoConstraint::is_bounding_box_valid	(	const double	left,
		const double	top,
		const double	right,
		const double	bottom ) const

protectedvirtualinherited

Definition at line 155 of file GeoConstraint.cc.

◆ is_longitude_rightmost()

bool functions::GeoConstraint::is_longitude_rightmost ( ) const

inlineinherited

Definition at line 234 of file GeoConstraint.h.

◆ reorder_data_longitude_axis()

void functions::GeoConstraint::reorder_data_longitude_axis	(	libdap::Array &	a,
		libdap::Array::Dim_iter	lon_dim )

protectedvirtualinherited

Reorder the data values relative to the longitude axis so that the reordered longitude map (see GeoConstraint::reorder_longitude_map()) and the data values match.

Note: This should be called with the Array that contains the d_lon_dim Array::Dim_iter.; This method must set the d_array_data and d_array_data_size fields. If those are set, apply_constraint_to_data() will use those values.; First set all the other constraints, including the latitude and then make this call. Other constraints, besides latitude, will be simple range constraints. Latitude might require that values be flipped, but that can be done after the longitude reordering takes place.

Todo: Fix this code so that it works with latitude as the rightmost map

Definition at line 434 of file GeoConstraint.cc.

◆ reorder_longitude_map()

void functions::GeoConstraint::reorder_longitude_map ( int longitude_index_left )

protectedvirtualinherited

Reorder the elements in the longitude map so that the longitude constraint no longer crosses the edge of the map's storage. The d_lon field is modified.

Note: The d_lon vector always has double values regardless of the type of d_longitude.

Parameters

longitude_index_left The left edge of the bounding box.

Definition at line 399 of file GeoConstraint.cc.

◆ set_bounding_box()

void functions::GeoConstraint::set_bounding_box	(	double	top,
		double	left,
		double	bottom,
		double	right )

inherited

Set the bounding box for this constraint. After calling this method the object has values for the indexes for the latitude and longitude extent as well as the sense of the latitude (south pole at the top or bottom of the Array or Grid). These are used by the apply_constraint_to_data() method to actually constrain the data.

Parameters

left	The left side of the bounding box.
right	The right side
top	The top
bottom	The bottom

Definition at line 541 of file GeoConstraint.cc.

◆ set_lat()

void functions::GeoConstraint::set_lat ( double * lat )

inlineinherited

Definition at line 209 of file GeoConstraint.h.

◆ set_lat_dim()

void functions::GeoConstraint::set_lat_dim ( libdap::Array::Dim_iter lat )

inlineinherited

Definition at line 220 of file GeoConstraint.h.

◆ set_lat_length()

void functions::GeoConstraint::set_lat_length ( int len )

inlineinherited

Definition at line 214 of file GeoConstraint.h.

◆ set_latitude_index_bottom()

void functions::GeoConstraint::set_latitude_index_bottom ( int bottom )

inlineinherited

Definition at line 226 of file GeoConstraint.h.

◆ set_latitude_index_top()

void functions::GeoConstraint::set_latitude_index_top ( int top )

inlineinherited

Definition at line 225 of file GeoConstraint.h.

◆ set_latitude_sense()

void functions::GeoConstraint::set_latitude_sense ( LatitudeSense l )

inlineinherited

Definition at line 240 of file GeoConstraint.h.

◆ set_lon()

void functions::GeoConstraint::set_lon ( double * lon )

inlineinherited

Definition at line 210 of file GeoConstraint.h.

◆ set_lon_dim()

void functions::GeoConstraint::set_lon_dim ( libdap::Array::Dim_iter lon )

inlineinherited

Definition at line 219 of file GeoConstraint.h.

◆ set_lon_length()

void functions::GeoConstraint::set_lon_length ( int len )

inlineinherited

Definition at line 215 of file GeoConstraint.h.

◆ set_longitude_index_left()

void functions::GeoConstraint::set_longitude_index_left ( int left )

inlineinherited

Definition at line 230 of file GeoConstraint.h.

◆ set_longitude_index_right()

void functions::GeoConstraint::set_longitude_index_right ( int right )

inlineinherited

Definition at line 231 of file GeoConstraint.h.

◆ set_longitude_notation()

void functions::GeoConstraint::set_longitude_notation ( Notation n )

inlineinherited

Definition at line 239 of file GeoConstraint.h.

◆ set_longitude_rightmost()

void functions::GeoConstraint::set_longitude_rightmost ( bool state )

inlineinherited

Definition at line 235 of file GeoConstraint.h.

◆ transform_constraint_to_pos_notation()

void functions::GeoConstraint::transform_constraint_to_pos_notation	(	double &	left,
		double &	right ) const

protectedinherited

Definition at line 115 of file GeoConstraint.cc.

◆ transform_longitude_to_neg_pos_notation()

void functions::GeoConstraint::transform_longitude_to_neg_pos_notation ( )

protectedvirtualinherited

Given that the Grid has a longitude map that uses the 'pos' notation, transform it to the 'neg_pos' notation. This method modifies the d_lon array.

Note: : About the two notations: 0 180 360 |------------------------—|----------------------—| 0 180,-180 0

Definition at line 149 of file GeoConstraint.cc.

◆ transform_longitude_to_pos_notation()

void functions::GeoConstraint::transform_longitude_to_pos_notation ( )

protectedvirtualinherited

Given that the Grid has a longitude map that uses the 'neg_pos' notation, transform it to the 'pos' notation. This method modifies the d_lon array.

Note: : About the two notations: 0 180 360 |------------------------—|----------------------—| 0 180,-180 0

Definition at line 131 of file GeoConstraint.cc.

◆ transpose_vector()

void functions::GeoConstraint::transpose_vector	(	double *	src,
		const int	length )

protectedvirtualinherited

Given a vector of doubles, transpose the elements. Use this to flip the latitude vector for a Grid that stores the southern latitudes at the top instead of the bottom.

Parameters

src	A pointer to the vector
length	The number of elements in the vector

Definition at line 335 of file GeoConstraint.cc.

Friends And Related Symbol Documentation

◆ GridGeoConstraintTest

friend class GridGeoConstraintTest

friend

Definition at line 59 of file GridGeoConstraint.h.

The documentation for this class was generated from the following files:

Public Types

Public Member Functions

Protected Member Functions

Friends

Detailed Description

Member Enumeration Documentation

◆ LatitudeSense

◆ Notation

Constructor & Destructor Documentation

◆ GridGeoConstraint() [1/2]

◆ GridGeoConstraint() [2/2]

◆ ~GridGeoConstraint()

Member Function Documentation

◆ apply_constraint_to_data()

◆ categorize_latitude()

◆ categorize_notation()

◆ find_latitude_indeces()

◆ find_longitude_indeces()

◆ flip_latitude_within_array()

◆ get_array_data()

◆ get_array_data_size()

◆ get_coards_lat_units()

◆ get_coards_lon_units()

◆ get_constrained_grid()

◆ get_lat()

◆ get_lat_dim()

◆ get_lat_length()

◆ get_lat_names()

◆ get_latitude_index_bottom()

◆ get_latitude_index_top()

◆ get_latitude_sense()

◆ get_lon()

◆ get_lon_dim()

◆ get_lon_length()

◆ get_lon_names()

◆ get_longitude_index_left()

◆ get_longitude_index_right()

◆ get_longitude_notation()

◆ is_bounding_box_set()

◆ is_bounding_box_valid()

◆ is_longitude_rightmost()

◆ reorder_data_longitude_axis()

◆ reorder_longitude_map()

◆ set_bounding_box()

◆ set_lat()

◆ set_lat_dim()

◆ set_lat_length()

◆ set_latitude_index_bottom()

◆ set_latitude_index_top()

◆ set_latitude_sense()

◆ set_lon()

◆ set_lon_dim()

◆ set_lon_length()

◆ set_longitude_index_left()

◆ set_longitude_index_right()

◆ set_longitude_notation()

◆ set_longitude_rightmost()

◆ transform_constraint_to_pos_notation()

◆ transform_longitude_to_neg_pos_notation()

◆ transform_longitude_to_pos_notation()

◆ transpose_vector()

Friends And Related Symbol Documentation

◆ GridGeoConstraintTest