next up previous index
Next: Write or plot computed Up: Output Previous: Output   Index

Output locations


\begin{picture}(18,0.12)
\thicklines
\put(0,0){\line(1,0){17}}
\put(0,0.1){\line(1,0){17}}
\end{picture}

FRAme 'sname' [xpfr] [ypfr] [alpfr] [xlenfr] [ylenfr] [mxfr] [myfr])

\begin{picture}(18,0.12)
\thicklines
\put(0,0){\line(1,0){17}}
\put(0,0.1){\line(1,0){17}}
\end{picture}

With this optional command the user defines output on a rectangular, uniform grid in a regular frame.


If the set of output locations is identical to a part of the computational grid, then the user can use the alternative command GROUP.


'sname' name of the frame defined by this command  
[xpfr] x -coordinate of the origin of the frame in problem coordinates  
  if Cartesian coordinates are used in m  
  if spherical coordinates are used in degrees (see command COORD)  
[ypfr] y -coordinate of the origin of the frame in problem coordinates  
  if Cartesian coordinates are used in m  
  if spherical coordinates are used in degrees (see command COORD)  
[alpfr] direction of the x -axis of the frame (in degrees, Cartesian convention; must be  
  0 in case of spherical coordinates)  
[xlenfr] length of the frame in x -direction  
  if Cartesian coordinates are used in m  
  if spherical coordinates are used in degrees (see command COORD)  
[ylenfr] length of the frame in y -direction  
  if Cartesian coordinates are used in m  
  if spherical coordinates are used in degrees (see command COORD)  
[mxfr] number of meshes in x -direction of the rectangular grid in the frame (one less  
  than the number of grid points in this direction)  
  Default: [mxfr]=20  
[myfr] number of meshes in y -direction of the rectangular grid in the frame (one less  
  than the number of grid points in this direction)  
  Default: [myfr]=20  

Some output may be required on a frame that is identical with the bottom input grid or with the computational grid. These frames need not be defined by the user with this command FRAME; the frames are always generated automatically by SWASH under the names 'sname' = 'BOTTGRID' (for the bottom grid) and 'sname' = 'COMPGRID' (for the computational grid).



\begin{picture}(18,0.12)
\thicklines
\put(0,0){\line(1,0){17}}
\put(0,0.1){\line(1,0){17}}
\end{picture}

GROUP 'sname' SUBGrid [ix1] [ix2] [iy1] [iy2]

\begin{picture}(18,0.12)
\thicklines
\put(0,0){\line(1,0){17}}
\put(0,0.1){\line(1,0){17}}
\end{picture}

With this optional command the user defines a group of output locations on a rectangular or curvilinear grid that is identical with (part of) the computational grid (rectilinear or curvilinear). Also, the flow variables (surface elevation, velocity components and pressure) will be outputted in their points of definition according to the Arakawa C-grid staggering. Such a group may be convenient for the user to obtain output that is not affected by interpolation errors.


Command CGRID should precede this command GROUP.


The subgrid contains those points (ix,iy) of the computational grid for which:
[ix1] $ \leq$ ix $ \leq$ [ix2] and [iy1] $ \leq$ iy $ \leq$ [iy2]

For convenience the size of the group, the corner coordinates and the angle with the problem coordinate system are written to PRINT file. The origin of the computational grid is (ix=1,iy=1)!


'sname' name of the set of output locations defined by this command  
[ix1] lowest grid index of subgrid in terms of computational grid in ix-direction  
[iy1] lowest grid index of subgrid in terms of computational grid in iy-direction  
[ix2] highest grid index of subgrid in terms of computational grid in ix-direction  
[iy2] highest grid index of subgrid in terms of computational grid in iy-direction  

Limitations:
[ix1]$ \geq$1, [ix2]$ \leq$[mxc]+1, [iy1]$ \geq$1, [iy2]$ \leq$[myc]+1 ([mxc] and [myc] as defined in the command CGRID).



\begin{picture}(18,0.12)
\thicklines
\put(0,0){\line(1,0){17}}
\put(0,0.1){\line(1,0){17}}
\end{picture}

CURve 'sname' [xp1] [yp1]  < [int] [xp] [yp] >

\begin{picture}(18,0.12)
\thicklines
\put(0,0){\line(1,0){17}}
\put(0,0.1){\line(1,0){17}}
\end{picture}

With this optional command the user defines output along a curved line. Actually this curve is a broken line, defined by the user with its corner points. The values of the output quantities along the curve are interpolated from the computational grid. This command may be used more than once to define more curves.


'sname' name of the curve  
[xp1],[yp1] problem coordinates of the first point of the curve  
  if Cartesian coordinates are used in m  
  if spherical coordinates are used in degrees (see command COORD)  
[int] SWASH will generate output at [int]-1 equidistant locations between two  
  subsequent corner points of the curve (including the two corner points of the curve)  
[xp],[yp] problem coordinates of a corner point of the curve. Repeat the group  
  [int] [xp] [yp] in proper order if there are more corner points on the curve.  


\begin{picture}(18,0.12)
\thicklines
\put(0,0){\line(1,0){17}}
\put(0,0.1){\line(1,0){17}}
\end{picture}

RAY 'rname' [xp1] [yp1] [xq1] [yq1]  <  [int] [xp] [yp] [xq] [yq] >

\begin{picture}(18,0.12)
\thicklines
\put(0,0){\line(1,0){17}}
\put(0,0.1){\line(1,0){17}}
\end{picture}

CANNOT BE USED IN 1D-MODE.


With this optional command the user provides SWASH with information to determine output locations along the depth contour line(s) defined subsequently in command ISOLINE (see below).


The locations are determined by SWASH as the intersections of the depth contour line(s) and the set of straight rays defined in this command RAY. These rays are characterized by a set of master rays defined by their start and end positions ([xp],[yp]) and ([xq],[yq]). Between each pair of sequential master rays thus defined SWASH generates [int]-1 intermediate rays by linear interpolation of the start and end positions.


Note that the rays thus defined have nothing in common with wave rays (e.g. as obtained from conventional refraction computations).


'rname' name of the set of rays defined by this command.  
[xp1],[yp1], problem coordinates of the begin and end points of the first master ray  
[xq1],[yq1] if Cartesian coordinates are used in m  
  if spherical coordinates are used in degrees (see command COORD)  
[int] number of subdivisions between the previous master ray and the  
  following master ray defined by the following data (number of  
  subdivisions is one more than the number of interpolated rays)  
[xp],[yp], problem coordinates of the begin and end points of each subsequent master ray  
[xq],[yq] if Cartesian coordinates are used in m  
  if spherical coordinates are used in degrees (see command COORD)  


\begin{picture}(18,0.12)
\thicklines
\put(0,0){\line(1,0){17}}
\put(0,0.1){\line(1,0){17}}
\end{picture}

                            | -> DEPth   |
ISOline  'sname'  'rname'  <              >  [dep]
                            |    BOTtom  |

\begin{picture}(18,0.12)
\thicklines
\put(0,0){\line(1,0){17}}
\put(0,0.1){\line(1,0){17}}
\end{picture}

CANNOT BE USED IN 1D-MODE AND IN CASE OF CURVILINEAR GRIDS.


With this optional command the user defines a set of output locations along one depth or bottom level contour line (in combination with command RAY).


'sname' name of the set of output locations defined by this command  
'rname' name of the set of rays (as defined in command RAY)  
DEPTH indicates the water depth, i.e. still water depth plus still water level  
  (see command SET) or still water depth plus initial spatially varying  
  water level (see command INPGRID WLEV).  
BOTTOM indicates the still water depth, i.e. the depth with respect to datum level.  
[dep] the depth (in meters) of the depth contour line along which output locations  
  are generated by SWASH.  

The set of output locations along the depth contour lines created with this command is of the type CURVE.



\begin{picture}(18,0.12)
\thicklines
\put(0,0){\line(1,0){17}}
\put(0,0.1){\line(1,0){17}}
\end{picture}

                   |  < [xp] [yp] >  |
POINts   'sname'  <                   >
                   |  FILE  'fname'  |

\begin{picture}(18,0.12)
\thicklines
\put(0,0){\line(1,0){17}}
\put(0,0.1){\line(1,0){17}}
\end{picture}

With this optional command the user defines a set of individual output locations (points). The coordinates of these points are given in the command itself or read from a file (option FILE).


'sname' name of the points  
[xp],[yp] problem coordinates of one output location  
  if Cartesian coordinates are used in m  
  if spherical coordinates are used in degrees (see command COORD)  
'fname' name of the file containing the output locations.  


next up previous index
Next: Write or plot computed Up: Output Previous: Output   Index
The SWASH team 2017-04-06