Changes between Version 124 and Version 125 of doc/app/iofiles


Ignore:
Timestamp:
Feb 26, 2021 4:27:46 PM (4 years ago)
Author:
wagner
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • doc/app/iofiles

    v124 v125  
    741741}}}
    742742{{{#!td
    743 This file is created in case of particle transport (see the [../parpar particles package]). It contains statistical information about the number of particles used and about the number of particles exchanged between each single PE. This information is output after every timestep if switched on by parameter [../parpar#write_particle_statistics write_particle_statistics].
     743This file is created in case of particle transport (see the [../particle_parameters particles package]). It contains statistical information about the number of particles used and about the number of particles exchanged between each single PE. This information is output after every timestep if switched on by parameter [../particle_parameters#write_particle_statistics write_particle_statistics].
    744744}}}
    745745|----------------
     
    758758}}}
    759759{{{#!td
    760 This file is created if particle transport is switched on (see the [../parpar particles package]) and contains all particle data for one or several output times (see [../parpar#dt_write_particle_data dt_write_particle_data]). \\\\
     760This file is created if particle transport is switched on (see the [../particle_parameters particles package]) and contains all particle data for one or several output times (see [../particle_parameters#dt_write_particle_data dt_write_particle_data]). \\\\
    761761The first record of this file contains an identification string (PALM version number, run identifier, etc., 80 characters long). The second record also contains a version string (80 characters long) followed by two records with particle group information and a record containing the index bounds of the 3d subdomain arrays (see [source:palm/trunk/SOURCE/check_open.f90@4182#L553]). Then, for each output time, two records follow, where the first one gives the output time and the second one the number of particles that are output for the subdomain. After that, particle data is output, one record for each model grid box (if particles exist in that box) of the respective subdomain. See [source:palm/trunk/SOURCE/lagrangian_particle_model_mod.f90@4182#L2364] for the respective output statements. A FORTRAN TYPE structure is used for storing the particle attributes. See [source:palm/trunk/SOURCE/mod_particle_attributes.f90@4182#L77] for the detailed TYPE structure.
    762762}}}
     
    810810}}}
    811811{{{#!td
    812 Binary data, which are read in by the model at the beginning of a [../runs restart run]). The appropriate file must have been written by the preceding job of the job chain (see [#PARTICLE_RESTART_DATA_OUT PARTICLE_RESTART_DATA_OUT]). This file is needed if particle transport is switched on (see the [../parpar particles package]) and contains all particle information (particle positions, velocities, etc.) from the end of the preceding run. Concerning runs on several processors it has to be noted that each processing element reads its own file and that the file content is processor-dependent. The number of processors which can be used must not be changed during a job chain and/or if a job chain is continued. \\\\
    813 The first record of this file contains a version number (four character string) of the subroutine, which output the data that follows ({{{write_particles}}}, see end of file {{{advec_particles.f90}}}). This number has to agree with the version number of the subroutine which is reading the file ({{{init_parrticles.f90}}}) in case of a restart run. Otherwise the model run is aborted. Version numbers are changed whenever new code revisions require a change of the file format. Some general information like the number of particles stored in the file, the number of particle groups, etc. are stored in the second record. The third record includes the particles to be released at the source and the fourth record contains all current particles. In case that particle tails are used (see [../parpar#maximum_number_of_tailpoints maximum_number_of_tailpoints]), a further record may follow, which contains the particle tail information. A FORTRAN TYPE structure is used for storing the particle attributes. For detailed informations about the file format see the corresponding READ statements in file {{{init_particles.f90}}}.
     812Binary data, which are read in by the model at the beginning of a [../runs restart run]). The appropriate file must have been written by the preceding job of the job chain (see [#PARTICLE_RESTART_DATA_OUT PARTICLE_RESTART_DATA_OUT]). This file is needed if particle transport is switched on (see the [../particle_parameters particles package]) and contains all particle information (particle positions, velocities, etc.) from the end of the preceding run. Concerning runs on several processors it has to be noted that each processing element reads its own file and that the file content is processor-dependent. The number of processors which can be used must not be changed during a job chain and/or if a job chain is continued. \\\\
     813The first record of this file contains a version number (four character string) of the subroutine, which output the data that follows ({{{write_particles}}}, see end of file {{{advec_particles.f90}}}). This number has to agree with the version number of the subroutine which is reading the file ({{{init_parrticles.f90}}}) in case of a restart run. Otherwise the model run is aborted. Version numbers are changed whenever new code revisions require a change of the file format. Some general information like the number of particles stored in the file, the number of particle groups, etc. are stored in the second record. The third record includes the particles to be released at the source and the fourth record contains all current particles. In case that particle tails are used (see [../particle_parameters#maximum_number_of_tailpoints maximum_number_of_tailpoints]), a further record may follow, which contains the particle tail information. A FORTRAN TYPE structure is used for storing the particle attributes. For detailed informations about the file format see the corresponding READ statements in file {{{init_particles.f90}}}.
    814814}}}
    815815|----------------
     
    828828}}}
    829829{{{#!td
    830 Binary data, which are output at the end of the run and possibly needed by [../runs restart runs]) for the initialization. This output file is then read as file [#PARTICLE_RESTART_DATA_IN PARTICLE_RESTART_DATA_IN]. The file is only written if particle transport is switched on (see the [../parpar particles package]). For a more detailed description of the file structure see PARTICLE_RESTART_DATA_IN.
     830Binary data, which are output at the end of the run and possibly needed by [../runs restart runs]) for the initialization. This output file is then read as file [#PARTICLE_RESTART_DATA_IN PARTICLE_RESTART_DATA_IN]. The file is only written if particle transport is switched on (see the [../particle_parameters particles package]). For a more detailed description of the file structure see PARTICLE_RESTART_DATA_IN.
    831831}}}
    832832|----------------
     
    11741174}}}
    11751175{{{#!td
    1176 This file contains data of the particle data (see [../parpar#dt_prel dt_prel]) in netCDF format. The data in this file can be visualized by any graphic software which provides a netCDF interface (e.g. [../ncl NCL], [http://www.ferret.noaa.gov/Ferret/ ferret] or [http://meteora.ucsd.edu/~pierce/ncview_home_page.html ncview]). \\\\
     1176This file contains data of the particle data (see [../particle_parameters#dt_prel dt_prel]) in netCDF format. The data in this file can be visualized by any graphic software which provides a netCDF interface (e.g. [../ncl NCL], [http://www.ferret.noaa.gov/Ferret/ ferret] or [http://meteora.ucsd.edu/~pierce/ncview_home_page.html ncview]). \\\\
    11771177See the description of [../netcdf PALM-netCDF-output] for more detailed informations.
    11781178}}}
     
    11931193}}}
    11941194{{{#!td
    1195 This file contains data of the time series of particle quantities (see [../parpar#dt_prel dt_prel]) in netCDF format. The data in this file can be visualized by any graphic software which provides a netCDF interface (e.g. [../ncl NCL], [http://www.ferret.noaa.gov/Ferret/ ferret] or [http://meteora.ucsd.edu/~pierce/ncview_home_page.html ncview]). For a list of available output quantities see  [../parpar#dt_dopts dt_dopts]. \\\\
    1196 In case of using more than one particle group (see [../parpar#number_of_particle_groups number_of_particle_groups]), separate time series are output for each of the groups. The long names of the variables in the netCDF file containing the respective time series all end with the string '' ' PG '' ## '' ' '', where ## is the number of the particle group (01, 02, etc.). \\\\
     1195This file contains data of the time series of particle quantities (see [../particle_parameters#dt_prel dt_prel]) in netCDF format. The data in this file can be visualized by any graphic software which provides a netCDF interface (e.g. [../ncl NCL], [http://www.ferret.noaa.gov/Ferret/ ferret] or [http://meteora.ucsd.edu/~pierce/ncview_home_page.html ncview]). For a list of available output quantities see  [../particle_parameters#dt_dopts dt_dopts]. \\\\
     1196In case of using more than one particle group (see [../particle_parameters#number_of_particle_groups number_of_particle_groups]), separate time series are output for each of the groups. The long names of the variables in the netCDF file containing the respective time series all end with the string '' ' PG '' ## '' ' '', where ## is the number of the particle group (01, 02, etc.). \\\\
    11971197See the description of [../netcdf PALM-netCDF-output] for more detailed information.
    11981198}}}