ROMS/TOMS User Manual

Discussions, suggestions and corrections to ROMS/TOMS documentation currently under developement.

Moderators: arango, robertson

Post Reply
Message
Author
User avatar
robertson
Site Admin
Posts: 121
Joined: Wed Feb 26, 2003 3:12 pm
Location: IMCS, Rutgers University

ROMS/TOMS User Manual

#1 Post by robertson » Fri Jul 30, 2004 7:49 pm

Dear Users,

We have begun developement on the ROMS/TOMS users manual. Since we are a community model, we have decided to make the developement of the manual a community effort as well. We started from the old SCRUM manual and plan to upgrade its information accordingly. Please visit:

http://www.myroms.org/documentation/docs.php

to view the very rough first draft of the ROMS/TOMS users manual.

Feel free to post any corrections or suggestions in this forum under the appropriate topic(s). Keep in mind that this is a work in progress and many areas of the documentation are not yet ready to be posted on the web. We will post updates and additions to the above site as they become available. We are hoping that some of the advanced users will help us to accomplish this time-consuming task. The users are the ones who know what level of documentation is needed. We as developers can take many issues regarding ROMS/TOMS usage for granted.

Thank you for your interest in ROMS

User avatar
kate
Posts: 3682
Joined: Wed Jul 02, 2003 5:29 pm
Location: IMS/UAF, USA

Re: ROMS/TOMS User Manual

#2 Post by kate » Fri Nov 13, 2009 1:33 am

Hmm, did anything ever come of this? :twisted:

My current draft manual is here. Again, this is a draft. It is also the manual describing (in part) my branch, not the trunk. Please let me know what I've missed :shock: , what I've gotten wrong :roll: , etc. Yes, I know about the "must update for ROMS" in the boundary condition section. :?

Some parts have made it to the wiki, some not.

User avatar
kate
Posts: 3682
Joined: Wed Jul 02, 2003 5:29 pm
Location: IMS/UAF, USA

Re: ROMS/TOMS User Manual

#3 Post by kate » Tue Nov 24, 2009 8:58 pm

I was reminded that I need to acknowledge ARSC for supporting this. Anyone else? Who should I put as supporting ROMS development? ONR, right? UCLA?

csherwood
Posts: 36
Joined: Fri Apr 02, 2004 4:46 pm
Location: USGS, Woods Hole, USA

Re: ROMS/TOMS User Manual

#4 Post by csherwood » Wed Nov 25, 2009 2:28 pm

Hi Kate,

The USGS should be mentioned as ROMS supporters, as should the National Ocean Partnership Program.

Cheers, Chris
Chris Sherwood, USGS
1 508 457 2269

User avatar
kate
Posts: 3682
Joined: Wed Jul 02, 2003 5:29 pm
Location: IMS/UAF, USA

Re: ROMS/TOMS User Manual

#5 Post by kate » Wed Nov 25, 2009 5:55 pm

Is there specific verbiage that should be used for either? ARSC has a set phrase for such things.

csherwood
Posts: 36
Joined: Fri Apr 02, 2004 4:46 pm
Location: USGS, Woods Hole, USA

Re: ROMS/TOMS User Manual

#6 Post by csherwood » Wed Nov 25, 2009 7:21 pm

Kate -

Nothing specific. The USGS Coastal and Marine Program has provided in-kind support as salaries of ROMS and CSTMS contributors and smaller contributions to support travel and workshops.

Happy Thanksgiving!
-Chris
Chris Sherwood, USGS
1 508 457 2269

jcwarner
Posts: 798
Joined: Wed Dec 31, 2003 6:16 pm
Location: USGS, USA

Re: ROMS/TOMS User Manual

#7 Post by jcwarner » Thu Nov 26, 2009 2:27 am

I have provided a little more than just "in kind support," and so have many others.
Master/ocean.h is a place to start,
but there are countless others whom have fixed bugs that have been broken and refixed countless times.

! !
! Regional Ocean Model System (ROMS) !
! Terrain-following Ocean Model System (TOMS) !
! !
! Master program to execute ROMS/TOMS drivers in ocean mode only !
! without coupling (sequential or concurrent) to any atmospheric !
! model. !
! !
! This ocean model solves the free surface, hydrostatic, primitive !
! equations over variable topography using stretched terrain- !
! following coordinates in the vertical and orthogonal curvilinear !
! coordinates in the horizontal. !
! !
! Nonlinear Model Developers: !
! !
! Dr. Hernan G. Arango !
! Institute of Marine and Coastal Sciences !
! Rutgers University, New Brunswick, NJ, USA !
! (arango@marine.rutgers.edu) !
! !
! Dr. Alexander F. Shchepetkin !
! Institute of Geophysics and Planetary Physics !
! UCLA, Los Angeles, CA, USA !
! (alex@atmos.ucla.edu) !
! !
! Dr. John C. Warner !
! U.S. Geological Survey !
! Woods Hole, MA, USA !
! (jcwarner@usgs.gov) !
! !
! Tangent linear and Adjoint Models and Algorithms Developers: !
! !
! Dr. Hernan G. Arango (arango@marine.rutgers.edu) !
! Dr. Bruce Cornuelle (bcornuelle@ucsd.edu) !
! Dr. Emanuele Di Lorenzo (edl@eas.gatech.edu) !
! Dr. Arthur J. Miller (ajmiller@ucsd.edu) !
! Dr. Andrew M. Moore (ammoore@ucsc.edu) !
! Dr. Brian Powell (powellb@uscs.edu) !
! !

User avatar
kate
Posts: 3682
Joined: Wed Jul 02, 2003 5:29 pm
Location: IMS/UAF, USA

Re: ROMS/TOMS User Manual

#8 Post by kate » Tue Dec 08, 2009 8:12 pm

I've updated the draft manual with a sketchy "getting started" chapter, also the svn appendix it refers to. Again, poke me if you find that something's missing.

I left the data assimilation gang out of the acknowledgments because it's not a part of this manual.

User avatar
kate
Posts: 3682
Joined: Wed Jul 02, 2003 5:29 pm
Location: IMS/UAF, USA

Re: ROMS/TOMS User Manual

#9 Post by kate » Mon Jun 21, 2010 5:03 pm

Happy Solstice!

I've updated the manual with some boundary condition information. This is probably "good enough" for our documentation commitment to MMS, but you can still feel free to let me know of things to fix.

User avatar
kate
Posts: 3682
Joined: Wed Jul 02, 2003 5:29 pm
Location: IMS/UAF, USA

Re: ROMS/TOMS User Manual

#10 Post by kate » Thu Jun 24, 2010 1:05 am

A few last changes and it's no longer the DRAFT manual. I left the filename the same, though, for consistency.

User avatar
kate
Posts: 3682
Joined: Wed Jul 02, 2003 5:29 pm
Location: IMS/UAF, USA

Re: ROMS/TOMS User Manual

#11 Post by kate » Fri Jan 14, 2011 9:08 am

I have uploaded the manual to the wiki and made a link in the Tutorials section. I have also uploaded all my slides from the Hong Kong workshop and put in links under Tutorials. More to come when I get Dale and Gan's slides.

User avatar
kate
Posts: 3682
Joined: Wed Jul 02, 2003 5:29 pm
Location: IMS/UAF, USA

Re: ROMS/TOMS User Manual

#12 Post by kate » Thu May 31, 2012 2:32 pm

There's a new Draft manual over here. Big chunks are the same as before, but I updated the ice description to be a little more consistent with the code.

User avatar
kate
Posts: 3682
Joined: Wed Jul 02, 2003 5:29 pm
Location: IMS/UAF, USA

Re: ROMS/TOMS User Manual

#13 Post by kate » Tue Nov 03, 2015 5:57 pm

I'm working on the manual again and decided to put it on github: https://github.com/kshedstrom/roms_manual. You process it with pdflatex, but the pdf file is there too.

User avatar
kate
Posts: 3682
Joined: Wed Jul 02, 2003 5:29 pm
Location: IMS/UAF, USA

Re: ROMS/TOMS User Manual

#14 Post by kate » Wed Dec 09, 2015 7:37 pm

I'm done updating the manual for now - it's off to BOEM for review. It's at github as in the prior message, but I guess I should change the wiki link.

User avatar
kate
Posts: 3682
Joined: Wed Jul 02, 2003 5:29 pm
Location: IMS/UAF, USA

Re: ROMS/TOMS User Manual

#15 Post by kate » Tue Apr 26, 2016 4:19 pm

The BOEM review is done and it now has the proper BOEM report number (2016-037). Updated at github.

Post Reply