Gtool5 では暦や日時の管理を容易にするためのモジュールとして dc_calendar を用意しています. このモジュールの使用により暦・日時管理に際しての 年, 月, 日, 時, 分, 秒の変換を容易に行うことが可能となります.
以下では, モデルの開始, 終了日時の管理を題材に, dc_calendar の使用方法を紹介します.
dc_calendar モジュールでは 1 ヶ月の日数, 1 日の秒数などを任意に指定した 暦を用いることも可能ですが, 以下ではグレゴリオ暦を用いて解説を行います. ユーザ定義の暦の使用法などについては 暦および日時の操作 (上級編) を参照ください.
例として, Fortran 90/95 汎用モジュール: 種別型パラメタの提供 で用いた サンプルプログラム の 時刻管理に dc_calendar を用いたプログラムを示します (拡散係数や時間ステップ等も多少変更しています). ソースコードはこちら. 赤字(カラーがでない場合はボールド)が dc_calendar に関係している箇所です.
!= Sample program for gtool_history/gtool5 ! ! * 2009/10/18 Y.Morikawa ! * 2003/08/21 M.Odaka ! * 2001/02/27 S.Takehiro ! ! Solving diffusion equation ! \[ ! du/dt = \kappa d^2 u/dx^2 ! \] ! for giving values of $u$ at $x=[0,1]$. ! program diffusion_cal1 use gtool_history ! Access module (モジュール指定) use dc_calendar ! Access module (モジュール指定) use dc_types ! Access module (モジュール指定) integer, parameter :: nx=30 ! Grid number (グリッド数) real(DP), parameter :: dx=1.0/(nx-1) ! Grid interval (グリッド間隔) real(DP), parameter :: dt=1. ! Time step [s] (時間間隔 [秒]) type(DC_CAL_DATE) :: start_date ! Start Date (モデル開始日時) type(DC_CAL_DATE) :: end_date ! End Date (モデル終了日時) real(DP) :: curtime ! Current time [sec] (経過時刻 [秒]) real(DP) :: endtime ! End time [sec] (終了時刻 [秒]) real(DP) :: dsptime ! Output interval [min] (出力間隔 [分]) real(DP), dimension(nx):: x=(/(dx*(i-1),i=1,nx)/) ! X coordinate (座標変数) real(DP), dimension(nx):: temp ! Temperature (温度) real(DP), parameter :: kappa=0.0001 ! Diffusion coefficient (熱拡散係数) character(256):: date_str call DCCalCreate( cal_type = 'Gregorian' ) ! Set calendar ! (暦設定) call DCCalDateCreate( year = 2009, month = 2, day = 28, & & hour = 23, min = 59, sec = 0.0_DP, & & date = start_date ) ! Set date ! (日時設定) curtime = DCCalConvertToSec( 0.0_DP, 'sec' ) ! Set initial time ! (初期時刻設定) endtime = DCCalConvertToSec( 10.0_DP, 'min' ) ! Set end time ! (終了時刻設定) dsptime = 1.0_DP ! Set output interval ! (出力間隔設定) temp = exp(-((x-0.5)/0.1)**2) ! Set initial value ! (初期値設定) call HistoryCreate( & ! Create output file & file='diffusion_cal1.nc', & ! (ヒストリー作成) & title='Diffusion equation', & & source='Sample program of gtool_history/gtool5', & & institution='GFD_Dennou Club davis project', & & dims=(/'x','t'/), dimsizes=(/nx,0/), & & longnames=(/'X-coordinate','time '/), & & units=(/'m ','min'/), & & origind=curtime, intervald=dsptime ) call HistoryPut('x',x) ! Output 'x' (次元変数出力) call HistoryAddVariable( & ! Set output variable & varname='temp', dims=(/'x','t'/), & ! (変数定義) & longname='temperature', units='K', xtype='double') call HistoryAddAttr('temp','gt_graph_tick_all',1) call HistoryAddAttr('temp','gt_graph_contour_spacing',(/0.0,1.0,0.01/)) call HistoryAddAttr('temp','+gt_user_davis_kappa',kappa) call HistoryPut('temp',temp) ! Output 'temp' (変数出力) call DCCalDateInquire( date_str, date = start_date ) ! Inquire date and set a character variable ! (日時を問い合わせて文字型変数へ代入) call HistoryAddAttr( 't', 'units', 'min since ' // trim(date_str) ) ! Output start date to a file ! (開始日時のファイルへの出力) write(6,*) "Start: ", trim(date_str) ! Display start date ! (開始日時の表示) do while ( curtime < endtime ) ! Check termination (終了判定) temp(2:nx-1) = temp(2:nx-1) & ! Time integration (時間積分) & + kappa*(temp(3:nx)-2*temp(2:nx-1)+temp(1:nx-2))/dx**2*dt if ( mod( curtime, dsptime ) == 0.0_DP ) then ! Check output timing (出力タイミング判定) call HistoryPut('temp',temp) ! Output 'temp' (変数出力) endif curtime = curtime + dt ! Progress model time (モデル時刻進行) enddo call DCCalDateInquire( date_str, curtime, start_date ) ! Inquire date and set a character variable ! (日時を問い合わせて文字型変数へ代入) write(6,*) "End: ", trim(date_str) ! Display end date (終了日時出力) call HistoryClose stop end program diffusion_cal1
上記のプログラム をダウンロードし, 以下のようにコンパイルしてください.
$ gt5frt diffusion_cal1.f90
そして作成された a.out を以下のように実行してください.
$ ./a.out
実行すると以下のメッセージが表示されるとともに, diffusion_cal1.nc ファイルが作成されます.
*** MESSAGE [HistoryCreate1] *** "diffusion_cal1.nc" is created (origin=0. [min]) Start: 2009-02-28T23:59:00 End: 2009-03-01T00:09:00 *** MESSAGE [HistoryClose] *** "diffusion_cal1.nc" is closed
以下では dc_calendar モジュールの各サブルーチンが行っていることを大まかに説明します. より詳しい説明は リファレンスマニュアル: dc_calendar を参照してください.
暦の設定を行います. cal_type に以下の文字列を与えることで暦の設定を 行います. 上記の例のように省略可能引数 cal を与えない場合には デフォルトの暦として設定が行われます. 省略可能引数 cal は 一度のプログラム実行に複数の暦を利用したい場合に使用します.
1 ヶ月の日数, 1 日の秒数などを任意に指定したい場合には 暦および日時の操作 (上級編) を参照ください.
日時の単位変換を行います.
in_time, in_unit に変換前の数値と単位を与えます. DCCalConvertToSec はこの数値を秒に変換して返します.
この他に, DCCalConvertToMin (分へ変換), DCCalConvertToHour (時へ変換), DCCalConvertToDay (日へ変換) を利用可能です.
date に与えられた情報を YYYY-MM-DDThh:mm:ss.sTZD (YYYY は年, MM は月, DD は日, hh は時, mm は分, ss.s は秒, TZD はタイムゾーン) の形式の文字列として date_str に受け取ります.
elapse_sec が指定される場合には date から elapse_sec の 秒数経過した日時が返ります.