Changes between Version 107 and Version 108 of doc/app/iofiles

Timestamp:

Sep 10, 2018 9:58:23 AM (6 years ago)

Author:

sward

Comment:

--

doc/app/iofiles

@@ -1 +1 @@
 = Input and output files =
-The model works with a set of files, which are all located in the temporary working directory and which are either expected at the beginning of the run (the so-called input files) or which are produced during the run and/or at the end of the simulation (output files). The following table lists all default files addressed by the model. They are arranged according to the associated FORTRAN unit (unit number). The unit 90 is used for different files, which are opened only briefly and uniquely in the model and closed directly afterwards. Unit numbers 101 - 109, 111 - 113, 116 and 121-160 refer to data files which have netCDF format. These are not opened by a FORTRAN-OPEN-statement but by a corresponding netCDF call ({{{NF90_CREATE}}} or {{{NF90_OPEN}}}). These files are only created on machines where a netCDF library is available. \\\\
+The model works with a set of files, which are all located in the temporary working directory and which are either expected at the beginning of the run (the so-called input files) or which are produced during the run and/or at the end of the simulation (output files). The following table lists all default files addressed by the model. They are arranged according to the associated FORTRAN unit (unit number). The unit 90 is used for different files, which are opened only briefly and uniquely in the model and closed directly afterwards. Unit numbers 101 - 109, 111 - 113, 116, 118 and 121-160 refer to data files which have netCDF format. These are not opened by a FORTRAN-OPEN-statement but by a corresponding netCDF call ({{{NF90_CREATE}}} or {{{NF90_OPEN}}}). These files are only created on machines where a netCDF library is available. \\\\
 The file names described in the list correspond to the names indicated in the respective OPEN instruction, i.e. the files are expected and saved under these names in the temporary working directory of the model. By default, file names are always written in capital letters. The third column indicates whether it is an input or output file (I and/or O). The netCDF files can be both input and output files (I/O). If restart jobs shall append data to an existing netCDF file (created by a previous job of the job chain), the respective file has to be given as an input file (see more details about the [../netcdf PALM-netCDF-output]). \\\\
 On parallel computers, many of the files are read and/or written by the central processing element 0 (PE0) only. These files have processor-independent content (and therefore they can be read or written by other PEs just as well). However, certain files have processor-dependent content. For the binary output of data for restart runs (local file [#BINOUT BINOUT]), for example, each PE outputs only the data of its subdomain. So each processing element writes into its own file with its own file name. These files lie in a subdirectory of the temporary working directory. Their names are built from the underline ("_") and the four digit processor ID. The data written for restart runs would be e.g. on the files BINOUT/_0000 (PE0), BINOUT/_0001 (PE1), BINOUT/_0002 (PE2) etc. Such files, which have processor-dependent content on parallel computers, are marked in the following list by the fact, that to the file name a line ("/") is attached. If appropriate output files are to be copied through '''mrun''' to permanent files, and/or files with processor-dependent content are supposed to be copied as input files into the temporary working directory of the model, you have to indicate a special file attribute in the appropriate file connection statement (see [wiki:arpe arpe], [wiki:flpe flpe] in the '''mrun''' description). Then the permanent file name will be interpreted as a directory name, in which the input files are expected and/or to which output files are written. The file names in these directories are always named _0000, _0001, _0002 etc. \\\\
@@ -1193 +1193 @@
 |----------------
 {{{#!td style="vertical-align:top"
+118
+}}}
+{{{#!td style="vertical-align:top"
+[=#DATA_AGT_NETCDF DATA_AGT_NETCDF]
+}}}
+{{{#!td style="vertical-align:top"
+O
+}}}
+{{{#!td style="vertical-align:top"
+NetCDF
+}}}
+{{{#!td 
+This file contains all output data from the [wiki:doc/tec/mas Multi Agent System (MAS)].\\\\
+Each variable has two dimensions (time and agent_number) so that at each [../agtpar#dt_write_agent_data output time step] all agent variables are output for each agent.\\
+The variables are:
+* agent ID (ag_id)
+* agent position (ag_x, ag_y)
+* wind speed at agent position (ag_wind)
+* temperature at agent position (ag_temp)
+* agent group (ag_group, see [../agtpar#number_of_agent_groups number_of_agent_groups])\\
+**Very important:** Due to agent data structure, agents may not always be sorted in the same succession. E.g. ag_id( time=i, agent_number= j) may not be the same as ag_id( time=i+1, agent_number= j). Thus, if individual agent data is needed, sorting by ag_id in postprocessing is required. \\\\
+
+
+
+float32 ag_wind(time,agent_number), float32 ag_temp(time,agent_number), float32 ag_group(time,agent_number)
+
+
+This file contains data of the temporally averaged 3d-volume data (see [../d3par#data_output data_output]) 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]). \\\\
+See the description of [../netcdf PALM-netCDF-output] for more detailed information.
+}}}
+|----------------
+{{{#!td style="vertical-align:top"
 199
 }}}