Changes between Version 17 and Version 18 of doc/app/palmrun

Timestamp:

Apr 12, 2018 3:13:47 PM (7 years ago)

Author:

raasch

Comment:

--

doc/app/palmrun

@@ -1 +1 @@
 = '''This page is under construction! ''' =
+\\\\\\
+
+= Running PALM with {{{palmrun}}}
+
+PALM can be run in three different modes: interactive mode, batch mode, and batch mode on a remote computer. Here we explain how to run PALM in interactive mode, which means that PALM executes (almost) immediately within your terminal session after you entered the {{{palmrun}}} command. You can follow the progress of the simulation on the terminal where a lot of informative messages will be output. You can also stop the simulation at any time by typing {{{CTRL C}}}. Running PALM in batch mode requires additional manual settings in the configuration file, which will be explained here (add link).
+
+The following instructions assume, that the automatic installer has run without any problems. Please switch to your working directory and check if the default configuration file has been generated
+{{{
+   cd ~/palm/current_version
+   ls -al
+   ls -al JOBS/example_cbl/INPUT
+}}}
+You should see the default configuration file {{{.palm.config.default}}}. Furthermore, the parameter file {{{JOBS/example_cbl/INPUT/example_cbl_p3d}}} should also exist. This is a FORTRAN-NAMELIST file to define the simulation setup and to steer the PALM simulation. You should now be able to start the first PALM simulation yourself. Please enter
+{{{
+   palmrun  -d example_cbl  -h default  -a "d3#"  -X4  -T4
+}}}
+{{{example_cbl}}} is the so-called ''run identifier'' and tells {{{palmrun}}} to use the NAMELIST file {{{example_cbl_p3d}}} from {{{JOBS/example_cbl/INPUT}}}. It also determines folders and names of output files generated by PALM using informations from the default file configuration file {{{..../trunk/SCRIPTS/.palm.iofiles}}}. Chapter .... explains the format of this file and how you can modify or extend it. As a new user, you should not need to care about this file because the default settings should do the job for you.
+
+
+
 \\\\\\