View source for Benchmarking 2010/How to get some sample data

== How to download sample data ==

The datasets will require some time to be merged and prepared, and the simbology still isn't fully decided on. In the meantime, you can download some sample data by following these steps:

* Go to http://centrodedescargas.cnig.es/CentroDescargas/index.jsp
: This is the website where the Spanish National Mapping Agency publishes some datasets


* On the top of the page, hit the [http://centrodedescargas.cnig.es/CentroDescargas/cambiarIdioma.do?lang=EN Welcome] link to enter the english version of the page


* [http://centrodedescargas.cnig.es/CentroDescargas/registro.do Register] for a new user. You'll need to enter the desired username, password, repeat password, full name and surname, email, and solve a captcha.


* Enter your account details to log in.


* Go to [http://centrodedescargas.cnig.es/CentroDescargas/buscadorCatalogo.do Advanced search]


* In the "products" drop-down menu, select either '''BCN25-BTN25''' for vector data, or '''Ortofoto PNOA Máxima Actualidad''' for aerial imagery.


* In the "MTN50 sheet number", enter any number between 1 and 1108.
: <span style='font-size:70%'>Barcelona is 420-421; Madrid is 559. You may want to check a [http://centrodedescargas.cnig.es/CentroDescargas/equipamiento/cuadricula_MTN50.png sheet reference] (caution: sheet reference is a 17MB image)</span>


* Hit "See list of products". Select a file to download. You will see the license for the data, which boils down to "''do not make any commercial use of this data''" and "''say that the data comes from the IGN''"


* You will see a survey. Hit "No enviar y continuar con descarga"


* Hit "Click here yo begin download"



== Raster data issues ==

Remember that the baseline of the OSGeo Benchmark for raster data are GeoTIFF files, but note you can only download ECW files. We will be converting the ECWs to GeoTIFFs.

There will be one big file for each one of the sheets in the following diagram. The area covers the whole [http://en.wikipedia.org/wiki/Catalonia Catalonia], which is about 32,114 km2 (12,399.3 sq mi):

[[image:cataluña_mtn50_sheets.png]]

== Vector data issues ==

Once unzipped, a sheet of vector data contains lots of shapefiles. The shapefiles will be merged, and most probably only the most interesting themes will be used.

Please note that the shapefiles are in ETRS89 + UTM28N/29N/30N/31N. The final shapefiles will be in WGS84, so you're encouraged to reproject them if you think it's neccesary for your testing.

A letter after the theme code explains what kind of geometry the shapefile contains. '''P''' stands for Point; '''L''' stands for Line; '''S''' stands for Surface (Polygon).

Only the following layers will be used:

{| border="1"
|-
| '''Code''' 
| '''Theme'''
| '''How should it be rendered'''
| '''Sample rendering'''
|-
|colspan=2 | '''Polygon'''
|-
| 0501S    ||   Settlement         || #C0C0C0 fill ;rendered under any other features

Optionally, use the field HABITANTES_501 to choose between 15 different fill images

|-
| 0507S    ||   Building           || 
 {| border="1"
 |-
 | SINGULARIDAD_507 = 01 || #FFACAC fill ||(normal building)
 |-
 | SINGULARIDAD_507 = 02 || #FF7878 fill ||(singular building - e.g. historic relevance)
 |}
 || [[Image:btn25_residential.png]]
|-
| 0513S    ||   Industry           || #DB71FF fill                          || [[Image:btn25_industrial.png]]
|-
|colspan=2 | '''Line'''
|-
| 0201L    ||   Contour lines  || 
 {| border="1"
 |-
 | CATEG_201 = 01 || 1px solid #E6B777 ||(normal contour line)
 |-
 | CATEG_201 = 02 || 1px solid #BF8F2E ||(master contour line)
 |-
 | CATEG_201 = 03 || do now draw       ||(auxiliary contour line) 
 |}
   || [[Image:btn25_cont.png]]
|-
| 0601L    ||   Motorway       ||
 {| border="1"
 |-
 | TIPO_601 = 01 || 4px yellow (#FFFF00) line, with 2px red (#FF0000) casing and 1px red (#FF0000) centerline  || (autopista / motorway)
 |-
 | TIPO_601 = 02 || 4px white (#FFFFFF) line, with 2px red (#FF0000) casing and 1px red (#FF0000) centerline  || (autovía / motorroad)
 |}
|rowspan=4| [[Image:btn25_roads.png]] [[Image:btn25_roads_legend.png]]
|-
| 0604L    ||   Road           || 3px orange, green or yellow line (depends on CFUN_0604 field) with 1px black casing
 {| border="1"
 |-
 | COMPETENCIA_604 = 01 || 3px red (#FF0000) line, with 1px black (#000000) casing || (carretera nacional / trunk road)
 |-
 | COMPETENCIA_604 != 01 and CATEGORIA_604 = 01 || 3px orange (#ffb501) line, with 1px black (#000000) casing || (carretera autonómica de 1er orden / primary road)
 |-
 | COMPETENCIA_604 != 01 and CATEGORIA_604 = 02 || 3px green (#00d700) line, with 1px black (#000000) casing || (carretera autonómica de 2º orden / secondary road)
 |-
 | COMPETENCIA_604 != 01 and CATEGORIA_604 = 03 || 3px yellow (#FFFF00) line, with 1px black (#000000) casing || (carretera autonómica de 3er orden / tertiary road)
 |}

|-
| 0607L    ||   Motorway/road link || 
 {| border="1"
 |-
 | TIPO_607 = 01 || Like autopistas (motorway), but half width
 |-
 | TIPO_607 = 02 || Like autovías (motorroad), but half width
 |-
 | TIPO_607 = 03 || Like carretera nacional (trunk road), but half width
 |-
 | TIPO_607 = 04 || Like carreteras de 1er nivel (primary roads), but half width
 |-
 | TIPO_607 = 05 || Like carreteras de 2º nivel (secondary roads), but half width
 |-
 | TIPO_607 = 06 || Like carreteras de 3er nivel (tertiary roads), but half width
 |}
|-
| 0610L    ||   Track         || 2px grey (#808080) line, 1px black (#000000) casing 
|-
|colspan=2 | '''Point'''
|-
| 0801P    ||   Toponym w/o geometry     || Label with field ETIQUETA; font size, weight and italics depending on field TIPO; maybe icon depending on TIPO           ||rowspan=2| [[Image:btn25_topo.png]]
|-
| 0802P    ||   Toponym w/ geometry      || Label with field ETIQUETA; font size, weight and italics depending on field TIPO; maybe icon depending on TIPO
|}

=== Rendering notes ===

This is by no means neccesary, but you might receive a penalty* if your rendering hits any of the following common pitfalls:
* Overlapping labels. Your software has text collision detection, hasn't it?
* Labels on linear features (e.g. river names) should follow the line geometry. Every letter tilted at the same angle = failure.
* Rendering any road casing on top of any road fill. 

[[image:paintersalgorithm.jpg]]

<span style='font-size:70%'>* The penalty is that Iván will '''not''' buy you a beer during FOSS4G. See, this is a friendly competition, but we can play rough :-P </span>

=== Ideal rendering ===

In an ideal world where money grows on trees and the streets are made out of candy, the development teams should have unlimited time to work on the map rendering.

Ideally, the rendering should be the same as the official topographic maps. You can download samples from the IGN (just follow the above instructions, but select '''MTN25RASTER''' instead of '''BCN25/BTN25''').

As you may see, the rendering rules can become very complex, and be non-intuitive at first. This is a performance benchmark, not a beauty one, so teams should focus on performance, and not pixel-to-pixel accuracy.

For reference, the legend of the topo map looks like this:

[[image:bcn25_btn25_legend.jpg|800px]]