[NeXus-tech] First draft of NeXus publication

[Pete Jemian]

Shall we discuss this at the next telco?

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>:
>
>> 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>
>>>> 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>
>> http://lists.nexusformat.org/mailman/listinfo/nexus-tech
>

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