MUD format data files

Syntax: | `RESTORE\MUD file RESTORE\MUD\TITLE file`
Qualifiers: | `\MUD, \TITLE`

The `RESTORE\MUD` command restores muSR MUD type data files containing histograms. Histogram number j is stored in column j of matrix `IH`. Histogram number j can be extracted into a vector using: `HJ = IH[*,j]`.

If the `\TITLE` qualifier is used, only the title is restored, into a character variable named `RUNTITLE` (so as not to confuse it with variable `MUDTITLE` used to store the same title on a complete restore).

General

scalars | strings
`RUNNUMBER` | `MUDTITLE`
`RUNDESC` | `LAB`
`EXPTNUMBER` | `MUDAREA`
`ELAPSEDSEC` | `METHOD`
`TIMEBEGIN` | `APPARATUS`
`TIMEEND` | `INSERT`
| `SAMPLE`
| `ORIENT`
| `DAS`
| `EXPERIMENTER`
| `TEMPERATURE`
| `FIELD`

Histograms

scalars | vectors | matrices | strings
`HISTNUM` | `NUMBINS` | `IH` | `HISTTITLE`
| `HISTSTART` |  |
| `HISTEND` |  |
| `HISTTYPE` |  |
| `HISTNUMBYTES` |  |
| `HISTBYTESPERBIN` |  |
| `HISTFSPERBIN` |  |
| `HISTT0_PS` |  |
| `HISTT0_BIN` |  |
| `HISTGOODBIN1` |  |
| `HISTGOODBIN2` |  |
| `HISTBKGD1` |  |
| `HISTBKGD2` |  |
| `NUMEVENTS` |  |

`HISTFSPERBIN` returns femtoseconds-per-bin:

if | TimeCode < 16 | then `HISTFSPERBIN` = 78125*2^TimeCode
if 16 ≤ | TimeCode < 32 | then `HISTFSPERBIN` = 48828.125*2^(TimeCode-16)
|  | otherwise `HISTFSPERBIN` = TimeCode

Scalers

scalars | vectors | strings
`NUMSCALERS` | `SCALERCOUNTS` | `SCALERLABEL`
`SCALERTYPE` |  |

If `NUMSCALERS` is zero, `SCALERTYPE`, `SCALERCOUNTS`, and `SCALERLABEL` will not be created.

Comments

scalars | vectors | strings
`COMMENTTYPE` | `COMMENTPREV` | `COMMENTAUTHOR`
`COMMENTNUM` | `COMMENTNEXT` | `COMMENTTITLE`
| `COMMENTTIME` | `COMMENTBODY`

Independent variables

scalars | vectors | strings
`INDVARTYPE` | `INDVARLOW` | `INDVARNAME`
| `INDVARHIGH` | `INDVARDESCRIPTION`
| `INDVARMEAN` | `INDVARUNITS`
| `INDVARSTDDEV` |
| `INDVARSKEWNESS` |

RESTORE command