[NeXus-tech] First draft of NeXus publication

Wed Jul 23 16:26:21 BST 2014

I’ve pushed a (mildly adapted) Makefile for latex projects and it seems to work fine here.

Tobias

From: NeXus-tech [mailto:nexus-tech-bounces at nexusformat.org] On Behalf Of Mark Könnecke
Sent: 23 July 2014 16:03
To: NeXus Technical sub-committee list
Subject: Re: [NeXus-tech] First draft of NeXus publication

Pete,

the requested rebuild. It is a bit involved:

latex nexus14aip
bibtext nexus14aip
latex nexus14aip
pdflatex nexus14aip

This is to get the references right.

Cheers,

     Mark

Am 23.07.2014 um 13:54 schrieb Pete Jemian <prjemian at gmail.com<mailto:prjemian at gmail.com>>:

Mark

Yes.  It is time to request that input.  I added a table yesterday that shows how multiple method instruments are presented.  Can you rebuild the pdf?  Verify that the \ref{} items are rendered properly.  For me, they looked of and I could not understand why that was happening.

Pete
On Jul 23, 2014 5:04 AM, "Mark Könnecke" <mark.koennecke at psi.ch<mailto:mark.koennecke at psi.ch>> wrote:
Pete,

Am 22.07.2014 um 20:29 schrieb Pete Jemian <jemian at anl.gov<mailto:jemian at anl.gov>>:

Shall we discuss this at the next telco?

yes, we should, I forgot yesterday. Shall we seek input from the wider committte before that?

Mark

On 7/17/2014 4:22 AM, Mark Könnecke wrote:

Hi all,

I attached a new version with the comments from Pete, Herbert and Tobias
merged in. I also fixed the tables
and built a complete authors list with the tools provided by revtex. As
Tobias suggested, the source for the
paper are now on github, in the nexus_definitions/ csipaper directory.
Including the correct bibtex file.
Sorry, Pete.

Regards,

     Mark

Am 15.07.2014 um 13:24 schrieb Tobias.Richter at diamond.ac.uk<mailto:Tobias.Richter at diamond.ac.uk>
<mailto:Tobias.Richter at diamond.ac.uk>:

Hi all,

I've made a few modifications to Pete's version.
Why don't we put that file into the definitions repo on github?

There are two more comments I could not address easily:

Scans:
I really think unrolling scans to 1D is a poor idea and multiple
dimensions are legal.

Changed to reflect MD scans as currently described in the manual.

But it also says you can discover what was scanned against what from
the NXdata group. How does that work?

You open the NXdata group of a scan and see:

   data[NP,xdim,ydim]
   rotation_angle[NP]
   polar_angle[NP]
  monitor1[NP]

and can deduce that rotation_angle and polar_angle were either varied or
logged during the
scan together with data collected on an area detector and a monitor.

Application definitions:
"data in a NeXus file is accessed by path"
This is may be the intention of 60% of the people 60% of the time. The
other 64% of the time this is wrong.

This results in 124% ? I changed this search for data.

Regards,

     Mark

If you can only have a single NXentry named "entry" there is no point
in having an entry in the first place. We have to allow more than a
single detector named "detector" and we need to encourage people
writing software that is supposed to read NeXus files to look around
for groups by type.

Regards,

Tobias

-----Original Message-----
From: NeXus-tech [mailto:nexus-tech-bounces at nexusformat.org] On Behalf
Of Pete Jemian
Sent: 14 July 2014 21:45
To: NeXus Technical sub-committee list
Subject: Re: [NeXus-tech] First draft of NeXus publication

Mark:

Nice job.

Enclosed are my revisions.  Various spelling was changed and some other
changes.  Nothing very big.  Without the bibliography file, it was not
possible to build the complete PDF.  However, these changes compile by
latex (revtex) with no build errors.

Another URL citation for canSAS was added since that work is ongoing
and near completion as well.

The table organization that you present is most valuable.  This content
is now missing in the manual and not easy to deduce with such a
presentation.  Once you are settled on the design, I plan to put it
into the Design section at a "good" location.  (Suggestions are
welcome.)

Regards,
  Pete

On 7/14/2014 2:36 AM, Mark Könnecke wrote:

Hi,

here is a first draft of a new publication on NeXus intended for
Reviews in Scientific Instrumentation (RSI).

There are still two things wrong with this draft:

- The proper attribution of NIAC. I have contacted the AIP helpline
about how they want to have that done.

- The lines in the tables are incorrect. I will fix this once we are
sure that this is the representation we

 want.

I think we can start discussing the content based on this draft.

When we are done with this I will ask an american colleague to
proofread this. The journal wants american english which I find a
challenge.

I included the text source files for people who wish to edit
themselves. But the revtex package is required to compile the latex.

Best Regards,

 Mark

_______________________________________________
NeXus-tech mailing list
NeXus-tech at nexusformat.org<mailto:NeXus-tech at nexusformat.org> <mailto:NeXus-tech at nexusformat.org>
http://lists.nexusformat.org/mailman/listinfo/nexus-tech

--

This e-mail and any attachments may contain confidential, copyright
and or privileged material, and are for the use of the intended
addressee only. If you are not the intended addressee or an authorised
recipient of the addressee please notify us of receipt by returning
the e-mail and do not use, copy, retain, distribute or disclose the
information in or attached to the e-mail.

Any opinions expressed within this e-mail are those of the individual
and not necessarily of Diamond Light Source Ltd.

Diamond Light Source Ltd. cannot guarantee that this e-mail or any
attachments are free from viruses and we cannot accept liability for
any damage which you may sustain as a result of software viruses which
may be transmitted in or with the message.

Diamond Light Source Limited (company no. 4375679). Registered in
England and Wales with its registered office at Diamond House, Harwell
Science and Innovation Campus, Didcot, Oxfordshire, OX11 0DE, United
Kingdom

<nexus14aip.tex>_______________________________________________
NeXus-tech mailing list
NeXus-tech at nexusformat.org<mailto:NeXus-tech at nexusformat.org> <mailto:NeXus-tech at nexusformat.org>
http://lists.nexusformat.org/mailman/listinfo/nexus-tech

--
----------------------------------------------------------
Pete R. Jemian, Ph.D.                <jemian at anl.gov<mailto:jemian at anl.gov>>
Beam line Controls and Data Acquisition, Group Leader
Advanced Photon Source,   Argonne National Laboratory
Argonne, IL  60439                   630 - 252 - 3189<tel:630%20-%20252%20-%203189>
-----------------------------------------------------------
  Education is the one thing for which people
     are willing to pay yet not receive.
-----------------------------------------------------------

_______________________________________________
NeXus-tech mailing list
NeXus-tech at nexusformat.org<mailto:NeXus-tech at nexusformat.org>
http://lists.nexusformat.org/mailman/listinfo/nexus-tech

_______________________________________________
NeXus-tech mailing list
NeXus-tech at nexusformat.org<mailto:NeXus-tech at nexusformat.org>
http://lists.nexusformat.org/mailman/listinfo/nexus-tech
_______________________________________________
NeXus-tech mailing list
NeXus-tech at nexusformat.org<mailto:NeXus-tech at nexusformat.org>
http://lists.nexusformat.org/mailman/listinfo/nexus-tech

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.nexusformat.org/mailman/private/nexus-tech/attachments/20140723/3cc4e0ac/attachment-0001.html>