IPDS.DAT - Revision history

Ak3jjuer: adjust allowed values for additional roughness

2021-02-19T07:37:12Z

adjust allowed values for additional roughness

← Older revision		Revision as of 07:37, 19 February 2021
Line 3:		Line 3:
	\|filetype=ipds.dat		\|filetype=ipds.dat
	\|version=1.4		\|version=1.4
	\|version_descr=~~July 2017~~		\|version_descr=February 2021
	\|significance=A file of type ipds.dat contains '''<u>i</u>'''nitial values of '''<u>p</u>'''hysical '''<u>d</u>'''ata'''<u>s</u>'''ets		\|significance=A file of type ipds.dat contains '''<u>i</u>'''nitial values of '''<u>p</u>'''hysical '''<u>d</u>'''ata'''<u>s</u>'''ets
	The possibilities using this file (e.g. to define start conditions) may illustrate these [[IPDS.DAT:Interpolation examples\|examples]].		The possibilities using this file (e.g. to define start conditions) may illustrate these [[IPDS.DAT:Interpolation examples\|examples]].
Line 78:		Line 78:
	#:* additional roughness		#:* additional roughness
	#::* key line: '''additional_roughness = nikuradse ..value..'''		#::* key line: '''additional_roughness = nikuradse ..value..'''
	#::* the roughness value must be greater or equal 0 and less than 10		#::* the roughness value must be greater or equal -1 and less than 1
	#:* concentration of suspended load		#:* concentration of suspended load
	#::* key line: '''suspendedload = ..sediment_name.. ..value..'''		#::* key line: '''suspendedload = ..sediment_name.. ..value..'''

imported>Schade Peter: + NCCUTOUT

2018-12-05T13:35:06Z

+ NCCUTOUT

← Older revision		Revision as of 13:35, 5 December 2018
Line 214:		Line 214:
	* <span style="background-color:orange;">New in V1.4</span> The method '''linear_distance_weighting''' works as described for '''nearest_points_in_sectors''' with one difference: The physical values will be averaged dependant to the distance to the positions (1/d).		* <span style="background-color:orange;">New in V1.4</span> The method '''linear_distance_weighting''' works as described for '''nearest_points_in_sectors''' with one difference: The physical values will be averaged dependant to the distance to the positions (1/d).
	* At first the interpolation method '''triangular_interpolation''' creates a grid of all available positions. This grid follows Delaunay-criteria and covers a convex hull around all positions. The grid generation process takes place in an external software package so called [http://members.allstream.net/~bjoe/ GEOMPACK] (author: Barry Joe) and gives back the grid via the interface '''ext_ipds_setup_mespos_tria'''.		* At first the interpolation method '''triangular_interpolation''' creates a grid of all available positions. This grid follows Delaunay-criteria and covers a convex hull around all positions. The grid generation process takes place in an external software package so called [http://members.allstream.net/~bjoe/ GEOMPACK] (author: Barry Joe) and gives back the grid via the interface '''ext_ipds_setup_mespos_tria'''.
	\|nutzerprogramme=[[GEOTRANSFORMER]], [[NCAGGREGATE]], [[TELEMAC-2D]] [SediMorph], [[UNS]], [[UNTRIM]] [SediMorph], [[UNTRIM2]], [[UNTRIM2007]] [SediMorph]		\|nutzerprogramme=[[GEOTRANSFORMER]], [[NCAGGREGATE]], [[NCCUTOUT]], [[TELEMAC-2D]] [SediMorph], [[UNS]], [[UNTRIM]] [SediMorph], [[UNTRIM2]], [[UNTRIM2007]] [SediMorph]
	\|language=Fortran90		\|language=Fortran90
	\|fileform=FORMATTED		\|fileform=FORMATTED

imported>Juerges Jens: Interpolationsmethode linear_distance_weighting hinzugefügt

2017-07-03T07:30:34Z

Interpolationsmethode linear_distance_weighting hinzugefügt

@@ Line 2: / Line 2: @@
 |name_de=IPDS.DAT
 |filetype=ipds.dat
-|version=1.3
+|version=1.4
-|version_descr=January 2014
+|version_descr=July 2017
 |significance=A file of type ipds.dat contains '''<u>i</u>'''nitial values of '''<u>p</u>'''hysical '''<u>d</u>'''ata'''<u>s</u>'''ets
 The possibilities using this file (e.g. to define start conditions) may illustrate these [[IPDS.DAT:Interpolation examples|examples]].
-All improvements coming with Version 1.3 are marked as follows: <span style="background-color:orange;">New in V1.3</span>
+All improvements coming with Version 1.4 are marked as follows: <span style="background-color:orange;">New in V1.4</span>
 |filecontents=
 # Block date_and_time
@@ Line 76: / Line 76: @@
 #:* control volume number
 #::* key line: '''control_volume_number = ..value..'''
 # Block '''region'''
 #* definition of regions
@@ Line 135: / Line 210: @@
 :* [[:File:Ems_maxdistdef.png|No specification of a maximum distance]] The interpolation takes place everywhere for all grid points. Far away of the positions the result will be artificial. (642x768 Pixel, 85kB).
 * specification of the interpolation method
-* key line: '''<nowiki>interpolation_method = nearest_points_in_sectors|triangular_interpolation</nowiki>'''
+* key line: '''<nowiki>interpolation_method = nearest_points_in_sectors | linear_distance_weighting | triangular_interpolation</nowiki>'''
-* The interpolation method '''nearest_points_in_sectors''' is developed at BAW and and tries to look for the nearest positions in different directions (sectors) for a point of interest. The physical values at all positions found will be averaged dependant to the square of the distance to the positions.
+* The interpolation method '''nearest_points_in_sectors''' is developed at BAW and and tries to look for the nearest positions in different directions (sectors) for a point of interest. The physical values at all positions found will be averaged dependant to the square of the distance to the positions (1/d**2).
-* <span style="background-color:orange;">New in V1.3</span> At first the interpolation method '''triangular_interpolation''' creates a grid of all available positions. This grid follows Delaunay-criteria and covers a convex hull around all positions. The grid generation process takes place in an external software package so called [http://members.allstream.net/~bjoe/ GEOMPACK] (author: Barry Joe) and gives back the grid via the interface '''ext_ipds_setup_mespos_tria'''.
+* <span style="background-color:orange;">New in V1.4</span> The method '''linear_distance_weighting''' works as described for '''nearest_points_in_sectors''' with one difference: The physical values will be averaged dependant to the distance to the positions (1/d).
 |nutzerprogramme=[[GEOTRANSFORMER]], [[NCAGGREGATE]], [[TELEMAC-2D]]  [SediMorph], [[UNS]], [[UNTRIM]]  [SediMorph], [[UNTRIM2]], [[UNTRIM2007]]  [SediMorph]
 |language=Fortran90

imported>Seiss Guntram: expand user programs

2015-03-17T09:01:02Z

expand user programs

← Older revision		Revision as of 09:01, 17 March 2015
Line 138:		Line 138:
	* The interpolation method '''nearest_points_in_sectors''' is developed at BAW and and tries to look for the nearest positions in different directions (sectors) for a point of interest. The physical values at all positions found will be averaged dependant to the square of the distance to the positions.		* The interpolation method '''nearest_points_in_sectors''' is developed at BAW and and tries to look for the nearest positions in different directions (sectors) for a point of interest. The physical values at all positions found will be averaged dependant to the square of the distance to the positions.
	* <span style="background-color:orange;">New in V1.3</span> At first the interpolation method '''triangular_interpolation''' creates a grid of all available positions. This grid follows Delaunay-criteria and covers a convex hull around all positions. The grid generation process takes place in an external software package so called [http://members.allstream.net/~bjoe/ GEOMPACK] (author: Barry Joe) and gives back the grid via the interface '''ext_ipds_setup_mespos_tria'''.		* <span style="background-color:orange;">New in V1.3</span> At first the interpolation method '''triangular_interpolation''' creates a grid of all available positions. This grid follows Delaunay-criteria and covers a convex hull around all positions. The grid generation process takes place in an external software package so called [http://members.allstream.net/~bjoe/ GEOMPACK] (author: Barry Joe) and gives back the grid via the interface '''ext_ipds_setup_mespos_tria'''.
	\|nutzerprogramme=[[NCAGGREGATE]], [[TELEMAC-2D]] [SediMorph], [[UNS]], [[UNTRIM]] [SediMorph], [[UNTRIM2]], [[UNTRIM2007]] [SediMorph]		\|nutzerprogramme=[[GEOTRANSFORMER]], [[NCAGGREGATE]], [[TELEMAC-2D]] [SediMorph], [[UNS]], [[UNTRIM]] [SediMorph], [[UNTRIM2]], [[UNTRIM2007]] [SediMorph]
	\|language=Fortran90		\|language=Fortran90
	\|fileform=FORMATTED		\|fileform=FORMATTED

imported>Lang Guenther: NCAGGREGATE added

2014-01-20T12:07:37Z

NCAGGREGATE added

← Older revision		Revision as of 12:07, 20 January 2014
Line 3:		Line 3:
	\|filetype=ipds.dat		\|filetype=ipds.dat
	\|version=1.3		\|version=1.3
	\|version_descr=~~December 2010~~		\|version_descr=January 2014
	\|significance=A file of type ipds.dat contains '''<u>i</u>'''nitial values of '''<u>p</u>'''hysical '''<u>d</u>'''ata'''<u>s</u>'''ets		\|significance=A file of type ipds.dat contains '''<u>i</u>'''nitial values of '''<u>p</u>'''hysical '''<u>d</u>'''ata'''<u>s</u>'''ets
	The possibilities using this file (e.g. to define start conditions) may illustrate these [[IPDS.DAT:Interpolation examples\|examples]].		The possibilities using this file (e.g. to define start conditions) may illustrate these [[IPDS.DAT:Interpolation examples\|examples]].
Line 73:		Line 73:
	#:::* specification of the used bed shear stress formula (at this time only the effective bed roughness according to nikuradse is implemented)		#:::* specification of the used bed shear stress formula (at this time only the effective bed roughness according to nikuradse is implemented)
	#:::* specification of the roughness coefficient		#:::* specification of the roughness coefficient
	#::* key line: '''rigid_layer_roughness = nikuradse ..value..'''		#::* key line: '''rigid_layer_roughness = nikuradse ..value..'''
			#:* control volume number
			#::* key line: '''control_volume_number = ..value..'''
	# Block '''region'''		# Block '''region'''
	#* definition of regions		#* definition of regions
Line 136:		Line 138:
	* The interpolation method '''nearest_points_in_sectors''' is developed at BAW and and tries to look for the nearest positions in different directions (sectors) for a point of interest. The physical values at all positions found will be averaged dependant to the square of the distance to the positions.		* The interpolation method '''nearest_points_in_sectors''' is developed at BAW and and tries to look for the nearest positions in different directions (sectors) for a point of interest. The physical values at all positions found will be averaged dependant to the square of the distance to the positions.
	* <span style="background-color:orange;">New in V1.3</span> At first the interpolation method '''triangular_interpolation''' creates a grid of all available positions. This grid follows Delaunay-criteria and covers a convex hull around all positions. The grid generation process takes place in an external software package so called [http://members.allstream.net/~bjoe/ GEOMPACK] (author: Barry Joe) and gives back the grid via the interface '''ext_ipds_setup_mespos_tria'''.		* <span style="background-color:orange;">New in V1.3</span> At first the interpolation method '''triangular_interpolation''' creates a grid of all available positions. This grid follows Delaunay-criteria and covers a convex hull around all positions. The grid generation process takes place in an external software package so called [http://members.allstream.net/~bjoe/ GEOMPACK] (author: Barry Joe) and gives back the grid via the interface '''ext_ipds_setup_mespos_tria'''.
	\|nutzerprogramme=[[TELEMAC-2D]] [SediMorph], [[UNS]], [[UNTRIM]] [SediMorph], [[UNTRIM2]], [[UNTRIM2007]] [SediMorph]		\|nutzerprogramme=[[NCAGGREGATE]], [[TELEMAC-2D]] [SediMorph], [[UNS]], [[UNTRIM]] [SediMorph], [[UNTRIM2]], [[UNTRIM2007]] [SediMorph]
	\|language=Fortran90		\|language=Fortran90
	\|fileform=FORMATTED		\|fileform=FORMATTED

imported>Lang Guenther: link UNTRIM2

2010-12-16T12:54:06Z

link UNTRIM2

← Older revision		Revision as of 12:54, 16 December 2010
Line 3:		Line 3:
	\|filetype=ipds.dat		\|filetype=ipds.dat
	\|version=1.3		\|version=1.3
	\|version_descr=~~June 2007~~		\|version_descr=December 2010
	\|significance=A file of type ipds.dat contains '''<u>i</u>'''nitial values of '''<u>p</u>'''hysical '''<u>d</u>'''ata'''<u>s</u>'''ets		\|significance=A file of type ipds.dat contains '''<u>i</u>'''nitial values of '''<u>p</u>'''hysical '''<u>d</u>'''ata'''<u>s</u>'''ets
	The possibilities using this file (e.g. to define start conditions) may illustrate these [[IPDS.DAT:Interpolation examples\|examples]].		The possibilities using this file (e.g. to define start conditions) may illustrate these [[IPDS.DAT:Interpolation examples\|examples]].
Line 136:		Line 136:
	* The interpolation method '''nearest_points_in_sectors''' is developed at BAW and and tries to look for the nearest positions in different directions (sectors) for a point of interest. The physical values at all positions found will be averaged dependant to the square of the distance to the positions.		* The interpolation method '''nearest_points_in_sectors''' is developed at BAW and and tries to look for the nearest positions in different directions (sectors) for a point of interest. The physical values at all positions found will be averaged dependant to the square of the distance to the positions.
	* <span style="background-color:orange;">New in V1.3</span> At first the interpolation method '''triangular_interpolation''' creates a grid of all available positions. This grid follows Delaunay-criteria and covers a convex hull around all positions. The grid generation process takes place in an external software package so called [http://members.allstream.net/~bjoe/ GEOMPACK] (author: Barry Joe) and gives back the grid via the interface '''ext_ipds_setup_mespos_tria'''.		* <span style="background-color:orange;">New in V1.3</span> At first the interpolation method '''triangular_interpolation''' creates a grid of all available positions. This grid follows Delaunay-criteria and covers a convex hull around all positions. The grid generation process takes place in an external software package so called [http://members.allstream.net/~bjoe/ GEOMPACK] (author: Barry Joe) and gives back the grid via the interface '''ext_ipds_setup_mespos_tria'''.
	\|nutzerprogramme=[[TELEMAC-2D]] [SediMorph], [[UNS]], [[UNTRIM]] [SediMorph], [[UNTRIM2007]] [SediMorph]		\|nutzerprogramme=[[TELEMAC-2D]] [SediMorph], [[UNS]], [[UNTRIM]] [SediMorph], [[UNTRIM2]], [[UNTRIM2007]] [SediMorph]
	\|language=Fortran90		\|language=Fortran90
	\|fileform=FORMATTED		\|fileform=FORMATTED

imported>BAWiki 2 at 13:10, 2 June 2010

2010-06-02T13:10:34Z

← Older revision		Revision as of 13:10, 2 June 2010
Line 5:		Line 5:
	\|version_descr=June 2007		\|version_descr=June 2007
	\|significance=A file of type ipds.dat contains '''<u>i</u>'''nitial values of '''<u>p</u>'''hysical '''<u>d</u>'''ata'''<u>s</u>'''ets		\|significance=A file of type ipds.dat contains '''<u>i</u>'''nitial values of '''<u>p</u>'''hysical '''<u>d</u>'''ata'''<u>s</u>'''ets
	The possibilities using this file (e.g. to define start conditions) may illustrate these examples.		The possibilities using this file (e.g. to define start conditions) may illustrate these [[IPDS.DAT:Interpolation examples\|examples]].
	All improvements coming with Version 1.3 are marked as follows: <span style="background-color:orange;">New in V1.3</span>		All improvements coming with Version 1.3 are marked as follows: <span style="background-color:orange;">New in V1.3</span>
	\|filecontents=		\|filecontents=

imported>BAWiki 2 at 13:39, 1 June 2010

2010-06-01T13:39:05Z

← Older revision		Revision as of 13:39, 1 June 2010
Line 4:		Line 4:
	\|version=1.3		\|version=1.3
	\|version_descr=June 2007		\|version_descr=June 2007
	\|significance=A file of type ipds.dat contains '''i'''nitial values of '''p'''hysical '''d'''ata'''s'''ets		\|significance=A file of type ipds.dat contains '''<u>i</u>'''nitial values of '''<u>p</u>'''hysical '''<u>d</u>'''ata'''<u>s</u>'''ets
	The possibilities using this file (e.g. to define start conditions) may illustrate these examples.		The possibilities using this file (e.g. to define start conditions) may illustrate these examples.
	All improvements coming with Version 1.3 are marked as follows: <span style="background-color:orange;">New in V1.3</span>		All improvements coming with Version 1.3 are marked as follows: <span style="background-color:orange;">New in V1.3</span>

imported>BAWiki 2 at 19:32, 31 May 2010

2010-05-31T19:32:25Z

← Older revision		Revision as of 19:32, 31 May 2010
Line 6:		Line 6:
	\|significance=A file of type ipds.dat contains '''i'''nitial values of '''p'''hysical '''d'''ata'''s'''ets		\|significance=A file of type ipds.dat contains '''i'''nitial values of '''p'''hysical '''d'''ata'''s'''ets
	The possibilities using this file (e.g. to define start conditions) may illustrate these examples.		The possibilities using this file (e.g. to define start conditions) may illustrate these examples.
	All improvements coming with Version 1.3 are marked as follows: ~~'''~~New in V1.3~~'''~~		All improvements coming with Version 1.3 are marked as follows: <span style="background-color:orange;">New in V1.3</span>
	\|filecontents=		\|filecontents=
	# Block date_and_time		# Block date_and_time
Line 135:		Line 135:
	* key line: '''<nowiki>interpolation_method = nearest_points_in_sectors\|triangular_interpolation</nowiki>'''		* key line: '''<nowiki>interpolation_method = nearest_points_in_sectors\|triangular_interpolation</nowiki>'''
	* The interpolation method '''nearest_points_in_sectors''' is developed at BAW and and tries to look for the nearest positions in different directions (sectors) for a point of interest. The physical values at all positions found will be averaged dependant to the square of the distance to the positions.		* The interpolation method '''nearest_points_in_sectors''' is developed at BAW and and tries to look for the nearest positions in different directions (sectors) for a point of interest. The physical values at all positions found will be averaged dependant to the square of the distance to the positions.
	* ~~'''~~New in V1.3~~'''~~ At first the interpolation method '''triangular_interpolation''' creates a grid of all available positions. This grid follows Delaunay-criteria and covers a convex hull around all positions. The grid generation process takes place in an external software package so called [http://members.allstream.net/~bjoe/ GEOMPACK] (author: Barry Joe) and gives back the grid via the interface '''ext_ipds_setup_mespos_tria'''.		* <span style="background-color:orange;">New in V1.3</span> At first the interpolation method '''triangular_interpolation''' creates a grid of all available positions. This grid follows Delaunay-criteria and covers a convex hull around all positions. The grid generation process takes place in an external software package so called [http://members.allstream.net/~bjoe/ GEOMPACK] (author: Barry Joe) and gives back the grid via the interface '''ext_ipds_setup_mespos_tria'''.
	\|nutzerprogramme=[[TELEMAC-2D]] [SediMorph], [[UNS]], [[UNTRIM]] [SediMorph], [[UNTRIM2007]] [SediMorph]		\|nutzerprogramme=[[TELEMAC-2D]] [SediMorph], [[UNS]], [[UNTRIM]] [SediMorph], [[UNTRIM2007]] [SediMorph]
	\|language=Fortran90		\|language=Fortran90

imported>BAWiki 2: Created page with '{{FileDescription |name_de=IPDS.DAT |filetype=ipds.dat |version=1.3 |version_descr=June 2007 |significance=A file of type ipds.dat contains '''i'''nitial values of '''p'''hysical…'

2010-05-31T12:35:23Z

Created page with '{{FileDescription |name_de=IPDS.DAT |filetype=ipds.dat |version=1.3 |version_descr=June 2007 |significance=A file of type ipds.dat contains '''i'''nitial values of '''p'''hysical…'

New page

{{FileDescription
|name_de=IPDS.DAT
|filetype=ipds.dat
|version=1.3
|version_descr=June 2007
|significance=A file of type ipds.dat contains '''i'''nitial values of '''p'''hysical '''d'''ata'''s'''ets
The possibilities using this file (e.g. to define start conditions) may illustrate these examples.
All improvements coming with Version 1.3 are marked as follows: '''New in V1.3'''
|filecontents=
# Block date_and_time
#* date and time specification
#* exactly one specification allowed
#* the following formats are implemented:
#:* DD.MM.YYYY-hh:mm:ss
#:* DD.MM.YYYY-hh:mm:ss.nnnnnnnnn
#:* DD.MM.YYYY-hh:mm:ss.nnnnnnnnn-ZONE
#* legend:
#:* DD = day of month (two digits 01-31)
#:* MM = month of year (two digits 01-12)
#:* YYYY = year (four digits)
#:* hh = hour of day (two digits 00-23)
#:* mm = minute of hour (two digits 00-59)
#:* ss = second of minute (two digits 00-59)
#:* nnnnnnnnn = nanoseconds (nine digits)
#:* ZONE = time zone (UTC/MEZ/MESZ/+3H/..)
#* key line: '''datetime = DD.MM.YYYY-hh:mm:ss.nnnnnnnnn-ZONE'''
# Block '''global_constant_values'''
#* definition of physical constant values in the whole area (default values)
#* exactly one '''global_constant_values''' block allowed
#* these default values can be overwritten by regional valid values via the regional_values) blocks
#* implemented physical values:
#:* water level
#::* key line: '''waterlevel = ..value..'''
#::* exactly one specification allowed
#:* salinity
#::* key line: '''salinity = ..value..'''
#::* exactly one specification allowed
#:* temperature
#::* key line: '''temperature = ..value..'''
#::* exactly one specification allowed
#:* sediment fractions and porosity
#::* key line for one sediment fraction: '''sediment_fraction = ..sediment_name.. ..fraction..'''
#::* use as many sediment fraction key lines as necessary
#::* key line for porosity: '''porosity = ..fraction..'''
#::* exactly one specification allowed for porosity
#::* all used sediment names must be identical to the names defined in the sediment classification file (type [[SOIL.DAT|soil.dat]])
#::* the sum of all sediment fractions must be 1
#:* ripple wave number
#::* the wave number k defines both direction and wavelength (λ) of a ripple structure (k = 2 π / λ)
#::* defining the wave number by giving its x- und y-component values
#::* key line: '''ripple_wavenumber = ..x-component.. ..y-component..'''
#::* exactly one specification allowed
#:* ripple height
#::* key line: '''ripple_height = ..value..'''
#::* exactly one specification allowed
#:* dune wave number
#::* the wave number k defines both direction and wavelength (λ) of a dune structure (k = 2 π / λ)
#::* defining the wave number by giving its x- und y-component values
#::* key line:'''dune_wavenumber = ..x-component.. ..y-component..'''
#::* exactly one specification allowed
#:* dune height
#::* key line: '''dune_height = ..value..'''
#::* exactly one specification allowed
#:* depth of the unerodable layer
#::* implemented are two ways ("absolute" and "relative") of giving the depth of the unerodable layer
#::* absolute depth is necessary if the unerodable layer lies in a geodetic (absolute) depth
#::* relative depth means the unerodable layer lies in a depth relative to the bottom of the water body (negative values represents values below the bottom of the water body)
#::* key line:'''<nowiki> rigid_layer_depth = relative|absolute ..value..</nowiki>'''
#::* exactly one specification allowed
#:* roughness of the unerodable layer
#::* the roughness of the unerodable layer is important if there are no sediments left at the bottom of the water body
#::* two specifications are necessary to define the roughness of the unerodable layer
#:::* specification of the used bed shear stress formula (at this time only the effective bed roughness according to nikuradse is implemented)
#:::* specification of the roughness coefficient
#::* key line: '''rigid_layer_roughness = nikuradse ..value..'''
# Block '''region'''
#* definition of regions
#* the maximum number of regions is unlimited
#* at least one region is necessary to define regional differing physical values
#* it is allowed to use no regions
#* each region needs a name:
#:* this name will be used as an identification key
#:* notice case sensitivity
#:* key line: '''region_name = ..name..'''
#* description of the border polygon
#:* the border polygon need at least three border points
#:* the maximum number of border points is unlimited
#:* the border polygon will be closed automatically
#:* key line for one border point: '''border_point = ..x-coordinate.. ..y-coordinate..'''
# Block '''sampling_point'''
#* definition of positions related to measured data
#* the maximum number of positions is unlimited
#* at least one position is necessary to define regional differing physical values
#* it is allowed to use no positions
#* each position needs a name:
#:* this name will be used as an identification key
#:* notice case sensitivity
#:* key line: '''sampling_point_name = ..name..'''
#* position specification
#:* specification of x- and y-coordinate
#:* only one position specification is allowed
#:* key line: '''sampling_point_xy = ..x-coordinate.. ..y-coordinate..'''
#* definition of physical values valid at the position
#:* it is allowed to use the same physical values as described in the global_constant_values block
# Block '''regional_values'''
#* definition of regional differing physical values
#* specification of regions with physical values related to positions
#* in the space between the positions the physical values will be interpolated
#* the maximum number of these blocks is unlimited
#* it is allowed to use no '''regional_values''' block (the physical constant values for the whole area will not change)
#* sorting the regional_values blocks so that the block with the lowest priority will come first (this is important only if the regions overlap)
#* specification of the region
#:* key line: '''<nowiki>region = inside|outside ..name..</nowiki>'''
#:* the name of the region must match with the region identification key defined in one of the region blocks
#:* with the "inside" or "outside" key word it is possible to define the region of interest inside or outside the region border polygon
#* specification of the geodetic layer
#:* key lines: '''lower_validity_level = ..lower_limit..'''<br />'''upper_validity_level = ..upper_limit..'''
#:* both specifications are not necessary
#* specification of positions
#:* the maximum number of positions is only limited to the maximum number of defined sampling_point blocks
#:* at least one position is necessary
#:* in the presence of only one position the physical values are constant over the whole region of interest
#:* the names of all positions must match with the position identification keys defined in the sampling_point blocks
#:* key line: '''sampling_point = ..name..'''
#* specification of a maximum distance between positions and a given point P. Only positions inside a distance radius around P are used for interpolation.
#:* only one specification allowed
#:* the value for maximum distance must be greater zero
#:* key line: '''sampling_point_maxdist = ..maximum_distance_to_positions..'''
#:* the key line ist not necessary. if maximum distance ist not specified, the default value ('''40.E6''') will be used. so it is ensured that older IPDS files (version 1.1) will produce the same result as before.
#:* The following pictures will document the influence of the maximum distance: Visualized in all pictures is the computed distribution of fine sand (.063-.177 mm grain diameter) for the mouth of the ems river. the computation started with 1382 measurement positions from the [http://www.rijkswaterstaat.nl/over_ons/adressen_en_diensten/landelijkediensten/waterdienst/waterdienst_locatie_zuiderwagenplein.aspx Rijksinstituut voor Kust en Zee (RIKZ)] sediment atlas. The colours represents different rates of fine sand: red represents 100%, yellow 75%, green 50% and dark blue 0% rate of fine sand.
:* [[:File:Ems_maxdist300m.png|The maximum distance to the positions (300m)]] corresponds to the internal grid resolution<br />The interpolation takes place only around positions. For all other grid points the measurement positions all too far away. The locations of the positions come clearly to sight. (642x768 Pixel, 21kB).
:* [[:File:Ems_maxdist1000m.png|The maximum distance to the positions (1000m)]] is about 3-4 times greater than the internal grid resolution<br />The interpolation takes place in all areas where positions are not too far away The result as a first approximation is nature alike. In wide areas will be no interpolation, because of the great distance to positions. (642x768 Pixel, 30kB).
:* [[:File:Ems_maxdistdef.png|No specification of a maximum distance]] The interpolation takes place everywhere for all grid points. Far away of the positions the result will be artificial. (642x768 Pixel, 85kB).
* specification of the interpolation method
* key line: '''<nowiki>interpolation_method = nearest_points_in_sectors|triangular_interpolation</nowiki>'''
* The interpolation method '''nearest_points_in_sectors''' is developed at BAW and and tries to look for the nearest positions in different directions (sectors) for a point of interest. The physical values at all positions found will be averaged dependant to the square of the distance to the positions.
* '''New in V1.3''' At first the interpolation method '''triangular_interpolation''' creates a grid of all available positions. This grid follows Delaunay-criteria and covers a convex hull around all positions. The grid generation process takes place in an external software package so called [http://members.allstream.net/~bjoe/ GEOMPACK] (author: Barry Joe) and gives back the grid via the interface '''ext_ipds_setup_mespos_tria'''.
|nutzerprogramme=[[TELEMAC-2D]] [SediMorph], [[UNS]], [[UNTRIM]] [SediMorph], [[UNTRIM2007]] [SediMorph]
|language=Fortran90
|fileform=FORMATTED
|fileaccess=SEQUENTIAL
|fileextension=.dat
|writemodules=-
|readmodules=$PROGHOME/fortran/lib/io_ipds/hp/mod_io_ipds_ui.f90<br />
$PROGHOME/fortran/lib/io_ipds/SGI/mod_io_ipds_ui.f90
|contact_original=[mailto:jens.juerges@baw.de J. Jürges]
|contact_maintenance=[mailto:jens.juerges@baw.de J. Jürges]
|examplefile=$PROGHOME/examples/ipds/ipds.dat
}}