Model:REF-DIF: Difference between revisions

From CSDMS
m renamed model without "/" as it will cause problems with subpages
 
m Text replacement - "{{End headertab}}" to "{{End headertab}} {{{{PAGENAME}}_autokeywords}}"
 
(40 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Model identity
|Model type=Single
}}
{{Start models incorporated}}
{{End a table}}
{{Model identity2
|ModelDomain=Coastal
|Spatial dimensions=1D
|Spatialscale=Continental, Regional-Scale
|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.
}}
{{Start model keyword table}}
{{Model keywords
|Model keywords=wave dynamics
}}
{{End a table}}
{{Modeler information
{{Modeler information
|First name=James
|First name=James
Line 6: Line 23:
|Town / City=Newark
|Town / City=Newark
|Postal code=19716
|Postal code=19716
|Country=United States
|State=Delaware
|State=Delaware
|Country=USA
|Email address=kirby@udel.edu
|Email address=kirby@udel.edu  
|Phone=(302) 831-2438
|Phone=(302) 831-2438
|Fax=(302) 831-1228
|Fax=(302) 831-1228
}}
{{Model identity
|Model type=Single
|Categories=Coastal
|Spatial dimensions=1D
|Spatialscale=Continental, Regional-Scale
|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.
}}
}}
{{Model technical information
{{Model technical information
Line 29: Line 38:
|Model availability=As code
|Model availability=As code
|Source code availability=Through web repository
|Source code availability=Through web repository
|Source web address=http://chinacat.coastal.udel.edu/programs/refdif/refdif.html
|Source web address=http://falk.ucsd.edu/modeling/
|Program license type=Other
|Program license type=Other
|Program license type other=GNU General Public License, Version 2
|Program license type other=GNU General Public License, Version 2
|OpenMI compliant=No not possible
|CCA component=No not possible
|IRF interface=No not possible
|Memory requirements=--
|Memory requirements=--
|Typical run time=--
|Typical run time=--
Line 65: Line 71:
|Describe any numerical limitations and issues=--
|Describe any numerical limitations and issues=--
}}
}}
{{Model testing
{{Model testing}}
|Describe available calibration data sets=--
|Describe available test data sets=--
|Describe ideal data for testing=--
}}
{{Users groups model
{{Users groups model
|Do you have current or future plans for collaborating with other researchers?=--
|Do you have current or future plans for collaborating with other researchers?=--
}}
}}
{{Documentation model
{{Documentation model
|Provide key papers on model if any=Refereed Journal Articles:
# Kirby, J.T. and Dalrymple, R.A.,``A parabolic equation for the combined refraction-diffraction of Stokes waves by mildly-varying topography'' Journal of Fluid Mechanics, 136, 453-466, 1983.
# Kirby, J.T., ``A note on linear surface wave-current interaction over slowly varying topography'' Journal of Geophysical Research, 89, 745-747, 1984.
# Dalrymple, R.A., Kirby, J.T. and Hwang, P.A., ``Wave diffraction due to areas of energy dissipation'' Journal of Waterway, Port, Coastal and Ocean Engineering, 110, 67-79, 1984.
# Kirby, J.T. and Dalrymple, R.A., ``Verification of a parabolic equation for propagation of weakly-nonlinear waves'' Coastal Engineering, 8, 219-232, 1984.
# Kirby, J.T., ``A general wave equation for waves over rippled beds'' Journal of Fluid Mechanics, 162, 171-186, 1986.
# Kirby, J. T., ``On the gradual reflection of weakly-nonlinear Stokes waves in regions with varying topography'' Journal of Fluid Mechanics, 162, 187-209, 1986.
# Kirby, J. T. and Dalrymple, R. A., ``Modelling waves in surfzones and around islands''Journal of Waterway, Port, Coastal and Ocean Engineering, 112, 78-93, 1986.
# Kirby, J. T., ``Higher-order approximations in the parabolic equation method for water waves'' Journal of Geophysical Research, 91, 933-952, 1986.
# Kirby, J. T. and Dalrymple, R. A., ``Approximate modelling of nonlinear dispersion in monochromatic wave models'' Coastal Engineering, 9, 545-561, 1986, and reply to discussions, 11, 87-92, 1987.
# Kirby, J. T., ``Open boundary condition in the parabolic equation method'' Journal of Waterway, Port, Coastal and Ocean Engineering, 112, 460-465, 1986.
# Kirby, J. T., ``Rational approximations in the parabolic equation method for water waves'' Coastal Engineering, 10, 355-378, 1986.
# Kirby, J. T., ``Parabolic wave computations in non-orthogonal coordinate systems'', Journal of Waterway, Port, Coastal and Ocean Engineering, 114, 673-685, 1988.
# Kirby, J. T., Dalrymple, R. A. and Kaku, H., ``Parabolic approximations for water waves in conformal coordinate systems'', Coastal Engineering, 23, 185-213, 1994.
# Work, P.A., and Kaihatu, J.M., ``Wave transformation at Pensacola Pass, Florida'', Journal of Waterway, Port, Coastal and Ocean Engineering, 123, 314-321, 1997.
# Chawla, A., Özkan-Haller, H. T. and Kirby, J. T., ``Spectral model for wave transformation over irregular bathymetry'', Journal of Waterway, Port, Coastal and Ocean Engineering, 124, 189-198, 1998.
# Raichle, A. W., "Numerical predictions of surfing conditions at Mavericks, California", Shore and Beach, 66(2), 26-30, 1998.
# Kirby, J. T. and Misra, S. K., ``A note on the modified mild-slope equation'', submitted to Journal of Fluid Mechanics, October 1998
Refereed Abstracts and Conference Proceedings
# Kirby, J. T. and Dalrymple, R. A., ``Propagation of weakly nonlinear surface waves in the presence of varying depth and currents'', Proc. 20th Congress Int. Assoc. Hydraulic Research 7, 198-202, Moscow, September, 1983.
# Dalrymple, R. A., Kirby, J. T. and Mann, D. W., ``Wave propagation in the vicinity of islands''Proc. 16th Offshore Technology Conf., Houston, 249-253, May, 1984.
# Kirby, J. T., ``Large-angle parabolic equation methods''Proc. 20th International Conference on Coastal Engineering, Taipei, November, 1986.
# Dalrymple, R. A., Kirby, J. T. and Seli, D. J., ``Wave trapping by breakwaters''Proc. 20th International Conference on Coastal Engineering, Taipei, November, 1986.
# Kaihatu, J. M. and Kirby, J. T., ``Frequency-domain water wave evolution in finite depth'', 1991 AGU Fall Meeting, December 1991. EOS, Transactions AGU, 72, Fall Meeting Suppl., 253, 1991 (abstract only).
# Kirby, J. T., ``Water waves in variable depth under continuous sea ice'', Proc. 2nd Intl. Offsh. and Polar Engrng. Conf., 70-76, San Francisco, June 14-19, 1992.
# Kirby, J. T. and Dalrymple, R. A., ``Parabolic and angular spectrum wave models in conformally-mapped coordinate systems'', Advances in Hydro- Science and Engineering, S. S-Y. Wang (ed), 1563-1570, Washington, June 1993.
# Özkan, H. T. and Kirby, J. T., ``Evolution of breaking directional spectral waves in the nearshore zone'', Proc. Waves '93, ASCE, 849-863, New Orleans, July 25-28, 1993.
# Cox, M. O., Howd, P. A. and Kirby, J. T., ``Shoreface geological control of nearshore wave energy'', submitted for Geol. Soc. Am. meeting, 1995.
# Cox, M. O., Howd, P. A. and Kirby, J. T. ``Application of a weakly non-linear wave refraction/diffraction model to the Wimble Shoals, NC region'', AGU Fall Meeting, 1995.
# Chawla, A., Özkan-Haller, H. T. and Kirby, J. T., ``Experimental study of breaking waves over a shoal'', Proc. 25th Intl. Conf. Coast. Engrng., Orlando, 2-15, 1996.
# Kaihatu, J.M., Rogers, W.E., Hsu, Y.L., and O'Reilly, W.C. "Use of phase resolving numerical wave models in coastal areas," Fifth International Workshop on Wave Hindcasting and Forecasting, Melbourne FL, 389-403, 1998.
Additional Technical Reports
# Kirby, J.T., ``Propagation of weakly-nonlinear surface water waves in regions with varying depth and current'', Department of Civil Engineering, University of Delaware, Research Report CE-83-37, July, 1983. (also Ph.D. dissertation)
# Kirby, J.T., ``Water wave propagation over uneven bottoms'', Coastal and Oceanographic Engineering Department, University of Florida, Technical Report UFL/COEL-TR/055, January, 1985.
# Dalrymple, R.A. and Kirby, J.T., ``Wave modification in the vicinity of islands. REF/DIF 1 Documentation manual'', Coastal and Offshore Engineering and Research, Inc., Newark, DE., January, 1985. (Revised June, 1986)
# Kirby, J.T. and Dalrymple, R.A., ``Combined refraction/diffraction model REF/DIF 1, user's manual'', Coastal and Offshore Engineering and Research, Inc., Newark, DE., January, 1985. (Revised June, 1986)
# Kaku, H. and Kirby, J.T., ``A parabolic model in polar coordinates for breakwater harbors'', Tech. Report UFL/COEL-TR/075, Coastal and Oceanographic Engineering Department, University of Florida, Gainesville, May, 1988.
# Kirby, J. T. and Ozkan, H. T., 1992, ``Combined Refraction/Diffraction Model for Spectral Wave Conditions REF/DIF S, Version 1.0. Documentation and User's Manual'', Research Report No. CACR-92-06, Center for Applied Coastal Research, Department of Civil Engineering, University of Delaware, Newark.
# Kirby, J. T. and Dalrymple, R. A., 1993, ``Combined Refraction/Diffraction Model REF/DIF 1, Version 2.4. Documentation and User's Manual'', Research Report No. CACR-92-04, Center for Applied Coastal Research, Department of Civil Engineering, University of Delaware, Newark.
# Kirby, J. T. and Özkan, H. T., 1994, ``Combined Refraction/Diffraction Model for Spectral Wave Conditions REF/DIF S, Version 1.1. Documentation and User's Manual'', Research Report No. CACR-94-04, Center for Applied Coastal Research, Department of Civil Engineering, University of Delaware, Newark.
# Kirby, J. T. and Dalrymple, R. A., 1994, ``Combined Refraction/Diffraction Model REF/DIF 1, Version 2.5. Documentation and User's Manual'', Research Report No. CACR-94-22, Center for Applied Coastal Research, Department of Civil Engineering, University of Delaware, Newark.
# Kaihatu, J. M., 1997, ``Review and verification of numerical wave models for near coastal areas - Part 1: Review of mild-slope equation, relevant approximations, and technical details of numerical wave models'', NRL/FR/7322--97-9669, Naval Research Laboratory, 27 pp.
# Rogers, W. E., Kaihatu, J. M. and Hsu, Y. L., 1998, ``Review and verification of numerical wave models for near coastal areas - Part 2: Verification of near coastal numerical wave models'', NRL/FR/7322--97-9680, Naval Research Laboratory, 103 pp.
# Hsu, Y.L., J.K. Kaihatu and A. MacNaughton, 1998. Validation test report for coastal wave refraction and diffraction model, NRL formal report, NRL/FR/7322-97-9664, 24 pp.
# R. Allard, L. Hsu, M.Collins, J. McKee Smith, M. Earle and K. Miles, 1998, ``Use of Coupled Numerical Wave and Surf Models to Simulate the Littoral Environment from Deep Water to the Beach'', NRL/FR/7322--98-9688, 48 pp.
|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,
|Model website if any=http://chinacat.coastal.udel.edu/programs/refdif/refdif.html
|Model website if any=http://chinacat.coastal.udel.edu/programs/refdif/refdif.html
|Model forum=--
|Model forum=--
}}
}}
{{Additional comments model
{{Additional comments model
|Comments=Both codes are undergoing extensive revisions needed to incorporate them into the framework of the NearCoM Nearshore Community Model.  
|Comments=Both codes are undergoing extensive revisions needed to incorporate them into the framework of the NearCoM Nearshore Community Model.
}}
{{CSDMS staff part
|OpenMI compliant=No but possible
|IRF interface=No but possible
|CMT component=No but possible
|CCA component=No but possible
}}
}}
{{Start coupled table}}
{{End a table}}
{{End headertab}}
{{{{PAGENAME}}_autokeywords}}
<!-- PLEASE USE THE "EDIT WITH FORM" BUTTON TO EDIT ABOVE CONTENTS; CONTINUE TO EDIT BELOW THIS LINE -->
<!-- PLEASE USE THE "EDIT WITH FORM" BUTTON TO EDIT ABOVE CONTENTS; CONTINUE TO EDIT BELOW THIS LINE -->
==Introduction==
==Introduction==


== History ==
== History ==


== Papers ==
== References  ==
<br>{{AddReferenceUploadButtons}}<br><br>
{{#ifexist:Template:{{PAGENAME}}-citation-indices|{{{{PAGENAME}}-citation-indices}}|}}<br>
{{Include_featured_references_models_cargo}}<br>


== Issues ==
== Issues ==


== Help ==
== Help ==
{{#ifexist:Model_help:{{PAGENAME}}|[[Model_help:{{PAGENAME}}]]|}}


== Input Files ==
== Input Files ==


== Output Files ==
== Output Files ==
== Download ==
== Source ==

Latest revision as of 20:17, 16 September 2020



REF-DIF


Metadata

Also known as
Model type Single
Model part of larger framework
Note on status model
Date note status model
Incorporated models or components:
Spatial dimensions 1D
Spatial extent Continental, Regional-Scale
Model domain Coastal
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 United States
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://falk.ucsd.edu/modeling/
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 but possible
BMI compliant No but possible
WMT component No but possible
PyMT component
Is this a data component
Can be coupled with:
Model info
Authors
James Kirby
Source code
Model citations
Nr. of publications: 18
Total citations: 1840
h-index: 14
m-quotient: 0.33
QR-code

Link to this page
Other models by author



Introduction

History

References



Nr. of publications: 18
Total citations: 1840
h-index: 14
m-quotient: 0.33



Featured publication(s)YearModel describedType of ReferenceCitations
Dalrymple, Robert A.; Kirby, James T.; Hwang, Paul A.; 1984. Wave Diffraction Due to Areas of Energy Dissipation. Journal of Waterway, Port, Coastal, and Ocean Engineering, 110, 67–79. 10.1061/(ASCE)0733-950X(1984)110:1(67)
(View/edit entry)		1984 REF-DIF
 Model overview 526
Kirby, James T.; Dalrymple, Robert A.; 1983. A parabolic equation for the combined refraction–diffraction of Stokes waves by mildly varying topography. Journal of Fluid Mechanics, 136, 453. 10.1017/S0022112083002232
(View/edit entry)		1983 REF-DIF
 Model overview 203
See more publications of REF-DIF


Issues

Help

Input Files

Output Files

Retrieved from "https://csdms.colorado.edu/csdms_wiki/index.php?title=Model:REF-DIF&oldid=299947"