Changeset 3104 for branches/2011/dev_LOCEAN_CMCC_INGV_MERCATOR_2011/DOC/TexFiles/Chapters/Chap_DIA.tex
- Timestamp:
- 2011-11-15T11:08:25+01:00 (13 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
branches/2011/dev_LOCEAN_CMCC_INGV_MERCATOR_2011/DOC/TexFiles/Chapters/Chap_DIA.tex
r2541 r3104 681 681 numeric of the code, so that the trajectories never intercept the bathymetry. 682 682 683 \subsubsection{ Input data: initial coordinates } 684 685 Initial coordinates can be given with Ariane Tools convention ( IJK coordinates ,(\np{ln\_ariane}=true) ) 686 or with longitude and latitude. 687 688 689 In case of Ariane convention, input filename is \np{"init\_float\_ariane"}. Its format is: 690 691 \texttt{ I J K nisobfl itrash itrash } 692 693 \noindent with: 694 695 - I,J,K : indexes of initial position 696 697 - nisobfl: 0 for an isobar float, 1 for a float following the w velocity 698 699 - itrash : set to zero; it is a dummy variable to respect Ariane Tools convention 700 701 - itrash :set to zero; it is a dummy variable to respect Ariane Tools convention 702 703 \noindent Example:\\ 704 \noindent \texttt{ 100.00000 90.00000 -1.50000 1.00000 0.00000}\\ 705 \texttt{ 102.00000 90.00000 -1.50000 1.00000 0.00000}\\ 706 \texttt{ 104.00000 90.00000 -1.50000 1.00000 0.00000}\\ 707 \texttt{ 106.00000 90.00000 -1.50000 1.00000 0.00000}\\ 708 \texttt{ 108.00000 90.00000 -1.50000 1.00000 0.00000}\\ 709 710 711 In the other case ( longitude and latitude ), input filename is \np{"init\_float"}. Its format is: 712 713 \texttt{ Long Lat depth nisobfl ngrpfl itrash} 714 715 \noindent with: 716 717 - Long, Lat, depth : Longitude, latitude, depth 718 719 - nisobfl: 0 for an isobar float, 1 for a float following the w velocity 720 721 - ngrpfl : number to identify searcher group 722 723 - itrash :set to 1; it is a dummy variable. 724 725 \noindent Example: 726 727 \noindent\texttt{ 20.0 0.0 0.0 0 1 1 }\\ 728 \texttt{ -21.0 0.0 0.0 0 1 1 }\\ 729 \texttt{ -22.0 0.0 0.0 0 1 1 }\\ 730 \texttt{ -23.0 0.0 0.0 0 1 1 }\\ 731 \texttt{ -24.0 0.0 0.0 0 1 1 }\\ 732 733 \np{jpnfl} is the total number of floats during the run. 734 When initial positions are read in a restart file ( \np{ln\_rstflo= .TRUE.} ), \np{jpnflnewflo} 735 can be added in the initialization file. 736 737 \subsubsection{ Output data } 738 739 \np{nn\_writefl} is the frequency of writing in float output file and \np{nn\_stockfl} 740 is the frequency of creation of the float restart file. 741 742 Output data can be written in ascii files (\np{ln\_flo\_ascii = .TRUE.} ). In that case, 743 output filename is \np{is trajec\_float}. 744 745 Another possiblity of writing format is Netcdf (\np{ln\_flo\_ascii = .FALSE.} ). There are 2 possibilities: 746 747 - if (\key{iomput}) is used, outputs are selected in \np{iodef.xml}. Here it is an example of specification 748 to put in files description section: 749 750 \vspace{-30pt} 751 \begin{alltt} {{\scriptsize 752 \begin{verbatim} 753 754 <group id="1d\_grid\_T" name="auto" description="ocean T grid variables" > } 755 <file id="floats" description="floats variables"> }\\ 756 <field ref="traj\_lon" name="floats\_longitude" freq\_op="86400" />} 757 <field ref="traj\_lat" name="floats\_latitude" freq\_op="86400" />} 758 <field ref="traj\_dep" name="floats\_depth" freq\_op="86400" />} 759 <field ref="traj\_temp" name="floats\_temperature" freq\_op="86400" />} 760 <field ref="traj\_salt" name="floats\_salinity" freq\_op="86400" />} 761 <field ref="traj\_dens" name="floats\_density" freq\_op="86400" />} 762 <field ref="traj\_group" name="floats\_group" freq\_op="86400" />} 763 </file>} 764 </group>} 765 766 \end{verbatim} 767 }}\end{alltt} 768 769 770 - if (\key{iomput}) is not used, a file called \np{trajec\_float.nc} will be created by IOIPSL library. 771 772 773 683 774 See also \href{http://stockage.univ-brest.fr/~grima/Ariane/}{here} the web site describing 684 775 the off-line use of this marvellous diagnostic tool. 776 777 778 % ------------------------------------------------------------------------------------------------------------- 779 % Harmonic analysis of tidal constituents 780 % ------------------------------------------------------------------------------------------------------------- 781 \section{Harmonic analysis of tidal constituents (\key{diaharm}) } 782 \label{DIA_diag_harm} 783 784 A module is available to compute the amplitude and phase for tidal waves. 785 This diagnostic is actived with \key{diaharm}. 786 787 %------------------------------------------namdia_harm---------------------------------------------------- 788 \namdisplay{namdia_harm} 789 %---------------------------------------------------------------------------------------------------------- 790 791 Concerning the on-line Harmonic analysis, some parameters are available in namelist: 792 793 - \texttt{nit000\_han} is the first time step used for harmonic analysis 794 795 - \texttt{nitend\_han} is the last time step used for harmonic analysis 796 797 - \texttt{nstep\_han} is the time step frequency for harmonic analysis 798 799 - \texttt{nb\_ana} is the number of harmonics to analyse 800 801 - \texttt{tname} is an array with names of tidal constituents to analyse 802 803 \texttt{nit000\_han} and \texttt{nitend\_han} must be between \texttt{nit000} and \texttt{nitend} of the simulation. 804 The restart capability is not implemented. 805 806 The Harmonic analysis solve this equation: 807 \begin{equation} 808 h_{i} - A_{0} + \sum^{nb\_ana}_{j=1}[A_{j}cos(\nu_{j}t_{j}-\phi_{j})] = e_{i} 809 \end{equation} 810 811 With $A_{j}$,$\nu_{j}$,$\phi_{j}$, the amplitude, frequency and phase for each wave and $e_{i}$ the error. 812 $h_{i}$ is the sea level for the time $t_{i}$ and $A_{0}$ is the mean sea level. \\ 813 We can rewrite this equation: 814 \begin{equation} 815 h_{i} - A_{0} + \sum^{nb\_ana}_{j=1}[C_{j}cos(\nu_{j}t_{j})+S_{j}sin(\nu_{j}t_{j})] = e_{i} 816 \end{equation} 817 with $A_{j}=\sqrt{C^{2}_{j}+S^{2}_{j}}$ et $\phi_{j}=arctan(S_{j}/C_{j})$. 818 819 We obtain in output $C_{j}$ and $S_{j}$ for each tidal wave. 820 821 % ------------------------------------------------------------------------------------------------------------- 822 % Sections transports 823 % ------------------------------------------------------------------------------------------------------------- 824 \section{Transports across sections (\key{diadct}) } 825 \label{DIA_diag_dct} 826 827 A module is available to compute the transport of volume, heat and salt through sections. This diagnostic 828 is actived with \key{diadct}. 829 830 Each section is defined by the coordinates of its 2 extremities. The pathways between them are contructed 831 using tools which can be found in \texttt{NEMOGCM/TOOLS/SECTIONS\_DIADCT} and are written in a binary file 832 \texttt{section\_ijglobal.diadct\_ORCA2\_LIM} which is later read in by NEMO to compute on-line transports. 833 834 The on-line transports module creates three output ascii files: 835 836 - \texttt{volume\_transport} for volume transports ( unit: $10^{6} m^{3} s^{-1}$ ) 837 838 - \texttt{heat\_transport} for heat transports ( unit: $10^{15} W $ ) 839 840 - \texttt{salt\_transport} for salt transports ( unit: $10^{9}g s^{-1}$ )\\ 841 842 843 Namelist parameters control how frequently the flows are summed and the time scales over which 844 they are averaged, as well as the level of output for debugging: 845 846 %------------------------------------------namdct---------------------------------------------------- 847 \namdisplay{namdct} 848 %------------------------------------------------------------------------------------------------------------- 849 850 \texttt{nn\_dct}: frequency of instantaneous transports computing 851 852 \texttt{nn\_dctwri}: frequency of writing ( mean of instantaneous transports ) 853 854 \texttt{nn\_debug}: debugging of the section 855 856 \subsubsection{ To create a binary file containing the pathway of each section } 857 858 In \texttt{NEMOGCM/TOOLS/SECTIONS\_DIADCT/run}, the file \texttt{ {list\_sections.ascii\_global}} 859 contains a list of all the sections that are to be computed (this list of sections is based on MERSEA project metrics). 860 861 Another file is available for the GYRE configuration (\texttt{ {list\_sections.ascii\_GYRE}}). 862 863 Each section is defined by: 864 865 \noindent \texttt{ long1 lat1 long2 lat2 nclass (ok/no)strpond (no)ice section\_name }\\ 866 with: 867 868 - \texttt{long1 lat1} , coordinates of the first extremity of the section; 869 870 - \texttt{long2 lat2} , coordinates of the second extremity of the section; 871 872 - \texttt{nclass} the number of bounds of your classes (e.g. 3 bounds for 2 classes); 873 874 - \texttt{okstrpond} to compute heat and salt transport, \texttt{nostrpond} if no; 875 876 - \texttt{ice} to compute surface and volume ice transports, \texttt{noice} if no. \\ 877 878 879 \noindent The results of the computing of transports, and the directions of positive 880 and negative flow do not depend on the order of the 2 extremities in this file.\\ 881 882 883 \noindent If nclass =/ 0,the next lines contain the class type and the nclass bounds: 884 885 \texttt{long1 lat1 long2 lat2 nclass (ok/no)strpond (no)ice section\_name} 886 887 \texttt{classtype} 888 889 \texttt{zbound1} 890 891 \texttt{zbound2} 892 893 \texttt{.} 894 895 \texttt{.} 896 897 \texttt{nclass-1} 898 899 \texttt{nclass} 900 901 \noindent where \texttt{classtype} can be: 902 903 - \texttt{zsal} for salinity classes 904 905 - \texttt{ztem} for temperature classes 906 907 - \texttt{zlay} for depth classes 908 909 - \texttt{zsigi} for insitu density classes 910 911 - \texttt{zsigp} for potential density classes \\ 912 913 914 The script \texttt{job.ksh} computes the pathway for each section and creates a binary file 915 \texttt{section\_ijglobal.diadct\_ORCA2\_LIM} which is read by NEMO. \\ 916 917 It is possible to use this tools for new configuations: \texttt{job.ksh} has to be updated 918 with the coordinates file name and path. \\ 919 920 921 Examples of two sections, the ACC\_Drake\_Passage with no classes, and the 922 ATL\_Cuba\_Florida with 4 temperature clases (5 class bounds), are shown: 923 924 \noindent \texttt{ -68. -54.5 -60. -64.7 00 okstrpond noice ACC\_Drake\_Passage} 925 926 \noindent \texttt{ -80.5 22.5 -80.5 25.5 05 nostrpond noice ATL\_Cuba\_Florida} 927 928 \noindent \texttt{ztem} 929 930 \noindent \texttt{-2.0} 931 932 \noindent \texttt{ 4.5} 933 934 \noindent \texttt{ 7.0} 935 936 \noindent \texttt{12.0} 937 938 \noindent \texttt{40.0} 939 940 941 \subsubsection{ To read the output files } 942 943 The output format is : 944 945 \small{\texttt{date, time-step number, section number, section name, section slope coefficient, class number, 946 class name, class bound 1 , classe bound2, transport\_direction1 , transport\_direction2, transport\_total}}\\ 947 948 949 For sections with classes, the first \texttt{nclass-1} lines correspond to the transport for each class 950 and the last line corresponds to the total transport summed over all classes. For sections with no classes, class number 951 \texttt{ 1 } corresponds to \texttt{ total class } and this class is called \texttt{N}, meaning \texttt{none}.\\ 952 953 954 \noindent \texttt{ transport\_direction1 } is the positive part of the transport ( \texttt{ > = 0 } ). 955 956 \noindent \texttt{ transport\_direction2 } is the negative part of the transport ( \texttt{ < = 0 } ).\\ 957 958 959 \noindent The \texttt{section slope coefficient} gives information about the significance of transports signs and direction:\\ 960 961 962 963 \begin{tabular}{|c|c|c|c|p{4cm}|} 964 \hline 965 section slope coefficient & section type & direction 1 & direction 2 & total transport \\ \hline 966 0. & horizontal & northward & southward & postive: northward \\ \hline 967 1000. & vertical & eastward & westward & postive: eastward \\ \hline 968 \texttt{=/0, =/ 1000.} & diagonal & eastward & westward & postive: eastward \\ \hline 969 \end{tabular} 970 971 685 972 686 973 % ------------------------------------------------------------------------------------------------------------- … … 726 1013 are removed from the sub-basins. Note also that the Arctic Ocean has been split 727 1014 into Atlantic and Pacific basins along the North fold line. } 728 \end{center} \end{figure} 1015 \end{center} \end{figure} 729 1016 %>>>>>>>>>>>>>>>>>>>>>>>>>>>> 730 1017 … … 733 1020 (see Section \ref{MISC_steric} below for one of them). 734 1021 Activating those outputs requires to define the \key{diaar5} CPP key. 1022 \\ 1023 \\ 735 1024 736 1025
Note: See TracChangeset
for help on using the changeset viewer.