Class spline_data
In: prepare_data/spline_data.f90

スプライン曲線データ生成モジュール

Spline curve data generation module

Note that Japanese and English are described in parallel.

スプライン曲線データを作成します. www.netlib.org/fmm/spline.f を参考に作成しました.

Spline curve data is generated This module is created referring to www.netlib.org/fmm/spline.f

Procedures List

Create :SPLDAT 型変数の初期設定
Close :SPLDAT 型変数の終了処理
PutLine :SPLDAT 型変数に格納されている情報の印字
initialized :SPLDAT 型変数が初期設定されているか否か
GetSpline :スプライン曲線データの作成
———— :————
Create :Constructor of "SPLDAT"
Close :Deconstructor of "SPLDAT"
PutLine :Print information of "SPLDAT"
initialized :Check initialization of "SPLDAT"
GetSpline :Get spline curve data

Usage

始めに, SPLDAT 型の変数を定義し, Create で初期設定を行います. GetSpline でスプライン曲線データを取得してください. SPLDAT 型の変数の終了処理には Close を用いてください.

First, initialize "SPLDAT" by "Create". Get spline curve data by using "GetSpline". In order to terminate "SPLDAT", use "Close".

Methods

Included Modules

dc_types dc_trace dc_string dc_present dc_message dcpam_error dc_error dc_iounit

Public Instance methods

Close( spl_dat, [err] )
Subroutine :
spl_dat :type(SPLDAT), intent(inout)
err :logical, intent(out), optional
: 例外処理用フラグ. デフォルトでは, この手続き内でエラーが 生じた場合, プログラムは強制終了します. 引数 err が与えられる場合, プログラムは強制終了せず, 代わりに err に .true. が代入されます.

Exception handling flag. By default, when error occur in this procedure, the program aborts. If this err argument is given, .true. is substituted to err and the program does not abort.

SPLDAT 型の変数の終了処理を行います. なお, 与えられた spl_datCreate によって初期設定 されていない場合, プログラムはエラーを発生させます.

Deconstructor of "SPLDAT". Note that if spl_dat is not initialized by "Create" yet, error is occurred.

Alias for SplineDataClose

Create( spl_dat, knots_num, x_knots, x_value, [nmlfile], [err] )
Subroutine :
spl_dat :type(SPLDAT), intent(inout)
knots_num :integer, intent(in)
: 結節点の数 (2 以上). the number of data points or knots (greater than 2)
x_knots(0:knots_num-1) :real(DP), intent(in)
: 結節点の横軸データ (増加する順序に並ぶ). The abscissas of the knots in strictly increasing order
x_value(0:knots_num-1) :real(DP), intent(in)
: 結節点の縦軸データ. The ordinates of the knots
nmlfile :character(*), intent(in), optional
: NAMELIST ファイルの名称. この引数に空文字以外を与えた場合, 指定されたファイルから NAMELIST 変数群を読み込みます. ファイルを読み込めない場合にはエラーを 生じます.

NAMELIST 変数群の詳細に関しては NAMELIST#spline_data_nml を参照してください.

NAMELIST file name. If nonnull character is specified to this argument, NAMELIST group name is loaded from the file. If the file can not be read, an error occurs.

See "NAMELIST#spline_data_nml" for details about a NAMELIST group.

err :logical, intent(out), optional
: 例外処理用フラグ. デフォルトでは, この手続き内でエラーが 生じた場合, プログラムは強制終了します. 引数 err が与えられる場合, プログラムは強制終了せず, 代わりに err に .true. が代入されます.

Exception handling flag. By default, when error occur in this procedure, the program aborts. If this err argument is given, .true. is substituted to err and the program does not abort.

SPLDAT 型の変数の初期設定を行います. 他のサブルーチンを使用する前に必ずこのサブルーチンによって SPLDAT 型の変数を初期設定してください.

なお, 与えられた spl_dat が既に初期設定されている場合, プログラムはエラーを発生させます.

NAMELIST を利用する場合には引数 nmlfileNAMELIST ファイル名 を与えてください. NAMELIST 変数群の詳細に関しては NAMELIST#spline_data_nml を参照してください.

Constructor of "SPLDAT". Initialize spl_dat by this subroutine, before other procedures are used,

Note that if spl_dat is already initialized by this procedure, error is occurred.

In order to use NAMELIST, specify a NAMELIST filename to argument nmlfile. See "NAMELIST#spline_data_nml" for details about a NAMELIST group.

Alias for SplineDataCreate

GetSpline( spl_dat, a_Dim, a_Data, [err] )
Subroutine :
spl_dat :type(SPLDAT), intent(inout)
a_Dim(:) :real(DP), intent(in)
: 軸データ. dimensional data
a_Data(:) :real(DP), intent(out)
: スプライン曲線データ. Spline curve data
err :logical, intent(out), optional
: 例外処理用フラグ. デフォルトでは, この手続き内でエラーが 生じた場合, プログラムは強制終了します. 引数 err が与えられる場合, プログラムは強制終了せず, 代わりに err に .true. が代入されます.

Exception handling flag. By default, when error occur in this procedure, the program aborts. If this err argument is given, .true. is substituted to err and the program does not abort.

a_Data にスプライン曲線データが返ります. a_Data の配列サイズは任意です. a_Dim には a_Data の軸データを与えてください.

なお, 与えられた spl_datCreate によって初期設定 されていない場合, プログラムはエラーを発生させます.

Spline curve data is returned to a_Data. Array size of a_Data is arbitrary. Give dimensional data of a_Data to a_Dim.

If spl_dat is not initialized by "Create" yet, error is occurred.

Alias for SplineDataGetSpline

PutLine( spl_dat, [unit], [indent], [err] )
Subroutine :
spl_dat :type(SPLDAT), intent(in)
unit :integer, intent(in), optional
: 出力先の装置番号. デフォルトの出力先は標準出力.

Unit number for output. Default value is standard output.

indent :character(*), intent(in), optional
: 表示されるメッセージの字下げ.

Indent of displayed messages.

err :logical, intent(out), optional
: 例外処理用フラグ. デフォルトでは, この手続き内でエラーが 生じた場合, プログラムは強制終了します. 引数 err が与えられる場合, プログラムは強制終了せず, 代わりに err に .true. が代入されます.

Exception handling flag. By default, when error occur in this procedure, the program aborts. If this err argument is given, .true. is substituted to err and the program does not abort.

引数 spl_dat に設定されている情報を印字します. デフォルトではメッセージは標準出力に出力されます. unit に装置番号を指定することで, 出力先を変更することが可能です.

Print information of spl_dat. By default messages are output to standard output. Unit number for output can be changed by unit argument.

Alias for SplineDataPutLine

SPLDAT
Derived Type :
initialized = .false. :logical
: 初期設定フラグ. Initialization flag
knots_num :integer
: 結節点の数 (2 以上). the number of data points or knots (greater than 2)
x_knots(:) =>null() :real(DP), pointer
: 結節点の横軸データ (増加する順序に並ぶ). The abscissas of the knots in strictly increasing order
x_value(:) =>null() :real(DP), pointer
: 結節点の縦軸データ. The ordinates of the knots
x_coeffB(:) =>null() :real(DP), pointer
: スプライン係数. Spline coefficient
x_coeffC(:) =>null() :real(DP), pointer
: スプライン係数. Spline coefficient
x_coeffD(:) =>null() :real(DP), pointer
: スプライン係数. Spline coefficient

まず, Create で "SPLDAT" 型の変数を初期設定して下さい. 初期設定された "SPLDAT" 型の変数を再度利用する際には, Close によって終了処理を行ってください.

Initialize "SPLDAT" variable by "Create" before usage. If you reuse "SPLDAT" variable again for another application, terminate by "Close".

initialized( spl_dat ) result(result)
Function :
result :logical
spl_dat :type(SPLDAT), intent(in)

spl_dat が初期設定されている場合には .true. が, 初期設定されていない場合には .false. が返ります.

If spl_dat is initialized, .true. is returned. If spl_dat is not initialized, .false. is returned.

Alias for SplineDataInitialized

Private Instance methods

NmlRead( nmlfile, [err] )
Subroutine :
nmlfile :character(*), intent(in)
: NAMELIST ファイルの名称. NAMELIST file name
!$ integer, intent(inout):param_i
!$ real(DP), intent(inout):param_r
!$ character(*), intent(inout):param_c_
!$ character(TOKEN):param_c
err :logical, intent(out), optional
: 例外処理用フラグ. デフォルトでは, この手続き内でエラーが 生じた場合, プログラムは強制終了します. 引数 err が与えられる場合, プログラムは強制終了せず, 代わりに err に .true. が代入されます.

Exception handling flag. By default, when error occur in this procedure, the program aborts. If this err argument is given, .true. is substituted to err and the program does not abort.

NAMELIST ファイル nmlfile から値を入力するための 内部サブルーチンです. Create 内で呼び出されることを 想定しています.

値が NAMELIST ファイル内で指定されていない場合には, 入力された値がそのまま返ります.

なお, nmlfile に空文字が与えられた場合, または 与えられた nmlfile を読み込むことができない場合, プログラムはエラーを発生させます.

This is an internal subroutine to input values from NAMELIST file nmlfile. This subroutine is expected to be called by "Create".

A value not specified in NAMELIST file is returned without change.

If nmlfile is empty, or nmlfile can not be read, error is occurred.

Alias for SplineDataNmlRead

Subroutine :
spl_dat :type(SPLDAT), intent(inout)
err :logical, intent(out), optional
: 例外処理用フラグ. デフォルトでは, この手続き内でエラーが 生じた場合, プログラムは強制終了します. 引数 err が与えられる場合, プログラムは強制終了せず, 代わりに err に .true. が代入されます.

Exception handling flag. By default, when error occur in this procedure, the program aborts. If this err argument is given, .true. is substituted to err and the program does not abort.

SPLDAT 型の変数の終了処理を行います. なお, 与えられた spl_datCreate によって初期設定 されていない場合, プログラムはエラーを発生させます.

Deconstructor of "SPLDAT". Note that if spl_dat is not initialized by "Create" yet, error is occurred.

[Source]

  subroutine SplineDataClose( spl_dat, err )
    !
    ! SPLDAT 型の変数の終了処理を行います.
    ! なお, 与えられた *spl_dat* が Create によって初期設定
    ! されていない場合, プログラムはエラーを発生させます.
    !
    ! Deconstructor of "SPLDAT".
    ! Note that if *spl_dat* is not initialized by "Create" yet,
    ! error is occurred.
    !
    use dc_trace, only: BeginSub, EndSub
    use dc_string, only: PutLine, Printf
    use dc_types, only: DP, STRING, TOKEN, STDOUT
    use dc_error, only: StoreError, DC_NOERR, DC_ENOTINIT
    implicit none
    type(SPLDAT), intent(inout):: spl_dat
    logical, intent(out), optional:: err
                              ! 例外処理用フラグ.
                              ! デフォルトでは, この手続き内でエラーが
                              ! 生じた場合, プログラムは強制終了します.
                              ! 引数 *err* が与えられる場合,
                              ! プログラムは強制終了せず, 代わりに
                              ! *err* に .true. が代入されます.
                              !
                              ! Exception handling flag. 
                              ! By default, when error occur in 
                              ! this procedure, the program aborts. 
                              ! If this *err* argument is given, 
                              ! .true. is substituted to *err* and 
                              ! the program does not abort. 

    !-----------------------------------
    !  作業変数
    !  Work variables
    integer:: stat
    character(STRING):: cause_c
    character(*), parameter:: subname = 'SplineDataClose'
  continue
    call BeginSub( subname )
    stat = DC_NOERR
    cause_c = ''

    !-----------------------------------------------------------------
    !  初期設定のチェック
    !  Check initialization
    !-----------------------------------------------------------------
    if ( .not. spl_dat % initialized ) then
      stat = DC_ENOTINIT
      cause_c = 'SPLDAT'
      goto 999
    end if

    !-----------------------------------------------------------------
    !  "SPLDAT" の設定の消去
    !  Clear the settings for "SPLDAT"
    !-----------------------------------------------------------------
    deallocate( spl_dat % x_knots  )
    deallocate( spl_dat % x_value  )
    deallocate( spl_dat % x_coeffB )
    deallocate( spl_dat % x_coeffC )
    deallocate( spl_dat % x_coeffD )

    !-----------------------------------------------------------------
    !  終了処理, 例外処理
    !  Termination and Exception handling
    !-----------------------------------------------------------------
    spl_dat % initialized = .false.
999 continue
    call StoreError( stat, subname, err, cause_c )
    call EndSub( subname )
  end subroutine SplineDataClose
Subroutine :
spl_dat :type(SPLDAT), intent(inout)
knots_num :integer, intent(in)
: 結節点の数 (2 以上). the number of data points or knots (greater than 2)
x_knots(0:knots_num-1) :real(DP), intent(in)
: 結節点の横軸データ (増加する順序に並ぶ). The abscissas of the knots in strictly increasing order
x_value(0:knots_num-1) :real(DP), intent(in)
: 結節点の縦軸データ. The ordinates of the knots
nmlfile :character(*), intent(in), optional
: NAMELIST ファイルの名称. この引数に空文字以外を与えた場合, 指定されたファイルから NAMELIST 変数群を読み込みます. ファイルを読み込めない場合にはエラーを 生じます.

NAMELIST 変数群の詳細に関しては NAMELIST#spline_data_nml を参照してください.

NAMELIST file name. If nonnull character is specified to this argument, NAMELIST group name is loaded from the file. If the file can not be read, an error occurs.

See "NAMELIST#spline_data_nml" for details about a NAMELIST group.

err :logical, intent(out), optional
: 例外処理用フラグ. デフォルトでは, この手続き内でエラーが 生じた場合, プログラムは強制終了します. 引数 err が与えられる場合, プログラムは強制終了せず, 代わりに err に .true. が代入されます.

Exception handling flag. By default, when error occur in this procedure, the program aborts. If this err argument is given, .true. is substituted to err and the program does not abort.

SPLDAT 型の変数の初期設定を行います. 他のサブルーチンを使用する前に必ずこのサブルーチンによって SPLDAT 型の変数を初期設定してください.

なお, 与えられた spl_dat が既に初期設定されている場合, プログラムはエラーを発生させます.

NAMELIST を利用する場合には引数 nmlfileNAMELIST ファイル名 を与えてください. NAMELIST 変数群の詳細に関しては NAMELIST#spline_data_nml を参照してください.

Constructor of "SPLDAT". Initialize spl_dat by this subroutine, before other procedures are used,

Note that if spl_dat is already initialized by this procedure, error is occurred.

In order to use NAMELIST, specify a NAMELIST filename to argument nmlfile. See "NAMELIST#spline_data_nml" for details about a NAMELIST group.

[Source]

  subroutine SplineDataCreate( spl_dat, knots_num, x_knots, x_value, nmlfile, err )
    !
    ! SPLDAT 型の変数の初期設定を行います.
    ! 他のサブルーチンを使用する前に必ずこのサブルーチンによって
    ! SPLDAT 型の変数を初期設定してください.
    !
    ! なお, 与えられた *spl_dat* が既に初期設定されている場合,
    ! プログラムはエラーを発生させます.
    !
    ! NAMELIST を利用する場合には引数 *nmlfile* に NAMELIST ファイル名
    ! を与えてください. NAMELIST 変数群の詳細に関しては 
    ! NAMELIST#spline_data_nml を参照してください. 
    !
    ! Constructor of "SPLDAT".
    ! Initialize *spl_dat* by this subroutine, 
    ! before other procedures are used, 
    !
    ! Note that if *spl_dat* is already initialized 
    ! by this procedure, error is occurred.
    !
    ! In order to use NAMELIST, specify a NAMELIST filename to 
    ! argument *nmlfile*. See "NAMELIST#spline_data_nml"
    ! for details about a NAMELIST group.
    !
    use dc_trace, only: BeginSub, EndSub
    use dc_string, only: PutLine, Printf
    use dc_types, only: DP, STRING, TOKEN, STDOUT
    use dc_present, only: present_and_not_empty, present_and_true
    use dc_message, only: MessageNotify
    use dcpam_error, only: StoreError, DCPAM_EBADNUMBER, DCPAM_ESMALLVAL
    use dc_error, only: DC_NOERR, DC_EALREADYINIT, DC_EARGLACK, DC_ENEGATIVE, DC_ENOFILEREAD
    implicit none
    type(SPLDAT), intent(inout):: spl_dat
    integer, intent(in):: knots_num
                              ! 結節点の数 (2 以上). 
                              ! the number of data points or knots
                              ! (greater than 2)
    real(DP), intent(in):: x_knots (0:knots_num-1)
                              ! 結節点の横軸データ (増加する順序に並ぶ). 
                              ! The abscissas of the knots 
                              ! in strictly increasing order
    real(DP), intent(in):: x_value (0:knots_num-1)
                              ! 結節点の縦軸データ. 
                              ! The ordinates of the knots
    character(*), intent(in), optional:: nmlfile
                              ! NAMELIST ファイルの名称. 
                              ! この引数に空文字以外を与えた場合, 
                              ! 指定されたファイルから 
                              ! NAMELIST 変数群を読み込みます. 
                              ! ファイルを読み込めない場合にはエラーを
                              ! 生じます.
                              !
                              ! NAMELIST 変数群の詳細に関しては 
                              ! NAMELIST#spline_data_nml 
                              ! を参照してください. 
                              !
                              ! NAMELIST file name. 
                              ! If nonnull character is specified to
                              ! this argument, 
                              ! NAMELIST group name is loaded from the 
                              ! file. 
                              ! If the file can not be read, 
                              ! an error occurs.
                              ! 
                              ! See "NAMELIST#spline_data_nml" 
                              ! for details about a NAMELIST group.
                              ! 
    logical, intent(out), optional:: err
                              ! 例外処理用フラグ.
                              ! デフォルトでは, この手続き内でエラーが
                              ! 生じた場合, プログラムは強制終了します.
                              ! 引数 *err* が与えられる場合,
                              ! プログラムは強制終了せず, 代わりに
                              ! *err* に .true. が代入されます.
                              !
                              ! Exception handling flag. 
                              ! By default, when error occur in 
                              ! this procedure, the program aborts. 
                              ! If this *err* argument is given, 
                              ! .true. is substituted to *err* and 
                              ! the program does not abort. 

    !-----------------------------------
    !  スプライン係数. 
    !  Spline coefficient
    real(DP):: x_coeffB (0:knots_num-1)
                              ! スプライン係数. 
                              ! Spline coefficient
    real(DP):: x_coeffC (0:knots_num-1)
                              ! スプライン係数. 
                              ! Spline coefficient
    real(DP):: x_coeffD (0:knots_num-1)
                              ! スプライン係数. 
                              ! Spline coefficient

    !-----------------------------------
    !  作業変数
    !  Work variables
    real(DP):: workA

    integer:: i               ! DO ループ用作業変数
                              ! Work variables for DO loop

    integer:: stat
    character(STRING):: cause_c
    integer:: cause_i
    character(*), parameter:: subname = 'SplineDataCreate'
  continue
    call BeginSub( subname, version )
    stat = DC_NOERR
    cause_c = ''
    cause_i = 0

    !-----------------------------------------------------------------
    !  初期設定のチェック
    !  Check initialization
    !-----------------------------------------------------------------
    if ( spl_dat % initialized ) then
      stat = DC_EALREADYINIT
      cause_c = 'SPLDAT'
      goto 999
    end if

    !-----------------------------------------------------------------
    !  引数の正当性のチェック
    !  Validation of arguments
    !-----------------------------------------------------------------
    if (knots_num < 2) then
      stat = DCPAM_ESMALLVAL
      cause_c = 'knots_num'
      cause_i = 2
      goto 999
    end if

    !-----------------------------------------------------------------
    !  "SPLDAT" の設定
    !  Configure the settings for "SPLDAT"
    !-----------------------------------------------------------------

    !-------------------------
    !  デフォルト値
    !  Default values
!!$    spl_dat % param_r = 0.0_DP
!!$    spl_dat % param_c = 'hogehoge'

    !-------------------------
    !  オプショナル引数からの値
    !  Values from optional arguments
!!$    spl_dat % param_i = param_i
!!$    if ( present(param_r) )  spl_dat % param_r = param_r
!!$    if ( present(param_c) )  spl_dat % param_c = param_c

    !-------------------------
    !  NAMELIST からの値
    !  Values from NAMELIST

!!$    if ( present_and_not_empty(nmlfile) ) then
!!$      call MessageNotify( 'M', subname, &
!!$        & 'Loading NAMELIST file "%c" ...', &
!!$        & c1 = trim(nmlfile) )
!!$      call NmlRead ( nmlfile = nmlfile, &      ! (in)
!!$        & param_i = spl_dat % param_i, &   ! (inout)
!!$        & param_r = spl_dat % param_r, &   ! (inout)
!!$        & param_c_ = spl_dat % param_c, &  ! (inout)
!!$        & err = err )                          ! (out)
!!$      if ( present_and_true(err) ) then
!!$        call MessageNotify( 'W', subname, &
!!$          & '"%c" can not be read.', &
!!$          & c1 = trim(nmlfile) )
!!$        stat = DC_ENOFILEREAD
!!$        cause_c = nmlfile
!!$        goto 999
!!$      end if
!!$    end if

    !-----------------------------------------------------------------
    !  設定値の正当性のチェック
    !  Validate setting values
    !-----------------------------------------------------------------
!!$    if ( spl_dat % param_i < 0 ) then
!!$      stat = DC_ENEGATIVE
!!$      cause_c = 'param_i'
!!$      goto 999
!!$    end if

    !-----------------------------------------------------------------
    !  スプライン係数の計算
    !  Calculate spline coefficient
    !-----------------------------------------------------------------
    x_coeffB = 0.0_DP
    x_coeffC = 0.0_DP
    x_coeffD = 0.0_DP
  
    if ( knots_num == 2 ) then
      x_coeffB(0) = ( x_value(1) - x_value(0) ) / ( x_knots(1) - x_knots(0) )
      x_coeffC(0) = 0.0_DP
      x_coeffD(0) = 0.0_DP
      x_coeffB(1) = x_coeffB(0)
      x_coeffC(1) = 0.0_DP
      x_coeffD(1) = 0.0_DP
    else
    
      x_coeffD(0) = x_knots(1) - x_knots(0)
      x_coeffC(1) = ( x_value(1) - x_value(0) ) / x_coeffD(0)

      do i = 1, knots_num-2
        x_coeffD(i)   = x_knots(i+1) - x_knots(i)
        x_coeffB(i)   = 2.0_DP * ( x_coeffD(i-1) + x_coeffD(i) )
        x_coeffC(i+1) = ( x_value(i+1) - x_value(i) ) / x_coeffD(i)
        x_coeffC(i)   = x_coeffC(i+1) - x_coeffC(i)
      enddo

      x_coeffB(0)           = - x_coeffD(0)
      x_coeffB(knots_num-1) = - x_coeffD(knots_num-2)
      x_coeffC(0)           = 0.0_DP
      x_coeffC(knots_num-1) = 0.0_DP
    
      if ( knots_num > 3 ) then
        x_coeffC(0) = x_coeffC(2) / ( x_knots(3)-x_knots(1) ) - x_coeffC(1) / ( x_knots(2)-x_knots(0) )

        x_coeffC(knots_num-1) = x_coeffC(knots_num-2) / ( x_knots(knots_num-1) - x_knots(knots_num-3) ) - x_coeffC(knots_num-3) / ( x_knots(knots_num-2) - x_knots(knots_num-4) )

        x_coeffC(0) = x_coeffC(0) * x_coeffD(0)**2.0_DP / ( x_knots(3) - x_knots(0) )

        x_coeffC(knots_num-1) = - x_coeffC(knots_num-1) * x_coeffD(knots_num-2)**2.0_DP / ( x_knots(knots_num-1) - x_knots(knots_num-4) )
      endif

      do i = 1, knots_num-1
        workA = x_coeffD(i-1) / x_coeffB(i-1)
        x_coeffB(i) = x_coeffB(i) - workA * x_coeffD(i-1)
        x_coeffC(i) = x_coeffC(i) - workA * x_coeffC(i-1)
      enddo

      x_coeffC(knots_num-1) = x_coeffC(knots_num-1) / x_coeffB(knots_num-1)

      do i = knots_num-2, 0, -1
        x_coeffC(i) = ( x_coeffC(i) - x_coeffD(i) * x_coeffC(i+1) ) / x_coeffB(i)
      enddo

      x_coeffB(knots_num-1) = ( x_value(knots_num-1) - x_value(knots_num-2) ) / x_coeffD(knots_num-2) + x_coeffD(knots_num-2) * ( x_coeffC(knots_num-2) + 2.0_DP * x_coeffC(knots_num-1) )

      do i = 0, knots_num-2

        x_coeffB(i) = ( x_value(i+1) - x_value(i) ) / x_coeffD(i) - x_coeffD(i) * ( x_coeffC(i+1) + 2.0_DP * x_coeffC(i) )

        x_coeffD(i) = ( x_coeffC(i+1) - x_coeffC(i) ) / x_coeffD(i)

        x_coeffC(i) = 3.0_DP * x_coeffC(i)

      enddo

      x_coeffC(knots_num-1) = 3.0_DP * x_coeffC(knots_num-1)
      x_coeffD(knots_num-1) = x_coeffD(knots_num-2)
    endif

    !-----------------------------------------------------------------
    !  *spl_dat* に設定値を格納
    !  Store setting values to *spl_dat*
    !-----------------------------------------------------------------
    spl_dat % knots_num = knots_num

    allocate( spl_dat % x_knots(0:knots_num-1) )
    allocate( spl_dat % x_value(0:knots_num-1) )
    allocate( spl_dat % x_coeffB(0:knots_num-1) )
    allocate( spl_dat % x_coeffC(0:knots_num-1) )
    allocate( spl_dat % x_coeffD(0:knots_num-1) )
    spl_dat % x_knots  = x_knots
    spl_dat % x_value  = x_value
    spl_dat % x_coeffB = x_coeffB
    spl_dat % x_coeffC = x_coeffC
    spl_dat % x_coeffD = x_coeffD

    !-----------------------------------------------------------------
    !  終了処理, 例外処理
    !  Termination and Exception handling
    !-----------------------------------------------------------------
    spl_dat % initialized = .true.
999 continue
    call StoreError( stat, subname, err, cause_c, cause_i )
    call EndSub( subname )
  end subroutine SplineDataCreate
Subroutine :
spl_dat :type(SPLDAT), intent(inout)
a_Dim(:) :real(DP), intent(in)
: 軸データ. dimensional data
a_Data(:) :real(DP), intent(out)
: スプライン曲線データ. Spline curve data
err :logical, intent(out), optional
: 例外処理用フラグ. デフォルトでは, この手続き内でエラーが 生じた場合, プログラムは強制終了します. 引数 err が与えられる場合, プログラムは強制終了せず, 代わりに err に .true. が代入されます.

Exception handling flag. By default, when error occur in this procedure, the program aborts. If this err argument is given, .true. is substituted to err and the program does not abort.

a_Data にスプライン曲線データが返ります. a_Data の配列サイズは任意です. a_Dim には a_Data の軸データを与えてください.

なお, 与えられた spl_datCreate によって初期設定 されていない場合, プログラムはエラーを発生させます.

Spline curve data is returned to a_Data. Array size of a_Data is arbitrary. Give dimensional data of a_Data to a_Dim.

If spl_dat is not initialized by "Create" yet, error is occurred.

[Source]

  subroutine SplineDataGetSpline( spl_dat, a_Dim, a_Data, err )
    !
    ! *a_Data* にスプライン曲線データが返ります.
    ! *a_Data* の配列サイズは任意です. 
    ! *a_Dim* には *a_Data* の軸データを与えてください. 
    !
    ! なお, 与えられた *spl_dat* が Create によって初期設定
    ! されていない場合, プログラムはエラーを発生させます.
    !
    ! Spline curve data is returned to *a_Data*. 
    ! Array size of *a_Data* is arbitrary. 
    ! Give dimensional data of *a_Data* to *a_Dim*. 
    !
    ! If *spl_dat* is not initialized by "Create" yet,
    ! error is occurred.
    !
    use dc_trace, only: BeginSub, EndSub
    use dc_string, only: PutLine, Printf, toChar
    use dc_types, only: DP, STRING, TOKEN, STDOUT
    use dcpam_error, only: StoreError, DCPAM_EARGSIZEMISMATCH, DCPAM_EBADNUMBER
    use dc_error, only: DC_NOERR, DC_ENOTINIT
    use dc_message, only: MessageNotify
    implicit none
    type(SPLDAT), intent(inout):: spl_dat
    real(DP), intent(in):: a_Dim (:)
                              ! 軸データ. 
                              ! dimensional data
    real(DP), intent(out):: a_Data (:)
                              ! スプライン曲線データ. 
                              ! Spline curve data
    logical, intent(out), optional:: err
                              ! 例外処理用フラグ.
                              ! デフォルトでは, この手続き内でエラーが
                              ! 生じた場合, プログラムは強制終了します.
                              ! 引数 *err* が与えられる場合,
                              ! プログラムは強制終了せず, 代わりに
                              ! *err* に .true. が代入されます.
                              !
                              ! Exception handling flag. 
                              ! By default, when error occur in 
                              ! this procedure, the program aborts. 
                              ! If this *err* argument is given, 
                              ! .true. is substituted to *err* and 
                              ! the program does not abort. 

    !-----------------------------------
    !  スプライン係数. 
    !  Spline coefficient
    integer:: knots_num
                              ! 結節点の数 (2 以上). 
                              ! the number of data points or knots
                              ! (greater than 2)

    real(DP):: x_knots  (0:spl_dat%knots_num-1)
                              ! 結節点の横軸データ (増加する順序に並ぶ). 
                              ! The abscissas of the knots 
                              ! in strictly increasing order
    real(DP):: x_value  (0:spl_dat%knots_num-1)
                              ! 結節点の縦軸データ. 
                              ! The ordinates of the knots

    real(DP):: x_coeffB (0:spl_dat%knots_num-1)
                              ! スプライン係数. 
                              ! Spline coefficient
    real(DP):: x_coeffC (0:spl_dat%knots_num-1)
                              ! スプライン係数. 
                              ! Spline coefficient
    real(DP):: x_coeffD (0:spl_dat%knots_num-1)
                              ! スプライン係数. 
                              ! Spline coefficient

    !-----------------------------------
    !  作業変数
    !  Work variables
    integer:: size_a_Dim
    integer:: size_a_Data

    integer:: i, k            ! DO ループ用作業変数
                              ! Work variables for DO loop

    integer:: stat
    character(STRING):: cause_c
    integer:: cause_i
    character(*), parameter:: subname = 'SplineDataGetSpline'
  continue
    call BeginSub( subname )
    stat = DC_NOERR
    cause_c = ''
    cause_i = 0

    !-----------------------------------------------------------------
    !  初期設定のチェック
    !  Check initialization
    !-----------------------------------------------------------------
    if ( .not. spl_dat % initialized ) then
      stat = DC_ENOTINIT
      cause_c = 'SPLDAT'
      goto 999
    end if

    !-----------------------------------------------------------------
    !  *spl_dat* に格納されている設定値の取り出し
    !  Fetch setting values stored in *spl_dat*
    !-----------------------------------------------------------------
    knots_num = spl_dat % knots_num
    x_knots   = spl_dat % x_knots
    x_value   = spl_dat % x_value
    x_coeffB  = spl_dat % x_coeffB
    x_coeffC  = spl_dat % x_coeffC
    x_coeffD  = spl_dat % x_coeffD

    !-----------------------------------------------------------------
    !  配列サイズの取得と確認
    !  Get and confirm array size
    !-----------------------------------------------------------------
    size_a_Dim = size( a_Dim )
    size_a_Data = size( a_Data )

    if ( size_a_Dim /= size_a_Data ) then
      stat = DCPAM_EARGSIZEMISMATCH
      cause_c = 'size(a_Dim)=' // trim( toChar(size_a_Dim) ) // ' and size(a_Data)=' // trim( toChar(size_a_Data) )
      goto 999
    end if

    if ( size_a_Dim < knots_num ) then
      call MessageNotify( 'W', subname, 'size of "%c" (%d) must be bigger than "%c=%d".', c1 = 'a_Dim', c2 = 'knots_num', i = (/size_a_Dim, knots_num/) )

      stat = DCPAM_EBADNUMBER
      cause_c = 'size of "a_Dim"'
      cause_i = size_a_Dim
      goto 999
    end if

    !-----------------------------------------------------------------
    !  スプライン曲線データの作成
    !  Generate spline curve data
    !-----------------------------------------------------------------
    a_Data = 0.0_DP

    k = 0
    do i = 1, size_a_Dim
      if ( k < knots_num - 1 ) then
        if ( a_Dim(i) >= x_knots(k+1) ) then
          k = k + 1
        end if
      end if
      a_Data(i) = x_value(k) + x_coeffB(k) * ( a_Dim(i) - x_knots(k) ) + x_coeffC(k) * ( a_Dim(i) - x_knots(k) )**2 + x_coeffD(k) * ( a_Dim(i) - x_knots(k) )**3
    enddo

    !-----------------------------------------------------------------
    !  終了処理, 例外処理
    !  Termination and Exception handling
    !-----------------------------------------------------------------
999 continue
    call StoreError( stat, subname, err, cause_c, cause_i )
    call EndSub( subname )
  end subroutine SplineDataGetSpline
Function :
result :logical
spl_dat :type(SPLDAT), intent(in)

spl_dat が初期設定されている場合には .true. が, 初期設定されていない場合には .false. が返ります.

If spl_dat is initialized, .true. is returned. If spl_dat is not initialized, .false. is returned.

[Source]

  logical function SplineDataInitialized( spl_dat ) result(result)
    !
    ! *spl_dat* が初期設定されている場合には .true. が,
    ! 初期設定されていない場合には .false. が返ります.
    !
    ! If *spl_dat* is initialized, .true. is returned.
    ! If *spl_dat* is not initialized, .false. is returned.
    !
    implicit none
    type(SPLDAT), intent(in):: spl_dat
  continue
    result = spl_dat % initialized
  end function SplineDataInitialized
Subroutine :
nmlfile :character(*), intent(in)
: NAMELIST ファイルの名称. NAMELIST file name
!$ integer, intent(inout):param_i
!$ real(DP), intent(inout):param_r
!$ character(*), intent(inout):param_c_
!$ character(TOKEN):param_c
err :logical, intent(out), optional
: 例外処理用フラグ. デフォルトでは, この手続き内でエラーが 生じた場合, プログラムは強制終了します. 引数 err が与えられる場合, プログラムは強制終了せず, 代わりに err に .true. が代入されます.

Exception handling flag. By default, when error occur in this procedure, the program aborts. If this err argument is given, .true. is substituted to err and the program does not abort.

NAMELIST ファイル nmlfile から値を入力するための 内部サブルーチンです. Create 内で呼び出されることを 想定しています.

値が NAMELIST ファイル内で指定されていない場合には, 入力された値がそのまま返ります.

なお, nmlfile に空文字が与えられた場合, または 与えられた nmlfile を読み込むことができない場合, プログラムはエラーを発生させます.

This is an internal subroutine to input values from NAMELIST file nmlfile. This subroutine is expected to be called by "Create".

A value not specified in NAMELIST file is returned without change.

If nmlfile is empty, or nmlfile can not be read, error is occurred.

[Source]

  subroutine SplineDataNmlRead( nmlfile, err )
    !
    ! NAMELIST ファイル *nmlfile* から値を入力するための
    ! 内部サブルーチンです. Create 内で呼び出されることを
    ! 想定しています.
    !
    ! 値が NAMELIST ファイル内で指定されていない場合には,
    ! 入力された値がそのまま返ります.
    !
    ! なお, *nmlfile* に空文字が与えられた場合, または
    ! 与えられた *nmlfile* を読み込むことができない場合, 
    ! プログラムはエラーを発生させます.
    !
    ! This is an internal subroutine to input values from 
    ! NAMELIST file *nmlfile*. This subroutine is expected to be
    ! called by "Create".
    !
    ! A value not specified in NAMELIST file is returned
    ! without change.
    !
    ! If *nmlfile* is empty, or *nmlfile* can not be read, 
    ! error is occurred.
    !
    use dc_trace, only: BeginSub, EndSub
    use dc_string, only: PutLine, Printf
    use dc_types, only: DP, STRING, TOKEN, STDOUT
    use dc_iounit, only: FileOpen
    use dc_message, only: MessageNotify
    use dc_present, only: present_and_true
    use dc_error, only: StoreError, DC_NOERR, DC_ENOFILEREAD
    implicit none
    character(*), intent(in):: nmlfile
                              ! NAMELIST ファイルの名称. 
                              ! NAMELIST file name
!!$    integer, intent(inout):: param_i
!!$    real(DP), intent(inout):: param_r
!!$    character(*), intent(inout):: param_c_
!!$    character(TOKEN):: param_c
    logical, intent(out), optional:: err
                              ! 例外処理用フラグ.
                              ! デフォルトでは, この手続き内でエラーが
                              ! 生じた場合, プログラムは強制終了します.
                              ! 引数 *err* が与えられる場合,
                              ! プログラムは強制終了せず, 代わりに
                              ! *err* に .true. が代入されます.
                              !
                              ! Exception handling flag. 
                              ! By default, when error occur in 
                              ! this procedure, the program aborts. 
                              ! If this *err* argument is given, 
                              ! .true. is substituted to *err* and 
                              ! the program does not abort. 

!!$    namelist /spline_data_nml/ &
!!$      & param_i, param_r, param_c
                              ! spline_data モジュール用
                              ! NAMELIST 変数群名.
                              !
                              ! spline_data#Create を使用する際に, 
                              ! オプショナル引数 *nmlfile* へ NAMELIST 
                              ! ファイル名を指定することで, そのファイルから
                              ! この NAMELIST 変数群を読み込みます.
                              !
                              ! NAMELIST group name for 
                              ! "spline_data" module.
                              ! 
                              ! If a NAMELIST filename is specified to 
                              ! an optional argument *nmlfile* 
                              ! when "spline_data#Create" is used, 
                              ! this NAMELIST group is loaded from 
                              ! the file.

    !-----------------------------------
    !  作業変数
    !  Work variables
    integer:: stat
    character(STRING):: cause_c
    integer:: unit_nml        ! NAMELIST ファイルオープン用装置番号. 
                              ! Unit number for NAMELIST file open
    integer:: iostat_nml      ! NAMELIST 読み込み時の IOSTAT. 
                              ! IOSTAT of NAMELIST read
    character(*), parameter:: subname = 'SplineDataNmlRead'
  continue
    call BeginSub( subname )
    stat = DC_NOERR
    cause_c = ''



    !-----------------------------------------------------------------
    !  文字型引数を NAMELIST 変数群へ代入
    !  Substitute character arguments to NAMELIST group
    !-----------------------------------------------------------------
!!$    param_c = param_c_

    !----------------------------------------------------------------
    !  NAMELIST ファイルのオープン
    !  Open NAMELIST file
    !----------------------------------------------------------------
    call FileOpen( unit = unit_nml, file = nmlfile, mode = 'r', err = err )                   ! (out)
    if ( present_and_true(err) ) then
      stat = DC_ENOFILEREAD
      cause_c = nmlfile
      goto 999
    end if


    !-----------------------------------------------------------------
    !  NAMELIST 変数群の取得
    !  Get NAMELIST group
    !-----------------------------------------------------------------
!!$    read( unit = unit_nml, & ! (in)
!!$      & nml = spline_data_nml, iostat = iostat_nml ) ! (out)
!!$    if ( iostat_nml == 0 ) then
!!$      call MessageNotify( 'M', subname, &
!!$        & 'NAMELIST group "%c" is loaded from "%c".', &
!!$        & c1 = 'spline_data_nml', c2 = trim(nmlfile) )
!!$      write(STDOUT, nml = spline_data_nml)
!!$    else
!!$      call MessageNotify( 'W', subname, &
!!$        & 'NAMELIST group "%c" is not found in "%c" (iostat=%d).', &
!!$        & c1 = 'spline_data_nml', c2 = trim(nmlfile), &
!!$        & i = (/iostat_nml/) )
!!$    end if

    close( unit_nml )

    !-----------------------------------------------------------------
    !  NAMELIST 変数群を文字型引数へ代入
    !  Substitute NAMELIST group to character arguments
    !-----------------------------------------------------------------
!!$    param_c_ = param_c

    !-----------------------------------------------------------------
    !  終了処理, 例外処理
    !  Termination and Exception handling
    !-----------------------------------------------------------------
999 continue
    call StoreError( stat, subname, err, cause_c )
    call EndSub( subname )
  end subroutine SplineDataNmlRead
Subroutine :
spl_dat :type(SPLDAT), intent(in)
unit :integer, intent(in), optional
: 出力先の装置番号. デフォルトの出力先は標準出力.

Unit number for output. Default value is standard output.

indent :character(*), intent(in), optional
: 表示されるメッセージの字下げ.

Indent of displayed messages.

err :logical, intent(out), optional
: 例外処理用フラグ. デフォルトでは, この手続き内でエラーが 生じた場合, プログラムは強制終了します. 引数 err が与えられる場合, プログラムは強制終了せず, 代わりに err に .true. が代入されます.

Exception handling flag. By default, when error occur in this procedure, the program aborts. If this err argument is given, .true. is substituted to err and the program does not abort.

引数 spl_dat に設定されている情報を印字します. デフォルトではメッセージは標準出力に出力されます. unit に装置番号を指定することで, 出力先を変更することが可能です.

Print information of spl_dat. By default messages are output to standard output. Unit number for output can be changed by unit argument.

[Source]

  subroutine SplineDataPutLine( spl_dat, unit, indent, err )
    !
    ! 引数 *spl_dat* に設定されている情報を印字します.
    ! デフォルトではメッセージは標準出力に出力されます. 
    ! *unit* に装置番号を指定することで, 出力先を変更することが可能です.
    !
    ! Print information of *spl_dat*.
    ! By default messages are output to standard output.
    ! Unit number for output can be changed by *unit* argument.
    !
    use dc_trace, only: BeginSub, EndSub
    use dc_string, only: PutLine, Printf
    use dc_types, only: DP, STRING, TOKEN, STDOUT
    use dc_error, only: StoreError, DC_NOERR, DC_ENOTINIT
    implicit none
    type(SPLDAT), intent(in):: spl_dat
    integer, intent(in), optional:: unit
                              ! 出力先の装置番号.
                              ! デフォルトの出力先は標準出力.
                              !
                              ! Unit number for output.
                              ! Default value is standard output.
    character(*), intent(in), optional:: indent
                              ! 表示されるメッセージの字下げ.
                              !
                              ! Indent of displayed messages.
    logical, intent(out), optional:: err
                              ! 例外処理用フラグ.
                              ! デフォルトでは, この手続き内でエラーが
                              ! 生じた場合, プログラムは強制終了します.
                              ! 引数 *err* が与えられる場合,
                              ! プログラムは強制終了せず, 代わりに
                              ! *err* に .true. が代入されます.
                              !
                              ! Exception handling flag. 
                              ! By default, when error occur in 
                              ! this procedure, the program aborts. 
                              ! If this *err* argument is given, 
                              ! .true. is substituted to *err* and 
                              ! the program does not abort. 

    !-----------------------------------
    !  作業変数
    !  Work variables
    integer:: stat
    character(STRING):: cause_c
    integer:: out_unit
    integer:: indent_len
    character(STRING):: indent_str
    character(*), parameter:: subname = 'SplineDataPutLine'
  continue
    call BeginSub( subname )
    stat = DC_NOERR
    cause_c = ''

    !-----------------------------------------------------------------
    !  初期設定のチェック
    !  Check initialization
    !-----------------------------------------------------------------
    if ( present(unit) ) then
      out_unit = unit
    else
      out_unit = STDOUT
    end if

    indent_len = 0
    indent_str = ''
    if ( present(indent) ) then
      if ( len(indent) /= 0 ) then
        indent_len = len(indent)
        indent_str(1:indent_len) = indent
      end if
    end if


    !-----------------------------------------------------------------
    !  "SPLDAT" の設定の印字
    !  Print the settings for "SPLDAT"
    !-----------------------------------------------------------------
    if ( spl_dat % initialized ) then
      call Printf( out_unit, indent_str(1:indent_len) // '#<SPLDAT:: @initialized=%y', l = (/spl_dat % initialized/) )

      call Printf( out_unit, indent_str(1:indent_len) // ' @knots_num=%d', i = (/spl_dat % knots_num/) )

      call PutLine( spl_dat % x_knots, unit = out_unit, lbounds = lbound(spl_dat % x_knots), ubounds = ubound(spl_dat % x_knots), indent = indent_str(1:indent_len) // ' @x_knots=' )

      call PutLine( spl_dat % x_value, unit = out_unit, lbounds = lbound(spl_dat % x_value), ubounds = ubound(spl_dat % x_value), indent = indent_str(1:indent_len) // ' @x_value=' )

      call PutLine( spl_dat % x_coeffB, unit = out_unit, lbounds = lbound(spl_dat % x_coeffB), ubounds = ubound(spl_dat % x_coeffB), indent = indent_str(1:indent_len) // ' @x_coeffB=' )

      call PutLine( spl_dat % x_coeffC, unit = out_unit, lbounds = lbound(spl_dat % x_coeffC), ubounds = ubound(spl_dat % x_coeffC), indent = indent_str(1:indent_len) // ' @x_coeffC=' )

      call PutLine( spl_dat % x_coeffD, unit = out_unit, lbounds = lbound(spl_dat % x_coeffD), ubounds = ubound(spl_dat % x_coeffD), indent = indent_str(1:indent_len) // ' @x_coeffD=' )

      call Printf( out_unit, indent_str(1:indent_len) // '>' )
    else
      call Printf( out_unit, indent_str(1:indent_len) // '#<SPLDAT:: @initialized=%y>', l = (/spl_dat % initialized/) )
    end if

    !-----------------------------------------------------------------
    !  終了処理, 例外処理
    !  Termination and Exception handling
    !-----------------------------------------------------------------
999 continue
    call StoreError( stat, subname, err, cause_c )
    call EndSub( subname )
  end subroutine SplineDataPutLine
version
Constant :
version = ’$Name: dcpam4-20080624-1 $’ // ’$Id: spline_data.f90,v 1.2 2007-09-21 13:50:05 morikawa Exp $’ :character(*), parameter

[Validate]