openjump

OpenJUMP, the Open Source GIS which has more than one trick in its kangaroo pocket, "jumps" from sourceforge to github to help you as never.

ANNOUNCEMENT
This is the final release of the long lasting OJ version 1.x series.

The next release will introduce backward incompatible changes that'll
initially break all unmodified extensions/plugins. So enjoy this one and
look forward to OJ2 developed in a Git-repo using the latest locationtech JTS.

OpenJUMP ReadMe file

Version 1.16 release rev.6669

3. January 2021

Contents

1. Licensing

2. Installation instructions

3. Running OpenJUMP

4. Support

5. OpenJUMP history

6. Credits

7. Latest changes

8. Licensing

OpenJUMP is distributed under the GNU General Public License version 2 (GPLv2).
The license text can be found in the file "licenses/gpl-2.txt".

OpenJUMP uses and distributes the following (in alphabetical order) formatted
as (Component name - License name - License file in "licenses/" folder or link)
BeanShell - LGPL2.1 - lgpl-2.1.txt
Buoy Framework - Public Domain
Code2000 Unicode font - GPL2 - gpl-2.txt
Commons Codec, Compress, Imaging, IO, Lang, Logging

• Apache License Version 2.0 - apache_license-2.0.txt
  CTS - GNU Lesser General Public License (GNU LGPL)
  Extensible-TIFF-JAI (xtiff jai) - MIT License - MIT-license.txt
  Icons (some original or based fully or in part on the following)
  FAMFAMFAM Silk by http://www.famfamfam.com - CC BY 2.5
  • http://creativecommons.org/licenses/by/2.5/
    Fugue by Yusuke Kamiyamane http://p.yusukekamiyamane.com - CC BY 3.0
  • http://creativecommons.org/licenses/by/3.0/
    OJ icon v3 and others by Edgar Soldin http://soldin.de - GPL2 - gpl-2.txt
    [ok|ko]_pg.png PostgreSQL icon - Trademark Policy
  • https://wiki.postgresql.org/wiki/Trademark_Policy
    [ok|ko]_mariadb.png MariaDB icon - MariaDB Branding Guidelines
  • https://mariadb.com/kb/en/mariadb/branding-guidelines/
    ok_spatialite.png Spatialite icon, dolphin_icon.png (Edgar Soldin)
  • GPL3 - gpl-3.txt
    JAI core, codec - Java Advanced Imaging Distribution License - jdl-jai.pdf
    JAI imageio core - BSD style license - jai-core.BSD-LICENSE.txt
    jai-imageio-core (standalone) - BSD 3-style with nuclear exception
• jai-imageio-core-LICENSE.txt
  JAMA - Public Domain
  Jdom - Apache-style open source jdom license, with the acknowledgment
  clause removed - jdom_license.txt
  JMath and its successor projects JMathTools (IO,Plot,Array)
• BSD license - jmath_license.txt
  Javascript library RHINO - GPL2 - gpl-2.txt
  JSON-simple - Apache License Version 2.0 - apache_license-2.0.txt
  JTS Topology Suite - LGPL2 - lgpl-2.1.txt
  JUnit - Eclipse Public License v1.0 - epl-v10.txt
  Jython - Jython license - jython_license.txt
  Log4J - Apache License Version 2.0 - apache_license-2.0.txt
  Logo
  Splash Logo designed by Paola Zanetti (paoladorileogmail.com)
  Vertical Design used in the installer by Stefan Steiniger 2012
  Netbeans swing outline - Apache License Version 2.0 - apache_license-2.0.txt
  Postgresql JDBC driver - Postgresql BSD license - postgresql-BSD_license.txt
  Simple Logging Facade for Java (SLF4J) - MIT License - MIT-license.txt
  lib/slf4j-api-.jar,slf4j-api-.jar
  Xerces2 Java Parser - Apache License Version 2.0 - apache_license-2.0.txt
  XZ for Java - Public Domain
  Outline Swing Component by Netbeans.org, GPL2 - gpl-2.txt

and the following plugins
( Component name - License name - License file in "licenses/" folder
list of files and dependencies with license if any )
Oracle Datastore (Nicolas Ribot) - GPL2 - gpl-2.txt
SkyPrinter - GPL2 - gpl-2.txt
SkyPrinterPlugIn-.jar
itext-.jar - LGPL2.1 - lgpl-2.1.txt

Additionally PLUS distribution contains
( Component name (Author) - License name - License file in "licenses/" folder
list of files and dependencies with license if any )
Batik SVG Toolkit - Apache License Version 2.0 - apache_license-2.0.txt
ECW and JPEG2000 Read Support based on ECW SDK 3.3 for
Windows x86/x64, Linux, Mac OSX with 32bit java runtime -
ERDAS ECW JPEG2000 SDK license - ecw license.txt
lib/native/[os/]{jecw-.jar,NCS.dll,ermapper.jar}
Geoarbores Vertex Symbols Collection (Giuseppe Aruta) - GPL2 - gpl-2.txt
lib/ext/VertexImages/.wkt
ImageIO Ext - LGPL3 - lgpl-3.0.txt (imageio-ext-tiff removed)
except the following dependencies/components:
commons-codec, commons-io, commons-lang, commons-logging (see above)
imageio-ext-streams - partly LGPL2 or 3 - imageio-ext-streams-LICENSE.txt
imageio-ext-tiff - BSD style license - imageio-ext-tiff-BSD-LICENSE.txt
imageio-ext-imagereadmt - BSD style license -
imageio-ext-imagereadmt-BSD-LICENSE.txt
turbojpeg-wrapper - BSD style license - LICENSE.libjpegturbo.txt
JEdit (1999) - GPL2 - gpl-2.txt
JGraphT - LGPL2 - lgpl-2.1.txt
lib/jgrapht-.jar
Postgis driver (postgis-.jar) - LGPL2 - lgpl-2.1.txt
MariaDB Connector/J (mariadb-java-client-.jar) - LGPL2 - lgpl-2.1.txt
MySQL Connector/J (mysql-connector-java--bin.jar) - GPL2 - gpl-2.txt
Xerial SQLite JDBC driver (sqlite-jdbc-.jar) - apache_license-2.0.txt

and the following plugins
Aggregation PlugIn (Micha雔 Michaud) - GPL2 - gpl-2.txt
aggregation-.jar
BeanShell Editor (Micha雔 Michaud) - GPL2 - gpl-2.txt
bsheditor4jump-.jar, buoy.jar(see above)
CAD Tools (Giuseppe Aruta) - GPL3 - gpl-3.0.txt
CadTools-.jar
CSV driver (Micha雔 Michaud) - GPL2 - gpl-2.txt
csv-driver-.jar
Concave Hull (Eric Grosso) - LGPL2.1, GPL2 - lgpl-2.1.txt, gpl-2.txt
ConcaveHull*.{jar,txt}
CTS extension (Micha雔 Michaud) - GPL2 - gpl-2.txt
CTS-PlugIn-.jar,
lib/cts-.jar - LGPL3 - lgpl-3.0.txt
SLF4J (see above)
DXF driver (Micha雔 Michaud) - GPL2 - gpl-2.txt
driver-dxf-.jar
Five Color Map Coloring (Larry Reeder) - GPL3 - gpl-3.0.txt
SLF4J (see above), JGraphT (see above)
Graph Extension (Micha雔 Michaud) - GPL2 - gpl-2.txt
graph-toolbox-.jar, lib/jump-jgrapht-.jar
JGraphT (see above)
Jump Chart (com.cadplan.jump) - GPL2 - gpl-2.txt
JumpChart.jar
JUMP DB Query Plugin (Larry Reeder) - GPL3 - gpl-3.0.txt
jumpdbquery-.jar, dbquery.properties
jsyntaxpane-.jar - Apache License Version 2.0 - apache_license-2.0.txt
gt2-oracle-spatial-.jar - LGPL2.1 - lgpl-2.1.txt
mysql-connector-java-.jar - GPL2 - gpl-2.txt
sqlite-jdbc-.jar - Apache License Version 2.0 - apache_license-2.0.txt
Jump Fill Pattern (com.cadplan.jump) - GPL2 - gpl-2.txt
JumpFillPattern.jar
KML Driver (skyjump) - GPL2 - gpl-2.txt
kml-driver-.jar
Matching (Micha雔 Michaud) - GPL2 - gpl-2.txt
matching-.jar
utils-.jar
Measure Toolbox (Giuseppe Aruta) - GPL3 - gpl-3.0.txt
MeasureToolbox_.jar
OpenKLEM (Geomatica) - GPL2 - gpl-2.0.txt
topographic and hydrological analysis
OpenKLEM-.jar
OpenKLEMOJ-.jar
OSM Driver (Stefan Steiniger) - GPL2 - gpl-2.txt
oj_osm_reader_v*.jar
Printer (com.cadplan.jump) - GPL2 - gpl-2.txt
jumpPrinter.jar (needs Vertex Symbols extension)
itext-.jar - LGPL2.1 - lgpl-2.1.txt
Pirol Csv Dataset
(de.fhOsnabrueck.jump.pirol.datasources.pirolCSV) - GPL2 - gpl-2.txt
PirolCsv.jar, pbaseClasses.jar
SetAttributes (Micha雔 Michaud) - GPL2 - gpl-2.txt
SetAttributes-.jar
jaxb/jaxb-.jar
Sextante Tools (es.unex.sextante.openjump.extensions) - GPL3 - gpl-3.0.txt
sextante-binding-.jar, sextante/.*
Sextante algorithms (www.scolab.es) - GPL3 - gpl-3.0.txt
sextante_new_algorithms.jar
TableLayout-.jar - Clearthought License - clearthought-2.0.txt
xbean-.jar - Apache License Version 2.0 - apache_license-2.0.txt
Topology Extension (Micha雔 Michaud) - GPL2 - gpl-2.txt
topology-.jar
Vertex Note (com.cadplan.jump) - GPL2 - gpl-2.txt
Vertex Symbols (com.cadplan.jump) - GPL2 - gpl-2.txt
VertexSymbols.jar
itext-.jar - LGPL2.1 - lgpl-2.1.txt
View Manager Extension (Micha雔 Michaud) - GPL2 - gpl-2.txt
ViewManager-.jar
jaxb/jaxb-.jar
WFS Plugin
commons-httpclient-3.1.jar
deegree2-core-2.6-pre2-20140511.220246-596.jar
jaxen-1.1.1.jar
vecmath-1.5.2.jar

2. Installation instructions

Try the shiny installers
OpenJUMP-Installer-.exe (for windows)
OpenJUMP-Installer-.jar (for linux & mac)
Or
Extract the portable zip file distribution.
OpenJUMP-Portable-*.zip

3. Running OpenJUMP

To start OpenJUMP run the launcher for your platform from the
/bin directory.

• On Windows, double-click on oj_windows.bat or OpenJUMP.exe
• On Linux/Unix, launch oj_linux.sh
• On MacOSX, launch oj_mac.command or OpenJUMP.app

Additionally, if you used the installer you should have

• On Windows, a start menu entry.
• On Linux, a link on the desktop.
• On MacOSX, a self contained app on the desktop.
  Move it to 'Applications' folder if you like.

Further information can be found in the OJ wiki: http://ojwiki.soldin.de

Startup/Command line options

Several startup options are available, either for the Java Virtual Machine,
or for the OpenJUMP application. To change them, edit the startup script
accordingly. The scripts contain documentation comments, don't be afraid.

Useful Java VM options
-Xms defines the allocated memory for the virtual machine at startup.
Example: -Xms256M will allocate 256M of memory for OpenJUMP
-Xmx defines the maximum allocated memory for the virtual machine.
Example: -Xmx256M
-Dproperty=value set a jvm system property.

OpenJUMP command line syntax:

oj_starter -option ... <[data|project]_file>...

OpenJUMP options:

-default-plugins <file.xml>
Specifies the configuration file of a standard set of functions realized
as plugins. For example almost all functions of the "Tools" menu.
This is configured as
-default-plugins bin\default-plugins.xml

-h, -help
show the help information

-i18n
Overrides the operating systems default locale setting (language,
number format etc.) For example:
- For starting OpenJUMP in French: use -i18n fr
- languages available (09/2011):
cz (czech)
de (german)
en (english)
es (spanish)
fi (finnish)
fr (french)
hu (hungarian)
it (italian)
ja_JP (japanese)
ml (malayalam)
pt (portuguese)
pt_BR (brazilian portuguese)
ta_IN (indian tamil)
te (telugu)
zh_CN (chinese simplified)
zh_HK (chinese Hong Kong)
ATTENTION: If the specified language is not available then
the language used is english (en).

-plug-in-directory
Sets the location of the plugin directory.
Default: JUMP_HOME/lib/ext

-project <path/project.jmp>
DEPRECATED: simply add the path as mentioned in the syntax above
Open a project located on the file system at starting time

-properties <file.xml>
specifies the file where OpenJUMP persistent properties are stored.
See Wiki article "How to use a plugin with a properties file in ECLIPSE".
Default: JUMP_HOME\bin\workbench-properties.xml

-state <some/folder>
specifies the folder where OpenJUMP stores data between executions
(workbench-state.xml).
Default: JUMP_HOME or SETTINGS_HOME

-v, -version
show version information

4. Support

for a general overview visit
www.openjump.org - the OpenJUMP web site
jump-pilot.sourceforge.net - alternative domain to the above
for support
consult the OJ wiki
http://ojwiki.soldin.de
use mailing list or trackers
http://ojwiki.soldin.de/index.php?title=OpenJUMP_Support

For commercial support, e.g. paid plugin development, contact the developer
mailing list http://lists.sourceforge.net/lists/listinfo/jump-pilot-devel .

5. OpenJUMP history

OpenJUMP is a "fork" of the JUMP "Java Unified Mapping Platform" software,
developed by Vividsolutions and released in 2003.
During 2004, some enthusiastic developers joined together to enhance further
the features of JUMP. They launched an independent development branch called
OpenJUMP. This name gives credit to the original JUMP development, and at the
same time describes the objectives of this project to be fully open to anyone
wanting to contribute.
Since May 2005 a complete development source is available at:
www.sourceforge.net/projects/jump-pilot

6. Credits

Many thanks to all the contributors of OpenJUMP for their time and efforts:

Original development team of JUMP was:
at Vividsolutions (www.vividsolutions.com)
Martin Davis
Jon Aquino
Alan Chang
at Refractions Research Inc (www.refractions.net)
David Blasby
Paul Ramsey

OpenJUMP project team (in alphabetical order):
Edgar Soldin (edso, http://soldin.de)
Giuseppe Aruta
Jukka Rahkonen
Micha雔 Michaud

Continuous or recent contributors (in alphabetical order):
Nicolas Ribot

Past contributors (in alphabetical order):
Alberto de Luca (geomaticaeambiente.it)
Andreas Schmitz (lat-lon.de)
Axel Orth
Basile Chandesris
Bing Ran
Eric Lemesre
Erwan Bocher
Ezequias Rodrigues da Rocha
Fco Lavin
Geoffrey G Roy
Hisaji Ono
Jaakko Ruutiainen
Jan Ruzicka
Joe Desbonet
John Clark
Jonathan Aquino
Kevin Neufeld
Landon Blake (Sunburned Surveyor)
Larry Becker (ISA.com)
Larry Reeder
Martin Davis (refractions.net)
Matthias Scholz
Mohammed Rashad
Ole Rahn
Paolo Rizzi
Paul Austin
Pedro Doria Meunier
Sascha Teichmann (intevation.de)
Stefan Steiniger (on hiatus)
Stephan Holl
Steve Tanner
Ugo Taddei
Uwe Dall黦e

Translation contributors are
Chinese: Elton Chan
Czech: Jan Ruzicka
English: Landon Blake
Finnish: Jukka Rahkonnen
French: Basile Chandesris, Erwan Bocher, Steve Tanner, Micha雔 Michaud
German: Florian Rengers, Stefan Steiniger, Edgar Soldin
Hungarian: Zoltan Siki
Italian: Giuseppe Aruta
Japanese: Hisaji Ono
Malayalam : Mohammed Rashad
Portuguese (brazilian):
Ezequias Rodrigues da Rocha,
Cristiano das Neves Almeida
Spanish:
Giuseppe Aruta, Steve Tanner, Fco Lavin,
Nacho Uve, Agustin Diez-Castillo
Tamil: Vikram Santhanam
Telugu: Ravi Vundavalli

Contributing projects and companies:

• Intevation GmbH
  Nightly Build process, collaborative PlugIn development (Print Layout PlugIn)
  contact: Jan Oliver Wagner/Stephan Holl
• Larry Becker and Robert Littlefield (SkyJUMP team)
  partly at Integrated Systems Analysts, Inc.
  for providing their Jump ISA tools code and numerous other improvements
• Lat/Lon GmbH (deeJUMP team)
  for providing some plugins and functionality (i.e. WFS and WMS Plugins)
  contact: Markus M黮ler/Andreas Schmitz
• Pirol Project from University of Applied Sciences Osnabr點k
  for providing the attribute editor. Note that the project is finished now.
  (contact: Arnd Kielhorn)
• VividSolutions Inc. & Refractions Inc.
  for support and answering the never ending stream of questions, especially:
  Martin Davis (now at Refractions Inc.)
  David Zwiers

others:

• L. Paul Chew for providing the Delaunay triangulation algorithm to
  create Voronoi diagrams

7. Latest changes

Version 1.16 release rev.6669 (released on 03. January 2021)

Announcement
This is the final release of the long lasting OJ version 1.x series.

The next release will introduce backward incompatible changes that'll
initially break all unmodified extensions/plugins. So enjoy this one and
look forward to OJ2 developed in a Git-repo using the latest locationtech JTS.

New Features

• Added RasterizePlugIn. A plugin to rasterize vector layer according to
  an attribute value and cell size (plugin located under Tools>Generate)
• Raster Pixel Inspection. Added capability to retrieve a set of pixel
  values in a table dragging on an area of the raster (like pixel inspector
  in ArcGIS) - currently limited to the first band
• Add an interiorBorder option to BasicStyle
• Added new tools in SextanteGIS :

• Under "DEM Processing" menu (Raster analisys)
  a) Map pits. Tool to map pits and sinks to verify the quality of a raster
  for hydrological analisys
  b) Remove single-cell pits. To remove single pits in order to speed sink
  filling of a DEM
  c) Remove sinks. Modified from "Sink Filling" Sextante tool, to solve
  a bug (Schr鰀er et al,, 2010, 6 International gvSIG Conference) and
  to speed the process
• Under "Rasterization and interpolation" menu
  d) Rasterize vector layer (2). Modified version of "Rasterize vector layer"
  to solve a bug on rasterize polygons

• EditOptionPanel : Added option to automatically open a feature attributes
  Info Frame after a new feature is created. Workaround to Feature request
  #245 "Create form to edit attribute values"
• CadTools Plugin version 0.9: added capability to load Python console and
  tools: added Align and Distribute selected features tools

Improvements

• reorder app exit handlers, do not run if exit is cancelled
• replaced MergeSelectedPolygonsWithNeighbourPlugIn by
  MergePolygonsWithNeighbourPlugIn :faster, transactional, more
• Updated CadTool plugin to ver. 1.0: activated Add and remove area plugin
• add support for gdal/spatialite via homebrew on macOS

• spatialite works if homebrew java is installed and used via JAVA_HOME
  above e.g. usr/local/opt/java11
• home-brew gdal on mac mini-howto
  1. Install home-brew according to https://brew.sh
  2. Add osgeo4mac repo 'brew tap osgeo/osgeo4mac'
  3. Install gdal 'brew install osgeo-gdal'
  4. run OJ

• added gdal support for debian/ubuntu, installing package libgdal-java
  suffices now to have gdal image loaders up and running, tested on Ubuntu 20
• tested spatialite DB Datastore support on Ubuntu 20, works with package
  libsqlite3-mod-spatialite installed
• installer
  • added a FinishPanel to installer as requested in featreq #270
  • disable shortcut creation on linux, not working properly anymore
  • enable run-privileged for all windows versions
• add multiple extension dirs support eg.
  -plug-in-directory "lib\plus" -plug-in-directory "lib\ext"
• Update GraphToolBox extension to 0.8.0 : improve strahler order
  calculation and add shreve, horton and hack orders
• SpatialDBDSDriver
  • fix sqlite not loading mod_spatialite anymore because
    connection properties were not delegated properly
  • keep one caching Dateparser instance per result dataset to speed up date
    parsing by magnitudes
• beautify selected menu item icons (checkboxed) on windows
  by ticking them visually
• make geoimg framework more robust if imageio-ext or gdal is missing
• add jai-imageio.core (oss successor of sun's jai-core) to OJ CORE
• prefer jai-imageio.core readers over all (primarily just TIF n BMP)
• upgrade imageio-ext to latest greatest 1.3.2
• ImageLayerManagerPlugin shows actually used loader if none was preselected
• upgrade commons imaging to 1.0-alpha2
• update postgresql and sqlite jdbc drivers
• converted Sextante Toolbox as OpenJUMP Detached InternaFrame
• Update and fixes BeanShell Editor PlugIn and dependencies
• Updated CadPlan Jump Printer plugin
• Updated VertexSymbols plugin to version 0.20:
  a) Extended capability of the plugin to feature classification by attribute
  value
  b) Added capability to style linestrings with symbols at user-defined
  distance between each other, offset to the line, and rotation according
  to segments orientation
  c) better visual and command organization
  d) activated capability to read/use pure WKT files as symbols (already
  embedded by Geoff)
  e) integration with some basic style parameters (line/fill colors, global
  transparency,..)
  f) improved panels, commands and GUI
• Correct text preview panel of TextEditor for wrapped text
• upgrade apache-commons jars codec, compress, imaging, lang3 to latest stable
• WMS client

• text request fetches encoding from header content-type now
• save trusted url that needs no cert verification only per session
• fix http auth on cert unverified requests
• rework allow cert unverified dialog, properly wraps and resizes now

• Now tolerate an empty cpg file along with shapefile

PLUS

• Added a valid plugin to export the view to several file formats (Raster,
  SVG, PDF). Export view to scale: style elements will be resized according
  to the selected scale. This plugin substitutes SaveViewAsRaster and
  SaveViewAsSVG plugins in OpenJUMP PLUS version
• PLUS upgrade ojmapcoloring, added Hungarian translation
  (thanks to JJnos Tam醩 Kis), polish translation

Bug Fixes

• fix #517 : raster styling of float32 image
• fix #516 modeler, z-interpolation was incorrect and transaction
  management was error-prone
• fix #512 about georeferencing (introduced by r6523)
• fix #503 again (half-pixel shift)
• fix #508 : java2xml with setInteriorBorder/hasInteriorBorder property
• fix #382 : deleting warping vectors was not possible with incremental mode
• fix #451 : Add image layer throwing NPE
• fix IllegalAccessException when using Sun TIFF reader with java9+
• fix #502 : fatal bug in ColorThemingStyle
• small fix in csv driver -> v1.1.1
• bugfix #385 RasterImageLayer was not cloneable
• Protection against null GeometryColumn when building spatial filter for Spatialite
• bugfix #491 WMS getCapability without title
• Fix a bug in spatialite loader preventing loading anything exported
  from QGis using spatialite format (OGC_OGR_LAYOUT)
• fix #497 : read dates from database as java.util.Date, not String
• fix #494 : csv driver 1.0.3 : fix serialization problem
• Fix #492 GetFeatureInfo without certificate + encoding