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 の 秒数経過した日時が返ります.