Geometry Boost List: Re: [geometry] [ggl] Upcoming changes in I/O formats structure

Subject: Re: [geometry] [ggl] Upcoming changes in I/O formats structure
From: Guillaume Carbonneau (guillaume.carbonneau_at_[hidden])
Date: 2012-05-01 11:52:41

This seems to include some of the support but does not support multi-*
http://svn.boost.org/svn/boost/trunk/boost/geometry/extensions/gis/io/wkb/  

Is there a branch that includes multi-* support?  

On Monday, April 30, 2012 at 10:50 PM, Guillaume Carbonneau wrote:

> Hello,  
>  
> I was wondering what was the status of this refactoring. I'd be interested in using the wkb reader/writer.
>  
> I'm looking here but I don't see it:
> http://svn.boost.org/svn/boost/trunk/boost/geometry/io/
>  
>  
> Thanks  
>  
> On Wednesday, December 7, 2011 at 2:45 PM, Mateusz Łoskot wrote:
>  
> > Folks,
> >  
> > Lately, I have discussed with Barend and Bruno proposal to change
> > structure of I/O formats. The motivation is to make it clear and simple,
> > but fairly well-structure at the same time.
> >  
> > I have applied necessary changes in my working copy and
> > I would like to commit it soon.
> > So, this message is a pre-commit announcement and warning.
> >  
> > Basically, changes I/O formats structure include:
> > 1) Get rid of domain or format standardisation body, so structure is flattened.
> > 2) Introduce some basic convention for naming files/folders per format layout.
> > 3) Separate I/O formats for simple geometries from multi-geometries
> >  
> > The new layout layout looks like this:
> >  
> > geometry/io/<FORMAT>/<FORMAT>.hpp (unsure, see note [1] below)
> > geometry/io/<FORMAT>/read.hpp
> > geometry/io/<FORMAT>/write.hpp
> > geometry/io/<FORMAT>/iomanip.hpp (see note [2])
> > geometry/io/<FORMAT>/detail/... (.hpp files with private
> > implementation details)
> >  
> > Note [1] Boost.Geometry stores all-in-one headers inside related
> > folder, for example
> > boost/geometry/geometries/geometries.hpp
> > but not at one level above:
> > boost/geometry/geometries.hpp
> > Most/many Boost libraries use the latter convention
> > So, I'm not sure if all-in-one headers for formats should be:
> > geometry/io/<FORMAT>/<FORMAT>.hpp
> > or
> > geometry/io/<FORMAT>.hpp
> > For now, I keep it geometry/io/<FORMAT>/<FORMAT>.hpp
> >  
> >  
> > Note [2] the iomanip.hpp used to be named stream_<FORMAT>.hpp.
> > If present, the stream_<FORMAT>.hpp defines stream manipulators for format.
> > I renamed it to iomanip.hpp to follow std naming of <iomanip> what is
> > more self-descriptive and exactly indicates purpose of the header.
> >  
> >  
> > Similar layout will be used for I/O for multi-geometries:
> > geometry/multi/io/<FORMAT>/...
> >  
> > Similar layout will be also used for I/O extensions:
> > boost/geometry/extensions/io/<FORMAT>/...
> > boost/geometry/extensions/multi/io/<FORMAT>/...
> >  
> >  
> > So, for example, the new structure will be:
> >  
> > boost/geometry/io/dsv/
> > boost/geometry/io/wkt
> > boost/geometry/multi/io/dsv//
> > boost/geometry/multi/io/wkt/
> >  
> > Finally, we have planned to move two formats from extensions to the
> > set of released formats:
> > - SVG
> > - WKT
> >  
> > The OGC WKT (Well-Known-Text) format is a simple and popular
> > GIS-derived format, however it has no GIS-specific
> > features built-in, so it is a perfect general purpose format for 2D
> > geometries (and soon 3D too).
> > The WKT format has complete implementation, so it is a mature piece of software.
> > We already use WKT format in tests, so it is a required piece of our kit.
> >  
> > The SVG is a popular format and it is extremely useful as it is the
> > only format so far which
> > we can use for visualisations of Boost.Geometry objects.
> >  
> > Next, I'm going to complete implementation of OGC WKB
> > (Well-Known-Binary) format and
> > move it to default set. The WKB format is a binary equivalent of WKT format
> >  
> > To summary, in near future I would like to have the following set of
> > formats released as built-in:
> >  
> > boost/geometry/io/dsv/
> > boost/geometry/io/svg/
> > boost/geometry/io/wkb/
> > boost/geometry/io/wkt/
> >  
> >  
> > If there are any objections or suggestions of improvements, please speak now.
> >  
> > Best regards,
> > --  
> > Mateusz Loskot, http://mateusz.loskot.net
> > Charter Member of OSGeo, http://osgeo.org
> > Member of ACCU, http://accu.org
> > _______________________________________________
> > ggl mailing list
> > ggl_at_[hidden] (mailto:ggl_at_[hidden])
> > http://lists.osgeo.org/mailman/listinfo/ggl
>