This separation of concerns is interesting. We should be able to style layers, but there is already a good format for that, as Tyler (I guess) remembered: SLD.<br><br>The idea of the repository and trying to output a simple roads theme is also good. Python is not my default language of choice, but I do have some fluency on it and I'm thrilled to help.<br>
<br>So, what about the specs? Lets start off with the simpler objects, like maps and map frames? I guess we could use some sort of UML or something near that to arrange all our ideas too. I'm not sure if everyone likes UML, but it helps me think and it's a great form of documenting. If anyone can suggest another, please do.<br>
<br>George<br><br><div class="gmail_quote">On Thu, Apr 8, 2010 at 6:24 PM, Landon Blake <span dir="ltr"><<a href="mailto:lblake@ksninc.com">lblake@ksninc.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
<div link="blue" vlink="blue" lang="EN-US">
<div>
<p class="MsoNormal"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">Looks like we’ve got a good start
with material posted by Carlos, Paul, and George. I would like to suggest the
following actions be taken in sequential order:</span></font></p>
<p class="MsoNormal"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;"> </span></font></p>
<p class="MsoNormal" style="margin-left: 0.5in;"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;"><span>(1)<font face="Times New Roman" size="1"><span style="font: 7pt "Times New Roman";"> </span></font></span></span></font><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">Decide if we will separate layout information (like page size, margins,
graphical components, inset map info) and styling information (label font,
label size, stroke color, fill patterns). I think this separation is a good
idea.</span></font></p>
<p class="MsoNormal" style="margin-left: 0.5in;"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;"><span>(2)<font face="Times New Roman" size="1"><span style="font: 7pt "Times New Roman";"> </span></font></span></span></font><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">Decide on a list of elements or items that we want to support for both
the layout and style components of the specification.</span></font></p>
<p class="MsoNormal" style="margin-left: 0.5in;"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;"><span>(3)<font face="Times New Roman" size="1"><span style="font: 7pt "Times New Roman";"> </span></font></span></span></font><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">Decide on a file format that will be consumed by map rendering
engines that support or spec. This could be XML, plain text, YAML or something
else. No need to have a flame war about the file format, we just need to pick
something.</span></font></p>
<p class="MsoNormal" style="margin-left: 0.5in;"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;"><span>(4)<font face="Times New Roman" size="1"><span style="font: 7pt "Times New Roman";"> </span></font></span></span></font><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">Start writing a draft specification document (maybe on the wiki)
and a sample input file based on the list of elements from step 2. Remember
that these two (2) documents are not the same thing.</span></font></p>
<p class="MsoNormal"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;"> </span></font></p>
<p class="MsoNormal"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">I’m not saying we can’t have
intense discussions about the details, but we’ve got some momentum and
the steps I listed above might help keep us moving.</span></font></p>
<p class="MsoNormal"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;"> </span></font></p>
<p class="MsoNormal"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">I’d also suggest that keeping the
spec and input file as simple as possible to begin with will be helpful. Let’s
“release early, release often” and add things to the spec as we go.
If we try to do everything at once we might bet overwhelmed. </span></font></p>
<p class="MsoNormal"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;"> </span></font></p>
<p class="MsoNormal"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">I think it might be helpful to have some
code that we can use to start processing our sample input file to produce some
type of output. Having some working prototype code will help us find problems
with the input file and spec early on in the process. I know that Tyler mentioned Python as
a possible choice. I can live with that. :] Can we throw together an SVN repo
somewhere that can hold code for the prototype we will use to test the input
file and spec?</span></font></p>
<p class="MsoNormal"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;"> </span></font></p>
<p class="MsoNormal"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">I’ll get an SVN repo for a Python
prototype set up if that has the groups support.</span></font></p>
<p class="MsoNormal"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;"> </span></font></p>
<p class="MsoNormal"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">I say we follow the steps above with the
following goals:</span></font></p>
<p class="MsoNormal"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;"> </span></font></p>
<p class="MsoNormal"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">Define a specification and input file that
defines the simplest possible map rendering information. When I say simple, I
mean the least amount of information. Let’s put together an input file
and some working Python code that could create a rendered map image (JPEG or
TIFF) from an ESRI Shapefile or WKT file containing some simple road
geometries. </span></font></p>
<p class="MsoNormal"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;"> </span></font></p>
<p class="MsoNormal"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">I think the leanest input file we can use
might be:</span></font></p>
<p class="MsoNormal" style="margin-left: 0.5in;"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;"><span>-<font face="Times New Roman" size="1"><span style="font: 7pt "Times New Roman";">
</span></font></span></span></font><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">Map
width and height.</span></font></p>
<p class="MsoNormal" style="margin-left: 0.5in;"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;"><span>-<font face="Times New Roman" size="1"><span style="font: 7pt "Times New Roman";">
</span></font></span></span></font><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">Scale of
the map.</span></font></p>
<p class="MsoNormal" style="margin-left: 0.5in;"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;"><span>-<font face="Times New Roman" size="1"><span style="font: 7pt "Times New Roman";">
</span></font></span></span></font><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">Stroke
color and line thickness of the vectors being rendered.</span></font></p>
<p class="MsoNormal" style="margin-left: 0.5in;"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;"><span>-<font face="Times New Roman" size="1"><span style="font: 7pt "Times New Roman";">
</span></font></span></span></font><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">Source
of the geospatial data being rendered.</span></font></p>
<p class="MsoNormal" style="margin-left: 0.5in;"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;"><span>-<font face="Times New Roman" size="1"><span style="font: 7pt "Times New Roman";">
</span></font></span></span></font><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">Destination
of the output file.</span></font></p>
<p class="MsoNormal"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;"> </span></font></p>
<p class="MsoNormal"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">We can start adding items to our input
file (like legends, map insets, girds, polygon fill styles, etc.) as we go.</span></font></p>
<p class="MsoNormal"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;"> </span></font></p>
<p class="MsoNormal"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">Not everyone is a fan of the agile
development style, and I might be moving too fast, but this is how I would move
us forward. Start bare bones, get something that works, and then add
functionality.</span></font></p>
<p class="MsoNormal"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;"> </span></font></p>
<div>
<p class="MsoNormal"><b><b><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">Landon</span></font></b></b><font color="navy"><span style="color: navy;"></span></font></p>
<p class="MsoNormal"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">Office Phone Number: (209) 946-0268</span></font><font color="navy"><span style="color: navy;"></span></font></p>
<p class="MsoNormal"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">Cell Phone Number: (209) 992-0658</span></font><font color="navy"><span style="color: navy;"></span></font></p>
<p class="MsoNormal"><font color="navy" face="Times New Roman" size="3"><span style="font-size: 12pt; color: navy;"> </span></font></p>
<p class="MsoNormal"><font color="navy" face="Times New Roman" size="3"><span style="font-size: 12pt; color: navy;"> </span></font></p>
</div>
<div>
<div class="MsoNormal" style="text-align: center;" align="center"><font face="Times New Roman" size="3"><span style="font-size: 12pt;">
<hr width="100%" align="center" size="2">
</span></font></div>
<p class="MsoNormal"><b><font face="Tahoma" size="2"><span style="font-size: 10pt; font-family: Tahoma; font-weight: bold;">From:</span></font></b><font face="Tahoma" size="2"><span style="font-size: 10pt; font-family: Tahoma;">
<a href="mailto:carto-bounces@lists.osgeo.org" target="_blank">carto-bounces@lists.osgeo.org</a> [mailto:<a href="mailto:carto-bounces@lists.osgeo.org" target="_blank">carto-bounces@lists.osgeo.org</a>] <b><span style="font-weight: bold;">On Behalf Of </span></b>Carlos Gabriel Asato<br>
<b><span style="font-weight: bold;">Sent:</span></b> Thursday, April 08, 2010
10:40 AM<br>
<b><span style="font-weight: bold;">To:</span></b> George Silva;
<a href="mailto:carto@lists.osgeo.org" target="_blank">carto@lists.osgeo.org</a><br>
<b><span style="font-weight: bold;">Subject:</span></b> Re: [Carto] Map
specifications</span></font></p>
</div>
<p class="MsoNormal"><font face="Times New Roman" size="3"><span style="font-size: 12pt;"> </span></font></p>
<div>
<div>
<p class="MsoNormal"><font face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial;">Dear all<br>
<br>
This is a map schema I am using for map production in my geological survey. It
works fine for maps composed of only one map frame. I made some modification
trying to adapt it for a map with multiple map frames. The original program
that use this scheme was made using Arc-Info AML (I have some ideas to port it
to the next ARCGIS Python). This scheme does not include metadata and is a good
idea to include it.<br>
<br>
The idea behind of this scheme is try to give flexibility on styles and data
source management and re-use. It works fine for model based cartography.<br>
<br>
<map><br>
<br>
<page name=anything><br>
<orientation>['v','h']</orientation> #if orientation is null
v is default<br>
<page_name>['a0','a1','a2'......]</page_name><br>
# if page name is not given then<br>
<page_size width='any number in cm' height='any number in cm'><br>
<br>
<margins up='any number' down=''any number' left='any number'
right='any number' units=[cm,inch,mm.....]><br>
<background_color>any_color</background_color><br>
<br>
<guideLine name=anything> # define guide lines or positions of
simetry for placing cartographic objects<br>
<xplace>middlepage</xplace><br>
<yplace units='cm'>margin.up - 10</yplace><br>
</guideLine><br>
<br>
<guidePoint name=anything><br>
<xplace units='mm'>30</xplace><br>
<yplace units='mm'>300</xplace><br>
</guidePoint><br>
<br>
<br>
<insets type=[text, image/jpg, image/svg, legend, document, ]
name=anything src=[file, http, dbconnector..]><br>
<insetParam
paramName=anything>value</insetParam><br>
<insetParam paramName=width
units=mm>25</insetParam><br>
<insetParam paramName=xposition
units=mm>30</insetParam># relative to page margins<br>
<insetParam paramName=relativeposition
>centerpage</insetParam># relative to page margins<br>
<insetParam paramName=xrelativeposition
>middlepage</insetParam># relative to page margins<br>
<insetParam paramName=xrelativeposition
>GuideLineDummy1</insetParam># relative to page margins<br>
<insetParam paramName=origin >0 0</insetParam><br>
<insetParam paramName=origin >middle
middle</insetParam><br>
</insets><br>
</page><br>
<br>
<br>
<br>
<mapStructure name=anything><br>
<MapFrameDefID>...<br>
<MapDefStyleID>...<br>
<DataSourceCollectionID>...<br>
<GridStyleID><br>
</mapStructure><br>
<br>
<mapStructure name=anything2><br>
<MapFrameDefID>...<br>
<MapDefStyleID>...<br>
<DataSourceCollectionID>...<br>
<GridStyleID><br>
</mapStructure><br>
<br>
.....<br>
<br>
<MapFrame name=anything><br>
<br>
<box>xmin ymin xmax ymax</box><br>
<FrameStyle><br>
<boxStyle>......<br>
<backgroundstyle>..<br>
<ScaleStyle>......<br>
<insets type=[text, image/jpg, image/svg, legend, document, ]
name=anything src=[file,http; dbconnector]><br>
<insetParam paramName=anything>value</insetParam><br>
<insetParam paramName=width
units=mm>25</insetParam><br>
<insetParam paramName=xposition
units=mm>30</insetParam># relative to frame<br>
<insetParam paramName=relativeposition
>centerframe</insetParam> # relative to frame<br>
<insetParam paramName=xrelativeposition
>middleframe</insetParam># relative to frame<br>
<insetParam paramName=origin >0 0</insetParam><br>
<insetParam paramName=origin >middle
middle</insetParam><br>
.....<br>
......<br>
</insets><br>
<br>
<br>
</FrameStyle><br>
</MapFrame><br>
<br>
<br>
<mapDef name=anything><br>
<scale>[any number, automatic]<br>
<mapSRS>EPSG:22634 .......# if no EPSG code is given other tags of forms
(may proj4 declaration) can be used for srs definition<br>
<mapExtend>['absolute defined by geographic or planar coordinate',
'relative defined by a boundary of an object']</mapExtend><br>
<mapAngle>.........<br>
<br>
<br>
</mapDef name=anything></span></font></p>
<div>
<p class="MsoNormal" style="margin-bottom: 12pt;"><font face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial;"> <br>
<br>
<DataSourceCollection name=anything><br>
<layer name='mustBeUnique'>....... </layer> #can be
file, url, etc, etc<br>
<layer name='mustBeUnique'>.......</layer><br>
<layer name='mustBeUnique'>.......</layer><br>
<layer name='mustBeUnique'>.......</layer><br>
</DataSourceCollection><br>
<br>
#For this sections is much better use SLD standard????<br>
<LayerRepresentation><br>
<layerDisplay><br>
layerName objectType pallete symbol LUT SelectionParameters<br>
<br>
</LayerRepresentation><br>
<br>
<br>
<GridDef><br>
<BoundaryDef>[box(xmin,ymin,xmax,ymax), "a geographic
object", "a polygon in WKT",......]<br>
<BoundarySRS> EPSG:<br>
<BoundaryStyle>palette, color, etc..<br>
<br>
<grid name=geo><br>
<gridSRS> EPSG:<br>
<gridStyle type=[grid, marks,...]
>palette, color, xinterval, yinterval, labelingStyle,
marksymbol,linesymbol.......<br>
<LabelingStyle>font, size, color,
orientation, template, offset<br>
</grid><br>
<grid name=planar><br>
<gridSRS> EPSG:<br>
<gridStyle type=[grid, marks,...]
>palette, color, xinterval, yinterval, labelingStyle.......<br>
<LabelingStyle>font, size, color,
orientation, template, gridOffset<br>
</grid><br>
<br>
<GridDef><br>
<br>
</Map><br>
<br>
I hope no forget anything!!!.<br>
<br>
Please make the comments you think appropiate<br>
<br>
Regards</span></font></p>
</div>
<p class="MsoNormal" style="margin-bottom: 12pt;"><font face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial;">Gabriel Asato<br>
Unidad Sensores Remotos y SIG<br>
Servicio Geológico Minero Argentino<br>
(SEGEMAR)<br>
Av. Julio A. Roca 651 p 8 of 1<br>
Cdad. Autónoma de Buenos Aires<br>
ARGENTINA</span></font></p>
<div>
<p class="MsoNormal"><font face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial;">tel 54-11-4349-3158/26<br>
fax 54-11-4349-3287</span></font></p>
<div>
<p class="MsoNormal"><font face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial;"> </span></font></p>
</div>
<div>
<p class="MsoNormal"><font face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial;"> </span></font></p>
<div>
<div class="MsoNormal" style="text-align: center;" align="center"><font face="Tahoma" size="2"><span style="font-size: 10pt; font-family: Tahoma;">
<hr width="100%" align="center" size="1">
</span></font></div>
<p class="MsoNormal"><b><font face="Tahoma" size="2"><span style="font-size: 10pt; font-family: Tahoma; font-weight: bold;">De:</span></font></b><font face="Tahoma" size="2"><span style="font-size: 10pt; font-family: Tahoma;"> George Silva
<<a href="mailto:georger.silva@gmail.com" target="_blank">georger.silva@gmail.com</a>><br>
<b><span style="font-weight: bold;">Para</span></b><b><span style="font-weight: bold;">:</span></b> <a href="mailto:carto@lists.osgeo.org" target="_blank">carto@lists.osgeo.org</a><br>
<b><span style="font-weight: bold;">Enviado:</span></b> miércoles, 7 de abril,
2010 22:26:48<br>
<b><span style="font-weight: bold;">Asunto:</span></b> [Carto] Map specifications<br>
</span></font><br>
Hello everyone,<br>
<br>
I would like to try to get the ball rolling, so I thought to start simple. I'm
not familiar with Mapnik also, so please bear with me.<br>
<br>
What are the components of a map document (this are just informal ideas, give
your opinion about them :P)<br>
<br>
"Map Metadata"<br>
Author<br>
Date/time<br>
Subject<br>
Description<br>
<br>
Size (width x height)<br>
Graphics (north arrow, title, other pictures, etc)<br>
Ordered set of "views" (I'm calling a view what would be a map inset,
a map inside another map)<br>
<br>
Each "view" should have:<br>
<br>
Size of map-inset<br>
Extent<br>
Scale<br>
Projection (datasets have projections, but they
can be represented in a different projection)<br>
Ordered set of Layers<br>
[Coordinate grid] (each of these should be
graphic? should these be tied up to each "view" or they are
independent map graphics?)<br>
[Scale Bar]<br>
[Scale Text]<br>
[Legend]<br>
other elements I'm missing?<br>
<br>
Since XML was mentioned by Tyler,
I tried a top-bottom approach.<br clear="all">
<br>
Any ideas about these?<br>
<br>
Thank you for your patiente :P<br>
<br>
George<br clear="all">
<br>
-- <br>
George R. C. Silva<br>
<br>
Desenvolvimento em GIS<br>
<a href="http://blog.geoprocessamento.net" target="_blank">http://blog.geoprocessamento.net</a></p>
</div>
</div>
</div>
</div>
</div>
<p class="MsoNormal"><font face="Times New Roman" size="3"><span style="font-size: 12pt;"><br>
</span></font></p>
</div>
<br><br><p><font face="Arial"><font size="1"><b>Warning:<br></b>Information provided via electronic media is not guaranteed against defects including translation and transmission errors. </font></font><font face="Arial"><font size="1">If the reader is not the intended recipient, you are hereby notified that any dissemination, distribution or copying of this communication is strictly prohibited. If you have received this information in error, please notify the sender immediately.</font></font></p>
</div>
<br>_______________________________________________<br>
Carto mailing list<br>
<a href="mailto:Carto@lists.osgeo.org">Carto@lists.osgeo.org</a><br>
<a href="http://lists.osgeo.org/mailman/listinfo/carto" target="_blank">http://lists.osgeo.org/mailman/listinfo/carto</a><br>
<br></blockquote></div><br><br clear="all"><br>-- <br>George R. C. Silva<br><br>Desenvolvimento em GIS<br><a href="http://blog.geoprocessamento.net">http://blog.geoprocessamento.net</a><br>