========================= README for 2A23 Ver. 7.12 ========================= Bug fix to the function SmallCell_Hpattern( ) in the file L2A23SmallCell.c The bug is limited to angle bin #47. Effect of the bug on 2A23 output is minor. =================== Usage of 2A23 V7.12 =================== (1) First, go to ../GANAL directory, and by reading README there and prepare ANAL_H0C_YYMMDDHH, then return to this directory. (2) Softlink the above created data-ANAL-H0C directory to this current directory. (3) If needed, edit the last part of L2A23_ANAL_DIR_conf. (4) Compile and run as follows: $ make -f make.L2A23-tkio $ ./L2A23main jobName 1C21-HDF-file 2A23-HDF-file VI-file ========================= README for 2A23 Ver. 7.11 ========================= Bug fix to the function calc_Htop() in the file L2A23rtypes.c. This bug does not seem to change science output data at all, though in theory science output can change. ========================= README for 2A23 Ver. 7.10 ========================= Bug fix to the function calc_Htop() in the file L2A23rtypes.c. This bug does not seem to change science output data at all, though in theory science output can change. ============================== README for 2A23 Ver. 7.09-rev1 ============================== Not a bug fix. Made corrections to comments in in the file L2A23freezH.c for types 292 and 297 as follows: and shallowRain[i] = 10 or 11; ---> and shallowRain[i] = 20 or 21; Since this was not a bug fix, I did not hand in the revision to neither NASA nor JAXA. ========================================== README for 2A23 Ver. 7.09 (V7 final again) ========================================== A bug fix to 2A23 Ver. 7.08 (V7 final) was made. For the sake of version number maintenance, the version number was increased from 7.08 to 7.09. The bug fix was made to the function find_ANAL_yymmddhh() in the file L2A23freezH.c. In addition to the bug fix, a test on date/time was strengthened in Ver. 7.09 because access to GANAL data crucially depends on date & time. -------------------------------------------------------------- The followings are in the README for 2A23 Ver. 7.08 (V7 final) -------------------------------------------------------------- Changes from 2A23 V7.06. - Added two source files L2A23MSubs.c and L2A23SmallCell.c. - Introduced a 3D number filter for BB detection. - Introduced a code for detecting small cell size, and added new rain types 237 and 297 in Ver. 7.08. ===================== Major changes from V6 ===================== (1) GANAL data are used. (2) The following new subcategories are added to the unified rain type: 105, 115, 135, 230, 235, 237, 292, 297, and 311. (3) Many shallow non-isolated is classified as convective. (4) Small rain cells with V-other and H-stra are classified as convective (rain type 237 and 297). (5) A 3D BB number filter is introduced for BB detection. ================================== Details of rain type in 2A23 V7.10 ================================== * * (Unified) rainType[i] * = 100: Stratiform certain. * When R_type_V[i] = T_stra; (BB exists) * and R_type_H[i] = T_stra; * * 105: Stratiform. --- added in V7. * When R_type_V[i] = T_stra; (BB exists) * and R_type_H[i] = T_stra; * But storm top (determined by 2A23) is too high. * * 110: Stratiform certain. * When R_type_V[i] = T_stra; (BB exists) * and R_type_H[i] = T_other; * (or, on a very rare occasion, when only R_type_V[i] is * available because of read scan error.) * * 115: Stratiform. --- added in V7. * When R_type_V[i] = T_stra; (BB exists) * and R_type_H[i] = T_other; * But storm top (determined by 2A23) is too high. * * 120: Probably stratiform. * When R_type_V[i] = T_other;(BB may exist but not detected) * and R_type_H[i] = T_stra; * BB not detected by V-profile method, but BB may exist. * Radar echo not strong enough to be convective, and not * noise (because H-pattern method classified this as * stratiform but not noise (i.e., others)), hence the * rain type in this case is most probably stratiform. * * 130: Maybe stratiform. * When R_type_V[i] = T_stra; (BB detection certain) * and R_type_H[i] = T_conv; * Ambiguous, but rain type may be stratiform because * the bright band (BB) certainly detected, and radar * echo below BB not so strong (because V-profile * method classified this as stratiform). * The H-pattern method classified this as convective * not because the existence of very strong radar echo * (if so, the V-profile method also would have * classified this as convective despite of the * existence of BB), but because it satisfied the * stand-out condition for convective center against * the background area with 11 km radius, which does * not necessarily mean that radar echo is very strong. * * 135: Maybe stratiform. --- added in V7 * When R_type_V[i] = T_stra; (BB detection certain) * and R_type_H[i] = T_conv; * But storm top (determined by 2A23) is too high. * * 140: Maybe stratiform or maybe transition or something else. * When R_type_V[i] = T_other; (BB hardly expected) * and R_type_H[i] = T_stra; * * 152: Maybe stratiform: * Shallow rain (non-isolated) is detected. * When R_type_V[i] = T_other; * R_type_H[i] = T_stra; * and shallowRain[i] = 20 or 21; * * 160: Maybe stratiform, but rain hardly expected near surface. * BB may exist but is not detected. * When R_type_V[i] = T_other; * and R_type_H[i] = T_stra; * * 170: Maybe stratiform, but rain hardly expected near surface. * BB hardly expected. Maybe cloud only. * Distinction between 170 and 300 is very small. * When R_type_V[i] = T_other; * and R_type_H[i] = T_stra; ** * 200: Convective certain. * When R_type_V[i] = T_conv; (no BB) * and R_type_H[i] = T_conv; * * 210: Convective certain. * When R_type_V[i] = T_other; * and R_type_H[i] = T_conv; * Since the criteria for convective by the V-profile * method is somewhat stringent, the V-profile method * classified this as others, but actually it is * convective because H-pattern method classified this * as convective (probably by the stand-out condition * for convective center against the background area). * Though certain, the confidence level would be very * slightly lower than that of the case designated by * the number 20 (i.e. the case where both methods * classified it as convective). * * 220: Convective certain. * When R_type_V[i] = T_conv; * and R_type_H[i] = T_other; * (or, on a very rare occasion, when only R_type_V[i] is * available because of read scan error.) * * 230: Probably convective. ---> Re-introduced in V7. * * When R_type_V[i] = T_stra; (BB exists) * R_type_H[i] = T_conv; * and Z below BB is strong. * Somewhat ambiguous because of the existence of the * bright band (BB). * But the rain type is probably convective because * radar echo below BB is so strong that even the * V-profile method classified it as convective, and * the H-pattern method also classified it as * convective. * * (In V5, R_type_V[i] = T_conv in this case, but * in V7, R_type_V[i] = T_stra because BB exists.) * * 235: Probably convective. ---> Added in V7. * When R_type_V[i] = T_other; * R_type_H[i] = T_stra; * and Htop_buff[i][1]> TOP_HIGH. * * 237: Probably convective. ---> Added in V7.08 * When R_type_V[i] = T_other; * R_type_H[i] = T_stra; * and the cell size is small, that is, * cell_compact_buff[n_scan][i]>0. * * 240: Maybe convective. * When R_type_V[i] = T_conv; * and R_type_H[i] = T_stra; * Though I tried to set the criteria for convective * by the V-profile method as being somewhat more * stringent than that of the H-pattern method, it is * not always the case. * I expect that this combination would happen in two cases: * * (1) When strong convective precipitation exists above * Hebb-1km, below which is examined by the H-method, * and echo below Hebb-1km is very weak due to strong * ATT. * * (2) But this combination also occurs when BB detection * fails. * (A very large Z at BB height would make the result of * V-method as convective when the detection of BB fails. * This may occur when BB is associated with strong * precipitation: V-method has a chance to miss the * BB, hence convective by V-method. A large ATT would * make the echo below BB very weak, hence stratiform by * H-method.) * * In practice, it is very difficult to distinguish the * above (1) and (2). In ver. 4.0, the above combination * is classified as convective, because it is certain that * the echo is strong so that it has a convective nature * in both (1) and (2). But, of course, a detailed study * is needed in Day-2 improvement of the algorithm. * * 251: Convective. * Shallow isolated is detected. * When R_type_V[i] = T_conv, * R_type_H[i] = T_conv; * and shallowRain[i] = 10 or 11; * * 252: Convective. * Shallow rain (non-isolated) is detected. * When R_type_V[i] = T_conv, * R_type_H[i] = T_conv; * and shallowRain[i] = 20 or 21; * * 261: Convective. * Shallow isolated is detected. * When R_type_V[i] = T_conv, * R_type_H[i] = T_other; * and shallowRain[i] = 10 or 11; * * 262: Convective. * Shallow rain (non-isolated) is detected. * When R_type_V[i] = T_conv, * R_type_H[i] = T_other; * and shallowRain[i] = 20 or 21; * * 271: Convective. * Shallow isolated is detected. * When R_type_V[i] = T_other, * R_type_H[i] = T_conv; * and shallowRain[i] = 10 or 11; * * 272: Convective. * Shallow rain (non-isolated) is detected. * When R_type_V[i] = T_other, * R_type_H[i] = T_conv; * and shallowRain[i] = 20 or 21; * * 281: Convective. * Shallow isolated is detected. * When R_type_V[i] = T_conv, * R_type_H[i] = T_stra; * and shallowRain[i] = 10 or 11; * * 282: Convective. * Shallow rain (non-isolated) is detected. * When R_type_V[i] = T_conv, * R_type_H[i] = T_stra; * and shallowRain[i] = 20 or 21; * * 291: Convective: * Shallow isolated is detected. * When R_type_V[i] = T_other; * R_type_H[i] = T_stra; * and shallowRain[i] = 10 or 11; * * 292: Convective: --- added in V7. * Shallow rain (non-isplated) is detected. But it is * difficult to distinguish it from shallow isolated. * When R_type_V[i] = T_other; * R_type_H[i] = T_stra; * and shallowRain[i] = 20 or 21; * * 297: Convective: --- added in V7.08 * Shallow rain (non-isplated) is detected. * And the cell size is small. * When R_type_V[i] = T_other; * R_type_H[i] = T_stra; * shallowRain[i] = 20 or 21; * and cell_compact_buff[n_scan][i]>0. * * 300: Others. * When R_type_V[i] = T_other; * and R_type_H[i] = T_other; * This category includes very weak echo (possibly noise) * and/or cloud (very weak echo in the lower altitude but * appreciable echo in the upper part, which was not * detected as bright band). * * 311: Others. --- added in V7. * Shallow isolated is detected. * When R_type_V[i] = T_other, * R_type_H[i] = T_other; * and shallowRain[i] = 10 or 11; * * 312: Others. * Shallow rain (non-isolated) is detected. * When R_type_V[i] = T_other, * R_type_H[i] = T_other; * and shallowRain[i] = 20 or 21; * * 313: Others. * If sidelobe clutter were not rejected, shallow * isolated would be detected. * When R_type_V[i] = T_other, * R_type_H[i] = T_other; * where * * R_type_V: rain type classified by the V-profile method, * R_type_H: rain type classified by the H-pattern method, which is * based on SHY95 developed by Prof. Houze and his group. * * The above assignment of numbers has the following meaning: * * (merged) rainType[i] / 100 = 1: stratiform, * 2: convective. * 3: others, * * (merged) rainType[i] % 100 = Sub-category, * * (merged) rainType[i] % 10 = 0: usual, * 1: shallow isolated, * 2: shallow non-isolated, exception is the * type 297 which is also shallow non-isolated. * 3: sidelobe clutter only (once shallow isolated * overwritten as sidelobe clutter only). * rainType[i]%10=3 occurs for type 313 only. * 5: Storm top (determined by 2A23) very high * (added in V7). * 7: V:other, H:stra. and the cell size is small. * There are two categories: * 237 for ordinary rain, and * 297 when detected as shallow non-isolated. * * where rainType[i] % 10 means MOD(rainType[i],10) in FORTRAN. * * The merged rainType is written to the output 2A23 HDF file.