/usr/share/doc/pythia8-doc/html/SaveSettings.html is in pythia8-doc-html 8.1.80-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 | <html>
<head>
<title>Save Settings</title>
<link rel="stylesheet" type="text/css" href="pythia.css"/>
<link rel="shortcut icon" href="pythia32.gif"/>
</head>
<body>
<h2>Save Settings</h2>
The information on this webpage is only valid if you access the PHP
dynamic webpages via a web browser, and does not apply to the static
HTML equivalents. With PHP, all of the settings in the PYTHIA program
are represented by radio buttons or fill-in boxes, that makes it easy
for you to construct a file with your desired changes. This file can
then be read into PYTHIA by your main program to steer the whole run.
<h3>Basic instructions</h3>
The functionality of the PHP option is described in the following.
<p/>
<table border="2" cellpadding="5"><td>
</td></table>
<ul>
<p/><li>
To begin with, you must specify a <b>(temporary) file name</b> in the
box above. If the filename already exists on the server, you will be
requested to pick a new name.</li>
<p/><li>
Once you have <b>Submit</b>ted your filename, you can browse through the
pages and make your selections. The values currently selected when you
load the page are the default values.</li>
<p/><li>
When you have finished making your changes to a particular page,
you <b>must</b> click on <b>Save Settings</b> at the <b>bottom</b> of
the page. This will write the changes to your temporary file. If you make
a mistake, just repeat the procedure for that category again.<br>
<p/><li>
When you have finished all the changes you need, return to this page
and click <b>Finish File</b>.</li>
<p/><li>
You will then get up a link, that you are asked to <b>right-click</b>
with your mouse (or equivalent).</li>
<p/><li>
In the menu that appears, pick the option <b>Save Link As</b>
(or equivalent).</li>
<p/><li>
You will now get up a file browser, for you to pick and <b>Save</b>
the location and file name (the latter by default the same as the
temporary file name).</li>
<p/><li>
At any time, if you click the <b>RESET</b> button, your temporary
file will be erased and you can start anew.</li>
<p/><li>
Before you use a file, be sure to <b>check it visually</b> to confirm
that you saved what you intended to. Minor corrections are easily made
in a text editor.
</li>
</ul>
<p/>
<h3>Supplementary notes</h3>
The documentation files exist in three versions.
<ol>
<p/><li>
As a set of <code>.xml</code> files, in the <code>xmldoc/</code>
subdirectory. These are the master copies that no user ever should
touch, but that are used to generate the variants below.</li>
<p/><li>
As a set of <code>.html</code> files, in the <code>htmldoc/</code>
subdirectory. You can open your own locally installed copy of the
<code>Welcome.html</code> file in your web browser and thereafter
navigate among all the pages. You can learn which parameters are free
to be changed, but not change anything, except by brute-force
cut-and-paste to a file of your own.</li>
<p/><li>
As a set of <code>.php</code> files, in the <code>phpdoc/</code>
subdirectory. For these files to provide the functionality described
above they have to accessed via a webserver. The one where you have
your homepage should work fine. Alternatively you can use pages already
available on another server.</li>
</ol>
<p/>
A few further comments about the operation of the PHP option:
<ul>
<p/><li>
To set up the PHP files on your webserver, you have to install the whole
<code>phpdoc/</code> subdirectory there. In addition to the
<code>.php</code> code this includes a few more files, plus a
subdirectory named <code>files</code> where the temporary files
are stored. This subdirectory must have public write access to work
(<code>chmod a+w files</code> if not).</li>
<p/><li>
The "temporary" files stored in <code>files</code> actually remain
unless the RESET button is used. The good news is that this makes
it possible to recover a file that otherwise might be lost. The bad
news is that the <code>files</code> directory may need to be cleaned
up from time to time. (But typically the files are pretty small, so
this should not be a major problem.)</li>
<p/><li>
When you click the <b>Save Settings</b> button on the bottom of a page
all changed settings are written on the temporary file in the format
<pre>
name-of-flag/mode/parameter/word = value
</pre>
with one variable per line. Thereafter all the settings on the page
are restored to their default values.</li>
<p/><li>
You can return to a page to do some further changes and save those.
If you change the same parameter twice, it is the last value that
counts. (Both values are stored in the file, with the more recent
lower down, and then PYTHIA does the changes sequentially.) However
remember that unchanged values are not stored, so if you want to
restore some default value it may be simpler to edit the file
afterwards.</li>
<p/><li>
The changeable flags/modes/parameters/words are mainly in the
"Setup Run Tasks" section of the index, but a few (less
frequently used ones) can also be found lower down, in the
"Study Output" and "Link to Other Programs" pages.
<p/><li>
It is not (yet) possible to modify particle data within the PHP-based
setup approach. This is a more difficult task, since e.g. the
modifications one may want to do in a decay table can be quite
interrelated.
</body>
</html>
<!-- Copyright (C) 2013 Torbjorn Sjostrand -->
|