ComposedRegion1D Class Reference

This class is subject to change. Programs using this class may require changes with a new version of VirtualLab.
Public class which defines a region composed by several 1D subregions. These subregions are composed using logical operations like AND, OR, XOR, DIFF. More...

Inheritance diagram for ComposedRegion1D:

Public Member Functions
override object	Clone ()
	Deep copy of the object. More...
	ComposedRegion1D ()
	Default constructor creating a new composed region, containing a single interval region. The composition mode is initialized as Union (OR).
	ComposedRegion1D (ComposedRegion1D composedRegion1D)
	Copy constructor. More...
	ComposedRegion1D (List< Region1D > subRegions, LogicalOperationType compositionMode, bool boundariesAreInside=false, PhysicalProperty propertyOfCoordinates=PhysicalProperty.Length)
	Constructor getting all field parameters. More...
	ComposedRegion1D (SerializationInfo info, StreamingContext context)
	Deserialization constructor. See the ISerializable interface for more details. More...
override bool	Equals (object obj, EqualityIntent equalityIntent)
	Equality operator. More...
override double[]	GetCoordinatesOfActualSubregionBorders (ExtrapolationInfo extrapolation2use)
	Method that gets the coordinates where a real subregion starts or ends. It doesn't contain borders of subregions which are no real borders but only those, where the inside/outside state changes. More...
override InsideOutside	GetInOutRelation (double point, ExtrapolationInfo extrapolation2use=null)
	Method which checks whether or not a point lies inside or outside the 2D region or on its boundary. More...
override void	Save (string fileName)
	Save this region to a file with a given name. More...
override void	UpdatePropertyOfCoordinates ()
	Method for handling update after change of the physical property of the coordinate
Public Member Functions inherited from Region1D
override object	Clone ()
	Clones the current object. More...
override bool	Equals (object obj, EqualityIntent equalityIntent)
	Equality operation More...
abstract double[]	GetCoordinatesOfActualSubregionBorders (ExtrapolationInfo extrapolation2use)
	Method that gets the coordinates where a real subregion starts or ends. It doesn't contain borders of subregions which are no real borders but only those, where the inside/outside state changes. More...
abstract InsideOutside	GetInOutRelation (double point, ExtrapolationInfo extrapolation2use=null)
	Method which checks whether or not a point lies inside or outside the 1D region or on its boundary. More...
bool	IsInside (double point)
	Method which checks whether or not a point is inside the 1D region. More...
void	MayBeNonzeroOutside (out bool maybeNonZeroLeft, out bool maybeNonZeroRight)
	Method which determines whether or not the region can provide "inside" state outside of its boundary interval. This is not the case for extrapolation mode 'ConstantZero', of course. More...
	Region1D (bool boundariesAreInside, PhysicalProperty propertyOfCoordinates=PhysicalProperty.Length)
	Constructor which gets the _boundariesAreInside flag. To be called from derived classes constructors. More...
	Region1D (Region1D region2bCopied)
	Copy constructor. More...
	Region1D (SerializationInfo info, StreamingContext context)
	Deserialization constructor. See the ISerializable interface for more details. More...
virtual void	UpdatePropertyOfCoordinates ()
	Method for handling update after change of the physical property of the coordinate
bool	Equals (object otherObject, EqualityIntent equalityIntent)
	Determines whether the specified Object is equal to this instance. More...
Public Member Functions inherited from IDocument
void	Reload ()
	Reload function for the document

Static Public Member Functions
static bool	operator!= (ComposedRegion1D o1, ComposedRegion1D o2)
	Unequals operator. More...
static bool	operator== (ComposedRegion1D o1, ComposedRegion1D o2)
	Equals operator More...
Static Public Member Functions inherited from Region1D
static Region1D	InvertRegion (Region1D region2Invert)
	Creates a new region with inverted in / out regions compared to this. More...
static Region1D	Load (string fileName)
	Loads the specified file name. Works independently from whether the document has been saved without view settings (as prior to VL 6.0) or with view settings. More...
static bool	operator!= (Region1D o1, Region1D o2)
	Unequals operator. More...
static bool	operator== (Region1D o1, Region1D o2)
	Equals operator More...
static Region1D	Translate (Region1D regionToShift, double shift)
	Translates (shifts) a given region by a given value. More...

Properties
override PhysicalValueRange	BoundingInterval [get]
	Gets the bounding box for the composed region, including all regions it consists of. Its sides are parallel to the x- and y-axis resp.
LogicalOperationType	CompositionMode [get, set]
	The logical operation to be used as composition mode.
ReadOnlyCollection< Region1D >	SubRegions [get, set]
	Get or set the list of subregions (as read-only list).
Properties inherited from Region1D
bool	BoundariesAreInside [get, set]
	Gets or sets whether or not the boundaries of the region belong to the inner region.
abstract PhysicalValueRange	BoundingInterval [get]
	Gets the bounding interval for the 1D region.
string	CommentOfCoordinates [get, set]
	Gets and sets the comment for the coordinates.
ExtrapolationInfo	ExtrapolationHandling [get, set]
	The extrapolation mode for this region.
bool	IsOneD [get]
	Gets whether this IRegion1D2D is 1D or 2D
string	Name [get, set]
	The name which can be given to the region by the user.
PhysicalProperty	PropertyOfCoordinates [get, set]
	Physical property of the coordinates of the region
Region1DType	RegionType [get]
	Gets the type of the region
SamplingParameters	SamplingForUsageWithComplexFields [get, set]
	Sampling parameters which will be used for a coordinate rescaling in case of using the region with a complex field.
Properties inherited from IRegion1D2D
bool	BoundariesAreInside [get, set]
	Gets or sets whether or not the boundaries of the region belong to the inner region.
bool	IsOneD [get]
	Gets whether this IRegion1D2D is 1D or 2D
string	Name [get, set]
	The name which can be given to the region by the user.
SamplingParameters	SamplingForUsageWithComplexFields [get, set]
	Sampling parameters which will be used for a coordinate rescaling in case of using the region with a complex field.
Properties inherited from IDocument
VirtualLabSession	Session [get, set]
	every documents need to be handled in a session ==> default is the VirtualLab Mainsession
NodeVLExplorer	TreeStructure [get]
	every document should have a node (maybe with subnodes) in the VirtualLab Explorer
DocumentType	TypeOfDocument [get]
	Gets an enum entry specifying the type of the document.

Additional Inherited Members
Static Public Attributes inherited from Region1D
const string	DefaultDocumentName
	The default document name (= type description) for an Order Collection.
static readonly string	FileDialogFilterString
	The filter string used in "Open File" dialogs.
const string	FileExtensionString
	The file extension for an Order Collection.

Detailed Description

This class is subject to change. Programs using this class may require changes with a new version of VirtualLab.
Public class which defines a region composed by several 1D subregions. These subregions are composed using logical operations like AND, OR, XOR, DIFF.

Constructor & Destructor Documentation

ComposedRegion1D() [1/3]

ComposedRegion1D	(	List< Region1D >	subRegions,
		LogicalOperationType	compositionMode,
		bool	boundariesAreInside = false,
		PhysicalProperty	propertyOfCoordinates = PhysicalProperty.Length
	)

Constructor getting all field parameters.

Parameters

subRegions	Regions to be composed.
compositionMode	Mode for compositing the regions. There is only one mode allowed for this object. If more than one mode is needed, this object may be part of another ComposedRegion1D, using another composition mode.
propertyOfCoordinates	Physical property of the coordinates.
boundariesAreInside	Flag which says whether or not the boundary is part of the inner region or not.

ComposedRegion1D() [2/3]

ComposedRegion1D

(

ComposedRegion1D

composedRegion1D

)

Copy constructor.

Parameters

composedRegion1D

Composed region to be copied.

ComposedRegion1D() [3/3]

ComposedRegion1D	(	SerializationInfo	info,
		StreamingContext	context
	)

Deserialization constructor. See the ISerializable interface for more details.

Parameters

info	SerializationInfo
context	StreamingContext

Member Function Documentation

Clone()

override object Clone

(

)

Deep copy of the object.

Returns

A deep copy of this.

Equals()

override bool Equals	(	object	obj,
		EqualityIntent	equalityIntent
	)

Equality operator.

Parameters

obj
equalityIntent	Defines what kind of equality you want to check when comparing two objects, for example all values or physical equality.

Returns

Implements IRegion1D2D.

GetCoordinatesOfActualSubregionBorders()

override double[] GetCoordinatesOfActualSubregionBorders ( ExtrapolationInfo  extrapolation2use )

virtual

Method that gets the coordinates where a real subregion starts or ends. It doesn't contain borders of subregions which are no real borders but only those, where the inside/outside state changes.

Returns

The coordinates of the actual subregion borders.

Implements Region1D.

GetInOutRelation()

override InsideOutside GetInOutRelation ( double  point, ExtrapolationInfo  extrapolation2use = null  )

virtual

Method which checks whether or not a point lies inside or outside the 2D region or on its boundary.

Parameters

point	The point to be checked whether it lies inside.
extrapolation2use	Extrapolation info actually to be used.

Returns

Information where the point lies in relation to the region.

Implements Region1D.

operator!=()

static bool operator!= ( ComposedRegion1D  o1, ComposedRegion1D  o2  )

static

Unequals operator.

Parameters

o1
o2

Returns

operator==()

static bool operator== ( ComposedRegion1D  o1, ComposedRegion1D  o2  )

static

Equals operator

Parameters

o1
o2

Returns

Save()

override void Save

(

string

fileName

)

Save this region to a file with a given name.

Parameters

fileName