<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
</head>
<body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">
Dear Georg,
<div class=""><br class="">
</div>
<div class=""><br class="">
<div>
<blockquote type="cite" class="">
<div class="">On 03 Aug 2016, at 14:48 , Ehlers, Georg <<a href="mailto:ehlersg@ornl.gov" class="">ehlersg@ornl.gov</a>> wrote:</div>
<br class="Apple-interchange-newline">
<div class="">
<div class="">I have installed McStas 2.3 on my desktop computer (Mac OSX 10.11.6).<br class="">
I have also browsed the two manuals provided, mcstas-2.3-manual.pdf and mcstas-2.3-components.pdf.<br class="">
<br class="">
Now I am wondering: The McStas homepage says that version 2.3 supports the mcpl binary event file format by Thomas Kittelmann (ESS). Where can I find more information? How would I use it? Where is the file format described? The manuals don’t say anything about
that. <br class="">
</div>
</div>
</blockquote>
<div><br class="">
</div>
This is true, it can be argued that the documentation is lacking in that respect, sorry about that!</div>
<div><br class="">
</div>
<div>The easiest way to use it is trying out the example instrument files provided with McStas 2.3, called Test_MCPL_output and Test_MCPL_input.</div>
<div>(Try mcdoc MCPL, this will give you a nice little HTML page with entries for both the instruments and the related components.)</div>
<div><br class="">
</div>
<div>If you want to look closer at the actual format and the code supporting it, the code should be in the libs/mcpl folder of your mcstas installation, i.e. /Applications/McStas-2.3.app/Contents/Resources/mcstas/2.3/libs/mcpl/ on your Mac.</div>
<div><br class="">
</div>
<div>We provide an example inputfile also that you may play with - sits in the same folder. Example output from mcpltool is shown at the bottom of this email.</div>
<div><br class="">
</div>
<div>Also, a few improvements were done to the MCPL support since McStas 2.3, so you might consider grabbing these bits and pieces from our GitHub? - See <a href="https://github.com/McStasMcXtrace/McCode/tree/master/common/lib/MCPL" class="">https://github.com/McStasMcXtrace/McCode/tree/master/common/lib/MCPL</a>,
corresponds to the above-mentioned folder.</div>
<div><br class="">
</div>
<div>
<blockquote type="cite" class="">
<div class="">
<div class="">Also, on page 18 (section “New features in McStas 2.3) the manual refers to the CHANGES document in “the relevant download folder at
<a href="http://download.mcstas.org/" class="">http://download.mcstas.org/</a>”. I do not see such a document anywhere. Am I just not looking in the right place?<br class="">
</div>
</div>
</blockquote>
</div>
<br class="">
</div>
<div class="">Oops my bad, never uploaded, now available at <a href="http://download.mcstas.org/mcstas-2.3/CHANGES" class="">http://download.mcstas.org/mcstas-2.3/CHANGES</a></div>
<div class=""><br class="">
</div>
<div class="">( It was on the other hand at the “other usual places” e.g. at <a href="http://www.mcstas.org/CHANGES_McStas" class="">http://www.mcstas.org/CHANGES_McStas</a> . :-) )</div>
<div class=""><br class="">
</div>
<div class=""><br class="">
</div>
<div class="">All the best and let us know if / when you find any issues. :-)</div>
<div class=""><br class="">
</div>
<div class="">Best,</div>
<div class=""><br class="">
</div>
<div class="">Peter</div>
<div class=""><br class="">
</div>
<div class="">——————</div>
<div class="">mcpltool example follows:</div>
<div class=""><br class="">
</div>
<div class=""><br class="">
</div>
<div class="">mcpltool /Applications/McStas-2.3.app/Contents/Resources/mcstas/2.3//libs/mcpl/voutput.mcpl <br class="">
Opened MCPL file voutput.mcpl:<br class="">
<br class="">
Basic info<br class="">
Format : MCPL-2<br class="">
No. of particles : 1000<br class="">
Header storage : 112 bytes<br class="">
Data storage : 88000 bytes<br class="">
<br class="">
Custom meta data<br class="">
Source : "McStas 2.3rc12 Test_MCPL_output"<br class="">
Number of comments : 1<br class="">
-> comment 0 : "Output by COMPONENT: vout"<br class="">
Number of blobs : 0<br class="">
<br class="">
Particle data format<br class="">
User flags : no<br class="">
Polarisation info : yes<br class="">
Fixed part. type : yes (pdgcode 2112)<br class="">
FP precision : double<br class="">
Endianness : little<br class="">
Storage : 88 bytes/particle<br class="">
<br class="">
index pdgcode ekin[MeV] x[cm] y[cm] z[cm] ux uy uz time[ms] weight pol-x pol-y pol-z<br class="">
0 2112 1.0832e-09 -0.47701 -0.13413 0 -0.015716 0.020314 0.99967 0.96593 4.1792e+07 0 0 0<br class="">
1 2112 2.1229e-09 0.34045 -0.24001 0 0.024156 0.022291 0.99946 0.29699 1.3696e+08 0 0 0<br class="">
2 2112 2.7277e-09 -0.3155 0.050996 0 0.010951 0.007016 0.99992 0.38107 1.9587e+08 0 0 0<br class="">
3 2112 7.1137e-10 -0.28054 0.23675 0 -0.030732 0.016651 0.99939 0.043826 1.757e+07 0 0 0<br class="">
4 2112 7.7e-10 -0.025928 0.081737 0 -0.029816 0.003234 0.99955 0.45319 2.0806e+07 0 0 0<br class="">
5 2112 1.0522e-08 -0.27707 0.25467 0 0.027865 0.020891 0.99939 0.036383 4.2633e+08 0 0 0<br class="">
6 2112 2.5521e-08 0.29884 0.21733 0 -0.030425 0.0051656 0.99952 0.7315 6.7203e+08 0 0 0<br class="">
7 2112 1.6412e-09 0.18957 -0.20358 0 0.031165 -0.024229 0.99922 0.073959 8.9998e+07 0 0 0<br class="">
8 2112 2.1494e-09 0.062953 -0.23881 0 -0.012252 0.003233 0.99992 0.6175 1.3983e+08 0 0 0<br class="">
9 2112 1.0317e-08 -0.14511 -0.029506 0 -0.0037271 -0.047437 0.99887 0.28321 4.2566e+08 0 0 0<br class="">
<br class="">
</div>
<br class="">
<br class="">
<div class=""><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: -webkit-auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; border-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-stroke-width: 0px;"><span><span style="color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px;">
<table border="0" cellspacing="0" cellpadding="0" width="400px" style="font-family: Arial; font-size: 8pt; color: black; border-collapse: collapse; border-spacing: 2px;" class="">
<tbody class="">
<tr class="">
<td width="400px" colspan="2" valign="top" style="font-weight: bold; font-size: 8pt; margin-bottom: 0px; font-family: Arial;" class="">
Peter Kjær Willendrup</td>
</tr>
<tr class="">
<td width="400px" colspan="2" valign="top" style="color: rgb(155, 155, 155); font-size: 8pt; margin-bottom: 0px; font-family: Arial;" class="">
Senior Research Engineer, Special Advisor</td>
</tr>
<tr class="">
<td width="400px" colspan="2" valign="top" style="font-size: 8pt; margin-bottom: 0px; font-family: Arial;" class="">
</td>
</tr>
<tr class="">
<td width="400px" colspan="2" valign="top" style="font-size: 8pt; margin-bottom: 0px; font-family: Arial; padding-bottom: 5px;" class="">
DTU Physics</td>
</tr>
</tbody>
</table>
</span><span style="color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px;"><span><span><span><span style="color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px;"><span><span><span><br class="Apple-interchange-newline">
<span><img height="1" width="400" apple-inline="yes" id="3F22E347-2299-48CE-A009-B448A2B44D3C" apple-width="yes" apple-height="yes" src="cid:image001.gif@01CCCAF1.5E6331F0" class=""></span><span class="Apple-style-span" style="border-collapse: separate; border-spacing: 0px;"><span class="Apple-style-span" style="color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: -webkit-auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; border-collapse: separate; border-spacing: 0px; -webkit-text-decorations-in-effect: none;"><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: -webkit-auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; border-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-stroke-width: 0px;"><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: -webkit-auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; border-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-stroke-width: 0px;"><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: -webkit-auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; border-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-stroke-width: 0px;"><span class="Apple-style-span" style="border-collapse: collapse; font-size: 15px;"><br class="Apple-interchange-newline">
<br class="">
</span></span></span></span><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: -webkit-auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; border-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-stroke-width: 0px;"><span class="Apple-style-span" style="border-collapse: collapse; font-family: Calibri, sans-serif; font-size: 15px;"><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: -webkit-auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; border-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-stroke-width: 0px;">
<table class="MsoNormalTable" border="0" cellspacing="0" cellpadding="0" width="400" style="width: 300pt; border-collapse: collapse; position: static; z-index: auto;">
<tbody class="">
<tr class="">
<td width="357" valign="top" style="width: 267.5pt; padding: 0cm;" class="">
<div style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class="">
<b class=""><span style="font-size: 8pt; font-family: Arial, sans-serif; color: black;" class="">Technical University of Denmark<o:p class=""></o:p></span></b></div>
</td>
<td width="43" rowspan="8" valign="top" style="width: 32.5pt; padding: 0cm;" class="">
<br class="">
</td>
</tr>
</tbody>
</table>
</span></span></span></span><span style="color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px;"><span><span><span><span style="color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px;"><span><span><span><br class="Apple-interchange-newline">
<span><img height="53" width="36" apple-inline="yes" id="CFA6F7E7-723C-410C-98DA-0AAFB277F619" apple-width="yes" apple-height="yes" src="cid:image002.gif@01CCCAF1.5E6331F0" class=""></span><span class="Apple-style-span" style="color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: -webkit-auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; border-spacing: 0px; -webkit-text-decorations-in-effect: none; border-collapse: separate;"><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: -webkit-auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; border-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-stroke-width: 0px;"><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: -webkit-auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; border-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-stroke-width: 0px;"><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: -webkit-auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; border-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-stroke-width: 0px;"><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: -webkit-auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; border-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-stroke-width: 0px;"><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: -webkit-auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; border-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-stroke-width: 0px;"><span class="Apple-style-span" style="border-collapse: collapse; font-family: Calibri, sans-serif;">
<div class=""><br class="Apple-interchange-newline">
<br class="">
</div>
</span></span></span></span></span></span></span><span class="Apple-style-span" style="color: rgb(0, 0, 0); font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; border-collapse: collapse; font-family: Calibri, sans-serif; font-size: 15px;">
<table class="MsoNormalTable" border="0" cellspacing="0" cellpadding="0" width="400" style="width: 300pt; border-collapse: collapse; position: static; z-index: auto;">
<tbody class="">
<tr class="">
<td width="400" colspan="2" valign="top" style="width: 300pt; padding: 0cm 0cm 3.75pt;" class="">
<div style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class="">
<span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: -webkit-auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; border-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-stroke-width: 0px;">
<table class="MsoNormalTable" border="0" cellspacing="0" cellpadding="0" width="400" style="width: 300pt; border-collapse: collapse; position: static; z-index: auto;">
<tbody class="">
<tr class="">
<td style="padding: 0cm;" class="">
<div style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class="">
<span style="font-size: 8pt; font-family: Arial, sans-serif; color: black;" class="">Department o</span><span style="font-size: 8pt; font-family: Arial, sans-serif; color: rgb(31, 73, 125);" class="">f</span><span style="font-size: 8pt; font-family: Arial, sans-serif; color: black;" class=""> Physics<o:p class=""></o:p></span></div>
<div style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class="">
<span style="font-size: 8pt; font-family: Arial, sans-serif; color: black;" class="">Fysikvej</span></div>
</td>
</tr>
<tr class="">
<td style="padding: 0cm;" class="">
<div style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class="">
<span style="font-size: 8pt; font-family: Arial, sans-serif; color: black;" class="">Building 307<o:p class=""></o:p></span></div>
</td>
</tr>
<tr class="">
<td style="padding: 0cm;" class="">
<div style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class="">
<span style="font-size: 8pt; font-family: Arial, sans-serif; color: black;" class="">DK-2800 Kongens Lyngby<o:p class=""></o:p></span></div>
</td>
</tr>
<tr class="">
<td style="padding: 0cm;" class="">
<div style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class="">
<span style="font-size: 8pt; font-family: Arial, sans-serif; color: black;" class="">Direct +45 2125 4612<o:p class=""></o:p></span></div>
</td>
</tr>
<tr class="">
<td style="padding: 0cm;" class="">
<div style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class="">
<span style="font-size: 8pt; font-family: Arial, sans-serif; color: black;" class="">Mobil +45 2125 4612<o:p class=""></o:p></span></div>
<div style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class="">
<span style="font-size: 8pt; font-family: Arial, sans-serif; color: black;" class="">Fax +45 4593 2399<o:p class=""></o:p></span></div>
</td>
</tr>
</tbody>
</table>
</span></div>
</td>
</tr>
</tbody>
</table>
</span><span class="Apple-style-span" style="color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: -webkit-auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; border-spacing: 0px; -webkit-text-decorations-in-effect: none; border-collapse: separate;"><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: -webkit-auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; border-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-stroke-width: 0px;"><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: -webkit-auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; border-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-stroke-width: 0px;"><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: -webkit-auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; border-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-stroke-width: 0px;"><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: -webkit-auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; border-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-stroke-width: 0px;"><span class="Apple-style-span" style="border-collapse: collapse;"><a href="mailto:pkwi@fysik.dtu.dk" class="">pkwi@fysik.dtu.dk</a></span></span></span></span></span></span>
</span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></div>
<br class="">
</body>
</html>