--- MITgcm/doc/tag-index 2006/05/30 22:49:21 1.662 +++ MITgcm/doc/tag-index 2007/02/08 00:12:37 1.770 @@ -1,9 +1,327 @@ -$Header: /home/ubuntu/mnt/e9_copy/MITgcm/doc/tag-index,v 1.662 2006/05/30 22:49:21 mlosch Exp $ +$Header: /home/ubuntu/mnt/e9_copy/MITgcm/doc/tag-index,v 1.770 2007/02/08 00:12:37 jmc Exp $ $Name: $ Notes on tags used in MITgcmUV ============================== +checkpoint58v_post +o change EOS (from POLY3 to JMD95P) in global_ocean.90x45x15 to get + useDynP_inEos_Zc tested. +o pkg/exf: changes to properly interpolate/mask/scale initial fields +o utils/matlab/cs_grid/read_cs: routines to speed up reading of CS510 fields + and portions thereof. See read_cs.txt for description and examples. +o utils/matlab/cs_grid/bk_line: to compute transport through passages, + add a script (grt_circ_bkl.m) to generate broken-line between 2 points, + following the great-circle arc between those 2 points. +o trap un-initialized variable with pathscale compiler on weddell.mit.edu + (thanks to Constantinos): fix few problems and get (almost) all exp to pass. +o 2nd-Order Moment Advection Scheme (Prather, 1986): first check-in + - enable by setting #define GAD_ALLOW_SOM_ADVECT (in GAD_OPTIONS.h) + - used without limiter (AdvScheme=80) or with Prather limiter (AdvScheme=81) + - still needs work (not working with some options ; efficiency to improve) + and serious testing. + - use this scheme for temperature & salinity in 2 advection test exp.: + advect_xy & advect_xz, respectively. + +checkpoint58u_post +o new test-exp: fizhi-cs-32x32x40 (40 levels) to replace the 10 levels. +o move call to INI_FORCING from PACKAGES_INIT_VARIABLES to INITIALISE_VARIA. +o testreport: add option "-skipdir" to skip some test. +o exf: when input wind-stress (#undef ALLOW_ATM_WIND), by-pass turbulent + momentum calculation. +o gad_advection: fix vertAdvecScheme (if different from advectionScheme) +o some cleaning: usePickupBeforeC35 no longer supported ; remove this option. + remove checkpoint.F and the_correction_step.F (no longer used); + do the k loop inside CYCLE_TRACER (supposed to be more efficient). +o add option (linFSConserveTr) to correct for tracer source/sink due to + Linear Free surface +o pkg/seaice: fix a bug in the flooding algorithm: turn off the snow machine +o pkg/thsice: fix reading mnc-pickups + +checkpoint58t_post +o pkg/diagnostics: fix multi-threaded output (when singleCpuIO=F) +o pkg/mdsio: + - clean-up mdsio_readfield.F & mdsio_writefield_new.F and + move to new files: mdsio_read_field.F (S/R MDS_READ_FIELD) & + mdsio_write_field.F (S/R MDS_WRITE_FIELD); + - fix multi-threaded singleCpuIO option in MDS_WRITE_FIELD + - collect old S/R in one file: mdsio_rw_field.F (now just a call to + either MDS_READ_FIELD or MDS_WRITE_FIELD ) + - new S/R (to replace MDSWRITEMETA), which allows to write more + informations (variable names, time ...) to meta files. + - modify rdmds.m to give back the meta file content. +o pkg/diagnostics: change vertical interpolation to be safer, and more + flexible (define p-levels to interpolate to in data.diagnostics); + add argument to S/R DIAGNOSTICS_GET_POINTERS to catch the right + diagnostic pointer. +o pkg/seaice: more cleaning up of seaice_growth, added many comments +o pkg/exf: put runoff0 and runoff1 into the appropriate common block +o fix multi-category seaice: + - change cpp flag SEAICE_MULTILEVEL to more meaningful name: + SEAICE_MULTICATEGORY + - fix short wave heat flux +o pkg/seaice: change default (SEAICE_OPTIONS.h): use C-grid dynamics + and allow to use EVP solver. Change forward lab_sea: test both EVP + solver and LSR solver, and use C-grid dynamics (like lab_sea adjoint) +o Initial check-in of lab_sea adjoint + (very similar to natl_box_adjoint/code_seaice) + * used C-grid and EVP solver + * used KPP, GM/Redi + * uses inAdExact=.TRUE. + * gradient checks fail for both ADM and TLM + due to sensitive snow melt code in seaice_grwoth (look for "JZ") + f.d. gradients actually seem more problematic than ADM, TLM gradients; + issue is related to forward mismatch between g77 an ifort +o pkg/seaice: overhaul of thermodynamics + - growth.F and groatb.F are replaced by new routine seaice_growth.F + - budget.F is replaced by two new routines seaice_budget_ocean/ice.F + - move a few global fields out of SEAICE.h into seaice_growth.F and + make them 2D (FICE/QNETO/ ...) + - remove FO (it is the same as QNETO) + - introduce a few local fields to avoid modifying external fields such + as atemp, etc. + +checkpoint58s_post +o pkg/exf: moved exf_init_runoff.F to exf_init.F and exf_set_gen.F + changed exf_set_gen.F so that + genperiod=0 means input file is one time-constant field and + genperiod=-12 means input file contains 12 monthly means +o CG2D: use pre-computed solver main-diagonal (stored in common block); + this affects truncation error ; generate new output file for exp. which + fails: exp4(12d), fizhi-cs-aqualev20(12d), front_relax(10d), + global_ocean.90x40x15(10d), global_ocean.cs32x15(10d).thsice(11d).viscA4(10d), + ideal_2D_oce(10d), internal_wave(09d), isomip.htd(11d), matrix_example(07d), + MLAdjust(4x11d,12d), natl_box(11d), rotating_tank(12d), + tutorial_global_oce_in_p(10d), tutorial_plume_on_slope(11d), + vermix(12d).ggl90(12d).my82(11d).opps(12d).pp81(11d) +o start implementation of deep-atmosphere and anelastic formulation +o verification: remove 2nd copy of input files and use script "prepare_run" + to make a symbolic link to the 1rst copy (reduce downloaded size by ~81.M) +o mom_common/vecinv/fluxform: fix a few initialisation isssues +o profiles: fix for multithreaded case + +o diagnostics: rename few diags: + s/'PRESSURE'/'RCENTER '/g + s/'TICE '/'oceFreez'/g + s/'TAUX '/'oceTAUX '/g + s/'TAUY '/'oceTAUY '/g + s/'SWFLUX '/'oceQsw '/g + s/DIFx/DFxE/g + s/DIFy/DFyE/g + and add few ocean-forcing diagnostics: + atmPload, sIceLoad, oceQnet, oceFWflx, oceSflux, surForcT & surForcS +o modifications to pkg/seaice/growth.F and budget.F, which change results of + lab_sea experiment: HSNOW was sometimes treated as effective and sometimes + as actual snow thickness. It now refers everywhere to effective snow + thickness, meaning that for non-zero AREA, actual thickness is HEFF/AREA. + +checkpoint58r_post +o modifications to pkg/seaice/growth.F, which change results of + lab_sea experiment: fixes pertain to melting snow over open water, to + masking EVAP under sea ice, and to using the correct AREA variable for + computations of EVAP, PRECIP, HSNOW, and GHEFF +o add ability to read bathy, salt, and theta using MNC (off by def) +o add flooding algorithm and advection of HSNOW for pkg/seaice; + both are turned off by default and do no change any results +o seaice advection with pkg/thsice: a step toward the use of non-linear + advection scheme, but #ifdef or commented out for now (requires more EXCH). +o use standard version of PTRACERS_INI_VARIA in tutorial_tracer_adjsens + (identical results) and the standard version of EXTERNAL_FIELDS_LOAD + in natl_box (affects results @ truncation level: update output.txt) +o multi-threading and IO: + - replace some call to MDSIO S/R by the corresponding READ/WRITE_FLD S/R. + - remove most of BEGIN_MASTER/ END_MASTER around READ/WRITE_FLD S/R calls + (needed to work with SingleCpuIO): tested in all verif. exp. +o GAD: use simpler DST3 formulation as default (old version left within #ifdef) + affects the results (but none of the verification test uses this scheme). +o Adding some pkg/diagnostics capability to pkg/seaice + (will certainly be subject to changes) +o ctrl: adding new control variables: + lwflux, lwdown, evap, snowprecip, apressure, runoff + +checkpoint58q_post +o added CPP_EEOPTIONS.h flag DISABLE_MPI_READY_TO_RECEIVE. Speeds up + 1/6-deg Southern Ocean configuration by 8% on IBM Datastar and + high_res_cube configuration by 4% on Columbia. +o clean-up multi-threaded problems (reported by debugger tcheck on ACES); + add (in global_with_exf/code) a version of EXF_INTERP_READ without + dynamical allocation (seems to work in multi-threaded). +o new function "MASTER_CPU_IO" (=T if master thread & master CPU, if using + single CPU io) so that TAF does not have to see EESUPPORT.h +o pkg/seaice: implement sea-ice loading (when using RealFreshWaterFlux) + +checkpoint58p_post +o obcs: stop if obcs is used with useCDscheme = .true. +o shelfice: + - fix a sign error so that no slip at shelfice interface works + - remove stop for combination non-hydrostatic code and shelfice. That does + not mean, that the results are correct, but at least they are numerically + stable +o diagnoctics: modify UVELPHI and VVELPHI to include hfac (i.e. mass-weighted) +o added adjoint exch routined for all exch*3d* routines + and updated flow directives + +checkpoint58o_post +o replace calls to EXCH_Z & EXCH_UV_AGRID: use the new _3D_ version ; + remove old subroutines (_XY_ & _XYZ_); update the adjoint version. +o change controling S/R for writing pickup file (new S/R do_write_pickup) + and clean-up reading/writing of pickup files. +o fix local version of read/write pickup (NH part) in rotating_tank/code +o simplify EXCH interface: + - change _XYZ_ interface to _3D_ subroutine (with 3rd dim in argument list) + - not often used EXCH S/R (exch_z, exch_uv_agrid): keep only the _3D_ version +o added the regrid package +o shelfice: + - add a simple boundary layer scheme to reduce noise + - fix the indexing in shelfice_u/v_drag so that there will be actually drag + +checkpoint58n_post +o fix globalArea multi-threaded calculation: need to apply GLOBAL_SUM to + local variable (not in common block). +o lot of small changes for multi-threaded. Most tests (using OMP & ifort) pass. + - still problems with pkgs: mnc, exp2, dic, cal, exf (and probably more); + - still BEGIN_MASTER/END_MASTER to remove around READ/WRITE_FLD S/R calls + to work with SingleCpuIO. +o add "_d 0" to real constant of pkg/cfc subroutines ; + update exp. cfc_exemple & tutorial_cfc_offline output files. +o multi-threading and IO: + - all threads call READ_FLD S/R (needed if using SingleCpuIO): + (no BEGIN_MASTER/ END_MASTER around the call, but inside MDSIO S/R. + - barrier before and after reading. + - stop if other than master is calling MDS_WRITELOCAL (if #undef IO_THREAD_SAFE) + - avoid using MDS_WRITELOCAL for LAND pkg output. + - new S/R AIM_WRITE_PHYS (replaces AIM_WRITE_LOCAL) to write AIM physics + common-block variables ; Allows multi-threading with master-thread IO. +o change default MAX_NO_THREADS from 32 to 4 ; + and stop cleanly when MAX_NO_THREADS is too small. +o add S/R BAR_CHECK to check multi-threaded barrier synchronization + +checkpoint58m_post +o add a Non-Hydroatatic test (with 3-D Coriolis, NHMTerms, biharmonic Visc. + and side-drag) on CS-grid : global_ocean.cs32x15.viscA4 +o make "tutorial_global_oce_latlon" from standard "global_ocean.90x40x15" exp. + keep global_ocean.90x40x15 (for AD testing) with former secondary test + (".qshyd") as the main test (mv output.qshyd.txt to output.txt) +o CVS modules: update MITgcm_verif_basic; remove MITgcm_verif_ocean & _verif_atmos; + add MITgcm_tutorials (= code + all the tutorials) +o ecco, option to compute cost for total ssh (mean+anom) +o consistent with addition of ptracer and ssh in pkg/profiles +o profiles: adding ptracer and ssh +o testreport: change multi-test output-file name + (from output.txt.{name} to output.{name}.txt) +o profiles: now ok for mutli-tiles case +o seaice: add 4 parameters for different advection schemes for area, + (effective) seaice thickness, enthalphy, and snow height. Their default + is the standard parameter SEAICEadvScheme +o calc_gw: + - add cosFacU in zonal viscous flux (harmonic.visc.). + - put back side-drag (call new S/R MOM_W_SIDEDRAG) and output.txt. + of tutorial_plume_on_slope. +o obcs_calc.F : fix index Pb in OBSeta & OBNeta (Thanks to Gianmaria). +o calc_gw: true flux-form, account for horizontal grid spacing. + update rotating_tank results, but not plume_on_slope (affected at + truncation level, 11 digits). + +checkpoint58l_post +o calc_gw: + - take bi,bj loops outside calc_gw to fix Pb with local array KappaRU,V + - remove side-drag for now (need to fix it); update plume_on_slope results. + - fix for partial-cell & non-uniform dz; update plume_on_slope results. +o commit code to make SST/SSS weights spatially variable + (based on either variable in-situ or variable initial T/S weights) +o pkg/ecco: + * commit code to relax deviations of xx_theta, xx_salt to 5*sigma, + now based on horizontally varying weights wthetaLev, wsaltLev + * cost_averagesflags now returns year indices in addition to day, month + * sflux balance is performed on annual basis + (sflxumm, sfluxmm2, bal_sfluxmm) + * for SSH anomaly, separate more cleanly contrib from T/P, ERS, GFO, + including separate counting and multipliers +o pkg/rbcs + * add all necessary infrastructure for pkg/rbcs levN adjoint checkpointing + +checkpoint58k_post +o testreport: + - always build in dir. "build" (if not there, mkdir build instead of building + & running in input) + - run in dir run (if it exists), in build otherwise. + - call prepare_run (if input/prepare_run exists) + - run multi-threaded test (with new option: "-mth") if file input/eedata.mth exists. +o pkg/exf modifications to interpolation and rotation routines for more + reasonable treatment of North Pole singularity: for tracers North Pole + value is set to northernmost zonal-mean value, for zonal velocity it is + set to zero, and for meridional velocity it is set to northernmost value. +o pkg/exf/exf_check_range.F + - add tile index to diagnostics and move stop statement to the very + end of the routine. +o pkg/diagnostics: (diagnostics_main_init.F) + define title of isomorphic variables according to the current config. +o pkg/thsice with pkg/seaice dynamics: +- fix domain of computation (interior only, required for exf) and do exchanges +- seaice-dynamics forcing: add atmospheric and seaice loading to SSH gradient +o towards a standard way of dealing with multi-threading in MONITOR + and ${PKG}_MONITOR (all except ptracers_monitor) subroutines. +o Pass variable viscosities (vertical and horizontal, e.g., KPP or Leith) + to W momentum equation in nonhydrostatic and quasihydrostatic runs. +o make exf_monitor & seaice_monitor independant of the main (dynamics) monitor. +o pkg/seaice: fix SEAICEuseEVPpickup parameter (put it in a commom block) +o generic_advdiff: DST advection S/R : use local copy of velocity to compute CFL + (problems ? with gradient check in bottom_ctrl_5x5 adjoint test) +o tracer advection: + - clean-up and simplify calc_common_factors.F + - make a local copy of velocity and pass it (as u,v,r_Trans) to DST tracer + advection subroutine (but still not used within DST advection S/R) +o rename pkg aim_ocn_coupler to atm_ocn_coupler (later on, will be used without aim) + +checkpoint58j_post +o new driver S/R: LOAD_FIELDS_DRIVER to load external forcing fields + from file (collects calls previously in FORWARD_STEP) +o move call to SEAICE_MODEL from FORWARD_STEP to DO_OCEANIC_PHYS +o adjoint store dir. adjusted accordingly +o genmake2 + replace target "ad_taf" by $(EXE_AD) ; add $(EXE_AD) to the make CLEAN list. + +checkpoint58i_post +o pkg/seaice: add parameter that allows to scale/turn off effect of seaice + on wind stress (SEAICEstressFactor defaults to 1.) +o Total number of Timers is finite (<=40): comment out 2 non-essential one + in the_main_loop.F to avoid Pb (e.g., when running fizhi test) +o vector_invariant: fix highOrderVorticity(=4.th.Order) advection + on CS-grid: no longer loosing mass. +o exf & curvilinear-grid: no longer modify longitude xC & xG. +o pkg/ggl90: fix sloppy output and fix a bug +o pkg/seaice: added SEAICEuseEVPpickup parameter + - Set to false in order to start EVP solver with + non-EVP pickup files when using SEAICEuseEVP + - fix sign error in diffusion in seaice_calc_rhs + +checkpoint58h_post +* Modifications for bottom topography control + o replace hFacC by _hFacC at various places + o replace ALLOW_HFACC_CONTROL by ALLOW_DEPTH_CONTROL + o add non-self-adjoint cg2d_nsa + o update autodiff support routines + o re-initialise hfac after ctrl_depth_ini + o works for 5x5 box, doesnt work for global_ocean.90x40x15 +* Adding verification for 5x5 box (4-layer) bottom topography control + +checkpoint58g_post +o pkg/diagnostics: implement "periodic averaging diagnostics" (e.g., + used for mean seasonal cycle, mean diurnal cycle); add an example + in verification/global_ocean.cs32x15/input.thsice/data.diagnostics +o pkg/ggl90: + - add parameter (minimum surface kinetic energy) + - fix bug (avoiding division by zero) +o couple pkg/thsice to pkg/seaice: + - modify advection in seaice to accomodate new scalar fields to be advected + - only muliDimAdection scheme work with seaice/thsice + - mapping of thsice-variables to seaice-variables, back and forth + - does not break the verification experiments, but does not give the + desired results either +o pkg/seaice + - make (default) second order advection a bit less confusing? + +checkpoint58f_post o couple pkg/thsice and pkg/exf (as a preparation for coupling pkg/thsice to pkg/seaice): - new routines thsice_map_exf and thsice_get_exf provide the interface @@ -16,6 +334,8 @@ exf_radiation, exf_wind - add new parameters and constants: longwave emissivity for ocean, ice and snow, evaporation parameters over ice + - decouple wind/stress computation from ALLOW_BULKFORMULA: always compute + either wind from stress or stress from wind o pkg/thSIce: - split thsice_step_fwd.F in 2 S/R: thsice_step_temp.F & thsice_step_fwd.F - put i,j loops inside S/R: THSICE_ALBEDO, THSICE_SOLVE4TEMP, THSICE_EXTEND