Documentation and Help for GenCade Ashley Frey

Transcription

1 Documentation and Help for Ashley Frey Research Civil Engineer, Co-PI of the Inlet Engineering Toolbox work unit of CIRP

2 Report Documentation Page Form Approved OMB No Public reporting burden for the collection of information is estimated to average 1 hour per response, including the time for reviewing instructions, searching existing data sources, gathering and maintaining the data needed, and completing and reviewing the collection of information. Send comments regarding this burden estimate or any other aspect of this collection of information, including suggestions for reducing this burden, to Washington Headquarters Services, Directorate for Information Operations and Reports, 1215 Jefferson Davis Highway, Suite 1204, Arlington VA Respondents should be aware that notwithstanding any other provision of law, no person shall be subject to a penalty for failing to comply with a collection of information if it does not display a currently valid OMB control number. 1. REPORT DATE OCT TITLE AND SUBTITLE Documentation and Help for 2. REPORT TYPE 3. DATES COVERED to a. CONTRACT NUMBER 5b. GRANT NUMBER 5c. PROGRAM ELEMENT NUMBER 6. AUTHOR(S) 5d. PROJECT NUMBER 5e. TASK NUMBER 5f. WORK UNIT NUMBER 7. PERFORMING ORGANIZATION NAME(S) AND ADDRESS(ES) U.S. Army Corps of Engineers,U.S. Army Engineer Research and Development Center,3909 Halls Ferry Road,Vicksburg,MS, PERFORMING ORGANIZATION REPORT NUMBER 9. SPONSORING/MONITORING AGENCY NAME(S) AND ADDRESS(ES) 10. SPONSOR/MONITOR S ACRONYM(S) 12. DISTRIBUTION/AVAILABILITY STATEMENT Approved for public release; distribution unlimited 13. SUPPLEMENTARY NOTES. 14. ABSTRACT 11. SPONSOR/MONITOR S REPORT NUMBER(S) 15. SUBJECT TERMS 16. SECURITY CLASSIFICATION OF: 17. LIMITATION OF ABSTRACT a. REPORT unclassified b. ABSTRACT unclassified c. THIS PAGE unclassified Same as Report (SAR) 18. NUMBER OF PAGES 7 19a. NAME OF RESPONSIBLE PERSON Standard Form 298 (Rev. 8-98) Prescribed by ANSI Std Z39-18

3 Documentation CIRP Website CIRP Wiki 2

4 on CIRP Website ~ ~ Bouss-20 CMS CPT I CPT Lite Inlet Res. Model (IRM) RMAP II SBAS Shoaling Toolbox, Version 1.0 Is a newly developed numerical model which combines the engineering power of GENESIS and the regional processes capability of the Cascade model. calculates shoreline change, wave-induced long-shore sand transport, and morphology change at inlets on a local to regional scale and can be applied as a planning or engineering tool. is operated within the Sur1ace-water Modeling System inter1ace, bringing fun c~ona lity of a georeferenced environment together with accessibility to other U.S. Army Corps of Engineers numerical models. Is being developed jointly by CIRP and the Regional Sediment Management (RSM) program. version 1.0 (release) System Requirements: Surtace-water Modeling System (SMS) version 11 1 beta (when available). For the latest version of SMS 11, see SMS tab above Gencade 1 0 l-400 KB zip file! - updated April l Fact Sheet: Yerslon 1 (PDF) Available Documentation: Documentation is under developement. A User's Guide is in progress and is located on the following wiki page: http1jcjm us ace army mjlfw!kl/. A Technical Report describing will be available in Summer Principal Point of Contact: Ashley Frey Ema 1: Ashley.E.Frelt@usace.armv.mil m. Engineer Research and Development Center 3909 Halls Ferry Road Vicksburg, MS Rill/ tltnr.!':trtlnr. ERDC 3

5 on CIRP Wiki Log in I create account rt! Page DISCUSSIOn Read View source View history Search Main page CIRP products CIRP publications CMS Main Page CMS Doc Portal Help links CIRP Website CHL Website USACE Navigation Gateway Aquaveo Website wiki resources Toolbox Forum Menu Print/export is a 1 D model that combines GENESIS and Cascade. It is operated within the Surface-water Modeling System (SMS) interface The first official release of is expected to occur in 2011 A beta version of is presently available and can be obtained by contacting the POC below. A user guide, examples of simple cases, applications, frequently asked questions, and important information will be posted here. A Technical Report is presently being drafted. GENESIS + Cascade 7 ~ c;nsafc ftpt tp bgttgmt PIIMIOCtool lllsm S.-) T1«1e sulft: month1 to ctf'ltvfln MYitlplelaltU.ItMNk, ancf b.lrrl ldi~ cumyiattvelnt~; ttuim curvjtu,.. of,.....,.,,_..cwp~~o~ocy,.., Typicatlricf rt'soiu1ion- SOD 1111'1 Crou ~W proc1un "- future gcw\!s wsw 'A tppl hc1nmrr dnfc" tool can,.pr...ntal.,.,...,.,. dttalll: suucturu.n. ~twe t«hnchotv- blc ~yb.xlt by pd ti.. 1Wkolatlollmollaloo u., StrJt JY! Add CtscMe apabiilihtogen SIS to ivtointic:iii'y inc ludell GE:NESISfeilt.nt. IMttr.. te from plan nina: thto.a,h ~~ r'n& dtsi&n Ccwc-r 'hne Ita lots from d~to cen1urles Pt~~rt-&ienal trt"nds FIM"nkl\ ttlkm'iattvconsistef\t bo&i.wluy co.dttio.s to louliwofe«s Rt:prewnc cumul.nive loco~ l projecuint~tk11ftc re&buly llttpres.nt ln.. t bypjnfa& and tjd1t dtft1 t"ttolutlon b:solvt.,.r... r.ctc.-.m-.,ts lndude YJtiJbte t r1d rhohttlon for ae<wuyand tffkltwt I utjuoui Hkit owrqen SIS Figure t Combination of GENESIS and Cascade m. was highlighted during tv;o CIRP workshops in The first took place in February in JacksonVille, FL. This was the first workshop to include. About 25 students listened to several presentations, watched a demonstration, and participated in a hands-on example. A full day session of was featured in san Diego in August The next CIRP Workshop is scheduled for March in Philadelphia. An overview of all CIRP tools, including Gencade, will be given on the first morning. A hands-on session of 'Mil take place dunng the second afternoon. ERDC 4

6 on CIRP Wiki Documentation user Guide ! L'l.~:'t"! 1..._ Getting Started Preparing Input Files Grid Setup Files, Menu, Model Setup, and Execution Developing AlternatiVes Executable Input Files Output Files Parameters TutoriaL/Example Boundary Conditions Wave Input Applications Model Calibration Technical Documentation Frequently Asked Questions Main ~ag e CIRP product s CIRP publicat ion3 CMS ~~ a i n Page CM S Doc Portal Help links CIRP W ebs ite CHL Website USACE Nalligatio n Gatewa y Aqu 3ve o Website \11/iki resources Toolbox Fort.rn Menu Print/e xport Page Ciscussion Read View source Vie\11 history arch Users Guide 1. Getting Started & Log in lcreate account Thi S Gencaoe QJide was last updated In January Most or :he scree1snots used In tnls guide were createc Wltn tne.t..ugust 19, 2011, build ct the SMS Developers are constantly upgrad in~ the SMS and Gen::ade exe:utab les. so the graphics in a future version may l oo~ slightly arrerent than the visuals included in this user guide A ve ry simple example car be founc here_ Ths example shows all st eps necessary :o produc~ results and inctuces a zip fte with all of the input and output files that car be used to reprodjce the results on another computer 1.1 Setup in the SMS GenCaje is run 'Nithin the SMS 11.1 Development. SMS 11.0 and earlier versions dj not have interfaces for. This section will guide a user through the process to set up the conceptual mode l, convert to a 10 grid, review the model, n.r1 GenCaje, visualze results. and de\:elop alternatives_ It is assurre d that the reader 1as no pr~vious experience with f ir::.t, t!-e GenC~d e exec.ut~b!e mu::.t be identtied on Ul=: m~ c.h ine_ T!1e GenC ~de exe c ut~b!e -~~~if! be ~ome vmi~ tion of GenCaje_v1_.e:{e. Thi s ex:ecutable must be placed in :he models folder mder SMS Th~ folder contain ing SMS 11.1 will most!ikety be located in Program Files Once SMS 11.1 is open on the machine, it is necessarr to specitr the location of the execut<:ble. If thi ~ is specified incorrectly or not at all, GmCade wmi not run_ln order to indicat e the location of the executa tie, it is necessary t o click on Ed it. go to Preferences. and click on the tab labeled file LocatiOns. The user sholtd scroll cown to under Moc"el Execuf.~tJJes and click on BRONSE. Once the execltable is selected, tre path fo ' the executable shjuld be li sted unde' MOdel Execuf.atJJes next to _ Figure 1 show3 the File Location~ window = rt! m. Figure 1. Define rrodel execu:able ERDC 5

7 ... on CIRP Wiki Documentation user Guide Getting Started Preparing Input Files Grid Setup Input Files Output Files Parameters TutoriaL/Example Boundary Conditions Wave Input Applications Model Calibration Technical Documentation Frequently Asked Questions Main page CIRP prod uct s CIRP publication s CMS Ma in Pag~ CMS Doc Po rt ~ l Help li n k~ CIRP Webs it ~ CIIL Web!iit e USACE Naloigation Gateway Aquaveo W ebs ite \11/iki resources Toolbox Fon.rn Menu Print/export Page Discussion Read View source \'1ew histay arch Input Files & Log in l create account After saving the project. several files will be created ir the user specified folder_ These fles inclu::le "_gen "_ shi, * shr.... wave... shcx. and ":1111. For ex:ample. r the nane or the pro;ect is test. tre input fles would be named test.gen. test Shi. test shr. and test_wave1.wave. In order to run, at lea5t the ".g en. ".wave, and ".3hi files are needed. The ~. sh r file is neces:>ary for a ccse with a regional contour, while "_shdx is created \lllhen variable grid resolution occurs The " 1 1 file is only crea:e d when using tlme-aepenaent wave transm13s1on ror a aetacnea ore<*<wate r The" gen file is the control fil e The first section of this 'ile lists information about the other input a1d outplt files_ The first lin e und3r files snows the p ath f or the location of the initial shoreline. If the case has a r egion31 contotx, the next!ine wil list the kj cation for ltle regional contcur. The next line specifies the number of W3Ve gages includ=d for the simulation \llltlile the next lines list the cell of the wave gage, the depth, nu mber of time st=ps for the wave informaton, and :he path for each wave gcg e_ The n ext section of the ~_ge n file is the mjdel setup_ This section includes t1e grid crigin and orientation. the simulation start and end date, the :ime s te~. the ton~sho re sand transport coefficients (K1 and K2), and the nunber or cell s in the offshore contolr smoothing winoow (ISI\.IOOTH). The nex: section of the ".gen fite i ~ the waves section. This ;ection includes the heigrt amplification factor, angle am~lifi cation factor, Gr'ld angle offset. The 050, berm height, closure de~h. and boundary conditims are round umer the beach heajing_ Seawalls, beach fills, inlets. ~ra ins. and other eatures included in the conceptu c::l model foiio'iiii the beach se ction in the " gen file rf! Fi9-1re 1. Example ".ge1 Left p<t1e l is top ) ffile The... shi file is the initial shoreline data file. Ea:h number in this file repr :=! sents a cell, anc the number is tte distance the sroreline is offset f or t1 e basel n e Ho(oOI m. [lihi at\ - a ~ ~:i;~~=~~.:.:~;:;~~=;... '"'"" uu.-n:.- :u u.o.u "'" '-~Ml"'' '"',_,_,,,, - - u.--. u " _... ~-. ~ - "" uw. n u n.tos "- '" " '"' ltf4j.- usn... t n '"''"... t«y.u4 l "' o. o.ll ~C-:1.- l-0-l.. UtGI.- ~~... l#li, UO IUU.SO't l«rr,isi u..... ~ - -._...,..., n '- " - '"" "'" '"' ttmi.-'"u :u ln>o.n>,.,..., ~,,._.,.,,_,, ,...,._..,, :.. - fl._, _ ,_......,... ~~ fuj",iu f$oiii,n UIU... IWif,UI fum.tlf 1-.Nt Utt$.1+t IMN- fmi'td,_. u-.- tuo.~o: lun... uuo. u lua.jh tuot.ou ' "" "',....,. IUN.ou u... - U IM.UI UU:.>U >U M.- UI... IM >UU.ft.... UIU... UUO. OI' OUM.- Ul... - '"" ~ - _ ERDC 6

8 Technical Reports and Technical Notes Rosati III, J., Frey, A. E., Brown, M. E., and Lin, L Analysis of Dredged Material Placement Alternatives for Bottleneck Removal, Matagorda Ship Channel, Texas. ERDC/CHL TR Vicksburg, MS: U.S. Army Engineer Research and Development Center. Thomas, R., and Dunkin, L Erosion Control and Environment Restoration Plan Development, Matagorda County, Texas, Phase 1: Preliminary Investigation. ERDC/CHL TR Vicksburg, MS: U.S. Army Engineer Research and Development Center. Beck, T. M., and Legault, K Optimization of Ebb Shoal Mining and Beach Nourishment at St. Johns County, St. Augustine Inlet, Florida. ERDC/CHL TR-12-14; Report 3. Vicksburg, MS: U.S. Army Engineer Research and Development Center. Frey, A.E., Munger, S., Williams, G.L., Wutkowski, M.J., and Conner, K.J Application at Onslow Bay, North Carolina. ERDC/CHL CHETN-IV-85. Vicksburg, MS: U.S. Army Engineer Research and Development Center. (In printing) Frey, A.E., Connell, K.J., Hanson, H., Larson, M., Thomas, R.C., Munger, S., and Zundel, A Version 1 Model Theory and User s Guide. ERDC/CHL TR-12-XX. Vicksburg, MS: U.S. Army Engineer Research and Development Center. 7