[NeXus-tech] First draft of NeXus publication

[Herbert J. Bernstein]

Dear Mark and Pete,

  This is a very useful paper.    Here are a couple of wording suggestions:

1.  "The NeXus data format is dual purpose: NeXus
can be used as a container format to store as much data as possible
about a beamline.
Such use is actively encouraged. The other use case of NeXus is to
define verifiable
standards for the application of NeXus to a well defined experimental
technique. "

might read better as

"The NeXus data format has two purposes.  First, NeXus defines a
format that can serve as a container for all relevant data associated
with a beamline, an increasingly important function.  Second, NeXus
defines standards in the form of ``application definitions'' for the
representation of information defining various experimental
techniques."

2.  As a glocal change, I suggest changing ``as much data as possible
about'' to ``all relevant data associated with'' and in the first use
within the body of the text expanding to
``all relevant data (e.g. experimental set-up, environmental
parameters, positioner
settings, raw data and, if appropriate, processed data) associated with''

Regards,
    Herbert

On Mon, Jul 14, 2014 at 4:44 PM, Pete Jemian <prjemian at gmail.com> wrote:
>
> 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
>> http://lists.nexusformat.org/mailman/listinfo/nexus-tech
>>
>
> _______________________________________________
> NeXus-tech mailing list
> NeXus-tech at nexusformat.org
> http://lists.nexusformat.org/mailman/listinfo/nexus-tech
>