UPLAY - Revision history

Ak3bfric at 10:21, 12 December 2022

2022-12-12T10:21:49Z

← Older revision		Revision as of 10:21, 12 December 2022
Line 115:		Line 115:
	\|add_software= GKS (graphical kernel system)		\|add_software= GKS (graphical kernel system)
	\|contact_original=[mailto:jens.juerges@baw.de J. Jürges]		\|contact_original=[mailto:jens.juerges@baw.de J. Jürges]
	\|contact_maintenance=[mailto:~~jens~~.~~juerges~~@baw.de ~~J. Jürges~~]		\|contact_maintenance=[mailto:sim.proghome@baw.de Working Group SIM]
	\|documentation= -		\|documentation= -
	}}		}}

Ak3jjuer: Adjustments to version 1.3 from march 2020

2020-03-12T09:26:34Z

Adjustments to version 1.3 from march 2020

← Older revision		Revision as of 09:26, 12 March 2020
Line 2:		Line 2:
	\|name_de=UPLAY		\|name_de=UPLAY
	\|name=uplay		\|name=uplay
	\|version=~~April 2018~~		\|version=March 2020
	\|version_descr=~~April 2018~~		\|version_descr=March 2020
	\|catchwords=		\|catchwords=
	numerical simulation<br />		numerical simulation<br />
Line 43:		Line 43:
	** '''[[NCPLOT.DAT\|ncplot_wlev.dat]]''': input steering file for [[NCPLOT]] to create an image of the waterlevels		** '''[[NCPLOT.DAT\|ncplot_wlev.dat]]''': input steering file for [[NCPLOT]] to create an image of the waterlevels
	** '''run_ncplot_wlev_user.sh''': UNIX-shellscript to launch an [[NCPLOT]] run to create an image of the waterlevels at the end of the simulation. In this shellscript the conversion from vector to bitmap image is included. Note that this conversion has to be adjusted to the location and size of the printing.		** '''run_ncplot_wlev_user.sh''': UNIX-shellscript to launch an [[NCPLOT]] run to create an image of the waterlevels at the end of the simulation. In this shellscript the conversion from vector to bitmap image is included. Note that this conversion has to be adjusted to the location and size of the printing.
	** '''~~newcplot_wl~~.dat''': input steering file for ~~NEWCPLOT~~ to create an image of the temporal development of the waterlevels. This image will not be shown by UPLAY, but can be useful to check whether the computaional results are a time independent solution.		** '''[[NCPLOT.DAT\|ncplot_wlev_zg.dat]]''': input steering file for [[NCPLOT]] to create an image of the temporal development of the waterlevels. This image will not be shown by UPLAY, but can be useful to check whether the computaional results are a time independent solution.
	** '''~~run_newcplot_wl_user~~.sh''': UNIX-shellscript to launch ~~a NEWCPLOT~~ run to create an image of the temporal development of the waterlevels.		** '''run_ncplot_wlev_zg_user.sh''': UNIX-shellscript to launch an [[NCPLOT]] run to create an image of the temporal development of the waterlevels.

	\|outputfiles=		\|outputfiles=
Line 89:		Line 89:

	Executable file for program [[NCPLOT]]. Without using this transfer parameter UPLAY uses a standard executable from within $PROGHOME.		Executable file for program [[NCPLOT]]. Without using this transfer parameter UPLAY uses a standard executable from within $PROGHOME.

	~~<tt>-newcplot_exe <name_und_pfad_zum_newcplot_executable></tt>~~

	~~Executable file for program [[NEWCPLOT]]. Without using this transfer parameter UPLAY uses a standard executable from within $PROGHOME.~~

	'''Hints for programmers'''		'''Hints for programmers'''

imported>Juerges Jens: + Image 1

2018-04-20T13:41:25Z

+ Image 1

← Older revision		Revision as of 13:41, 20 April 2018
Line 14:		Line 14:

	The change of grid depths will be done within the GUI. There are a (small) number of color classes each representing one depth value. Using UPLAY in standard manner there are 5 different color classes: "blue" representing 10 m below sea surface, "light blue" (-5m), "green" (-2m), "orange" (0m) and "red" representing 2 m above sea surface. The user activates one color class and clicks on grid elements to change the depth of that element to the color representing value.		The change of grid depths will be done within the GUI. There are a (small) number of color classes each representing one depth value. Using UPLAY in standard manner there are 5 different color classes: "blue" representing 10 m below sea surface, "light blue" (-5m), "green" (-2m), "orange" (0m) and "red" representing 2 m above sea surface. The user activates one color class and clicks on grid elements to change the depth of that element to the color representing value.

			[[File:UPLAY1.png\|thumb\|250px\|Image 1: Front end of UPLAY after the user changed the grid depth values of the "sandbox model" and computing and presenting the image of the computational results of the current velocities]]

	To compute the hydrodynamic effect UPLAY does the following in the background after the user started a simulation by clicking the right button:		To compute the hydrodynamic effect UPLAY does the following in the background after the user started a simulation by clicking the right button:

imported>Juerges Jens: Created page with "{{ProgramDescription |name_de=UPLAY |name=uplay |version=April 2018 |version_descr=April 2018 |catchwords= numerical simulation
hydrodynamic
visualization
le..."

2018-04-20T12:22:26Z

Created page with "{{ProgramDescription |name_de=UPLAY |name=uplay |version=April 2018 |version_descr=April 2018 |catchwords= numerical simulation hydrodynamic visualization le..."

New page

{{ProgramDescription
|name_de=UPLAY
|name=uplay
|version=April 2018
|version_descr=April 2018
|catchwords=
numerical simulation 
hydrodynamic 
visualization 
learning program 

|shortdescription=
UPLAY is a GUI around [[UNTRIM2]] and [[NCPLOT]]. With UPLAY the user is able to change grid depths graphically, to let compute the hydrodynamical effect of that grid depth change and to look at the results.

The change of grid depths will be done within the GUI. There are a (small) number of color classes each representing one depth value. Using UPLAY in standard manner there are 5 different color classes: "blue" representing 10 m below sea surface, "light blue" (-5m), "green" (-2m), "orange" (0m) and "red" representing 2 m above sea surface. The user activates one color class and clicks on grid elements to change the depth of that element to the color representing value.

To compute the hydrodynamic effect UPLAY does the following in the background after the user started a simulation by clicking the right button:
# Writing current grid files (format [[UTRSUB_GRID.DAT|utrsub_grid.dat]] and [[PLTSUB_GRID.UPI|pltsub_grid.upi]])
# Provide input files for [[UNTRIM2]] and execute an [[UNTRIM2]] simulation
# Provide input files for NCPLOT and create images containing the computational results (current velocity and water level) for one specific moment in time

The vector gaphics created by NCPLOT will be converted by UPLAY to the pixel format [https://en.wikipedia.org/wiki/BMP_file_format BMP] and presented to the user.

|inputfiles=
UPLAY is started by default without any input files. In this case UPLAY gets his input files from this directory: <tt>$PROGHOME/shellscripts/uplay/sandbox/</tt>. However, the user can prepare his own folder with input files if he does not want to use the "sandbox model". In this case the user has to provide the following files in his own folder and has to hand over the name of the folder by using the option <tt>-userdir <name_userdir></tt>:
* input files for UPLAY:
** '''uplay.dat''': input steering file for UPLAY. It controls in particular the layout of UPLAY
** '''grid files''' (format [[UTRSUB_GRID.DAT|utrsub_grid.dat]] and [[PLTSUB_GRID.UPI|pltsub_grid.upi]]): Position of grid edges and depth of subgrid edges and elements. Please note that in the current version of UPLAY every grid edge and element consists of only one subgrid edge and element.
* input files for [[UNTRIM2]]:
** '''[[UNTRIM2.DAT|untrim2009.dat]]''': input steering file for [[UNTRIM2]]. A coupling together with the K-Model or with Sedimorph or with the settling velocity package SV is not supported by UPLAY.
** '''utromp2009.dat''': input steering file of the hydrodynamic package UTROMP_2009. The description of initial and boundary values has to be simple: boundary input files are not supported as well as initial files.
** '''[[UNTRIM_EQS.DAT|eqs.dat]]''': input steering file of the density package EQS
** '''[[VERTICAL.DAT|vertical.dat]]''': input steering file describing the vertical resolution
** '''run_untrim2009_user.sh''': UNIX-shellscript to launch an [[UNTRIM2]] simulation run
* input files to create images of the computational results:
** '''[[NC2TABLE.DAT|nc2table.dat]]''': input steering file for [[NC2TABLE]]. [[NC2TABLE]] has to write the computational results to an ASCII file to compute the actual range of values.
** '''run_nc2table_user.sh''': UNIX-shellscript to launch an [[NC2TABLE]] run
** '''[[NCPLOT.DAT|ncplot_velo.dat]]''': input steering file for [[NCPLOT]] to create an image of the current velocities
** '''run_ncplot_velo_user.sh''': UNIX-shellscript to launch an [[NCPLOT]] run to create an image of the current velocities at the end of the simulation. In this shellscript the conversion from vector to bitmap image is included. Note that this conversion has to be adjusted to the location and size of the printing.
** '''[[NCPLOT.DAT|ncplot_wlev.dat]]''': input steering file for [[NCPLOT]] to create an image of the waterlevels
** '''run_ncplot_wlev_user.sh''': UNIX-shellscript to launch an [[NCPLOT]] run to create an image of the waterlevels at the end of the simulation. In this shellscript the conversion from vector to bitmap image is included. Note that this conversion has to be adjusted to the location and size of the printing.
** '''newcplot_wl.dat''': input steering file for NEWCPLOT to create an image of the temporal development of the waterlevels. This image will not be shown by UPLAY, but can be useful to check whether the computaional results are a time independent solution.
** '''run_newcplot_wl_user.sh''': UNIX-shellscript to launch a NEWCPLOT run to create an image of the temporal development of the waterlevels.

|outputfiles=
* as in [[UNTRIM2]] and [[NCPLOT]]

|methodology=
For each model run, a subfolder is created in the working directory. In the subfolder of a model simulation all result files of [[UNTRIM2]] and [[NCPLOT]] are kept. They are thus still available after generating and presenting with UPLAY. The naming for the subfolders is composed of a letter and 4 digits: At the start UPLAY searches for a letter that has not yet been used. Thus, in a folder simulations of up to 26 UPLAY sessions can be kept. Every simulation within a UPLAY session increases the four-digit counter by one. This allows up to 9999 simulations to be performed within a UPLAY session.

The program UPLAY can be called without a control file and without transfer parameters. In this case, a prepared "sandbox model" (a 2.5 km long and 500 m wide test channel with rectangular elements with a resolution of 500 m) is used. This is a 2D model for calculating hydrodynamics without the influence of density. Salt, heat, suspended particles and tracers are not included in the model. At the upstream edge, the inflow is controlled via a FLOW boundary with a constant value of 2000 m3 s-1. At the downstream edge, a water level boundary is implemented with constant value of +1 m. The simulation period is 1.5 hours with a time step of 90 seconds. The aim of the simulation is to calculate the resulting stationary solution. Therefore, the implicitness factor theta of [[UNTRIM2]] is equal to 1. Various tests have shown that the chosen time period is long enough to have a stationary solution at the end of the period. [[NCPLOT]] generates images of the flow and the waterlevels for the last moment of time. These images are read in and displayed by UPLAY.

'''Transfer parameters'''

<tt>-h</tt>

UPLAY shows a help text instead of starting the program in a normal manner.

<tt>-userdir <name_userdir></tt>

In standard case UPLAY gets his input files from this directory: <tt>$PROGHOME/shellscripts/uplay/sandbox/</tt>. However, the user can prepare his own folder with input files if he does not want to use the "sandbox model". In this case the user has to provide the input files in his own folder and has to hand over the name of the folder by using the option <tt>-userdir <name_userdir></tt>

Note that in this case the user is responsible that the input files describe the right time index to create images. The "sandbox model" uses the 61st time index in den CF-netCDF result files. The same applies to the names of the result files. For this purpose, the placeholder <tt><RUN></tt> may be used in the input files. This placeholder is replaced by UPLAY with the currently valid run name (equal to the folder name).

If the user wants to use his own grid, then the grid may contain only one subelement per grid element and only one subedge per grid edge. It is also important that the depths of the grid elements and the depths of the predefined color classes match. There must not be a grid element with a depth that is not covered by the color classes. UPLAY treats depth values as equal if the difference is less than 1 mm.

Most likely the UNIX-shellscripts has to be adjusted due to the circumstance that the conversion of the vector graphics to a bitmap image the program needs to know the correct cutout values.

<tt>-adjusted_velocity_color_palette <yes no adjusted></tt>

Adjust the color palette to the current range of velocity values? If the answer is "yes" or "adjusted", the adjustment takes place. If "no", UPLAY uses a standard range of values. Default ist "no".

<tt>-adjusted_waterlevel_color_palette <yes no adjusted></tt>

Adjust the color palette to the current range of waterlevel values? If the answer is "yes" or "adjusted", the adjustment takes place. If "no", UPLAY uses a standard range of values. Default ist "adjusted".

<tt>-untrim2009_exe <name_und_pfad_zum_untrim2009_executable></tt>

Executable file for program [[UNTRIM2]]. Without using this transfer parameter UPLAY uses a standard executable from within $PROGHOME.

<tt>-nc2table_exe <name_und_pfad_zum_nc2table_executable></tt>

Executable file for program [[NC2TABLE]]. Without using this transfer parameter UPLAY uses a standard executable from within $PROGHOME.

<tt>-ncplot_exe <name_und_pfad_zum_ncplot_executable></tt>

Executable file for program [[NCPLOT]]. Without using this transfer parameter UPLAY uses a standard executable from within $PROGHOME.

<tt>-newcplot_exe <name_und_pfad_zum_newcplot_executable></tt>

Executable file for program [[NEWCPLOT]]. Without using this transfer parameter UPLAY uses a standard executable from within $PROGHOME.

'''Hints for programmers'''

UPLAY consists of three parts: First a Fortran-Program, which works as a front end to show the grid depths, to let the user change the grid depths an to show the images of the computational results. Second a collection of UNIX-shellscripts as a back end to control simulation an creation of images. The third part is a UNIX-shellscript as a starting program. This starting script will fullfill all the necessary conditions for a successful use of the front end.

The communication between front and back end is done through data files and UNIX environment variables.

The Fortran Program uses the following PROGHOME software packages:
* <tt>h_grid</tt> for in- and output of grid files
* <tt>dic-io</tt> to read the UPLAY steering file
* <tt>base-library</tt> for basic functions (e.g. to read windows bitmap files (BMP))

In addition, the Fortran program absolutely needs the GKS (graphical kernel system) installation for basic drawing functions and a netCDF installation.

'''Limitations'''

* A coupling of [[UNTRIM2]] together with the K-Model or with Sedimorph or with the settling velocity package SV is not supported by UPLAY.
* If [[UNTRIM2]] has to solve the transport equation for salt, heat, suspended particles or tracers UPLAY does not support the creation of images of the computational results of salinity, temperature or concentration.

|preprocessor=
[[UTRPRE]]
|postprocessor=
[[DAVIT]], [[NCAGGREGATE]], [[NCANALYSE]], [[NCAUTO]], [[NCDELTA]], [[NCPLOT]], [[NC2TABLE]], [[UNTRIM2007MONITOR]]
|language=Fortran90
|add_software= GKS (graphical kernel system)
|contact_original=[mailto:jens.juerges@baw.de J. Jürges]
|contact_maintenance=[mailto:jens.juerges@baw.de J. Jürges]
|documentation= -
}}

UPLAY - Revision history

Ak3bfric at 10:21, 12 December 2022

Ak3jjuer: Adjustments to version 1.3 from march 2020

imported>Juerges Jens: + Image 1

imported>Juerges Jens: Created page with "{{ProgramDescription |name_de=UPLAY |name=uplay |version=April 2018 |version_descr=April 2018 |catchwords= numerical simulation hydrodynamic visualization le..."

imported>Juerges Jens: Created page with "{{ProgramDescription |name_de=UPLAY |name=uplay |version=April 2018 |version_descr=April 2018 |catchwords= numerical simulation
hydrodynamic
visualization
le..."