CINXE.COM

<!DOCTYPE html> <html class="client-nojs" lang="en" dir="ltr"> <head> <meta charset="UTF-8"/> <title>Matrix values - OpenStreetMap Wiki</title> <script>document.documentElement.className="client-js";RLCONF={"wgBreakFrames":false,"wgSeparatorTransformTable":["",""],"wgDigitTransformTable":["",""],"wgDefaultDateFormat":"dmy","wgMonthNames":["","January","February","March","April","May","June","July","August","September","October","November","December"],"wgRequestId":"28810a9678d9aafb0ed8f2ad","wgCSPNonce":false,"wgCanonicalNamespace":"","wgCanonicalSpecialPageName":false,"wgNamespaceNumber":0,"wgPageName":"Matrix_values","wgTitle":"Matrix values","wgCurRevisionId":2545897,"wgRevisionId":2545897,"wgArticleId":244130,"wgIsArticle":true,"wgIsRedirect":false,"wgAction":"view","wgUserName":null,"wgUserGroups":["*"],"wgCategories":["Proposals with \"Draft\" status sorted by newest edit"],"wgPageContentLanguage":"en","wgPageContentModel":"wikitext","wgRelevantPageName":"Matrix_values","wgRelevantArticleId":244130,"wgIsProbablyEditable":false,"wgRelevantPageIsProbablyEditable":false,"wgRestrictionEdit":[],"wgRestrictionMove":[], "wgMFDisplayWikibaseDescriptions":{"search":false,"nearby":false,"watchlist":false,"tagline":false},"wgVisualEditor":{"pageLanguageCode":"en","pageLanguageDir":"ltr","pageVariantFallbacks":"en"},"wgULSAcceptLanguageList":[],"wgULSCurrentAutonym":"English","wgVector2022PreviewPages":[],"wgEditSubmitButtonLabelPublish":false,"wgULSPosition":"personal","wgULSisCompactLinksEnabled":true};RLSTATE={"site.styles":"ready","user.styles":"ready","user":"ready","user.options":"loading","skins.vector.styles.legacy":"ready","ext.OsmWikibase-all":"ready","ext.visualEditor.desktopArticleTarget.noscript":"ready","ext.uls.pt":"ready","wikibase.client.init":"ready"};RLPAGEMODULES=["site","mediawiki.page.ready","mediawiki.toc","skins.vector.legacy.js","ext.visualEditor.desktopArticleTarget.init","ext.visualEditor.targetLoader","ext.gadget.taginfo","ext.gadget.dataitemlinks","ext.gadget.maps","ext.uls.compactlinks","ext.uls.interface"];</script> <script>(RLQ=window.RLQ||[]).push(function(){mw.loader.implement("user.options@12s5i",function($,jQuery,require,module){mw.user.tokens.set({"patrolToken":"+\\","watchToken":"+\\","csrfToken":"+\\"});});});</script> <link rel="stylesheet" href="/w/load.php?lang=en&modules=ext.OsmWikibase-all%7Cext.uls.pt%7Cext.visualEditor.desktopArticleTarget.noscript%7Cskins.vector.styles.legacy%7Cwikibase.client.init&only=styles&skin=vector"/> <script async="" src="/w/load.php?lang=en&modules=startup&only=scripts&raw=1&skin=vector"></script> <meta name="ResourceLoaderDynamicStyles" content=""/> <link rel="stylesheet" href="/w/load.php?lang=en&modules=site.styles&only=styles&skin=vector"/> <noscript><link rel="stylesheet" href="/w/load.php?lang=en&modules=noscript&only=styles&skin=vector"/></noscript> <meta name="generator" content="MediaWiki 1.39.10"/> <meta name="format-detection" content="telephone=no"/> <meta name="viewport" content="width=1000"/> <link rel="icon" href="/favicon.ico"/> <link rel="search" type="application/opensearchdescription+xml" href="/w/opensearch_desc.php" title="OpenStreetMap Wiki (en)"/> <link rel="EditURI" type="application/rsd+xml" href="//wiki.openstreetmap.org/w/api.php?action=rsd"/> <link rel="license" href="/wiki/Wiki_content_license"/> <link rel="alternate" type="application/atom+xml" title="OpenStreetMap Wiki Atom feed" href="/w/index.php?title=Special:RecentChanges&feed=atom"/> </head> <body class="mediawiki ltr sitedir-ltr mw-hide-empty-elt ns-0 ns-subject page-Matrix_values rootpage-Matrix_values skin-vector action-view skin-vector-legacy vector-feature-language-in-header-enabled vector-feature-language-in-main-page-header-disabled vector-feature-language-alert-in-sidebar-disabled vector-feature-sticky-header-disabled vector-feature-sticky-header-edit-disabled vector-feature-table-of-contents-disabled vector-feature-visual-enhancement-next-disabled"><div id="mw-page-base" class="noprint"></div> <div id="mw-head-base" class="noprint"></div> <div id="content" class="mw-body" role="main"> <a id="top"></a> <div id="siteNotice"></div> <div class="mw-indicators"> </div> <h1 id="firstHeading" class="firstHeading mw-first-heading"><span class="mw-page-title-main">Matrix values</span></h1> <div id="bodyContent" class="vector-body"> <div id="siteSub" class="noprint">From OpenStreetMap Wiki</div> <div id="contentSub"></div> <div id="contentSub2"></div> <div id="jump-to-nav"></div> <a class="mw-jump-link" href="#mw-head">Jump to navigation</a> <a class="mw-jump-link" href="#searchInput">Jump to search</a> <div id="mw-content-text" class="mw-body-content mw-content-ltr" lang="en" dir="ltr"><div class="mw-parser-output"><table class="vcard" dir="ltr" style="margin:2px 0;background:#EEE;border:1px solid #AAA;padding:5px"> <tbody><tr> <th colspan="2" style="border-bottom:1px solid #AAA;text-align:left;font-size:120%"> </th></tr> <tr> <th style="text-align:left"><a href="/wiki/Proposal_process#Proposal_status_overview_list" title="Proposal process">Proposal status</a>: </th> <td><a href="/wiki/Category:Proposals_with_%22Draft%22_status" title="Category:Proposals with "Draft" status">Draft</a> (<a href="/wiki/Category:Proposed_features_under_way" title="Category:Proposed features under way">under way</a>) </td></tr></tbody></table><p>[[Category:Proposals with "Draft" status|]][[Category:Proposed features under way|]] </p><p>Despite <a href="/wiki/One_feature,_one_OSM_element" title="One feature, one OSM element">One feature, one OSM element</a> principle, tagging some complex concepts or objects still matter when it comes about stacked objects on a single node or alongside a way. It may be useful to consider options to describe how it goes when situations can't be addressed with simpler scalar values in keys. <br />Matrix values intend to define a 2 dimension table as a text string put in a key value. It's not encouraged nor designed to extend it to keys names which can get <a href="/wiki/Namespaces" class="mw-redirect" title="Namespaces">Namespaces</a>. <br />Such table cells will contain values that refer to the key holding the matrix. Thus, different values in the table are still consistent as they should be all part of the same set of concepts a given key is intended for. </p><p>Work has been done to document highway lanes or complex arrangement of power lines on a single support. This page summarises and generalises conclusions and habits to help anyone that would use same tooling to solve another situation. <br />This article is about things like: <tt dir="ltr" class="mw-content-ltr" style="background:#EEF;font-size:1em;line-height:1.6"><bdi style="white-space:nowrap"><a href="/wiki/Key:line_attachment" title="Key:line attachment">line_attachment</a></bdi>=<bdi>2(suspension|pin|suspension)|(anchor)</bdi></tt> </p><p>This page is under construction, please don't mind some errors and its incompleteness. </p> <div id="toc" class="toc" role="navigation" aria-labelledby="mw-toc-heading"><input type="checkbox" role="button" id="toctogglecheckbox" class="toctogglecheckbox" style="display:none" /><div class="toctitle" lang="en" dir="ltr"><h2 id="mw-toc-heading">Contents</h2><span class="toctogglespan"><label class="toctogglelabel" for="toctogglecheckbox"></label></span></div> <ul> <li class="toclevel-1 tocsection-1"><a href="#Principles"><span class="tocnumber">1</span> <span class="toctext">Principles</span></a> <ul> <li class="toclevel-2 tocsection-2"><a href="#Restrictions"><span class="tocnumber">1.1</span> <span class="toctext">Restrictions</span></a></li> <li class="toclevel-2 tocsection-3"><a href="#Defining_a_table"><span class="tocnumber">1.2</span> <span class="toctext">Defining a table</span></a></li> <li class="toclevel-2 tocsection-4"><a href="#Factorise_rows"><span class="tocnumber">1.3</span> <span class="toctext">Factorise rows</span></a></li> </ul> </li> <li class="toclevel-1 tocsection-5"><a href="#Handling"><span class="tocnumber">2</span> <span class="toctext">Handling</span></a></li> <li class="toclevel-1 tocsection-6"><a href="#Use_cases"><span class="tocnumber">3</span> <span class="toctext">Use cases</span></a> <ul> <li class="toclevel-2 tocsection-7"><a href="#Highway_lanes"><span class="tocnumber">3.1</span> <span class="toctext">Highway lanes</span></a></li> <li class="toclevel-2 tocsection-8"><a href="#Power_supports"><span class="tocnumber">3.2</span> <span class="toctext">Power supports</span></a></li> <li class="toclevel-2 tocsection-9"><a href="#Telecom_antennas"><span class="tocnumber">3.3</span> <span class="toctext">Telecom antennas</span></a></li> </ul> </li> </ul> </div> <h2><span class="mw-headline" id="Principles">Principles</span></h2> <h3><span class="mw-headline" id="Restrictions">Restrictions</span></h3> <p>A matrix value is a really complex way of modelling information on objects that may be linked to external databases instead of populating OSM. <br />You should always wonder what is the exact need you satisfy when using them as to not clutter the database with non-geogra磨ical information and be sure this conforms to <a href="/wiki/Good_practice" title="Good practice">Good_practices</a>. <br />Matrix values allow to document things that couldn't with simple scalar values. They're not designed to merge objects or make the mapping more concise. It's still recommended to use scalar values with as many OSM feature as needed to produce the simpler tagging as possible. </p> <h3><span class="mw-headline" id="Defining_a_table">Defining a table</span></h3> <p>Defined table always depends on context the matrix is used in. <br />It is relative to a physical feature seen on ground and the key documentation should explicitly define how matrix values are used and what they mean. </p> <h3><span class="mw-headline" id="Factorise_rows">Factorise rows</span></h3> <p>Sometimes, it may be possible to merge equivalent rows in a single set of values by adding a positive multiplicating factor representing the amount of time the pattern is repeated on ground. <br />For instance, <tt dir="ltr" class="mw-content-ltr" style="background:#EEF;font-size:1em;line-height:1.6"><bdi style="white-space:nowrap"><a href="/wiki/Key:line_attachment" title="Key:line attachment">line_attachment</a></bdi>=<bdi>2(suspension|pin|suspension)|(anchor)</bdi></tt> is a simplified version of <tt dir="ltr" class="mw-content-ltr" style="background:#EEF;font-size:1em;line-height:1.6"><bdi style="white-space:nowrap"><a href="/wiki/Key:line_attachment" title="Key:line attachment">line_attachment</a></bdi>=<bdi>(suspension|pin|suspension)|(suspension|pin|suspension)|(anchor)</bdi></tt>. Both value could be used independently and will mean the same thing. </p> <h2><span class="mw-headline" id="Handling">Handling</span></h2> <h2><span class="mw-headline" id="Use_cases">Use cases</span></h2> <h3><span class="mw-headline" id="Highway_lanes">Highway lanes</span></h3> <p>See <a href="/wiki/Lanes" title="Lanes">corresponding article</a>. </p> <h3><span class="mw-headline" id="Power_supports">Power supports</span></h3> <h3><span class="mw-headline" id="Telecom_antennas">Telecom antennas</span></h3>    </div> <div class="printfooter" data-nosnippet="">Retrieved from "<a dir="ltr" href="https://wiki.openstreetmap.org/w/index.php?title=Matrix_values&oldid=2545897">https://wiki.openstreetmap.org/w/index.php?title=Matrix_values&oldid=2545897</a>"</div></div> <div id="catlinks" class="catlinks" data-mw="interface"><div id="mw-normal-catlinks" class="mw-normal-catlinks"><a href="/wiki/Special:Categories" title="Special:Categories">Category</a>: <ul><li><a href="/wiki/Category:Proposals_with_%22Draft%22_status_sorted_by_newest_edit" title="Category:Proposals with "Draft" status sorted by newest edit">Proposals with "Draft" status sorted by newest edit</a></li></ul></div></div> </div> </div> <div id="mw-navigation"> <h2>Navigation menu</h2> <div id="mw-head"> <nav id="p-personal" class="vector-menu mw-portlet mw-portlet-personal vector-user-menu-legacy" aria-labelledby="p-personal-label" role="navigation" > <h3 id="p-personal-label" class="vector-menu-heading " > <span class="vector-menu-heading-label">Personal tools</span> </h3> <div class="vector-menu-content"> <ul class="vector-menu-content-list"><li id="pt-uls" class="mw-list-item active"><a class="uls-trigger" href="#"><span>English</span></a></li><li id="pt-createaccount" class="mw-list-item"><a href="/w/index.php?title=Special:CreateAccount&returnto=Matrix+values" title="You are encouraged to create an account and log in; however, it is not mandatory"><span>Create account</span></a></li><li id="pt-login" class="mw-list-item"><a href="/w/index.php?title=Special:UserLogin&returnto=Matrix+values" title="You are encouraged to log in; however, it is not mandatory [o]" accesskey="o"><span>Log in</span></a></li></ul> </div> </nav> <div id="left-navigation"> <nav id="p-namespaces" class="vector-menu mw-portlet mw-portlet-namespaces vector-menu-tabs vector-menu-tabs-legacy" aria-labelledby="p-namespaces-label" role="navigation" > <h3 id="p-namespaces-label" class="vector-menu-heading " > <span class="vector-menu-heading-label">Namespaces</span> </h3> <div class="vector-menu-content"> <ul class="vector-menu-content-list"><li id="ca-nstab-main" class="selected mw-list-item"><a href="/wiki/Matrix_values" title="View the content page [c]" accesskey="c"><span>Page</span></a></li><li id="ca-talk" class="new mw-list-item"><a href="/w/index.php?title=Talk:Matrix_values&action=edit&redlink=1" rel="discussion" title="Discussion about the content page (page does not exist) [t]" accesskey="t"><span>Discussion</span></a></li></ul> </div> </nav> <nav id="p-variants" class="vector-menu mw-portlet mw-portlet-variants emptyPortlet vector-menu-dropdown" aria-labelledby="p-variants-label" role="navigation" > <input type="checkbox" id="p-variants-checkbox" role="button" aria-haspopup="true" data-event-name="ui.dropdown-p-variants" class="vector-menu-checkbox" aria-labelledby="p-variants-label" /> <label id="p-variants-label" aria-label="Change language variant" class="vector-menu-heading " > <span class="vector-menu-heading-label">English</span> </label> <div class="vector-menu-content"> <ul class="vector-menu-content-list"></ul> </div> </nav> </div> <div id="right-navigation"> <nav id="p-views" class="vector-menu mw-portlet mw-portlet-views vector-menu-tabs vector-menu-tabs-legacy" aria-labelledby="p-views-label" role="navigation" > <h3 id="p-views-label" class="vector-menu-heading " > <span class="vector-menu-heading-label">Views</span> </h3> <div class="vector-menu-content"> <ul class="vector-menu-content-list"><li id="ca-view" class="selected mw-list-item"><a href="/wiki/Matrix_values"><span>Read</span></a></li><li id="ca-viewsource" class="mw-list-item"><a href="/w/index.php?title=Matrix_values&action=edit" title="This page is protected.
You can view its source [e]" accesskey="e"><span>View source</span></a></li><li id="ca-history" class="mw-list-item"><a href="/w/index.php?title=Matrix_values&action=history" title="Past revisions of this page [h]" accesskey="h"><span>View history</span></a></li></ul> </div> </nav> <nav id="p-cactions" class="vector-menu mw-portlet mw-portlet-cactions emptyPortlet vector-menu-dropdown" aria-labelledby="p-cactions-label" role="navigation" title="More options" > <input type="checkbox" id="p-cactions-checkbox" role="button" aria-haspopup="true" data-event-name="ui.dropdown-p-cactions" class="vector-menu-checkbox" aria-labelledby="p-cactions-label" /> <label id="p-cactions-label" class="vector-menu-heading " > <span class="vector-menu-heading-label">More</span> </label> <div class="vector-menu-content"> <ul class="vector-menu-content-list"></ul> </div> </nav> <div id="p-search" role="search" class="vector-search-box-vue vector-search-box-show-thumbnail vector-search-box-auto-expand-width vector-search-box"> <div> <h3 > <label for="searchInput">Search</label> </h3> <form action="/w/index.php" id="searchform" class="vector-search-box-form"> <div id="simpleSearch" class="vector-search-box-inner" data-search-loc="header-navigation"> <input class="vector-search-box-input" type="search" name="search" placeholder="Search OpenStreetMap Wiki" aria-label="Search OpenStreetMap Wiki" autocapitalize="sentences" title="Search OpenStreetMap Wiki [f]" accesskey="f" id="searchInput" > <input type="hidden" name="title" value="Special:Search"> <input id="mw-searchButton" class="searchButton mw-fallbackSearchButton" type="submit" name="fulltext" title="Search the pages for this text" value="Search"> <input id="searchButton" class="searchButton" type="submit" name="go" title="Go to a page with this exact name if it exists" value="Go"> </div> </form> </div> </div> </div> </div> <div id="mw-panel"> <div id="p-logo" role="banner"> <a class="mw-wiki-logo" href="/wiki/Main_Page" title="Visit the main page"></a> </div> <nav id="p-site" class="vector-menu mw-portlet mw-portlet-site vector-menu-portal portal" aria-labelledby="p-site-label" role="navigation" > <h3 id="p-site-label" class="vector-menu-heading " > <span class="vector-menu-heading-label">Site</span> </h3> <div class="vector-menu-content"> <ul class="vector-menu-content-list"><li id="n-mainpage" class="mw-list-item"><a href="/wiki/Main_Page" title="Visit the main page [z]" accesskey="z"><span>Main Page</span></a></li><li id="n-osm-homepage" class="mw-list-item"><a href="https://www.openstreetmap.org/"><span>The map</span></a></li><li id="n-mapfeatures" class="mw-list-item"><a href="/wiki/Map_features"><span>Map Features</span></a></li><li id="n-contributors" class="mw-list-item"><a href="/wiki/Contributors"><span>Contributors</span></a></li><li id="n-help" class="mw-list-item"><a href="/wiki/Get_help" title="The place to find out"><span>Help</span></a></li><li id="n-blogs" class="mw-list-item"><a href="/wiki/OSM_Blogs"><span>Blogs</span></a></li><li id="n-Shop" class="mw-list-item"><a href="/wiki/Merchandise"><span>Shop</span></a></li><li id="n-sitesupport" class="mw-list-item"><a href="/wiki/Donations"><span>Donations</span></a></li><li id="n-talk-wiki" class="mw-list-item"><a href="/wiki/Talk:Wiki"><span>Wiki discussion</span></a></li><li id="n-recentchanges" class="mw-list-item"><a href="/wiki/Special:RecentChanges" title="A list of recent changes in the wiki [r]" accesskey="r"><span>Recent changes</span></a></li></ul> </div> </nav> <nav id="p-tb" class="vector-menu mw-portlet mw-portlet-tb vector-menu-portal portal" aria-labelledby="p-tb-label" role="navigation" > <h3 id="p-tb-label" class="vector-menu-heading " > <span class="vector-menu-heading-label">Tools</span> </h3> <div class="vector-menu-content"> <ul class="vector-menu-content-list"><li id="t-whatlinkshere" class="mw-list-item"><a href="/wiki/Special:WhatLinksHere/Matrix_values" title="A list of all wiki pages that link here [j]" accesskey="j"><span>What links here</span></a></li><li id="t-recentchangeslinked" class="mw-list-item"><a href="/wiki/Special:RecentChangesLinked/Matrix_values" rel="nofollow" title="Recent changes in pages linked from this page [k]" accesskey="k"><span>Related changes</span></a></li><li id="t-specialpages" class="mw-list-item"><a href="/wiki/Special:SpecialPages" title="A list of all special pages [q]" accesskey="q"><span>Special pages</span></a></li><li id="t-print" class="mw-list-item"><a href="javascript:print();" rel="alternate" title="Printable version of this page [p]" accesskey="p"><span>Printable version</span></a></li><li id="t-permalink" class="mw-list-item"><a href="/w/index.php?title=Matrix_values&oldid=2545897" title="Permanent link to this revision of this page"><span>Permanent link</span></a></li><li id="t-info" class="mw-list-item"><a href="/w/index.php?title=Matrix_values&action=info" title="More information about this page"><span>Page information</span></a></li><li id="t-cite" class="mw-list-item"><a href="/w/index.php?title=Special:CiteThisPage&page=Matrix_values&id=2545897&wpFormIdentifier=titleform" title="Information on how to cite this page"><span>Cite this page</span></a></li></ul> </div> </nav> <nav id="p-lang" class="vector-menu mw-portlet mw-portlet-lang vector-menu-portal portal" aria-labelledby="p-lang-label" role="navigation" > <h3 id="p-lang-label" class="vector-menu-heading " > <span class="vector-menu-heading-label">In other languages</span> </h3> <div class="vector-menu-content"> <ul class="vector-menu-content-list"></ul> <div class="after-portlet after-portlet-lang"><span class="wb-langlinks-add wb-langlinks-link"><a href="https://wiki.openstreetmap.org/wiki/Special:NewItem?site=wiki&page=Matrix+values" title="Add interlanguage links" class="wbc-editpage">Add links</a></span></div> </div> </nav> </div> </div> <footer id="footer" class="mw-footer" role="contentinfo" > <ul id="footer-info"> <li id="footer-info-lastmod"> This page was last edited on 22 June 2023, at 09:24.</li> <li id="footer-info-copyright">Content is available under <a href="/wiki/Wiki_content_license" title="Wiki content license">Creative Commons Attribution-ShareAlike 2.0 license</a> unless otherwise noted.</li> </ul> <ul id="footer-places"> <li id="footer-places-privacy"><a href="https://www.osmfoundation.org/wiki/Privacy_Policy">Privacy policy</a></li> <li id="footer-places-about"><a href="/wiki/About">About OpenStreetMap Wiki</a></li> <li id="footer-places-disclaimer"><a href="/wiki/Disclaimer">Disclaimers</a></li> <li id="footer-places-mobileview"><a href="//wiki.openstreetmap.org/w/index.php?title=Matrix_values&mobileaction=toggle_view_mobile" class="noprint stopMobileRedirectToggle">Mobile view</a></li> </ul> <ul id="footer-icons" class="noprint"> <li id="footer-copyrightico"><a href="https://creativecommons.org/licenses/by-sa/2.0/"><img src="/cc-wiki.png" alt="Creative Commons Attribution-ShareAlike 2.0 license" width="88" height="31" loading="lazy"/></a></li> <li id="footer-poweredbyico"><a href="https://www.mediawiki.org/"><img src="/w/resources/assets/poweredby_mediawiki_88x31.png" alt="Powered by MediaWiki" srcset="/w/resources/assets/poweredby_mediawiki_132x47.png 1.5x, /w/resources/assets/poweredby_mediawiki_176x62.png 2x" width="88" height="31" loading="lazy"/></a></li> </ul> </footer> <script>(RLQ=window.RLQ||[]).push(function(){mw.config.set({"wgPageParseReport":{"limitreport":{"cputime":"0.060","walltime":"0.152","ppvisitednodes":{"value":263,"limit":1000000},"postexpandincludesize":{"value":2219,"limit":2097152},"templateargumentsize":{"value":71,"limit":2097152},"expansiondepth":{"value":8,"limit":100},"expensivefunctioncount":{"value":0,"limit":500},"unstrip-depth":{"value":0,"limit":20},"unstrip-size":{"value":1,"limit":5000000},"entityaccesscount":{"value":0,"limit":250},"timingprofile":["100.00% 135.917 1 -total"," 52.70% 71.630 1 Template:Proposal_Page"," 46.85% 63.677 3 Template:Tag"," 44.24% 60.135 1 Template:Langcode"," 1.80% 2.452 7 Template:Proposal_Status"," 1.66% 2.251 1 Template:Yesno"]},"scribunto":{"limitreport-timeusage":{"value":"0.080","limit":"15"},"limitreport-virtmemusage":{"value":6332416,"limit":52428800},"limitreport-estmemusage":0},"cachereport":{"timestamp":"20241128171445","ttl":86400,"transientcontent":false}}});mw.config.set({"wgBackendResponseTime":341});});</script> </body> </html>