Multidataset: Difference between revisions

From Maria GDK Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
The multidataset XML (.m6mmultidataset.xml) is used to setup and describe similar type datasets. A dataset is typically produced from the same source data/format.
The multidataset XML (.m6mmultidataset.xml) is used to setup and describe similar type datasets. A dataset is typically produced from the same source data/format.


All entries in this file are treated as hints and may be overridden by the map renderer. Also, all "limits" refer to selected scalebase (nominal or actual) multiplied by nominalscalefactor. For "nominal", these do not usually match actual map scale.
All entries in this file are treated as hints and may be overridden by the map renderer.


All limits can be given as zoomlevels since Maria GDK 2.0. Use postfix "L" to parse limits as zoomlevel instead ofmapscale(f.ex. minvisible="15L" maxvisible="6L"). Mapscales will be converted to corresponding zoomlevels. Thinningtab and scalebase isobsolete since version 2.0.
All limits can be given as zoomlevels since Maria GDK 2.0. Use postfix "L" to parse limits as zoomlevel instead ofmapscale(f.ex. minvisible="15L" maxvisible="6L"). Mapscales will be converted to corresponding zoomlevels.


== Multidataset ==
== Multidataset ==
Line 26: Line 26:
   <groupsettingtemplates>
   <groupsettingtemplates>
     <groupsettingtemplate grouppattern="Arealdekke" geotype="area">
     <groupsettingtemplate grouppattern="Arealdekke" geotype="area">
       <groupsetting  drawpri="700" thinning="1.0">
       <groupsetting  drawpri="700">
         <limits maxvisible="10M"/>
         <limits maxvisible="10M"/>
       </groupsetting>
       </groupsetting>
Line 32: Line 32:


     <groupsettingtemplate grouppattern="Arealdekke" geotype="line">
     <groupsettingtemplate grouppattern="Arealdekke" geotype="line">
       <groupsetting  drawpri="400" thinning="1.0">
       <groupsetting  drawpri="400" >
         <limits maxvisible="10M"/>
         <limits maxvisible="10M"/>
       </groupsetting>
       </groupsetting>
Line 38: Line 38:


     <groupsettingtemplate grouppattern="Roads\Motorvei" geotype="line">
     <groupsettingtemplate grouppattern="Roads\Motorvei" geotype="line">
       <groupsetting  drawpri="290" thinning="1.0">
       <groupsetting  drawpri="290">
         <limits maxvisible="10M"/>
         <limits maxvisible="10M"/>
       </groupsetting>
       </groupsetting>
Line 44: Line 44:


     <groupsettingtemplate grouppattern="Buildings" geotype="line">
     <groupsettingtemplate grouppattern="Buildings" geotype="line">
       <groupsetting  drawpri="150" thinning="1.0">
       <groupsetting  drawpri="150">
         <limits maxvisible="10M"/>
         <limits maxvisible="10M"/>
       </groupsetting>
       </groupsetting>
Line 50: Line 50:


     <groupsettingtemplate grouppattern="Navn" geotype="point">
     <groupsettingtemplate grouppattern="Navn" geotype="point">
       <groupsetting drawpri="50" thinning="1.0">
       <groupsetting drawpri="50">
         <limits maxvisible="10M" />
         <limits maxvisible="10M" />
       </groupsetting>
       </groupsetting>
Line 70: Line 70:
| Global settings for multidataset.
| Global settings for multidataset.
| C
| C
|-
| [[#thinningtab|thinningtab]]
| Feature thinning table. '''Obsolete since Maria GDK 2.0.'''
| O C
|-
|-
| [[#groupsettingtemplates|groupsettingtemplates]]
| [[#groupsettingtemplates|groupsettingtemplates]]
Line 91: Line 87:
!width="15%"| '''Properties'''
!width="15%"| '''Properties'''
|-
|-
| multidatasetlimits
| [[#multidatasetlimits|multidatasetlimits]]
| Collection of scale limits that apply globally to this multidataset.
| Collection of scale limits that apply globally to this multidataset.
| O A
| O A
|-
|-
| scalebase
| [[#groupsetting|groupsetting]]
| Global map scale base. '''Obsolete since Maria GDK 2.0'''
| O A
|-
| nominalscalefactor
| Global scale factor.
| O A
|-
| cache
| Global map cache settings.
| O C
|-
| groupsetting
| Default groupsettings.
| Default groupsettings.
| O C A
| O C A
|-
|-
| resourcereferences
| [[#resourcereferences|resourcereferences]]
| Collection of style information hints to be used by the map renderer.
| Collection of style information hints to be used by the map renderer.
| A
| A
Line 122: Line 106:
===== Multidatasetlimits =====
===== Multidatasetlimits =====


Scale/level limits that apply gobally to this multidataset. See [[#limits|#limits]] for further information. Also used for setting overzoom parameter.
Scale/level limits that apply gobally to this multidataset. See [[#limits|limits]] for further information. Also used for setting overzoom parameter.


Overzoom is used for drawing maps on levels where no data exists. The number of levels specified by the overzoom parameter controls the number of levels the mapservice can search upwards in the maplevel tree for data to draw. The first level encountered to contain data will be used.
Overzoom is used for drawing maps on levels where no data exists. The number of levels specified by the overzoom parameter controls the number of levels the mapservice can search upwards in the maplevel tree for data to draw. The first level encountered to contain data will be used.
Line 135: Line 119:
| overzoom
| overzoom
| Number of levels. Default value is 0.
| Number of levels. Default value is 0.
| \
|  
|}
|}


Line 169: Line 153:
| drawpri
| drawpri
| Layer draw priority. Lower number equals higher priority. Default value is 100.
| Layer draw priority. Lower number equals higher priority. Default value is 100.
|
|-
| thinning
| Default value is -1.0. (No thinning)
|
|
|}
|}


===== Limits =====
===== Limits =====
All <code>limits</code> refer to selected <code>scalebase</code> (<code>nominal</code> or <code>actual</code>) multiplied by <code>nominalscalefactor</code>. For <code>nominal</code>, these do not usually match actual map scale.


{| class="wikitable"
{| class="wikitable"
Line 216: Line 194:
|}
|}


=== Thinningtab ===
==== Resourcereferences ====
 
{{Note|Thinning tabs may produce ugly artifacts and have no use for regular maps. Use with caution.}}
 
<source lang="xml">  <thinningtab active="true">
    <entry scale="1" accuracy="1.0"/>
    <entry scale="10k" accuracy="4.0"/>
    <entry scale="25k" accuracy="8.0"/>
    <entry scale="50k" accuracy="15.0"/>
    <entry scale="100k" accuracy="30.0"/>
    <entry scale="250k" accuracy="150.0"/>
    <entry scale="500k" accuracy="300.0"/>
    <entry scale="1M" accuracy="600.0"/>
    <entry scale="5M" accuracy="3000.0"/>
  </thinningtab></source>
{| class="wikitable"
! '''Child element'''
! '''Description'''
! '''Properties'''
|-
| [[#entry|entry]]
| Thinning table entry.
| A R
|}


{| class="wikitable"
{| class="wikitable"
Line 246: Line 201:
!width="15%"| '''Properties'''
!width="15%"| '''Properties'''
|-
|-
| active
| styleroot
| True if thinning table values should be used. Default value is false/inactive.
| Root folder for styling.
|
|-
| symbols
| Folder/name of symbols-xml. Location is relative to styleroot.
|
|-
| normal
| Folder/name of scriptcollection-xml. Location is relative to styleroot.
|
|
|}
==== Entry ====
{| class="wikitable"
! '''Attribute'''
! '''Description'''
! '''Properties'''
|-
|-
| scale
| simple
| Map scale threshold.
| Folder name of simple scriptcollection-xml. Location is relative to styleroot.
|
|
|-
|-
| accuracy
| featuregrouping
| Thinning accuracy value.
| Folder/name of featuregrouping-xml. Location is relative to styleroot.
|
|
|}
|}


==== Groupsettingtemplates ====
=== Groupsettingtemplates ===


{| class="wikitable"
{| class="wikitable"

Revision as of 09:32, 24 September 2019

The multidataset XML (.m6mmultidataset.xml) is used to setup and describe similar type datasets. A dataset is typically produced from the same source data/format.

All entries in this file are treated as hints and may be overridden by the map renderer.

All limits can be given as zoomlevels since Maria GDK 2.0. Use postfix "L" to parse limits as zoomlevel instead ofmapscale(f.ex. minvisible="15L" maxvisible="6L"). Mapscales will be converted to corresponding zoomlevels.

Multidataset

Example: 

<multidataset>
  <globalsettings>
    <multidatasetlimits minvisible="1K" maxvisible="1000000K" 
                        simplestyle="10000K" label="10M"/>
    <resourcereferences styleroot="m6msymbols" 
                        symbols="n5000\symbols.xml" 
                        normal="n5000\ScriptCollection.xml" 
                        simple="n5000\ScriptCollection.xml" 
                        featuregrouping="n5000\featuregrouping.xml"/>
    <groupsetting drawpri="300">
      <limits minvisible="1K" maxvisible="100000K" 
              simplestyle="10000K" label="10M"/>
    </groupsetting>
  </globalsettings>

  <groupsettingtemplates>
    <groupsettingtemplate grouppattern="Arealdekke" geotype="area">
      <groupsetting  drawpri="700">
        <limits maxvisible="10M"/>
      </groupsetting>
    </groupsettingtemplate> 

    <groupsettingtemplate grouppattern="Arealdekke" geotype="line">
      <groupsetting  drawpri="400" >
        <limits maxvisible="10M"/>
      </groupsetting>
    </groupsettingtemplate> 

    <groupsettingtemplate grouppattern="Roads\Motorvei" geotype="line">
      <groupsetting  drawpri="290">
        <limits maxvisible="10M"/>
      </groupsetting>
    </groupsettingtemplate>

    <groupsettingtemplate grouppattern="Buildings" geotype="line">
      <groupsetting  drawpri="150">
        <limits maxvisible="10M"/>
      </groupsetting>
    </groupsettingtemplate> 

    <groupsettingtemplate grouppattern="Navn" geotype="point">
      <groupsetting drawpri="50">
        <limits maxvisible="10M" />
      </groupsetting>
    </groupsettingtemplate>
  </groupsettingtemplates>  

  <add filepattern="N5000.m6mindex"/>
</multidataset>

<multidataset> is the root node of the multidataset-xml.

Child element Description Properties
Global settings for multidataset. C
Templates for group settings. O R C
Filters used to add data files. O R A

Globalsettings

Child element Description Properties
Collection of scale limits that apply globally to this multidataset. O A
Default groupsettings. O C A
Collection of style information hints to be used by the map renderer. A
datasetclipborder Dataset clip border setting. Used to prevent clipping of large point symbols at dataset borders. O A
Multidatasetlimits

Scale/level limits that apply gobally to this multidataset. See for further information. Also used for setting overzoom parameter.

Overzoom is used for drawing maps on levels where no data exists. The number of levels specified by the overzoom parameter controls the number of levels the mapservice can search upwards in the maplevel tree for data to draw. The first level encountered to contain data will be used.

Note: overzoom is implemented post version 2.0.1.

Attribute Description Properties
overzoom Number of levels. Default value is 0.

Example: 

<multidatasetlimits minvisible="0" maxvisible="256M" simplestyle="256M" label="10M" overzoom="4"/>

Groupsetting

Groupsettings under globalsettings act as a default template for the groupsettings listed in the groupsettingtemplate section of the xml.
Child element Description Properties
Collection of scale limits that apply globally to this multidataset. O A
Layer clip border setting. Used to prevent clipping of large point symbols at tile borders. O A
Attribute Description Properties
drawpri Layer draw priority. Lower number equals higher priority. Default value is 100.
Limits
Attribute Description Properties
minvisible Minimum scale for rendering layer. Use of scale factors (k/K/m/M) are allowed.
maxvisible Maximum scale for rendering layer. Use of scale factors (k/K/m/M) are allowed.
simplestyle Scale threshold (minimum scale) for showing simple style.
label Scale threshold (maximum scale) for showing label.
Clipborder
Clipborder is only used when drawing points.
Attribute Description Properties
value Clip border value in pixels.

Resourcereferences

Attribute Description Properties
styleroot Root folder for styling.
symbols Folder/name of symbols-xml. Location is relative to styleroot.
normal Folder/name of scriptcollection-xml. Location is relative to styleroot.
simple Folder name of simple scriptcollection-xml. Location is relative to styleroot.
featuregrouping Folder/name of featuregrouping-xml. Location is relative to styleroot.

Groupsettingtemplates

Child element Description Properties
Feature group settings template entry. R C A

Groupsettingtemplate

Child element Description Properties
Featuregroup settings. C A
Attribute Description Properties
grouppattern Featuregroup namepattern filter.
geotype Geotype in featuregroup. Valid values are point, line, area and unknown. Default value is unknown.
Groupsetting

See paragraph Groupsetting. Values in this groupsetting block overrides the values in the global groupsetting block.

Add

Attribute Description Properties
filepattern Filepattern filter. Used to select map data files (mainly .vtiles.sqlite). R
Retrieved from "http://docs.maria.teleplanglobe.com/index.php?title=Multidataset&oldid=2667"