JOSM/Plugins/josmtiff

From OpenStreetMap Wiki
Jump to navigation Jump to search
  • JOSM/Plugins/josmtiff
  • In other languages

josmtiff is a plugin for JOSM that imports a georeferenced TIFF image and displays it as a background layer. It is intended for local GeoTIFF imagery that already uses WGS 84 geographic coordinates (EPSG:4326).

A GeoTIFF displayed as a background layer in JOSM.

Features

  • Opens files with the .tif and .tiff extensions.
  • Reads georeferencing from GeoTIFF ModelTiepoint and ModelPixelScale tags, or from a ModelTransformation tag.
  • Places the image according to its geographic bounds and updates the layer bounds when the JOSM map projection changes.
  • Adds the imported image as a background layer, so JOSM's standard layer visibility and opacity controls can be used.
  • Checks the coordinate reference system before importing.
  • Warns before loading files of 200 MB or larger.

Installation

The plugin requires JOSM version 19044 or newer.

From JOSM's plugin manager

  1. Open JOSM.
  2. Select Edit -> Preferences -> Plugins.
  3. Click Download list, search for josmtiff, and select it.
  4. Confirm the changes and restart JOSM if requested.
Selecting josmtiff in JOSM's plugin preferences.

Manual installation

If the plugin is not yet available in the plugin manager, download josmtiff.jar from the latest GitHub release and copy it to the JOSM plugins directory. Restart JOSM afterwards.

See Manually install JOSM plugins for the plugin-directory location on each operating system.

Usage

  1. Open JOSM and load or download the OSM data for the area covered by the image.
  2. Select Imagery -> Import GeoTIFF.
  3. Choose a georeferenced .tif or .tiff file.
  4. The image is added to the Layers panel as a background layer named after the source file.
  5. Use the standard controls in the Layers panel to change its visibility or opacity.
The Import GeoTIFF command in the Imagery menu.

Supported coordinate reference system

The current version supports only geographic WGS 84 coordinates, identified as EPSG:4326. The file must also contain GeoTIFF georeferencing tags.

For a GeoTIFF in another coordinate reference system, reproject it before importing. For example, with GDAL: 

gdalwarp -t_srs EPSG:4326 input.tif output_4326.tif
The message shown when a GeoTIFF uses an unsupported coordinate reference system.

Limitations

  • Coordinate reference systems other than EPSG:4326 are not currently supported.
  • A TIFF without GeoTIFF georeferencing tags cannot be positioned and is rejected.
  • The complete raster is decoded into memory. Large or very high-resolution files can take a long time to load and may require additional Java heap memory.
  • The imported layer is for display as a background; the plugin does not modify or export the source GeoTIFF.

Troubleshooting

The plugin reports an unsupported coordinate system
Reproject the file to EPSG:4326, for example with the gdalwarp command shown above.
The plugin reports that the file is not georeferenced
Confirm that the file is a GeoTIFF rather than an ordinary TIFF. It must contain ModelTiepoint and ModelPixelScale tags, or a ModelTransformation tag.
Importing is slow or JOSM runs out of memory
Create a smaller cropped raster, reduce its resolution, or start JOSM with a larger Java heap. Files of 200 MB or larger trigger a confirmation dialog before decoding.

Links

Retrieved from "https://wiki.openstreetmap.org/w/index.php?title=JOSM/Plugins/josmtiff&oldid=3064227"