mo_io Module Reference

File reading routines. More...

Data Types
interface	loadtxt
	Read a file into a 2D array containing reals. More...

Functions/Subroutines
subroutine	loadtxt_dp (filename, d, skiprows, max_rows)
	Read a file into a 2D array containing reals.
subroutine	loadtxt_sp (filename, d, skiprows, max_rows)
	Read a file into a 2D array containing reals.
integer function, public	number_of_columns (u)
	Determine number of columns in a file. The columns are assumed to be separated by spaces or tabs.
integer function, public	number_of_rows (u)
	Determine number of rows in a file.

Detailed Description

File reading routines.

This module provides routines to load a file into an array. This is mainly taken from the Fortran stdlib: https://github.com/fortran-lang/stdlib

Version

0.1

Authors

Sebastian Mueller

Date

Apr 2022

Copyright

Copyright 2005-2024, the CHS Developers, Sabine Attinger: All rights reserved. FORCES is released under the LGPLv3+ license

The UFZ (CHS) FORCES code is free software. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the free Software Foundation either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You received a copy of the GNU Lesser General Public License along with the UFZ CHS FORCES code. It can be found in the files COPYING and COPYING.LESSER provided with this software. The complete GNU license text can also be found at http://www.gnu.org/licenses/.

Function/Subroutine Documentation

loadtxt_dp()

subroutine mo_io::loadtxt_dp ( character(len=*), intent(in)  filename, real(dp), dimension(:,:), intent(out), allocatable  d, integer(i4), intent(in), optional  skiprows, integer(i4), intent(in), optional  max_rows  )

private

Read a file into a 2D array containing reals.

Parameters

[in]	filename	Filename to load the array from
[out]	d	The array 'd' will be automatically allocated with the correct dimensions
[in]	skiprows	lines to skip at the begining
[in]	max_rows	Read max_rows lines of content after skiprows lines. The default is to read all the lines (negative values).

Definition at line 33 of file mo_io.f90.

loadtxt_sp()

subroutine mo_io::loadtxt_sp ( character(len=*), intent(in)  filename, real(sp), dimension(:,:), intent(out), allocatable  d, integer(i4), intent(in), optional  skiprows, integer(i4), intent(in), optional  max_rows  )

private

Read a file into a 2D array containing reals.

Parameters

[in]	filename	Filename to load the array from
[out]	d	The array 'd' will be automatically allocated with the correct dimensions
[in]	skiprows	lines to skip at the begining
[in]	max_rows	Read max_rows lines of content after skiprows lines. The default is to read all the lines (negative values).

Definition at line 75 of file mo_io.f90.

number_of_columns()

integer function, public mo_io::number_of_columns

(

integer(i4), intent(in)

u

)

Determine number of columns in a file. The columns are assumed to be separated by spaces or tabs.

Returns

Number of columns.

Parameters

[in]

u

unit of the open file

Definition at line 118 of file mo_io.f90.

References mo_string_utils::is_blank(), and number_of_columns().

Referenced by mo_io::loadtxt::loadtxt_dp(), mo_io::loadtxt::loadtxt_sp(), and number_of_columns().

Here is the call graph for this function:

Here is the caller graph for this function:

number_of_rows()

integer function, public mo_io::number_of_rows

(

integer(i4), intent(in)

u

)

Determine number of rows in a file.

Returns

Number of rows.

Parameters

[in]

u

unit of the open file

Definition at line 140 of file mo_io.f90.

References number_of_rows().

Referenced by mo_io::loadtxt::loadtxt_dp(), mo_io::loadtxt::loadtxt_sp(), and number_of_rows().

Here is the call graph for this function:

Here is the caller graph for this function: