= PALM Quickstart Guide =

Ideally, you have successfully installed PALM using the [wiki:doc/install/automatic automatic installer].\\ If so, the installer has 
* downloaded PALM from the subversion control (svn) repository into a predefined directory structure on your local PC (see Fig. 1),
* created the required palmrun [wiki:doc/app/palmrun configuration file], e.g. '''.palm.config.default''' (hidden file),
* pre-compiled ([wiki:doc/app/palmbuild palmbuild]) the '''UTIL'''ity programs and '''SOURCE''' code,
* run some small test simulations ('''JOBS''', see Fig. 2).\\

{{{
#!div style="align:'left'; width: 270px; border: 0px solid; float:left"
[[Image(file_tree_1.png, 250px, right, margin-right=2, margin-top=0, border=0)]]\\
'''Fig. 1''' Directory structure of PALM installation.
}}}
{{{
#!div style="align:'left'; width: 270px; border: 0px solid; float:left"
[[Image(file_tree_2.png, 250px, right, margin-right=2, margin-top=0, border=0)]]\\
'''Fig. 2''' Directory structure of PALM simulation setup.
}}}

\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\
Somewhere near the end of the automatic installation process, the following lines should have appeared in your terminal:\\
{{{
PALM installation successful
...
PALM installer finished.
}}}
\\
Further, the installer has printed an example command for starting a PALM simulation, e.g.
{{{
palmrun -r example_cbl   -a d3#      -c default       -X 4     -T 4
                |           |             |              |        |                
            run identifier  |  configuration identifier  |   tasks per node   
                     I/O control list             number of cores           
}}}

We have a [wiki:doc/app/palmrungui GUI] to create and submit the palmrun command (software requirements: QT4, python). Type into the terminal:
{{{
palmrungui
}}}

{{{
#!table style="border:none;vertical-align:top;text-align:left;width:750px"
  {{{#!tr style="border:none;width:750px"
    {{{#!td style="border:none"
    [[Image(palmrun_gui.png, width=750px, left, nolink)]]
    }}}
  }}}
}}}

If this doesn't work, copy and paste the command into the terminal.