| 1 |
C $Header: /u/gcmpack/MITgcm/pkg/flt/flt_main.F,v 1.8 2010/12/22 21:25:18 jahn Exp $ |
| 2 |
C $Name: $ |
| 3 |
|
| 4 |
#include "FLT_OPTIONS.h" |
| 5 |
|
| 6 |
C ================================================================== |
| 7 |
C |
| 8 |
C Float Package for the MIT Model |
| 9 |
C |
| 10 |
C Main Routines: |
| 11 |
C |
| 12 |
C o flt_main - Integrates the floats forward and stores |
| 13 |
C positions and vertical profiles at specific |
| 14 |
C time intervals. |
| 15 |
C o flt_readparms - Read parameter file |
| 16 |
C o flt_init_fixed - Initialise fixed |
| 17 |
C o flt_init_varia - Initialise the floats |
| 18 |
C o flt_restart - Writes restart data to file (=> renamed: flt_write_pickup) |
| 19 |
C |
| 20 |
C Second Level Subroutines: |
| 21 |
C |
| 22 |
C o flt_runga2 - Second order Runga-Kutta inetgration (default) |
| 23 |
C o flt_exchg - Does a new distribution of floats over tiles |
| 24 |
C after every integration step. |
| 25 |
C o flt_up - moves float to the surface (if flag is set) |
| 26 |
C and stores profiles to file |
| 27 |
C o flt_down - moves float to its target depth (if flag is set) |
| 28 |
C o flt_traj - stores positions and data to file |
| 29 |
C o flt_interp_linear - contains blinear interpolation scheme |
| 30 |
C o flt_mapping - contains mapping functions & subroutine |
| 31 |
C o flt_mdsreadvector - modified mdsreadvector to read files |
| 32 |
C |
| 33 |
C ToDo: |
| 34 |
C |
| 35 |
C o avoid exchanges when arrays empty |
| 36 |
C o 3D advection of floats |
| 37 |
C |
| 38 |
C ================================================================== |
| 39 |
C |
| 40 |
C Documentation: |
| 41 |
C |
| 42 |
C To be made.... |
| 43 |
C |
| 44 |
C |
| 45 |
C started: Arne Biastoch abiastoch@ucsd.edu 10-Jan-2000 |
| 46 |
C (adopted from version written by Detlef Stammer |
| 47 |
C for the old model code) |
| 48 |
C |
| 49 |
C changed: Arne Biastoch abiastoch@ucsd.edu 21-JUN-2001 |
| 50 |
C |
| 51 |
C ================================================================== |
| 52 |
|
| 53 |
CBOP 0 |
| 54 |
C !ROUTINE: FLT_MAIN |
| 55 |
|
| 56 |
C !INTERFACE: |
| 57 |
SUBROUTINE FLT_MAIN ( |
| 58 |
I myTime, myIter, myThid ) |
| 59 |
|
| 60 |
C !DESCRIPTION: |
| 61 |
C ================================================================== |
| 62 |
C SUBROUTINE FLT_MAIN |
| 63 |
C ================================================================== |
| 64 |
C o This routine steps floats forward in time and samples the model |
| 65 |
C state at float position every flt_int_traj time steps. |
| 66 |
C Also moves the float up and down and samples vertical profiles. |
| 67 |
C |
| 68 |
C o Uses 2nd or fourth order runga-kutta |
| 69 |
C o Spatial interpolation is bilinear close to boundaries and otherwise |
| 70 |
C a polynomial interpolation. |
| 71 |
C o Particles are kept in grid space (with position of dp taken as |
| 72 |
C x(south), y(east) grid cell point) |
| 73 |
C o Calls profile every flt_int_prof time steps; in that event the |
| 74 |
C profile over the whole water column is written to file and the |
| 75 |
C float might be moved upwards to the surface (depending on its |
| 76 |
C configuration). |
| 77 |
C ================================================================== |
| 78 |
|
| 79 |
C !USES: |
| 80 |
IMPLICIT NONE |
| 81 |
C == global variables == |
| 82 |
#include "SIZE.h" |
| 83 |
#include "EEPARAMS.h" |
| 84 |
#include "PARAMS.h" |
| 85 |
#include "FLT_SIZE.h" |
| 86 |
#include "FLT.h" |
| 87 |
|
| 88 |
C !INPUT PARAMETERS: |
| 89 |
C myTime :: current time in simulation |
| 90 |
C myIter :: current iteration number |
| 91 |
C myThid :: my Thread Id number |
| 92 |
_RL myTime |
| 93 |
INTEGER myIter, myThid |
| 94 |
|
| 95 |
C !FUNCTIONS: |
| 96 |
LOGICAL DIFFERENT_MULTIPLE |
| 97 |
EXTERNAL DIFFERENT_MULTIPLE |
| 98 |
|
| 99 |
C !LOCAL VARIABLES: |
| 100 |
CEOP |
| 101 |
|
| 102 |
#ifdef ALLOW_DEBUG |
| 103 |
IF (debugMode) CALL DEBUG_ENTER( 'FLT_MAIN', myThid ) |
| 104 |
#endif |
| 105 |
|
| 106 |
C-- integration of the float trajectories |
| 107 |
#ifdef ALLOW_DEBUG |
| 108 |
IF (debugMode) CALL DEBUG_CALL('FLT_RUNGA*', myThid ) |
| 109 |
#endif |
| 110 |
#ifdef FLT_SECOND_ORDER_RUNGE_KUTTA |
| 111 |
c WRITE(0,*) ' bf call flt_runga2', myIter |
| 112 |
CALL TIMER_START('FLOATS RUNGA2 [FLT LOOP]',myThid) |
| 113 |
CALL FLT_RUNGA2( myTime, myIter, myThid ) |
| 114 |
CALL TIMER_STOP ('FLOATS RUNGA2 [FLT LOOP]',myThid) |
| 115 |
c WRITE(0,*) ' af call flt_runga2', myIter |
| 116 |
#else |
| 117 |
c WRITE(0,*) ' bf call flt_runga4', myIter |
| 118 |
CALL TIMER_START('FLOATS RUNGA4 [FLT LOOP]',myThid) |
| 119 |
CALL FLT_RUNGA4( myTime, myIter, myThid ) |
| 120 |
CALL TIMER_STOP ('FLOATS RUNGA4 [FLT LOOP]',myThid) |
| 121 |
c WRITE(0,*) ' af call flt_runga4', myIter |
| 122 |
#endif |
| 123 |
|
| 124 |
C-- do exchanges between tiles if necessary |
| 125 |
|
| 126 |
#ifdef ALLOW_DEBUG |
| 127 |
IF (debugMode) CALL DEBUG_CALL('FLT_EXCH*', myThid ) |
| 128 |
#endif |
| 129 |
CALL TIMER_START('FLOATS EXCHG [FLT LOOP]',myThid) |
| 130 |
#ifdef ALLOW_EXCH2 |
| 131 |
CALL FLT_EXCH2( myTime, myIter, myThid ) |
| 132 |
#else |
| 133 |
CALL FLT_EXCHG( myTime, myIter, myThid ) |
| 134 |
#endif |
| 135 |
CALL TIMER_STOP ('FLOATS EXCHG [FLT LOOP]',myThid) |
| 136 |
|
| 137 |
C-- store profiles every flt_int_prof time steps and move floats up and down |
| 138 |
|
| 139 |
IF ( DIFFERENT_MULTIPLE( flt_int_prof, myTime, deltaTClock ) |
| 140 |
& ) THEN |
| 141 |
#ifdef ALLOW_DEBUG |
| 142 |
IF (debugMode) CALL DEBUG_CALL('FLT_UP', myThid ) |
| 143 |
#endif |
| 144 |
CALL TIMER_START('FLOATS UP [FLT LOOP]',myThid) |
| 145 |
CALL FLT_UP( myTime, myIter, myThid ) |
| 146 |
CALL TIMER_STOP ('FLOATS UP [FLT LOOP]',myThid) |
| 147 |
ENDIF |
| 148 |
|
| 149 |
#ifdef ALLOW_DEBUG |
| 150 |
IF (debugMode) CALL DEBUG_CALL('FLT_DOWN', myThid ) |
| 151 |
#endif |
| 152 |
c WRITE(0,*) ' bf call flt_down', myIter |
| 153 |
CALL TIMER_START('FLOATS DOWN [FLT LOOP]',myThid) |
| 154 |
CALL FLT_DOWN( myTime, myIter, myThid ) |
| 155 |
CALL TIMER_STOP ('FLOATS DOWN [FLT LOOP]',myThid) |
| 156 |
c WRITE(0,*) ' af call flt_down', myIter |
| 157 |
|
| 158 |
C-- store particles every flt_int_traj timesteps: |
| 159 |
|
| 160 |
IF ( DIFFERENT_MULTIPLE( flt_int_traj, myTime, deltaTClock ) |
| 161 |
& ) THEN |
| 162 |
#ifdef ALLOW_DEBUG |
| 163 |
IF (debugMode) CALL DEBUG_CALL('FLT_TRAJ', myThid ) |
| 164 |
#endif |
| 165 |
c WRITE(0,*) ' bf call flt_traj', myIter |
| 166 |
CALL TIMER_START('FLOATS TRAJ [FLT LOOP]',myThid) |
| 167 |
CALL FLT_TRAJ( myTime, myIter, myThid ) |
| 168 |
CALL TIMER_STOP ('FLOATS TRAJ [FLT LOOP]',myThid) |
| 169 |
c WRITE(0,*) ' af call flt_traj', myIter |
| 170 |
ENDIF |
| 171 |
|
| 172 |
#ifdef ALLOW_DEBUG |
| 173 |
IF (debugMode) CALL DEBUG_LEAVE( 'FLT_MAIN', myThid ) |
| 174 |
#endif |
| 175 |
|
| 176 |
RETURN |
| 177 |
END |
Parent Directory
| 
Revision Log
| 
Revision Graph