[Nexus] Status of NAPI

[Pete Jemian]

Andy:

Created issue:
https://github.com/nexusformat/definitions/issues/413

Thanks for pointing this out.  I agree that the manual may appear to be 
inconsistent with regards to the NAPI, as well as a few other things 
(backend storage file format, coordinate system, method to identify the 
default data for plotting, just to name a few).

Are there some obvious locations that make this point.  Otherwise, my 
approach to editing and revising will be to start with a PDF version and 
search for terms such as "NAPI" or "how to access/read/write data".

Pete

On 6/21/2015 1:04 PM, Tobias Richter wrote:
> Hi Andy,
>
> The official policy just reflects the (perceived) requirements of the community. Your thoughts are correct NAPI is not recommended for new applications. And yes, the manual hasn’t been updated in all areas to reflect this. Please point us to the relevant sections you find unclear. Someone reading the texts with fresh eyes can really make a difference.
>
> Since we focus on HDF5 now, the NAPI backend abstraction (supporting XML and HDF4 in addition) isn’t needed for that. NAPI also provides nothing that would ensure files follow the standard and very little that would at least make conforming easier. So the only benefit is some slight simplification of the hdf5 interface, which denies some of the power of the underlying container format.
>
> That being said, NAPI is not disappearing any time soon, while people rely on it. We should drop support for unused bindings though.
>
> In my view in the long run, some reference application or tools would still be needed to be able to demonstrate interoperability.
>
> Regards,
>
> Tobias
>
>
>> On 21 Jun 2015, at 17:39, Andy Gotz <andy.gotz at esrf.fr> wrote:
>>
>> Hi Eugen + Nexus community.
>>
>> I have a naive question : what is the status of the NAPI? I thought it is being maintained only for legacy applications and that it is not recommended for new applications. But this is not clear from the manual. In some places the reader gets the impression the NAPI is the official API for accessing files conforming to Nexus. In other places the opposite is stated and the hdf5 API is considered as the right way to access files.
>>
>> What is the official policy on the NAPI?
>>
>> Andy
>> _______________________________________________
>> NeXus mailing list
>> NeXus at nexusformat.org
>> http://lists.nexusformat.org/mailman/listinfo/nexus
>
>
> _______________________________________________
> NeXus mailing list
> NeXus at nexusformat.org
> http://lists.nexusformat.org/mailman/listinfo/nexus
>

-- 
----------------------------------------------------------
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.
-----------------------------------------------------------