| 1 | // License: GPL. For details, see LICENSE file.
|
|---|
| 2 | package org.openstreetmap.josm.data.projection;
|
|---|
| 3 |
|
|---|
| 4 | import java.io.BufferedReader;
|
|---|
| 5 | import java.io.IOException;
|
|---|
| 6 | import java.io.InputStream;
|
|---|
| 7 | import java.io.InputStreamReader;
|
|---|
| 8 | import java.nio.charset.StandardCharsets;
|
|---|
| 9 | import java.util.ArrayList;
|
|---|
| 10 | import java.util.Collection;
|
|---|
| 11 | import java.util.Collections;
|
|---|
| 12 | import java.util.HashMap;
|
|---|
| 13 | import java.util.HashSet;
|
|---|
| 14 | import java.util.LinkedHashMap;
|
|---|
| 15 | import java.util.List;
|
|---|
| 16 | import java.util.Locale;
|
|---|
| 17 | import java.util.Map;
|
|---|
| 18 | import java.util.Set;
|
|---|
| 19 | import java.util.regex.Matcher;
|
|---|
| 20 | import java.util.regex.Pattern;
|
|---|
| 21 |
|
|---|
| 22 | import org.openstreetmap.josm.Main;
|
|---|
| 23 | import org.openstreetmap.josm.data.coor.EastNorth;
|
|---|
| 24 | import org.openstreetmap.josm.data.coor.LatLon;
|
|---|
| 25 | import org.openstreetmap.josm.data.projection.datum.Datum;
|
|---|
| 26 | import org.openstreetmap.josm.data.projection.datum.GRS80Datum;
|
|---|
| 27 | import org.openstreetmap.josm.data.projection.datum.NTV2GridShiftFileWrapper;
|
|---|
| 28 | import org.openstreetmap.josm.data.projection.datum.SevenParameterDatum;
|
|---|
| 29 | import org.openstreetmap.josm.data.projection.datum.ThreeParameterDatum;
|
|---|
| 30 | import org.openstreetmap.josm.data.projection.datum.WGS84Datum;
|
|---|
| 31 | import org.openstreetmap.josm.data.projection.proj.ClassProjFactory;
|
|---|
| 32 | import org.openstreetmap.josm.data.projection.proj.DoubleStereographic;
|
|---|
| 33 | import org.openstreetmap.josm.data.projection.proj.LambertConformalConic;
|
|---|
| 34 | import org.openstreetmap.josm.data.projection.proj.LonLat;
|
|---|
| 35 | import org.openstreetmap.josm.data.projection.proj.Mercator;
|
|---|
| 36 | import org.openstreetmap.josm.data.projection.proj.Proj;
|
|---|
| 37 | import org.openstreetmap.josm.data.projection.proj.ProjFactory;
|
|---|
| 38 | import org.openstreetmap.josm.data.projection.proj.SwissObliqueMercator;
|
|---|
| 39 | import org.openstreetmap.josm.data.projection.proj.TransverseMercator;
|
|---|
| 40 | import org.openstreetmap.josm.gui.preferences.projection.ProjectionChoice;
|
|---|
| 41 | import org.openstreetmap.josm.gui.preferences.projection.ProjectionPreference;
|
|---|
| 42 | import org.openstreetmap.josm.io.CachedFile;
|
|---|
| 43 | import org.openstreetmap.josm.tools.Utils;
|
|---|
| 44 |
|
|---|
| 45 | /**
|
|---|
| 46 | * Class to handle projections
|
|---|
| 47 | *
|
|---|
| 48 | */
|
|---|
| 49 | public final class Projections {
|
|---|
| 50 |
|
|---|
| 51 | /**
|
|---|
| 52 | * Class to hold information about one projection.
|
|---|
| 53 | */
|
|---|
| 54 | public static class ProjectionDefinition {
|
|---|
| 55 | public String code;
|
|---|
| 56 | public String name;
|
|---|
| 57 | public String definition;
|
|---|
| 58 |
|
|---|
| 59 | public ProjectionDefinition(String code, String name, String definition) {
|
|---|
| 60 | this.code = code;
|
|---|
| 61 | this.name = name;
|
|---|
| 62 | this.definition = definition;
|
|---|
| 63 | }
|
|---|
| 64 | }
|
|---|
| 65 |
|
|---|
| 66 | private static final Set<String> allCodes = new HashSet<>();
|
|---|
| 67 | private static final Map<String, ProjectionChoice> allProjectionChoicesByCode = new HashMap<>();
|
|---|
| 68 | private static final Map<String, Projection> projectionsByCode_cache = new HashMap<>();
|
|---|
| 69 |
|
|---|
| 70 | /*********************************
|
|---|
| 71 | * Registry for custom projection
|
|---|
| 72 | *
|
|---|
| 73 | * should be compatible to PROJ.4
|
|---|
| 74 | */
|
|---|
| 75 | static final Map<String, ProjFactory> projs = new HashMap<>();
|
|---|
| 76 | static final Map<String, Ellipsoid> ellipsoids = new HashMap<>();
|
|---|
| 77 | static final Map<String, Datum> datums = new HashMap<>();
|
|---|
| 78 | static final Map<String, NTV2GridShiftFileWrapper> nadgrids = new HashMap<>();
|
|---|
| 79 | static final Map<String, ProjectionDefinition> inits;
|
|---|
| 80 |
|
|---|
| 81 | static {
|
|---|
| 82 | registerBaseProjection("lonlat", LonLat.class, "core");
|
|---|
| 83 | registerBaseProjection("josm:smerc", Mercator.class, "core");
|
|---|
| 84 | registerBaseProjection("lcc", LambertConformalConic.class, "core");
|
|---|
| 85 | registerBaseProjection("somerc", SwissObliqueMercator.class, "core");
|
|---|
| 86 | registerBaseProjection("tmerc", TransverseMercator.class, "core");
|
|---|
| 87 | registerBaseProjection("sterea", DoubleStereographic.class, "core");
|
|---|
| 88 |
|
|---|
| 89 | ellipsoids.put("airy", Ellipsoid.Airy);
|
|---|
| 90 | ellipsoids.put("mod_airy", Ellipsoid.AiryMod);
|
|---|
| 91 | ellipsoids.put("aust_SA", Ellipsoid.AustSA);
|
|---|
| 92 | ellipsoids.put("bessel", Ellipsoid.Bessel1841);
|
|---|
| 93 | ellipsoids.put("bess_nam", Ellipsoid.BesselNamibia);
|
|---|
| 94 | ellipsoids.put("clrk66", Ellipsoid.Clarke1866);
|
|---|
| 95 | ellipsoids.put("clrk80", Ellipsoid.Clarke1880);
|
|---|
| 96 | ellipsoids.put("clarkeIGN", Ellipsoid.ClarkeIGN);
|
|---|
| 97 | ellipsoids.put("evrstSS", Ellipsoid.EverestSabahSarawak);
|
|---|
| 98 | ellipsoids.put("intl", Ellipsoid.Hayford);
|
|---|
| 99 | ellipsoids.put("helmert", Ellipsoid.Helmert);
|
|---|
| 100 | ellipsoids.put("krass", Ellipsoid.Krassowsky);
|
|---|
| 101 | ellipsoids.put("GRS67", Ellipsoid.GRS67);
|
|---|
| 102 | ellipsoids.put("GRS80", Ellipsoid.GRS80);
|
|---|
| 103 | ellipsoids.put("WGS66", Ellipsoid.WGS66);
|
|---|
| 104 | ellipsoids.put("WGS72", Ellipsoid.WGS72);
|
|---|
| 105 | ellipsoids.put("WGS84", Ellipsoid.WGS84);
|
|---|
| 106 |
|
|---|
| 107 | datums.put("WGS84", WGS84Datum.INSTANCE);
|
|---|
| 108 | datums.put("GRS80", GRS80Datum.INSTANCE);
|
|---|
| 109 | datums.put("NAD83", GRS80Datum.INSTANCE);
|
|---|
| 110 | datums.put("carthage", new ThreeParameterDatum(
|
|---|
| 111 | "Carthage 1934 Tunisia", "carthage",
|
|---|
| 112 | Ellipsoid.Clarke1880, -263.0, 6.0, 431.0));
|
|---|
| 113 | datums.put("GGRS87", new ThreeParameterDatum(
|
|---|
| 114 | "Greek Geodetic Reference System 1987", "GGRS87",
|
|---|
| 115 | Ellipsoid.GRS80, -199.87, 74.79, 246.62));
|
|---|
| 116 | datums.put("hermannskogel", new ThreeParameterDatum(
|
|---|
| 117 | "Hermannskogel", "hermannskogel",
|
|---|
| 118 | Ellipsoid.Bessel1841, 653.0, -212.0, 449.0));
|
|---|
| 119 | datums.put("ire65", new SevenParameterDatum(
|
|---|
| 120 | "Ireland 1965", "ire65",
|
|---|
| 121 | Ellipsoid.AiryMod, 482.530, -130.596, 564.557, -1.042, -0.214, -0.631, 8.15));
|
|---|
| 122 | datums.put("nzgd49", new SevenParameterDatum(
|
|---|
| 123 | "New Zealand Geodetic Datum 1949", "nzgd49",
|
|---|
| 124 | Ellipsoid.Hayford, 59.47, -5.04, 187.44, 0.47, -0.1, 1.024, -4.5993));
|
|---|
| 125 | datums.put("OSGB36", new SevenParameterDatum(
|
|---|
| 126 | "Airy 1830", "OSGB36",
|
|---|
| 127 | Ellipsoid.Airy, 446.448, -125.157, 542.060, 0.1502, 0.2470, 0.8421, -20.4894));
|
|---|
| 128 | datums.put("potsdam", new SevenParameterDatum(
|
|---|
| 129 | "Potsdam Rauenberg 1950 DHDN", "potsdam",
|
|---|
| 130 | Ellipsoid.Bessel1841, 598.1, 73.7, 418.2, 0.202, 0.045, -2.455, 6.7));
|
|---|
| 131 |
|
|---|
| 132 | nadgrids.put("BETA2007.gsb", NTV2GridShiftFileWrapper.BETA2007);
|
|---|
| 133 | nadgrids.put("ntf_r93_b.gsb", NTV2GridShiftFileWrapper.ntf_rgf93);
|
|---|
| 134 |
|
|---|
| 135 | List<ProjectionDefinition> pds;
|
|---|
| 136 | try {
|
|---|
| 137 | pds = loadProjectionDefinitions("resource://data/projection/custom-epsg");
|
|---|
| 138 | } catch (IOException ex) {
|
|---|
| 139 | throw new RuntimeException(ex);
|
|---|
| 140 | }
|
|---|
| 141 | inits = new LinkedHashMap<>();
|
|---|
| 142 | for (ProjectionDefinition pd : pds) {
|
|---|
| 143 | inits.put(pd.code, pd);
|
|---|
| 144 | }
|
|---|
| 145 |
|
|---|
| 146 | for (ProjectionChoice pc : ProjectionPreference.getProjectionChoices()) {
|
|---|
| 147 | for (String code : pc.allCodes()) {
|
|---|
| 148 | allProjectionChoicesByCode.put(code, pc);
|
|---|
| 149 | }
|
|---|
| 150 | }
|
|---|
| 151 | allCodes.addAll(inits.keySet());
|
|---|
| 152 | allCodes.addAll(allProjectionChoicesByCode.keySet());
|
|---|
| 153 | }
|
|---|
| 154 |
|
|---|
| 155 | private Projections() {
|
|---|
| 156 | // Hide default constructor for utils classes
|
|---|
| 157 | }
|
|---|
| 158 |
|
|---|
| 159 | public static EastNorth project(LatLon ll) {
|
|---|
| 160 | if (ll == null) return null;
|
|---|
| 161 | return Main.getProjection().latlon2eastNorth(ll);
|
|---|
| 162 | }
|
|---|
| 163 |
|
|---|
| 164 | public static LatLon inverseProject(EastNorth en) {
|
|---|
| 165 | if (en == null) return null;
|
|---|
| 166 | return Main.getProjection().eastNorth2latlon(en);
|
|---|
| 167 | }
|
|---|
| 168 |
|
|---|
| 169 | /**
|
|---|
| 170 | * Plugins can register additional base projections.
|
|---|
| 171 | *
|
|---|
| 172 | * @param id The "official" PROJ.4 id. In case the projection is not supported
|
|---|
| 173 | * by PROJ.4, use some prefix, e.g. josm:myproj or gdal:otherproj.
|
|---|
| 174 | * @param fac The base projection factory.
|
|---|
| 175 | * @param origin Multiple plugins may implement the same base projection.
|
|---|
| 176 | * Provide plugin name or similar string, so it be differentiated.
|
|---|
| 177 | */
|
|---|
| 178 | public static void registerBaseProjection(String id, ProjFactory fac, String origin) {
|
|---|
| 179 | projs.put(id, fac);
|
|---|
| 180 | }
|
|---|
| 181 |
|
|---|
| 182 | public static void registerBaseProjection(String id, Class<? extends Proj> projClass, String origin) {
|
|---|
| 183 | registerBaseProjection(id, new ClassProjFactory(projClass), origin);
|
|---|
| 184 | }
|
|---|
| 185 |
|
|---|
| 186 | public static Proj getBaseProjection(String id) {
|
|---|
| 187 | ProjFactory fac = projs.get(id);
|
|---|
| 188 | if (fac == null) return null;
|
|---|
| 189 | return fac.createInstance();
|
|---|
| 190 | }
|
|---|
| 191 |
|
|---|
| 192 | public static Ellipsoid getEllipsoid(String id) {
|
|---|
| 193 | return ellipsoids.get(id);
|
|---|
| 194 | }
|
|---|
| 195 |
|
|---|
| 196 | public static Datum getDatum(String id) {
|
|---|
| 197 | return datums.get(id);
|
|---|
| 198 | }
|
|---|
| 199 |
|
|---|
| 200 | public static NTV2GridShiftFileWrapper getNTV2Grid(String id) {
|
|---|
| 201 | return nadgrids.get(id);
|
|---|
| 202 | }
|
|---|
| 203 |
|
|---|
| 204 | /**
|
|---|
| 205 | * Get the projection definition string for the given id.
|
|---|
| 206 | * @param id the id
|
|---|
| 207 | * @return the string that can be processed by #{link CustomProjection}.
|
|---|
| 208 | * Null, if the id isn't supported.
|
|---|
| 209 | */
|
|---|
| 210 | public static String getInit(String id) {
|
|---|
| 211 | ProjectionDefinition pd = inits.get(id.toUpperCase(Locale.ENGLISH));
|
|---|
| 212 | if (pd == null) return null;
|
|---|
| 213 | return pd.definition;
|
|---|
| 214 | }
|
|---|
| 215 |
|
|---|
| 216 | /**
|
|---|
| 217 | * Load projection definitions from file.
|
|---|
| 218 | *
|
|---|
| 219 | * @param path the path
|
|---|
| 220 | * @return projection definitions
|
|---|
| 221 | * @throws IOException in case of I/O error
|
|---|
| 222 | */
|
|---|
| 223 | public static List<ProjectionDefinition> loadProjectionDefinitions(String path) throws IOException {
|
|---|
| 224 | try (
|
|---|
| 225 | InputStream in = new CachedFile(path).getInputStream();
|
|---|
| 226 | BufferedReader r = new BufferedReader(new InputStreamReader(in, StandardCharsets.UTF_8));
|
|---|
| 227 | ) {
|
|---|
| 228 | return loadProjectionDefinitions(r);
|
|---|
| 229 | }
|
|---|
| 230 | }
|
|---|
| 231 |
|
|---|
| 232 | /**
|
|---|
| 233 | * Load projection definitions from file.
|
|---|
| 234 | *
|
|---|
| 235 | * @param r the reader
|
|---|
| 236 | * @return projection definitions
|
|---|
| 237 | * @throws IOException in case of I/O error
|
|---|
| 238 | */
|
|---|
| 239 | public static List<ProjectionDefinition> loadProjectionDefinitions(BufferedReader r) throws IOException {
|
|---|
| 240 | List<ProjectionDefinition> result = new ArrayList<>();
|
|---|
| 241 | Pattern epsgPattern = Pattern.compile("<(\\d+)>(.*)<>");
|
|---|
| 242 | String line, lastline = "";
|
|---|
| 243 | while ((line = r.readLine()) != null) {
|
|---|
| 244 | line = line.trim();
|
|---|
| 245 | if (!line.startsWith("#") && !line.isEmpty()) {
|
|---|
| 246 | if (!lastline.startsWith("#")) throw new AssertionError("EPSG file seems corrupted");
|
|---|
| 247 | String name = lastline.substring(1).trim();
|
|---|
| 248 | Matcher m = epsgPattern.matcher(line);
|
|---|
| 249 | if (m.matches()) {
|
|---|
| 250 | String code = "EPSG:" + m.group(1);
|
|---|
| 251 | String definition = m.group(2).trim();
|
|---|
| 252 | result.add(new ProjectionDefinition(code, name, definition));
|
|---|
| 253 | } else {
|
|---|
| 254 | Main.warn("Failed to parse line from the EPSG projection definition: "+line);
|
|---|
| 255 | }
|
|---|
| 256 | }
|
|---|
| 257 | lastline = line;
|
|---|
| 258 | }
|
|---|
| 259 | return result;
|
|---|
| 260 | }
|
|---|
| 261 |
|
|---|
| 262 | public static Projection getProjectionByCode(String code) {
|
|---|
| 263 | Projection proj = projectionsByCode_cache.get(code);
|
|---|
| 264 | if (proj != null) return proj;
|
|---|
| 265 | ProjectionChoice pc = allProjectionChoicesByCode.get(code);
|
|---|
| 266 | if (pc != null) {
|
|---|
| 267 | Collection<String> pref = pc.getPreferencesFromCode(code);
|
|---|
| 268 | pc.setPreferences(pref);
|
|---|
| 269 | try {
|
|---|
| 270 | proj = pc.getProjection();
|
|---|
| 271 | } catch (Exception e) {
|
|---|
| 272 | String cause = e.getMessage();
|
|---|
| 273 | Main.warn("Unable to get projection "+code+" with "+pc + (cause != null ? ". "+cause : ""));
|
|---|
| 274 | }
|
|---|
| 275 | }
|
|---|
| 276 | if (proj == null) {
|
|---|
| 277 | ProjectionDefinition pd = inits.get(code);
|
|---|
| 278 | if (pd == null) return null;
|
|---|
| 279 | proj = new CustomProjection(pd.name, code, pd.definition, null);
|
|---|
| 280 | }
|
|---|
| 281 | projectionsByCode_cache.put(code, proj);
|
|---|
| 282 | return proj;
|
|---|
| 283 | }
|
|---|
| 284 |
|
|---|
| 285 | public static Collection<String> getAllProjectionCodes() {
|
|---|
| 286 | return Collections.unmodifiableCollection(allCodes);
|
|---|
| 287 | }
|
|---|
| 288 |
|
|---|
| 289 | private static String listKeys(Map<String, ?> map) {
|
|---|
| 290 | List<String> keys = new ArrayList<>(map.keySet());
|
|---|
| 291 | Collections.sort(keys);
|
|---|
| 292 | return Utils.join(", ", keys);
|
|---|
| 293 | }
|
|---|
| 294 |
|
|---|
| 295 | /**
|
|---|
| 296 | * Replies the list of projections as string (comma separated).
|
|---|
| 297 | * @return the list of projections as string (comma separated)
|
|---|
| 298 | * @since 8533
|
|---|
| 299 | */
|
|---|
| 300 | public static String listProjs() {
|
|---|
| 301 | return listKeys(projs);
|
|---|
| 302 | }
|
|---|
| 303 |
|
|---|
| 304 | /**
|
|---|
| 305 | * Replies the list of ellipsoids as string (comma separated).
|
|---|
| 306 | * @return the list of ellipsoids as string (comma separated)
|
|---|
| 307 | * @since 8533
|
|---|
| 308 | */
|
|---|
| 309 | public static String listEllipsoids() {
|
|---|
| 310 | return listKeys(ellipsoids);
|
|---|
| 311 | }
|
|---|
| 312 |
|
|---|
| 313 | /**
|
|---|
| 314 | * Replies the list of datums as string (comma separated).
|
|---|
| 315 | * @return the list of datums as string (comma separated)
|
|---|
| 316 | * @since 8533
|
|---|
| 317 | */
|
|---|
| 318 | public static String listDatums() {
|
|---|
| 319 | return listKeys(datums);
|
|---|
| 320 | }
|
|---|
| 321 |
|
|---|
| 322 | /**
|
|---|
| 323 | * Replies the list of nadgrids as string (comma separated).
|
|---|
| 324 | * @return the list of nadgrids as string (comma separated)
|
|---|
| 325 | * @since 8533
|
|---|
| 326 | */
|
|---|
| 327 | public static String listNadgrids() {
|
|---|
| 328 | return listKeys(nadgrids);
|
|---|
| 329 | }
|
|---|
| 330 | }
|
|---|