Model:REF-DIF: Difference between revisions

From CSDMS
No edit summary
Line 78: Line 78:
}}
}}
{{Documentation model
{{Documentation model
|Provide key papers on model if any=Key Papers:
*'''Dalrymple, R.A., Kirby, J.T. and Hwang, P.A., 1984. Wave diffraction due to areas of energy dissipation. Journal of Waterway, Port, Coastal and Ocean Engineering, 110, 67-79.'''
*'''Kirby, J.T. and Dalrymple, R.A., 1983. A parabolic equation for the combined refraction-diffraction of Stokes waves by mildly-varying topography Journal of Fluid Mechanics, 136, 453-466.'''
*'''Kirby, J.T., 1984. A note on linear surface wave-current interaction over slowly varying topography Journal of Geophysical Research, 89, 745-747.'''
*'''Kirby, J. T., 1986. Higher-order approximations in the parabolic equation method for water waves Journal of Geophysical Research, 91, 933-952.'''
*'''Kirby, J. T. and Dalrymple, R. A., 1993. Combined Refraction/Diffraction Model, REF/DIF 1 Version 2.5, Documentation and User’s Manual. CACR Report No. 94-22.'''
Other Papers:
* Kirby, J.T. and Dalrymple, R.A., 1984. Verification of a parabolic equation for propagation of weakly-nonlinear waves Coastal Engineering, 8, 219-232.
* Kirby, J.T., 1986. A general wave equation for waves over rippled beds Journal of Fluid Mechanics, 162, 171-186.
* Kirby, J. T., 1986. On the gradual reflection of weakly-nonlinear Stokes waves in regions with varying topography Journal of Fluid Mechanics, 162, 187-209.
* Kirby, J. T. and Dalrymple, R. A., 1986. Modelling waves in surfzones and around islandsJournal of Waterway, Port, Coastal and Ocean Engineering, 112, 78-93.
* Kirby, J. T. and Dalrymple, R. A., 1987. Approximate modelling of nonlinear dispersion in monochromatic wave models Coastal Engineering, 9, 545-561, 1986, and reply to discussions, 11, 87-92.
* Kirby, J. T., 1986. Open boundary condition in the parabolic equation method Journal of Waterway, Port, Coastal and Ocean Engineering, 112, 460-465.
* Kirby, J. T., 1986. Rational approximations in the parabolic equation method for water waves Coastal Engineering, 10, 355-378.
* Kirby, J. T., 1988. Parabolic wave computations in non-orthogonal coordinate systems, Journal of Waterway, Port, Coastal and Ocean Engineering, 114, 673-685.
* Kirby, J. T., Dalrymple, R. A. and Kaku, H., 1994. Parabolic approximations for water waves in conformal coordinate systems, Coastal Engineering, 23, 185-213.
* Work, P.A., and Kaihatu, J.M., 1997. Wave transformation at Pensacola Pass, Florida, Journal of Waterway, Port, Coastal and Ocean Engineering, 123, 314-321, Doi: ([http://dx.doi.org/10.1061/(ASCE)0733-950X(1997)123:6(314) 10.1061/(ASCE)0733-950X(1997)123:6(314)]).
* Chawla, A., Özkan-Haller, H. T. and Kirby, J. T., 1998. Spectral model for wave transformation and Breaking over irregular bathymetry, Journal of Waterway, Port, Coastal and Ocean Engineering, 124, 189-198, Doi: ([http://dx.doi.org/10.1061/(ASCE)0733-950X(1998)124:4(189) 10.1061/(ASCE)0733-950X(1998)124:4(189)]).
* Raichle, A. W., 1998. Numerical predictions of surfing conditions at Mavericks, California, Shore and Beach, 66(2), 26-30.
Kirby, J. T. and Misra, S. K.,1998.  A note on the modified mild-slope equation, submitted to Journal of Fluid Mechanics.
|Manual model available=Yes
|Manual model available=Yes
|Model manual=REF-DIF users manual 1993.pdf, Refdif1v30-2002.pdf,
|Model manual=REF-DIF users manual 1993.pdf, Refdif1v30-2002.pdf,

Revision as of 15:51, 25 June 2013



REF-DIF


Metadata

Also known as
Model type Single
Model part of larger framework
Note on status model
Date note status model
Spatial dimensions 1D
Spatial extent Continental, Regional-Scale
Model domain
One-line model description Phase-resolving parabolic refraction-diffraction model for ocean surface wave propagation.
Extended model description REF/DIF is a phase-resolving parabolic refraction-diffraction model for ocean surface wave propagation. It was originally developed by Jim Kirby and Tony Dalrymple starting in 1982, based on Kirby's dissertation work. This work led to the development of REF/DIF 1, a monochromatic wave model.
Keywords:

wave dynamics,

Name James Kirby
Type of contact Model developer
Institute / Organization University of Delaware, Department of Civil EngineeringCenter for Applied Coastal Research
Postal address 1
Postal address 2
Town / City Newark
Postal code 19716
State Delaware
Country USA"USA" is not in the list (Afghanistan, Albania, Algeria, Andorra, Angola, Antigua and Barbuda, Argentina, Armenia, Australia, Austria, ...) of allowed values for the "Country" property.
Email address kirby@udel.edu
Phone (302) 831-2438
Fax (302) 831-1228


Supported platforms
Unix, Linux, Windows
Other platform There is a special version of REF/DIF (v2.5) for dos
Programming language

Fortran77

Other program language
Code optimized Single Processor
Multiple processors implemented
Nr of distributed processors
Nr of shared processors
Start year development 1982
Does model development still take place? Yes
If above answer is no, provide end year model development
Code development status
When did you indicate the 'code development status'?
Model availability As code
Source code availability
(Or provide future intension)
Through web repository
Source web address http://chinacat.coastal.udel.edu/programs/refdif/refdif.html
Source csdms web address
Program license type Other
Program license type other GNU General Public License, Version 2
Memory requirements --
Typical run time --


Describe input parameters The input includes file names for output, subgrid information, physical parameters and wave conditions. Water depth is obtained from the master program though a file name for water depth input is still kept in "indat.dat".
Input format Binary
Other input format
Describe output parameters Model output:
  • Complex amplitude,
  • Wave Heights and angles
  • Radiation stresses and forcing terms
  • Wave induced mass flux
  • Velocity moments for bottom stress calculation
Output format Binary
Other output format
Pre-processing software needed? Yes
Describe pre-processing software In cases where the standard required the use of a non-typical format (as in the use of the machine-independent binary HDF formats for large arrays), then the data transfer to and from LRSS is handled using a pre- and post-processing layer.
Post-processing software needed? Yes
Describe post-processing software In cases where the standard required the use of a non-typical format (as in the use of the machine-independent binary HDF formats for large arrays), then the data transfer to and from LRSS is handled using a pre- and post-processing layer.
Visualization software needed? No
If above answer is yes
Other visualization software


Describe processes represented by the model See manual version3
Describe key physical parameters and equations See manual version3
Describe length scale and resolution constraints Assumptions:

The REF/DIF 1 model, in parabolic form, has a number of assumptions inherent in it and it is necessary to discuss these directly. These assumptions are:

  1. Mild bottom slope.
  2. Weak nonlinearity.
  3. The wave direction is confined to a sector ±70 ◦ to the principal assumed wave direction, due to the use of the minimax wide angle parabolic approximation of Kirby (1986b).
Describe time scale and resolution constraints --
Describe any numerical limitations and issues --


Describe available calibration data sets
Upload calibration data sets if available:
Describe available test data sets
Upload test data sets if available:
Describe ideal data for testing


Do you have current or future plans for collaborating with other researchers? --
Is there a manual available? Yes
Upload manual if available: Media:REF-DIF users manual 1993.pdf, Media:Refdif1v30-2002.pdf
Model website if any http://chinacat.coastal.udel.edu/programs/refdif/refdif.html
Model forum / discussion board --
Comments Both codes are undergoing extensive revisions needed to incorporate them into the framework of the NearCoM Nearshore Community Model.


This part will be filled out by CSDMS staff

OpenMI compliant No not possible
BMI compliant No not possible
WMT component Not yet"Not yet" is not in the list (Yes, In progress, No but possible, No not possible) of allowed values for the "Code CMT compliant or not" property.
PyMT component
Is this a data component
Can be coupled with:
Model info
James Kirby
Nr. of publications: 18
Total citations: 1840
h-index: 14
m-quotient: 0.33

Link to this page



Introduction

History

References


Source code

Suggested way to reference a version of the model source code following data reference guidelines:


The part "]]" of the query was not understood.</br>Results might not be as expected.
Publication(s)Model describedCitations


Overview and general


The part "]]" of the query was not understood.</br>Results might not be as expected.
Publication(s)Model describedCitations


Applications


The part "]]" of the query was not understood.</br>Results might not be as expected.
Publication(s)Model describedCitations


Related theory and data


The part "]]" of the query was not understood.</br>Results might not be as expected.
Publication(s)Model describedCitations

Issues

Help

Input Files

Output Files