org.apache.sis.referencing/org/apache/sis/referencing/CommonCRS.html - sis-site - Git at Google

 <!DOCTYPE HTML>
 <html lang="en">
 <head>
 <!-- Generated by javadoc (21) on Thu Oct 05 19:54:57 CEST 2023 -->
 <title>CommonCRS (Apache SIS 1.4 API)</title>
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <meta name="dc.created" content="2023-10-05">
 <meta name="description" content="declaration: module: org.apache.sis.referencing, package: org.apache.sis.referencing, enum: CommonCRS">
 <meta name="generator" content="javadoc/ClassWriterImpl">
 <meta name="keywords" content="org.apache.sis.referencing.CommonCRS class">
 <meta name="keywords" content="values()">
 <meta name="keywords" content="valueOf()">
 <meta name="keywords" content="forDatum()">
 <meta name="keywords" content="defaultGeographic()">
 <meta name="keywords" content="normalizedGeographic()">
 <meta name="keywords" content="geographic()">
 <meta name="keywords" content="geographic3D()">
 <meta name="keywords" content="geocentric()">
 <meta name="keywords" content="spherical()">
 <meta name="keywords" content="datum()">
 <meta name="keywords" content="ellipsoid()">
 <meta name="keywords" content="primeMeridian()">
 <meta name="keywords" content="universal()">
 <link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style">
 <link rel="stylesheet" type="text/css" href="../../../../../sis.css" title="Style">
 <link rel="stylesheet" type="text/css" href="../../../../../script-dir/jquery-ui.min.css" title="Style">
 <script type="text/javascript" src="../../../../../script.js"></script>
 <script type="text/javascript" src="../../../../../script-dir/jquery-3.6.1.min.js"></script>
 <script type="text/javascript" src="../../../../../script-dir/jquery-ui.min.js"></script>
 </head>
 <body class="class-declaration-page">
 <script type="text/javascript">var pathtoroot = "../../../../../";
 loadScripts(document, 'script');</script>
 <noscript>
 <div>JavaScript is disabled on your browser.</div>
 </noscript>
 <div class="flex-box">
 <header role="banner" class="flex-header">
 <nav role="navigation">
 <!-- ========= START OF TOP NAVBAR ======= -->
 <div class="top-nav" id="navbar-top"><button id="navbar-toggle-button" aria-controls="navbar-top" aria-expanded="false" aria-label="Toggle navigation links"><span class="nav-bar-toggle-icon">&nbsp;</span><span class="nav-bar-toggle-icon">&nbsp;</span><span class="nav-bar-toggle-icon">&nbsp;</span></button>
 <div class="skip-nav"><a href="#skip-navbar-top" title="Skip navigation links">Skip navigation links</a></div>
 <ul id="navbar-top-firstrow" class="nav-list" title="Navigation">
 <li><a href="../../../../../index.html">Overview</a></li>
 <li><a href="../../../../module-summary.html">Module</a></li>
 <li><a href="package-summary.html">Package</a></li>
 <li class="nav-bar-cell1-rev">Class</li>
 <li><a href="package-tree.html">Tree</a></li>
 <li><a href="../../../../../deprecated-list.html">Deprecated</a></li>
 <li><a href="../../../../../index-all.html">Index</a></li>
 <li><a href="../../../../../help-doc.html#class">Help</a></li>
 </ul>
 <ul class="sub-nav-list-small">
 <li>
 <p>Summary:</p>
 <ul>
 <li><a href="#nested-class-summary">Nested</a></li>
 <li><a href="#enum-constant-summary">Enum Constants</a></li>
 <li>Field</li>
 <li><a href="#method-summary">Method</a></li>
 </ul>
 </li>
 <li>
 <p>Detail:</p>
 <ul>
 <li><a href="#enum-constant-detail">Enum Constants</a></li>
 <li>Field</li>
 <li><a href="#method-detail">Method</a></li>
 </ul>
 </li>
 </ul>
 </div>
 <div class="sub-nav">
 <div id="navbar-sub-list">
 <ul class="sub-nav-list">
 <li>Summary:&nbsp;</li>
 <li><a href="#nested-class-summary">Nested</a>&nbsp;|&nbsp;</li>
 <li><a href="#enum-constant-summary">Enum Constants</a>&nbsp;|&nbsp;</li>
 <li>Field&nbsp;|&nbsp;</li>
 <li><a href="#method-summary">Method</a></li>
 </ul>
 <ul class="sub-nav-list">
 <li>Detail:&nbsp;</li>
 <li><a href="#enum-constant-detail">Enum Constants</a>&nbsp;|&nbsp;</li>
 <li>Field&nbsp;|&nbsp;</li>
 <li><a href="#method-detail">Method</a></li>
 </ul>
 </div>
 <div class="nav-list-search"><a href="../../../../../search.html">SEARCH</a>
 <input type="text" id="search-input" disabled placeholder="Search">
 <input type="reset" id="reset-button" disabled value="reset">
 </div>
 </div>
 <!-- ========= END OF TOP NAVBAR ========= -->
 <span class="skip-nav" id="skip-navbar-top"></span></nav>
 </header>
 <div class="flex-content">
 <main role="main">
 <!-- ======== START OF CLASS DATA ======== -->
 <div class="header">
 <div class="sub-title"><span class="module-label-in-type">Module</span>&nbsp;<a href="../../../../module-summary.html">org.apache.sis.referencing</a></div>
 <div class="sub-title"><span class="package-label-in-type">Package</span>&nbsp;<a href="package-summary.html">org.apache.sis.referencing</a></div>
 <h1 title="Enum Class CommonCRS" class="title">Enum Class CommonCRS</h1>
 </div>
 <div class="inheritance" title="Inheritance Tree"><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Object.html" title="class or interface in java.lang" class="external-link">Object</a>
 <div class="inheritance"><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Enum.html" title="class or interface in java.lang" class="external-link">Enum</a>&lt;<a href="CommonCRS.html" title="enum class in org.apache.sis.referencing">CommonCRS</a>&gt;
 <div class="inheritance">CommonCRS</div>
 </div>
 </div>
 <section class="class-description" id="class-description">
 <dl class="notes">
 <dt>All Implemented Interfaces:</dt>
 <dd><code><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/io/Serializable.html" title="class or interface in java.io" class="external-link">Serializable</a></code>, <code><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Comparable.html" title="class or interface in java.lang" class="external-link">Comparable</a>&lt;<a href="CommonCRS.html" title="enum class in org.apache.sis.referencing">CommonCRS</a>&gt;</code>, <code>Constable</code></dd>
 </dl>
 <hr>
 <div class="type-signature"><span class="modifiers">public enum </span><span class="element-name type-name-label">CommonCRS</span>
 <span class="extends-implements">extends <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Enum.html" title="class or interface in java.lang" class="external-link">Enum</a>&lt;<a href="CommonCRS.html" title="enum class in org.apache.sis.referencing">CommonCRS</a>&gt;</span></div>
 <div class="block">Frequently-used geodetic CRS and datum that are guaranteed to be available in SIS.
  Some (not all) objects defined in this enumeration are equivalent to objects defined
  in the EPSG geodetic dataset. In such case there is a choice:

  <ul class="verbose">
    <li>If the <a href="https://sis.apache.org/epsg.html">EPSG dataset is installed</a>, then the methods
        in this enumeration are effectively shortcuts for object definitions in the EPSG database.</li>
    <li>If there is no EPSG database available, or if the query failed, or if there is no EPSG definition
        for an object, then <code>CommonCRS</code> fallbacks on hard-coded values with minimal information.
        The <a href="AbstractIdentifiedObject.html#getIdentifiers()">identifier</a> associated to the returned
        object should be interpreted as "see that EPSG code for more complete definition".</li>
  </ul>

  Consequently, the methods in this enumeration never return <code>null</code>.
  The definitions used as fallbacks are available in public sources
  and do not include EPSG metadata except the identifier.
  If the EPSG geodetic dataset has been used, the <a href="ImmutableIdentifier.html#getAuthority()">authority</a> title
  will be something like <cite>"EPSG geodetic dataset"</cite>, otherwise it will be <cite>"Subset of EPSG"</cite>.

  <p>Referencing objects are cached after creation. Invoking the same method on the same <code>CommonCRS</code>
  instance twice will return the same <a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/IdentifiedObject.html" title="class or interface in org.opengis.referencing" class="external-link"><code>IdentifiedObject</code></a> instance, unless the internal cache has been cleared
  (e.g. the application is running in a container environment and some modules have been installed or uninstalled).</p>

  <h2 id="example-heading">Example</h2>
  The following code fetches a geographic Coordinate Reference System
  using (<var>longitude</var>, <var>latitude</var>) axis order on the <a href="#WGS84"><code>WGS84</code></a> geodetic datum:


 <div class="snippet-container"><button class="copy snippet-copy" aria-label="Copy snippet" onclick="copySnippet(this)"><span data-copied="Copied!">Copy</span><img src="../../../../../copy.svg" alt="Copy snippet"></button>
 <pre class="snippet"><code class="language-java">GeographicCRS crs = CommonCRS.WGS84.normalizedGeographic();
 </code></pre>
 </div>


  <h2 id="available-objects-heading">Available objects</h2>
  For each enumeration value, the name of the CRS, datum and ellipsoid objects may or may not be the same.
  Below is an alphabetical list of object names available in this enumeration:

  <blockquote><table class="sis">
    <caption>Geodetic objects accessible by enumeration constants</caption>
    <tr><th>Name or alias</th>                                     <th>Object type</th>           <th>Enumeration value</th></tr>
    <tr><td>Clarke 1866</td>                                       <td>Ellipsoid</td>             <td><a href="#NAD27"><code>NAD27</code></a></td></tr>
    <tr><td>European Datum 1950 (ED50)</td>                        <td>CRS, datum</td>            <td><a href="#ED50"><code>ED50</code></a></td></tr>
    <tr><td>European Terrestrial Reference System (ETRS) 1989</td> <td>CRS, datum</td>            <td><a href="#ETRS89"><code>ETRS89</code></a></td></tr>
    <tr><td>Greenwich</td>                                         <td>Prime meridian</td>        <td>Any enumeration value</td></tr>
    <tr><td>GRS 1980</td>                                          <td>Ellipsoid</td>             <td><a href="#GRS1980"><code>GRS1980</code></a>, <a href="#ETRS89"><code>ETRS89</code></a>, <a href="#NAD83"><code>NAD83</code></a></td></tr>
    <tr><td>GRS 1980 Authalic Sphere</td>                          <td>Ellipsoid</td>             <td><a href="#SPHERE"><code>SPHERE</code></a></td></tr>
    <tr><td>International 1924</td>                                <td>Ellipsoid</td>             <td><a href="#ED50"><code>ED50</code></a></td></tr>
    <tr><td>North American Datum 1927</td>                         <td>CRS, datum</td>            <td><a href="#NAD27"><code>NAD27</code></a></td></tr>
    <tr><td>North American Datum 1983</td>                         <td>CRS, datum</td>            <td><a href="#NAD83"><code>NAD83</code></a></td></tr>
    <tr><td>World Geodetic System (WGS) 1972</td>                  <td>CRS, datum, ellipsoid</td> <td><a href="#WGS72"><code>WGS72</code></a></td></tr>
    <tr><td>World Geodetic System (WGS) 1984</td>                  <td>CRS, datum, ellipsoid</td> <td><a href="#WGS84"><code>WGS84</code></a></td></tr>
  </table></blockquote></div>
 <dl class="notes">
 <dt>Since:</dt>
 <dd>0.4</dd>
 <dt>See Also:</dt>
 <dd>
 <ul class="tag-list">
 <li><a href="factory/CommonAuthorityFactory.html" title="class in org.apache.sis.referencing.factory"><code>CommonAuthorityFactory</code></a></li>
 </ul>
 </dd>
 </dl>
 </section>
 <section class="summary">
 <ul class="summary-list">
 <!-- ======== NESTED CLASS SUMMARY ======== -->
 <li>
 <section class="nested-class-summary" id="nested-class-summary">
 <h2>Nested Class Summary</h2>
 <div class="caption"><span>Nested Classes</span></div>
 <div class="summary-table three-column-summary">
 <div class="table-header col-first">Modifier and Type</div>
 <div class="table-header col-second">Class</div>
 <div class="table-header col-last">Description</div>
 <div class="col-first even-row-color"><code>static enum&nbsp;</code></div>
 <div class="col-second even-row-color"><code><a href="CommonCRS.Engineering.html" class="type-name-link" title="enum class in org.apache.sis.referencing">CommonCRS.Engineering</a></code></div>
 <div class="col-last even-row-color">
 <div class="block">Frequently-used engineering CRS and datum that are guaranteed to be available in SIS.</div>
 </div>
 <div class="col-first odd-row-color"><code>static enum&nbsp;</code></div>
 <div class="col-second odd-row-color"><code><a href="CommonCRS.Temporal.html" class="type-name-link" title="enum class in org.apache.sis.referencing">CommonCRS.Temporal</a></code></div>
 <div class="col-last odd-row-color">
 <div class="block">Frequently-used temporal CRS and datum that are guaranteed to be available in SIS.</div>
 </div>
 <div class="col-first even-row-color"><code>static enum&nbsp;</code></div>
 <div class="col-second even-row-color"><code><a href="CommonCRS.Vertical.html" class="type-name-link" title="enum class in org.apache.sis.referencing">CommonCRS.Vertical</a></code></div>
 <div class="col-last even-row-color">
 <div class="block">Frequently-used vertical CRS and datum that are guaranteed to be available in SIS.</div>
 </div>
 </div>
 <div class="inherited-list">
 <h2 id="nested-classes-inherited-from-class-java.lang.Enum">Nested classes/interfaces inherited from class&nbsp;<a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Enum.html" title="class or interface in java.lang" class="external-link">Enum</a></h2>
 <code><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Enum.EnumDesc.html" title="class or interface in java.lang" class="external-link">Enum.EnumDesc</a>&lt;<a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Enum.EnumDesc.html" title="class or interface in java.lang" class="external-link">E</a> extends <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Enum.html" title="class or interface in java.lang" class="external-link">Enum</a>&lt;<a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Enum.EnumDesc.html" title="class or interface in java.lang" class="external-link">E</a>&gt;&gt;</code></div>
 </section>
 </li>
 <!-- =========== ENUM CONSTANT SUMMARY =========== -->
 <li>
 <section class="constants-summary" id="enum-constant-summary">
 <h2>Enum Constant Summary</h2>
 <div class="caption"><span>Enum Constants</span></div>
 <div class="summary-table two-column-summary">
 <div class="table-header col-first">Enum Constant</div>
 <div class="table-header col-last">Description</div>
 <div class="col-first even-row-color"><code><a href="#ED50" class="member-name-link">ED50</a></code></div>
 <div class="col-last even-row-color">
 <div class="block">European Datum 1950 (ED50).</div>
 </div>
 <div class="col-first odd-row-color"><code><a href="#ETRS89" class="member-name-link">ETRS89</a></code></div>
 <div class="col-last odd-row-color">
 <div class="block">European Terrestrial Reference System 1989.</div>
 </div>
 <div class="col-first even-row-color"><code><a href="#GRS1980" class="member-name-link">GRS1980</a></code></div>
 <div class="col-last even-row-color">
 <div class="block">Unknown datum based upon the GRS 1980 ellipsoid.</div>
 </div>
 <div class="col-first odd-row-color"><code><a href="#NAD27" class="member-name-link">NAD27</a></code></div>
 <div class="col-last odd-row-color">
 <div class="block">North American Datum 1927.</div>
 </div>
 <div class="col-first even-row-color"><code><a href="#NAD83" class="member-name-link">NAD83</a></code></div>
 <div class="col-last even-row-color">
 <div class="block">North American Datum 1983.</div>
 </div>
 <div class="col-first odd-row-color"><code><a href="#SPHERE" class="member-name-link">SPHERE</a></code></div>
 <div class="col-last odd-row-color">
 <div class="block">Unspecified datum based upon the GRS 1980 Authalic Sphere.</div>
 </div>
 <div class="col-first even-row-color"><code><a href="#WGS72" class="member-name-link">WGS72</a></code></div>
 <div class="col-last even-row-color">
 <div class="block">World Geodetic System 1972.</div>
 </div>
 <div class="col-first odd-row-color"><code><a href="#WGS84" class="member-name-link">WGS84</a></code></div>
 <div class="col-last odd-row-color">
 <div class="block">World Geodetic System 1984.</div>
 </div>
 </div>
 </section>
 </li>
 <!-- ========== METHOD SUMMARY =========== -->
 <li>
 <section class="method-summary" id="method-summary">
 <h2>Method Summary</h2>
 <div id="method-summary-table">
 <div class="table-tabs" role="tablist" aria-orientation="horizontal"><button id="method-summary-table-tab0" role="tab" aria-selected="true" aria-controls="method-summary-table.tabpanel" tabindex="0" onkeydown="switchTab(event)" onclick="show('method-summary-table', 'method-summary-table', 3)" class="active-table-tab">All Methods</button><button id="method-summary-table-tab1" role="tab" aria-selected="false" aria-controls="method-summary-table.tabpanel" tabindex="-1" onkeydown="switchTab(event)" onclick="show('method-summary-table', 'method-summary-table-tab1', 3)" class="table-tab">Static Methods</button><button id="method-summary-table-tab2" role="tab" aria-selected="false" aria-controls="method-summary-table.tabpanel" tabindex="-1" onkeydown="switchTab(event)" onclick="show('method-summary-table', 'method-summary-table-tab2', 3)" class="table-tab">Instance Methods</button><button id="method-summary-table-tab4" role="tab" aria-selected="false" aria-controls="method-summary-table.tabpanel" tabindex="-1" onkeydown="switchTab(event)" onclick="show('method-summary-table', 'method-summary-table-tab4', 3)" class="table-tab">Concrete Methods</button></div>
 <div id="method-summary-table.tabpanel" role="tabpanel">
 <div class="summary-table three-column-summary" aria-labelledby="method-summary-table-tab0">
 <div class="table-header col-first">Modifier and Type</div>
 <div class="table-header col-second">Method</div>
 <div class="table-header col-last">Description</div>
 <div class="col-first even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4"><code><a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/datum/GeodeticDatum.html" title="class or interface in org.opengis.referencing.datum" class="external-link">GeodeticDatum</a></code></div>
 <div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4"><code><a href="#datum()" class="member-name-link">datum</a>()</code></div>
 <div class="col-last even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4">
 <div class="block">Returns the geodetic datum associated to this geodetic object.</div>
 </div>
 <div class="col-first odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code>static <a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/crs/GeographicCRS.html" title="class or interface in org.opengis.referencing.crs" class="external-link">GeographicCRS</a></code></div>
 <div class="col-second odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code><a href="#defaultGeographic()" class="member-name-link">defaultGeographic</a>()</code></div>
 <div class="col-last odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4">
 <div class="block">Returns the default two-dimensional normalized geographic CRS.</div>
 </div>
 <div class="col-first even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4"><code><a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/datum/Ellipsoid.html" title="class or interface in org.opengis.referencing.datum" class="external-link">Ellipsoid</a></code></div>
 <div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4"><code><a href="#ellipsoid()" class="member-name-link">ellipsoid</a>()</code></div>
 <div class="col-last even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4">
 <div class="block">Returns the ellipsoid associated to this geodetic object.</div>
 </div>
 <div class="col-first odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code>static <a href="CommonCRS.html" title="enum class in org.apache.sis.referencing">CommonCRS</a></code></div>
 <div class="col-second odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code><a href="#forDatum(org.opengis.referencing.crs.CoordinateReferenceSystem)" class="member-name-link">forDatum</a><wbr>(<a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/crs/CoordinateReferenceSystem.html" title="class or interface in org.opengis.referencing.crs" class="external-link">CoordinateReferenceSystem</a>&nbsp;crs)</code></div>
 <div class="col-last odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4">
 <div class="block">Returns the <code>CommonCRS</code> enumeration value for the datum of the given CRS.</div>
 </div>
 <div class="col-first even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4"><code><a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/crs/GeocentricCRS.html" title="class or interface in org.opengis.referencing.crs" class="external-link">GeocentricCRS</a></code></div>
 <div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4"><code><a href="#geocentric()" class="member-name-link">geocentric</a>()</code></div>
 <div class="col-last even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4">
 <div class="block">Returns the geocentric CRS using a Cartesian coordinate system.</div>
 </div>
 <div class="col-first odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4"><code><a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/crs/GeographicCRS.html" title="class or interface in org.opengis.referencing.crs" class="external-link">GeographicCRS</a></code></div>
 <div class="col-second odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4"><code><a href="#geographic()" class="member-name-link">geographic</a>()</code></div>
 <div class="col-last odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4">
 <div class="block">Returns the two-dimensional geographic CRS with axes in the standard (<var>latitude</var>, <var>longitude</var>)
  order.</div>
 </div>
 <div class="col-first even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4"><code><a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/crs/GeographicCRS.html" title="class or interface in org.opengis.referencing.crs" class="external-link">GeographicCRS</a></code></div>
 <div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4"><code><a href="#geographic3D()" class="member-name-link">geographic3D</a>()</code></div>
 <div class="col-last even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4">
 <div class="block">Returns the three-dimensional geographic CRS with axes in the standard (<var>latitude</var>,
  <var>longitude</var>, <var>height</var>) order.</div>
 </div>
 <div class="col-first odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4"><code><a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/crs/GeographicCRS.html" title="class or interface in org.opengis.referencing.crs" class="external-link">GeographicCRS</a></code></div>
 <div class="col-second odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4"><code><a href="#normalizedGeographic()" class="member-name-link">normalizedGeographic</a>()</code></div>
 <div class="col-last odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4">
 <div class="block">Returns a two-dimensional geographic CRS with axes in the non-standard but computationally convenient
  (<var>longitude</var>, <var>latitude</var>) order.</div>
 </div>
 <div class="col-first even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4"><code><a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/datum/PrimeMeridian.html" title="class or interface in org.opengis.referencing.datum" class="external-link">PrimeMeridian</a></code></div>
 <div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4"><code><a href="#primeMeridian()" class="member-name-link">primeMeridian</a>()</code></div>
 <div class="col-last even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4">
 <div class="block">Returns the prime meridian associated to this geodetic object.</div>
 </div>
 <div class="col-first odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4"><code><a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/crs/GeocentricCRS.html" title="class or interface in org.opengis.referencing.crs" class="external-link">GeocentricCRS</a></code></div>
 <div class="col-second odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4"><code><a href="#spherical()" class="member-name-link">spherical</a>()</code></div>
 <div class="col-last odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4">
 <div class="block">Returns the geocentric CRS using a spherical coordinate system.</div>
 </div>
 <div class="col-first even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4"><code><a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/crs/ProjectedCRS.html" title="class or interface in org.opengis.referencing.crs" class="external-link">ProjectedCRS</a></code></div>
 <div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4"><code><a href="#universal(double,double)" class="member-name-link">universal</a><wbr>(double&nbsp;latitude,
  double&nbsp;longitude)</code></div>
 <div class="col-last even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4">
 <div class="block">Returns a Universal Transverse Mercator (UTM) or a Universal Polar Stereographic (UPS) projection
  for the zone containing the given point.</div>
 </div>
 <div class="col-first odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code>static <a href="CommonCRS.html" title="enum class in org.apache.sis.referencing">CommonCRS</a></code></div>
 <div class="col-second odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code><a href="#valueOf(java.lang.String)" class="member-name-link">valueOf</a><wbr>(<a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" class="external-link">String</a>&nbsp;name)</code></div>
 <div class="col-last odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4">
 <div class="block">Returns the enum constant of this class with the specified name.</div>
 </div>
 <div class="col-first even-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code>static <a href="CommonCRS.html" title="enum class in org.apache.sis.referencing">CommonCRS</a>[]</code></div>
 <div class="col-second even-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code><a href="#values()" class="member-name-link">values</a>()</code></div>
 <div class="col-last even-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4">
 <div class="block">Returns an array containing the constants of this enum class, in
 the order they are declared.</div>
 </div>
 </div>
 </div>
 </div>
 <div class="inherited-list">
 <h3 id="methods-inherited-from-class-Enum">Methods inherited from class&nbsp;<a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Enum.html" title="class or interface in java.lang" class="external-link">Enum</a></h3>
 <code><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Enum.html#clone()" title="class or interface in java.lang" class="external-link">clone</a>, <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Enum.html#compareTo(E)" title="class or interface in java.lang" class="external-link">compareTo</a>, <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Enum.html#describeConstable()" title="class or interface in java.lang" class="external-link">describeConstable</a>, <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Enum.html#equals(java.lang.Object)" title="class or interface in java.lang" class="external-link">equals</a>, <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Enum.html#finalize()" title="class or interface in java.lang" class="external-link">finalize</a>, <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Enum.html#getDeclaringClass()" title="class or interface in java.lang" class="external-link">getDeclaringClass</a>, <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Enum.html#hashCode()" title="class or interface in java.lang" class="external-link">hashCode</a>, <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Enum.html#name()" title="class or interface in java.lang" class="external-link">name</a>, <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Enum.html#ordinal()" title="class or interface in java.lang" class="external-link">ordinal</a>, <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Enum.html#toString()" title="class or interface in java.lang" class="external-link">toString</a>, <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Enum.html#valueOf(java.lang.Class,java.lang.String)" title="class or interface in java.lang" class="external-link">valueOf</a></code></div>
 <div class="inherited-list">
 <h3 id="methods-inherited-from-class-Object">Methods inherited from class&nbsp;<a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Object.html" title="class or interface in java.lang" class="external-link">Object</a></h3>
 <code><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Object.html#getClass()" title="class or interface in java.lang" class="external-link">getClass</a>, <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Object.html#notify()" title="class or interface in java.lang" class="external-link">notify</a>, <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Object.html#notifyAll()" title="class or interface in java.lang" class="external-link">notifyAll</a>, <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Object.html#wait()" title="class or interface in java.lang" class="external-link">wait</a>, <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Object.html#wait(long)" title="class or interface in java.lang" class="external-link">wait</a>, <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Object.html#wait(long,int)" title="class or interface in java.lang" class="external-link">wait</a></code></div>
 </section>
 </li>
 </ul>
 </section>
 <section class="details">
 <ul class="details-list">
 <!-- ============ ENUM CONSTANT DETAIL =========== -->
 <li>
 <section class="constant-details" id="enum-constant-detail">
 <h2>Enum Constant Details</h2>
 <ul class="member-list">
 <li>
 <section class="detail" id="WGS84">
 <h3>WGS84</h3>
 <div class="member-signature"><span class="modifiers">public static final</span>&nbsp;<span class="return-type"><a href="CommonCRS.html" title="enum class in org.apache.sis.referencing">CommonCRS</a></span>&nbsp;<span class="element-name">WGS84</span></div>
 <div class="block">World Geodetic System 1984.
  This is the default CRS for most <code>org.apache.sis</code> packages.

  <blockquote><table class="compact">
  <caption>WGS84 properties</caption>
    <tr><th>CRS identifiers:</th>         <td>CRS:84, EPSG:4326</td></tr>
    <tr><th>Name and abbreviation:</th>   <td>World Geodetic System 1984 (WGS 84)</td></tr>
    <tr><th>Prime meridian:</th>          <td>Greenwich</td></tr>
    <tr><th>Semi-major axis length:</th>  <td>6378137 metres</td></tr>
    <tr><th>Semi-minor axis length:</th>  <td>6356752 metres <i>(approximated)</i></td></tr>
    <tr><th>Inverse flattening:</th>      <td>298.257223563 <i>(definitive)</i></td></tr>
    <tr><th>UTM zones:</th>               <td>1 to 60 in North and South hemispheres</td></tr>
  </table></blockquote></div>
 </section>
 </li>
 <li>
 <section class="detail" id="WGS72">
 <h3>WGS72</h3>
 <div class="member-signature"><span class="modifiers">public static final</span>&nbsp;<span class="return-type"><a href="CommonCRS.html" title="enum class in org.apache.sis.referencing">CommonCRS</a></span>&nbsp;<span class="element-name">WGS72</span></div>
 <div class="block">World Geodetic System 1972.

  <blockquote><table class="compact">
  <caption>WGS72 properties</caption>
    <tr><th>CRS identifiers:</th>         <td>EPSG:4322</td></tr>
    <tr><th>Name and abbreviation:</th>   <td>World Geodetic System 1972 (WGS 72)</td></tr>
    <tr><th>Prime meridian:</th>          <td>Greenwich</td></tr>
    <tr><th>Semi-major axis length:</th>  <td>6378135 metres</td></tr>
    <tr><th>Semi-minor axis length:</th>  <td>6356751 metres <i>(approximated)</i></td></tr>
    <tr><th>Inverse flattening:</th>      <td>298.26 <i>(definitive)</i></td></tr>
    <tr><th>UTM zones:</th>               <td>1 to 60 in North and South hemispheres</td></tr>
  </table></blockquote></div>
 </section>
 </li>
 <li>
 <section class="detail" id="NAD83">
 <h3>NAD83</h3>
 <div class="member-signature"><span class="modifiers">public static final</span>&nbsp;<span class="return-type"><a href="CommonCRS.html" title="enum class in org.apache.sis.referencing">CommonCRS</a></span>&nbsp;<span class="element-name">NAD83</span></div>
 <div class="block">North American Datum 1983.
  The ellipsoid is <cite>"GRS 1980"</cite>.
  This ellipsoid is very close, but not identical, to the <a href="#WGS84">WGS84</a> one.

  <blockquote><table class="compact">
  <caption>NAD83 properties</caption>
    <tr><th>CRS identifier:</th>          <td>CRS:83, EPSG:4269</td></tr>
    <tr><th>Name and abbreviation:</th>   <td>North American Datum 1983 (NAD83)</td></tr>
    <tr><th>Prime meridian:</th>          <td>Greenwich</td></tr>
    <tr><th>Semi-major axis length:</th>  <td>6378137 metres</td></tr>
    <tr><th>Semi-minor axis length:</th>  <td>6356752 metres <i>(approximated)</i></td></tr>
    <tr><th>Inverse flattening:</th>      <td>298.257222101 <i>(definitive)</i></td></tr>
    <tr><th>UTM zones:</th>               <td>1 to 23 in the North hemisphere</td></tr>
  </table></blockquote>

  <div class="note"><b>Note:</b>
  <a href="#ETRS89"><code>ETRS89</code></a> uses the same ellipsoid for a different datum.
  The <cite>Web Map Server</cite> <code>"CRS:83"</code> authority code uses the NAD83 datum,
  while the <code>"IGNF:MILLER"</code> authority code uses the GRS80 datum.</div></div>
 </section>
 </li>
 <li>
 <section class="detail" id="NAD27">
 <h3>NAD27</h3>
 <div class="member-signature"><span class="modifiers">public static final</span>&nbsp;<span class="return-type"><a href="CommonCRS.html" title="enum class in org.apache.sis.referencing">CommonCRS</a></span>&nbsp;<span class="element-name">NAD27</span></div>
 <div class="block">North American Datum 1927.

  <blockquote><table class="compact">
  <caption>NAD27 properties</caption>
    <tr><th>CRS identifiers:</th>         <td>CRS:27, EPSG:4267</td></tr>
    <tr><th>Name and abbreviation:</th>   <td>North American Datum 1927 (NAD27)</td></tr>
    <tr><th>Prime meridian:</th>          <td>Greenwich</td></tr>
    <tr><th>Semi-major axis length:</th>  <td>6378206.4 metres</td></tr>
    <tr><th>Semi-minor axis length:</th>  <td>6356583.8 metres <i>(definitive)</i></td></tr>
    <tr><th>UTM zones:</th>               <td>1 to 22 in the North hemisphere</td></tr>
  </table></blockquote></div>
 </section>
 </li>
 <li>
 <section class="detail" id="ETRS89">
 <h3>ETRS89</h3>
 <div class="member-signature"><span class="modifiers">public static final</span>&nbsp;<span class="return-type"><a href="CommonCRS.html" title="enum class in org.apache.sis.referencing">CommonCRS</a></span>&nbsp;<span class="element-name">ETRS89</span></div>
 <div class="block">European Terrestrial Reference System 1989.
  The ellipsoid is <cite>"GRS 1980"</cite>.
  This ellipsoid is very close, but not identical, to the <a href="#WGS84">WGS84</a> one.

  <blockquote><table class="compact">
  <caption>ETRS89 properties</caption>
    <tr><th>CRS identifiers:</th>         <td>EPSG:4258</td></tr>
    <tr><th>Name and abbreviation:</th>   <td>European Terrestrial Reference System 1989 (ETRS89)</td></tr>
    <tr><th>Prime meridian:</th>          <td>Greenwich</td></tr>
    <tr><th>Semi-major axis length:</th>  <td>6378137 metres</td></tr>
    <tr><th>Semi-minor axis length:</th>  <td>6356752 metres <i>(approximated)</i></td></tr>
    <tr><th>Inverse flattening:</th>      <td>298.257222101 <i>(definitive)</i></td></tr>
    <tr><th>UTM zones:</th>               <td>28 to 37 in the North hemisphere</td></tr>
  </table></blockquote>

  <div class="note"><b>Note:</b>
  <a href="#NAD83"><code>NAD83</code></a> uses the same ellipsoid for a different datum.
  The <cite>Web Map Server</cite> <code>"CRS:83"</code> authority code uses the NAD83 datum,
  while the <code>"IGNF:MILLER"</code> authority code uses the GRS80 datum.</div></div>
 </section>
 </li>
 <li>
 <section class="detail" id="ED50">
 <h3>ED50</h3>
 <div class="member-signature"><span class="modifiers">public static final</span>&nbsp;<span class="return-type"><a href="CommonCRS.html" title="enum class in org.apache.sis.referencing">CommonCRS</a></span>&nbsp;<span class="element-name">ED50</span></div>
 <div class="block">European Datum 1950 (ED50).

  <blockquote><table class="compact">
  <caption>ED50 properties</caption>
    <tr><th>CRS identifiers:</th>         <td>EPSG:4230</td></tr>
    <tr><th>Name and abbreviation:</th>   <td>European Datum 1950 (ED50)</td></tr>
    <tr><th>Prime meridian:</th>          <td>Greenwich</td></tr>
    <tr><th>Semi-major axis length:</th>  <td>6378388 metres</td></tr>
    <tr><th>Semi-minor axis length:</th>  <td>6356912 metres <i>(approximated)</i></td></tr>
    <tr><th>Inverse flattening:</th>      <td>297 <i>(definitive)</i></td></tr>
    <tr><th>UTM zones:</th>               <td>28 to 38 in the North hemisphere</td></tr>
  </table></blockquote></div>
 </section>
 </li>
 <li>
 <section class="detail" id="GRS1980">
 <h3>GRS1980</h3>
 <div class="member-signature"><span class="modifiers">public static final</span>&nbsp;<span class="return-type"><a href="CommonCRS.html" title="enum class in org.apache.sis.referencing">CommonCRS</a></span>&nbsp;<span class="element-name">GRS1980</span></div>
 <div class="block">Unknown datum based upon the GRS 1980 ellipsoid.
  Use only in cases where geodetic datum is unknown.

  <blockquote><table class="compact">
  <caption>GRS1980 properties</caption>
    <tr><th>CRS identifiers:</th>         <td><del>EPSG:4019</del></td></tr>
    <tr><th>Name and abbreviation:</th>   <td>Unknown datum based upon the GRS 1980 ellipsoid</td></tr>
    <tr><th>Prime meridian:</th>          <td>Greenwich</td></tr>
    <tr><th>Semi-major axis length:</th>  <td>6378137 metres</td></tr>
    <tr><th>Semi-minor axis length:</th>  <td>6356752 metres <i>(approximated)</i></td></tr>
    <tr><th>Inverse flattening:</th>      <td>298.257222101 <i>(definitive)</i></td></tr>
  </table></blockquote></div>
 <dl class="notes">
 <dt>Since:</dt>
 <dd>1.0</dd>
 </dl>
 </section>
 </li>
 <li>
 <section class="detail" id="SPHERE">
 <h3>SPHERE</h3>
 <div class="member-signature"><span class="modifiers">public static final</span>&nbsp;<span class="return-type"><a href="CommonCRS.html" title="enum class in org.apache.sis.referencing">CommonCRS</a></span>&nbsp;<span class="element-name">SPHERE</span></div>
 <div class="block">Unspecified datum based upon the GRS 1980 Authalic Sphere.

  <blockquote><table class="compact">
  <caption>Sphere properties</caption>
    <tr><th>CRS identifiers:</th>         <td><del>EPSG:4047</del></td></tr>
    <tr><th>Name and abbreviation:</th>   <td>Unspecified datum based upon the GRS 1980 Authalic Sphere</td></tr>
    <tr><th>Prime meridian:</th>          <td>Greenwich</td></tr>
    <tr><th>Semi-major axis length:</th>  <td>6371007 metres</td></tr>
    <tr><th>Semi-minor axis length:</th>  <td>6371007 metres <i>(definitive)</i></td></tr>
  </table></blockquote></div>
 <dl class="notes">
 <dt>See Also:</dt>
 <dd>
 <ul class="tag-list-long">
 <li><a href="datum/DefaultEllipsoid.html#getAuthalicRadius()"><code>DefaultEllipsoid.getAuthalicRadius()</code></a></li>
 </ul>
 </dd>
 </dl>
 </section>
 </li>
 </ul>
 </section>
 </li>
 <!-- ============ METHOD DETAIL ========== -->
 <li>
 <section class="method-details" id="method-detail">
 <h2>Method Details</h2>
 <ul class="member-list">
 <li>
 <section class="detail" id="values()">
 <h3>values</h3>
 <div class="member-signature"><span class="modifiers">public static</span>&nbsp;<span class="return-type"><a href="CommonCRS.html" title="enum class in org.apache.sis.referencing">CommonCRS</a>[]</span>&nbsp;<span class="element-name">values</span>()</div>
 <div class="block">Returns an array containing the constants of this enum class, in
 the order they are declared.</div>
 <dl class="notes">
 <dt>Returns:</dt>
 <dd>an array containing the constants of this enum class, in the order they are declared</dd>
 </dl>
 </section>
 </li>
 <li>
 <section class="detail" id="valueOf(java.lang.String)">
 <h3>valueOf</h3>
 <div class="member-signature"><span class="modifiers">public static</span>&nbsp;<span class="return-type"><a href="CommonCRS.html" title="enum class in org.apache.sis.referencing">CommonCRS</a></span>&nbsp;<span class="element-name">valueOf</span><wbr><span class="parameters">(<a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" class="external-link">String</a>&nbsp;name)</span></div>
 <div class="block">Returns the enum constant of this class with the specified name.
 The string must match <i>exactly</i> an identifier used to declare an
 enum constant in this class.  (Extraneous whitespace characters are
 not permitted.)</div>
 <dl class="notes">
 <dt>Parameters:</dt>
 <dd><code>name</code> - the name of the enum constant to be returned.</dd>
 <dt>Returns:</dt>
 <dd>the enum constant with the specified name</dd>
 <dt>Throws:</dt>
 <dd><code><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/IllegalArgumentException.html" title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - if this enum class has no constant with the specified name</dd>
 <dd><code><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/NullPointerException.html" title="class or interface in java.lang" class="external-link">NullPointerException</a></code> - if the argument is null</dd>
 </dl>
 </section>
 </li>
 <li>
 <section class="detail" id="forDatum(org.opengis.referencing.crs.CoordinateReferenceSystem)">
 <h3>forDatum</h3>
 <div class="member-signature"><span class="modifiers">public static</span>&nbsp;<span class="return-type"><a href="CommonCRS.html" title="enum class in org.apache.sis.referencing">CommonCRS</a></span>&nbsp;<span class="element-name">forDatum</span><wbr><span class="parameters">(<a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/crs/CoordinateReferenceSystem.html" title="class or interface in org.opengis.referencing.crs" class="external-link">CoordinateReferenceSystem</a>&nbsp;crs)</span></div>
 <div class="block">Returns the <code>CommonCRS</code> enumeration value for the datum of the given CRS.
  The given CRS shall comply to the following conditions
  (otherwise an <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/IllegalArgumentException.html" title="class or interface in java.lang" class="external-link"><code>IllegalArgumentException</code></a> is thrown):

  <ul>
    <li>The <code>crs</code> is either an instance of <a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/crs/SingleCRS.html" title="class or interface in org.opengis.referencing.crs" class="external-link"><code>SingleCRS</code></a>,
        or an instance of <a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/crs/CompoundCRS.html" title="class or interface in org.opengis.referencing.crs" class="external-link"><code>CompoundCRS</code></a>
        with an <a href="CRS.html#getHorizontalComponent(org.opengis.referencing.crs.CoordinateReferenceSystem)">horizontal component</a>.</li>
    <li>The <code>crs</code> or the horizontal component of <code>crs</code> is associated to a <a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/datum/GeodeticDatum.html" title="class or interface in org.opengis.referencing.datum" class="external-link"><code>GeodeticDatum</code></a>.</li>
    <li>The geodetic datum either<ul>
      <li>has the same EPSG code than one of the <code>CommonCRS</code> enumeration values, or</li>
      <li>has no EPSG code but is <a href="../../../../../org.apache.sis.util/org/apache/sis/util/Utilities.html#equalsIgnoreMetadata(java.lang.Object,java.lang.Object)">equal, ignoring metadata</a>,
        to the <a href="#datum()"><code>datum()</code></a> value of one of the <code>CommonCRS</code> enumeration values.</li>
    </ul></li>
  </ul>

  This method is useful for easier creation of various coordinate reference systems through the
  <a href="#geographic()"><code>geographic()</code></a>, <a href="#geocentric()"><code>geocentric()</code></a> or other convenience methods when the set of datums
  supported by <code>CommonCRS</code> is known to be sufficient.</div>
 <dl class="notes">
 <dt>Parameters:</dt>
 <dd><code>crs</code> - the coordinate reference system for which to get a <code>CommonCRS</code> value.</dd>
 <dt>Returns:</dt>
 <dd>the <code>CommonCRS</code> value for the geodetic datum of the given CRS.</dd>
 <dt>Throws:</dt>
 <dd><code><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/IllegalArgumentException.html" title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - if no <code>CommonCRS</code> value can be found for the given CRS.</dd>
 <dt>Since:</dt>
 <dd>0.8</dd>
 <dt>See Also:</dt>
 <dd>
 <ul class="tag-list">
 <li><a href="#datum()"><code>datum()</code></a></li>
 </ul>
 </dd>
 </dl>
 </section>
 </li>
 <li>
 <section class="detail" id="defaultGeographic()">
 <h3>defaultGeographic</h3>
 <div class="member-signature"><span class="modifiers">public static</span>&nbsp;<span class="return-type"><a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/crs/GeographicCRS.html" title="class or interface in org.opengis.referencing.crs" class="external-link">GeographicCRS</a></span>&nbsp;<span class="element-name">defaultGeographic</span>()</div>
 <div class="block">Returns the default two-dimensional normalized geographic CRS.
  This CRS is okay for <em>computational purposes</em> but should
  not be used for showing coordinates in graphical user interfaces.
  The CRS returned by this method has the following properties:

  <ul>
    <li>Axis order is (<var>longitude</var>, <var>latitude</var>).</li>
    <li>Axis directions are (<a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/cs/AxisDirection.html#EAST" title="class or interface in org.opengis.referencing.cs" class="external-link">East</a>, <a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/cs/AxisDirection.html#NORTH" title="class or interface in org.opengis.referencing.cs" class="external-link">North</a>).</li>
    <li>Angular unit is <a href="../../../../../org.apache.sis.util/org/apache/sis/measure/Units.html#DEGREE"><code>Units.DEGREE</code></a>.</li>
    <li>Prime meridian in Greenwich.</li>
  </ul>

  <h4 id="default-reference-frame-heading">Default reference frame</h4>
  This method makes no guarantees about the datum. The current default datum is WGS 84,
  but this may change or become configurable in any future SIS versions.

  <p>This default CRS is assigned to
  <a href="../geometry/GeneralEnvelope.html#%3Cinit%3E(org.opengis.metadata.extent.GeographicBoundingBox)">envelopes created
  from a geographic bounding box</a>. Since ISO 19115 <a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/metadata/extent/GeographicBoundingBox.html" title="class or interface in org.opengis.metadata.extent" class="external-link"><code>GeographicBoundingBox</code></a> is approximated by definition,
  their datum can be arbitrary.</p></div>
 <dl class="notes">
 <dt>Returns:</dt>
 <dd>the default two-dimensional geographic CRS with (<var>longitude</var>, <var>latitude</var>) axis order.</dd>
 </dl>
 </section>
 </li>
 <li>
 <section class="detail" id="normalizedGeographic()">
 <h3>normalizedGeographic</h3>
 <div class="member-signature"><span class="modifiers">public</span>&nbsp;<span class="return-type"><a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/crs/GeographicCRS.html" title="class or interface in org.opengis.referencing.crs" class="external-link">GeographicCRS</a></span>&nbsp;<span class="element-name">normalizedGeographic</span>()</div>
 <div class="block">Returns a two-dimensional geographic CRS with axes in the non-standard but computationally convenient
  (<var>longitude</var>, <var>latitude</var>) order. The coordinate system axes will be oriented toward
  <a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/cs/AxisDirection.html#EAST" title="class or interface in org.opengis.referencing.cs" class="external-link">East</a> and <a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/cs/AxisDirection.html#NORTH" title="class or interface in org.opengis.referencing.cs" class="external-link">North</a> respectively, with units
  in degrees. The following table summarizes the coordinate reference systems known to this class,
  together with an enumeration value that can be used for fetching that CRS:

  <blockquote><table class="sis">
    <caption>Commonly used geographic CRS</caption>
    <tr><th>Name or alias</th>            <th>Enum</th>            <th>Code</th></tr>
    <tr><td>ED50</td>                     <td><a href="#ED50"><code>ED50</code></a></td>   <td></td></tr>
    <tr><td>ETRS89</td>                   <td><a href="#ETRS89"><code>ETRS89</code></a></td> <td></td></tr>
    <tr><td>NAD27</td>                    <td><a href="#NAD27"><code>NAD27</code></a></td>  <td>CRS:27</td></tr>
    <tr><td>NAD83</td>                    <td><a href="#NAD83"><code>NAD83</code></a></td>  <td>CRS:83</td></tr>
    <tr><td>GRS 1980</td>                 <td><a href="#GRS1980"><code>GRS1980</code></a></td><td></td></tr>
    <tr><td>GRS 1980 Authalic Sphere</td> <td><a href="#SPHERE"><code>SPHERE</code></a></td> <td></td></tr>
    <tr><td>WGS 72</td>                   <td><a href="#WGS72"><code>WGS72</code></a></td>  <td></td></tr>
    <tr><td>WGS 84</td>                   <td><a href="#WGS84"><code>WGS84</code></a></td>  <td>CRS:84</td></tr>
  </table></blockquote></div>
 <dl class="notes">
 <dt>Returns:</dt>
 <dd>the geographic CRS with non-standard (<var>longitude</var>, <var>latitude</var>) axis order.</dd>
 <dt>See Also:</dt>
 <dd>
 <ul class="tag-list-long">
 <li><a href="CRS.html#forCode(java.lang.String)"><code>CRS.forCode(String)</code></a></li>
 <li><a href="crs/DefaultGeographicCRS.html#forConvention(org.apache.sis.referencing.cs.AxesConvention)"><code>DefaultGeographicCRS.forConvention(AxesConvention)</code></a></li>
 <li><a href="cs/AxesConvention.html#NORMALIZED"><code>AxesConvention.NORMALIZED</code></a></li>
 </ul>
 </dd>
 </dl>
 </section>
 </li>
 <li>
 <section class="detail" id="geographic()">
 <h3>geographic</h3>
 <div class="member-signature"><span class="modifiers">public</span>&nbsp;<span class="return-type"><a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/crs/GeographicCRS.html" title="class or interface in org.opengis.referencing.crs" class="external-link">GeographicCRS</a></span>&nbsp;<span class="element-name">geographic</span>()</div>
 <div class="block">Returns the two-dimensional geographic CRS with axes in the standard (<var>latitude</var>, <var>longitude</var>)
  order. The coordinate system axes will be oriented toward <a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/cs/AxisDirection.html#NORTH" title="class or interface in org.opengis.referencing.cs" class="external-link">North</a> and
  <a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/cs/AxisDirection.html#EAST" title="class or interface in org.opengis.referencing.cs" class="external-link">East</a> respectively, with units in degrees.
  The following table summarizes the coordinate reference systems known to this class,
  together with an enumeration value that can be used for fetching that CRS:

  <blockquote><table class="sis">
    <caption>Commonly used geographic CRS</caption>
    <tr><th>Name or alias</th>            <th>Enum</th>            <th>EPSG</th></tr>
    <tr><td>ED50</td>                     <td><a href="#ED50"><code>ED50</code></a></td>   <td>4230</td></tr>
    <tr><td>ETRS89</td>                   <td><a href="#ETRS89"><code>ETRS89</code></a></td> <td>4258</td></tr>
    <tr><td>NAD27</td>                    <td><a href="#NAD27"><code>NAD27</code></a></td>  <td>4267</td></tr>
    <tr><td>NAD83</td>                    <td><a href="#NAD83"><code>NAD83</code></a></td>  <td>4269</td></tr>
    <tr><td>GRS 1980</td>                 <td><a href="#GRS1980"><code>GRS1980</code></a></td><td><del>4019</del></td></tr>
    <tr><td>GRS 1980 Authalic Sphere</td> <td><a href="#SPHERE"><code>SPHERE</code></a></td> <td><del>4047</del></td></tr>
    <tr><td>WGS 72</td>                   <td><a href="#WGS72"><code>WGS72</code></a></td>  <td>4322</td></tr>
    <tr><td>WGS 84</td>                   <td><a href="#WGS84"><code>WGS84</code></a></td>  <td>4326</td></tr>
  </table></blockquote></div>
 <dl class="notes">
 <dt>Returns:</dt>
 <dd>the geographic CRS with standard (<var>latitude</var>, <var>longitude</var>) axis order.</dd>
 <dt>See Also:</dt>
 <dd>
 <ul class="tag-list">
 <li><a href="CRS.html#forCode(java.lang.String)"><code>CRS.forCode(String)</code></a></li>
 <li><a href="crs/DefaultGeographicCRS.html" title="class in org.apache.sis.referencing.crs"><code>DefaultGeographicCRS</code></a></li>
 </ul>
 </dd>
 </dl>
 </section>
 </li>
 <li>
 <section class="detail" id="geographic3D()">
 <h3>geographic3D</h3>
 <div class="member-signature"><span class="modifiers">public</span>&nbsp;<span class="return-type"><a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/crs/GeographicCRS.html" title="class or interface in org.opengis.referencing.crs" class="external-link">GeographicCRS</a></span>&nbsp;<span class="element-name">geographic3D</span>()</div>
 <div class="block">Returns the three-dimensional geographic CRS with axes in the standard (<var>latitude</var>,
  <var>longitude</var>, <var>height</var>) order. The following table summarizes the coordinate
  reference systems known to this class, together with an enumeration value that can be used for
  fetching that CRS:

  <blockquote><table class="sis">
    <caption>Commonly used geographic CRS</caption>
    <tr><th>Name or alias</th>            <th>Enum</th>            <th>EPSG</th></tr>
    <tr><td>ED50</td>                     <td><a href="#ED50"><code>ED50</code></a></td>   <td></td></tr>
    <tr><td>ETRS89</td>                   <td><a href="#ETRS89"><code>ETRS89</code></a></td> <td>4937</td></tr>
    <tr><td>NAD27</td>                    <td><a href="#NAD27"><code>NAD27</code></a></td>  <td></td></tr>
    <tr><td>NAD83</td>                    <td><a href="#NAD83"><code>NAD83</code></a></td>  <td></td></tr>
    <tr><td>GRS 1980</td>                 <td><a href="#GRS1980"><code>GRS1980</code></a></td><td></td></tr>
    <tr><td>GRS 1980 Authalic Sphere</td> <td><a href="#SPHERE"><code>SPHERE</code></a></td> <td></td></tr>
    <tr><td>WGS 72</td>                   <td><a href="#WGS72"><code>WGS72</code></a></td>  <td>4985</td></tr>
    <tr><td>WGS 84</td>                   <td><a href="#WGS84"><code>WGS84</code></a></td>  <td>4979</td></tr>
  </table></blockquote></div>
 <dl class="notes">
 <dt>Returns:</dt>
 <dd>the three-dimensional geographic CRS associated to this enum.</dd>
 <dt>See Also:</dt>
 <dd>
 <ul class="tag-list">
 <li><a href="CRS.html#forCode(java.lang.String)"><code>CRS.forCode(String)</code></a></li>
 <li><a href="crs/DefaultGeographicCRS.html" title="class in org.apache.sis.referencing.crs"><code>DefaultGeographicCRS</code></a></li>
 </ul>
 </dd>
 </dl>
 </section>
 </li>
 <li>
 <section class="detail" id="geocentric()">
 <h3>geocentric</h3>
 <div class="member-signature"><span class="modifiers">public</span>&nbsp;<span class="return-type"><a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/crs/GeocentricCRS.html" title="class or interface in org.opengis.referencing.crs" class="external-link">GeocentricCRS</a></span>&nbsp;<span class="element-name">geocentric</span>()</div>
 <div class="block">Returns the geocentric CRS using a Cartesian coordinate system. Axis units are metres.
  The following table summarizes the coordinate reference systems known to this class,
  together with an enumeration value that can be used for fetching that CRS:

  <blockquote><table class="sis">
    <caption>Commonly used geocentric CRS</caption>
    <tr><th>Name or alias</th>            <th>Enum</th>            <th>EPSG</th></tr>
    <tr><td>ED50</td>                     <td><a href="#ED50"><code>ED50</code></a></td>   <td></td></tr>
    <tr><td>ETRS89</td>                   <td><a href="#ETRS89"><code>ETRS89</code></a></td> <td>4936</td></tr>
    <tr><td>NAD27</td>                    <td><a href="#NAD27"><code>NAD27</code></a></td>  <td></td></tr>
    <tr><td>NAD83</td>                    <td><a href="#NAD83"><code>NAD83</code></a></td>  <td></td></tr>
    <tr><td>GRS 1980</td>                 <td><a href="#GRS1980"><code>GRS1980</code></a></td><td></td></tr>
    <tr><td>GRS 1980 Authalic Sphere</td> <td><a href="#SPHERE"><code>SPHERE</code></a></td> <td></td></tr>
    <tr><td>WGS 72</td>                   <td><a href="#WGS72"><code>WGS72</code></a></td>  <td>4984</td></tr>
    <tr><td>WGS 84</td>                   <td><a href="#WGS84"><code>WGS84</code></a></td>  <td>4978</td></tr>
  </table></blockquote></div>
 <dl class="notes">
 <dt>Returns:</dt>
 <dd>the geocentric CRS associated to this enum.</dd>
 <dt>See Also:</dt>
 <dd>
 <ul class="tag-list">
 <li><a href="CRS.html#forCode(java.lang.String)"><code>CRS.forCode(String)</code></a></li>
 <li><a href="crs/DefaultGeocentricCRS.html" title="class in org.apache.sis.referencing.crs"><code>DefaultGeocentricCRS</code></a></li>
 </ul>
 </dd>
 </dl>
 </section>
 </li>
 <li>
 <section class="detail" id="spherical()">
 <h3>spherical</h3>
 <div class="member-signature"><span class="modifiers">public</span>&nbsp;<span class="return-type"><a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/crs/GeocentricCRS.html" title="class or interface in org.opengis.referencing.crs" class="external-link">GeocentricCRS</a></span>&nbsp;<span class="element-name">spherical</span>()</div>
 <div class="block">Returns the geocentric CRS using a spherical coordinate system. Axes are:

  <ol>
    <li>Spherical latitude in degrees oriented toward <a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/cs/AxisDirection.html#NORTH" title="class or interface in org.opengis.referencing.cs" class="external-link">north</a>.</li>
    <li>Spherical longitude in degrees oriented toward <a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/cs/AxisDirection.html#EAST" title="class or interface in org.opengis.referencing.cs" class="external-link">east</a>.</li>
    <li>Geocentric radius in metres oriented toward <a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/cs/AxisDirection.html#UP" title="class or interface in org.opengis.referencing.cs" class="external-link">up</a>.</li>
  </ol></div>
 <dl class="notes">
 <dt>Returns:</dt>
 <dd>the geocentric CRS associated to this enum.</dd>
 <dt>Since:</dt>
 <dd>0.7</dd>
 <dt>See Also:</dt>
 <dd>
 <ul class="tag-list">
 <li><a href="crs/DefaultGeocentricCRS.html" title="class in org.apache.sis.referencing.crs"><code>DefaultGeocentricCRS</code></a></li>
 </ul>
 </dd>
 </dl>
 </section>
 </li>
 <li>
 <section class="detail" id="datum()">
 <h3>datum</h3>
 <div class="member-signature"><span class="modifiers">public</span>&nbsp;<span class="return-type"><a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/datum/GeodeticDatum.html" title="class or interface in org.opengis.referencing.datum" class="external-link">GeodeticDatum</a></span>&nbsp;<span class="element-name">datum</span>()</div>
 <div class="block">Returns the geodetic datum associated to this geodetic object.
  The following table summarizes the datums known to this class,
  together with an enumeration value that can be used for fetching that datum:

  <blockquote><table class="sis">
    <caption>Commonly used geodetic datums</caption>
    <tr><th>Name or alias</th>                                     <th>Enum</th>            <th>EPSG</th></tr>
    <tr><td>European Datum 1950</td>                               <td><a href="#ED50"><code>ED50</code></a></td>   <td>6230</td></tr>
    <tr><td>European Terrestrial Reference System 1989</td>        <td><a href="#ETRS89"><code>ETRS89</code></a></td> <td>6258</td></tr>
    <tr><td>North American Datum 1927</td>                         <td><a href="#NAD27"><code>NAD27</code></a></td>  <td>6267</td></tr>
    <tr><td>North American Datum 1983</td>                         <td><a href="#NAD83"><code>NAD83</code></a></td>  <td>6269</td></tr>
    <tr><td>Not specified (based on GRS 1980 ellipsoid)</td>       <td><a href="#GRS1980"><code>GRS1980</code></a></td><td>6019</td></tr>
    <tr><td>Not specified (based on GRS 1980 Authalic Sphere)</td> <td><a href="#SPHERE"><code>SPHERE</code></a></td> <td>6047</td></tr>
    <tr><td>World Geodetic System 1972</td>                        <td><a href="#WGS72"><code>WGS72</code></a></td>  <td>6322</td></tr>
    <tr><td>World Geodetic System 1984</td>                        <td><a href="#WGS84"><code>WGS84</code></a></td>  <td>6326</td></tr>
  </table></blockquote></div>
 <dl class="notes">
 <dt>Returns:</dt>
 <dd>the geodetic datum associated to this enum.</dd>
 <dt>See Also:</dt>
 <dd>
 <ul class="tag-list-long">
 <li><a href="#forDatum(org.opengis.referencing.crs.CoordinateReferenceSystem)"><code>forDatum(CoordinateReferenceSystem)</code></a></li>
 <li><a href="datum/DefaultGeodeticDatum.html" title="class in org.apache.sis.referencing.datum"><code>DefaultGeodeticDatum</code></a></li>
 </ul>
 </dd>
 </dl>
 </section>
 </li>
 <li>
 <section class="detail" id="ellipsoid()">
 <h3>ellipsoid</h3>
 <div class="member-signature"><span class="modifiers">public</span>&nbsp;<span class="return-type"><a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/datum/Ellipsoid.html" title="class or interface in org.opengis.referencing.datum" class="external-link">Ellipsoid</a></span>&nbsp;<span class="element-name">ellipsoid</span>()</div>
 <div class="block">Returns the ellipsoid associated to this geodetic object.
  The following table summarizes the ellipsoids known to this class,
  together with an enumeration value that can be used for fetching that ellipsoid:

  <blockquote><table class="sis">
    <caption>Commonly used ellipsoids</caption>
    <tr><th>Name or alias</th>                    <th>Enum</th>            <th>EPSG</th></tr>
    <tr><td>Clarke 1866</td>                      <td><a href="#NAD27"><code>NAD27</code></a></td>  <td>7008</td></tr>
    <tr><td>GRS 1980</td>                         <td><a href="#GRS1980"><code>GRS1980</code></a></td><td>7019</td></tr>
    <tr><td>GRS 1980 Authalic Sphere</td>         <td><a href="#SPHERE"><code>SPHERE</code></a></td> <td>7048</td></tr>
    <tr><td>International 1924</td>               <td><a href="#ED50"><code>ED50</code></a></td>   <td>7022</td></tr>
    <tr><td>World Geodetic System (WGS) 1972</td> <td><a href="#WGS72"><code>WGS72</code></a></td>  <td>7043</td></tr>
    <tr><td>World Geodetic System (WGS) 1984</td> <td><a href="#WGS84"><code>WGS84</code></a></td>  <td>7030</td></tr>
  </table></blockquote></div>
 <dl class="notes">
 <dt>Returns:</dt>
 <dd>the ellipsoid associated to this enum.</dd>
 <dt>See Also:</dt>
 <dd>
 <ul class="tag-list">
 <li><a href="datum/DefaultEllipsoid.html" title="class in org.apache.sis.referencing.datum"><code>DefaultEllipsoid</code></a></li>
 </ul>
 </dd>
 </dl>
 </section>
 </li>
 <li>
 <section class="detail" id="primeMeridian()">
 <h3>primeMeridian</h3>
 <div class="member-signature"><span class="modifiers">public</span>&nbsp;<span class="return-type"><a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/datum/PrimeMeridian.html" title="class or interface in org.opengis.referencing.datum" class="external-link">PrimeMeridian</a></span>&nbsp;<span class="element-name">primeMeridian</span>()</div>
 <div class="block">Returns the prime meridian associated to this geodetic object.
  The following table summarizes the prime meridians known to this class,
  together with an enumeration value that can be used for fetching that prime meridian:

  <blockquote><table class="sis">
    <caption>Commonly used prime meridians</caption>
    <tr><th>Name or alias</th> <th>Enum</th>           <th>EPSG</th></tr>
    <tr><td>Greenwich</td>     <td><a href="#WGS84"><code>WGS84</code></a></td> <td>8901</td></tr>
  </table></blockquote></div>
 <dl class="notes">
 <dt>Returns:</dt>
 <dd>the prime meridian associated to this enum.</dd>
 <dt>See Also:</dt>
 <dd>
 <ul class="tag-list">
 <li><a href="datum/DefaultPrimeMeridian.html" title="class in org.apache.sis.referencing.datum"><code>DefaultPrimeMeridian</code></a></li>
 </ul>
 </dd>
 </dl>
 </section>
 </li>
 <li>
 <section class="detail" id="universal(double,double)">
 <h3>universal</h3>
 <div class="member-signature"><span class="modifiers">public</span>&nbsp;<span class="return-type"><a href="http://www.geoapi.org/3.0/javadoc/org.opengis.geoapi/org/opengis/referencing/crs/ProjectedCRS.html" title="class or interface in org.opengis.referencing.crs" class="external-link">ProjectedCRS</a></span>&nbsp;<span class="element-name">universal</span><wbr><span class="parameters">(double&nbsp;latitude,
  double&nbsp;longitude)</span></div>
 <div class="block">Returns a Universal Transverse Mercator (UTM) or a Universal Polar Stereographic (UPS) projection
  for the zone containing the given point.
  There is a total of 120 UTM zones, with 60 zones in the North hemisphere and 60 zones in the South hemisphere.
  The projection zone is determined from the arguments as below:

  <ul class="verbose">
    <li>If the <var>latitude</var> argument is less than 80°S or equal or greater than 84°N,
        then a <cite>Universal Polar Stereographic</cite> projection is created.</li>
    <li>Otherwise a <cite>Universal Transverse Mercator</cite> projection is created as below:
      <ul class="verbose">
        <li>The sign of the <var>latitude</var> argument determines the hemisphere:
            North for positive latitudes (including positive zero) or
            South for negative latitudes (including negative zero).
            The latitude magnitude is ignored, except for the special cases documented below
            and for ensuring that the latitude is inside the [-90 … 90]° range.</li>
        <li>The value of the <var>longitude</var> argument determines the 6°-width zone,
            numbered from 1 for the zone starting at 180°W up to 60 for the zone finishing at 180°E.
            Longitudes outside the [-180 … 180]° range will be rolled as needed before to compute the zone.</li>
        <li>Calculation of UTM zone involves two special cases (if those special cases are not desired,
            they can be avoided by making sure that the given latitude is below 56°N):
          <ul>
            <li>Between 56°N and 64°N, zone 32 is widened to 9° (at the expense of zone 31)
                to accommodate southwest Norway.</li>
            <li>Between 72°N and 84°N, zones 33 and 35 are widened to 12° to accommodate Svalbard.
                To compensate for these 12° wide zones, zones 31 and 37 are widened to 9° and
                zones 32, 34, and 36 are eliminated.</li>
          </ul>
        </li>
      </ul>
    </li>
  </ul>

  <div class="note"><b>Tip:</b>
  for "straight" UTM zone calculation without any special case (neither Norway, Svalbard or Universal Polar
  Stereographic projection), one can replace the <code>latitude</code> argument by <code>Math.signum(latitude)</code>.
  For using a specific zone number, one can additionally replace the <code>longitude</code> argument by
  <code>zone * 6 - 183</code>.</div>

  The map projection uses the following parameters:

  <table class="sis">
    <caption>Universal Transverse Mercator (UTM) and Universal Polar Stereographic (UPS) projection parameters</caption>
    <tr>
      <th>Parameter name</th>
      <th>UTM parameter value</th>
      <th>UPS parameter value</th>
    </tr><tr>
      <td>Latitude of natural origin</td>
      <td>0°</td>
      <td>90°N or 90°S depending on the sign of given latitude</td>
    </tr><tr>
      <td>Longitude of natural origin</td>
      <td>Central meridian of the UTM zone containing the given longitude</td>
      <td>0°</td>
    </tr><tr>
      <td>Scale factor at natural origin</td>
      <td>0.9996</td>
      <td>0.994</td>
    </tr><tr>
      <td>False easting</td>
      <td>500 000 metres</td>
      <td>2 000 000 metres</td>
    </tr><tr>
      <td>False northing</td>
      <td>0 (North hemisphere) or 10 000 000 (South hemisphere) metres</td>
      <td>2 000 000 metres</td>
    </tr>
  </table>

  The coordinate system axes are (Easting, Northing) in metres.

  <p>Be aware of parameter order! For this method, latitude is first.
  This order is for consistency with the non-normalized <a href="#geographic()">geographic</a> CRS
  of all items in this <code>CommonCRS</code> enumeration.</p></div>
 <dl class="notes">
 <dt>Parameters:</dt>
 <dd><code>latitude</code> - a latitude in the desired UTM or UPS projection zone.</dd>
 <dd><code>longitude</code> - a longitude in the desired UTM or UPS projection zone.</dd>
 <dt>Returns:</dt>
 <dd>a Universal Transverse Mercator or Polar Stereographic projection for the zone containing the given point.</dd>
 <dt>Since:</dt>
 <dd>0.8</dd>
 </dl>
 </section>
 </li>
 </ul>
 </section>
 </li>
 </ul>
 </section>
 <!-- ========= END OF CLASS DATA ========= -->
 </main>
 </div>
 </div>
 </body>
 </html>