OpenJUMP (The JUMP Pilot Project) Files

Announcement
------------
  We are very proud to present some major improvements in this release 
  reflected in the major version jump from 1.16 to version 2.0.
  The long overdue port to the recent and maintained JTS 1.18 took place as
  well as the switch from sf.net's svn to github git as source repository.
  We invite each and every user, developer to take part in the development and 
  improvement of this project. it's not called *Open*JUMP by accident :)

  We want to acknowledge the efforts of Eric Grosso, who took the initiative 
  and researched the best way to move over to git, preserving the commit history
  as well as the upgrade to locationtech's JTS. Thank you Eric!


OpenJUMP Readme file
--------------------
Version 2.0 release rev.5095[a56ff6d]

01. March 2022

Contents
--------
1. Licensing
2. Installation instructions
3. Running OpenJUMP
4. Support
5. OpenJUMP history
6. Credits
7. Latest changes


1. 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 (paoladorileo<AT>gmail.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ël Michaud) - GPL2 - gpl-2.txt
  aggregation-*.jar
 BeanShell Editor (Michaël 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ël 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ël Michaud) - GPL2 - gpl-2.txt
  CTS-PlugIn-*.jar,
  lib/cts-*.jar - LGPL3 - lgpl-3.0.txt
  SLF4J (see above)
 DXF driver (Michaël 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ël 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ël 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ël 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ël 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ël 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 
<appfolder>/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 <argument> ... <[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 <locale>
    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).

  -extensions-directory <path> 
    Sets the location of the extensions folder. Can be defined multiple times.
    Look for extensions in <path>/*.jar files, adds all jar-files recursively
    to runtime classpath. (see also -limit-ext-lookup)
    Default: JUMP_HOME/lib/ext

  -jars-directory <path>
    Adds all contained jar-files recursively to runtime classpath.
    Can be defined multiple times.

  -limit-ext-lookup true|false
    Limits the search for extensions in jar files to jar-files contained in
    extension-directory folder root. Setting to 'false' enables extension
    lookup in all jars + class files recursively (for devel purposes).
    Default: true (to speed up OJ start)

  DEPRECATED: use '-extensions-directory','-jars-directory','-limit-ext-lookup'
  -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ël 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üge

Translation contributors are
  Chinese: Elton Chan
  Czech: Jan Ruzicka
  English: Landon Blake
  Finnish: Jukka Rahkonnen
  French: Basile Chandesris, Erwan Bocher, Steve Tanner, Michaël 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üller/Andreas Schmitz
- Pirol Project from University of Applied Sciences Osnabrück
  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
-----------------

New Features
  - Removed WFS functionality because of missing deegree2 sources
  - Add GeometrySnapperPlugIn and a self-snap function into geometry 
    functions plugin
  - overhauled cmd line parameters for extension development support,
    parameter '-plug-in-directory' renamed to '-extensions-directory' 
    new cmd line parameters '-jars-directory','-limit-ext-lookup'
    see https://github.com/openjump-gis/openjump/commit/3a0b5327f14ff31
    commit message on how it is supposed to work
  - removed mysql jdbc in favor of freely available mariadb jdbc
  - removed ImportArcMapStylePlugIn
  - add Snap-rounding plugin using JTS 1.18
  - add GeometryFixer algorithm to MakeValidPlugIn
  - AttributePredicate: add Long data type

Improvements
  - OJ2 core and extension repos now located at 
    https://github.com/openjump-gis/
  - cleaned all extension and dependency jar binaries from source tree,
    they are downloaded with maven during the build now
  - mavenized complete development chain, including IDE development
  - upgraded to latest greatest JTS 1.18.2
  - improved usage of JTS algorithms
  - convert OJ2 project to UTF-8, language files can be edited online now
  - adapted all PLUS extensions to OJ2 API changes
  - mavenized build and packaging of all PLUS extensions
  - clean/improve wms layer management, add style management
  - adbtoolbox vectorize algorithm: use cell height, not only cell width
  - add a fast vectorization algorithm to Raster VectorizeToPolygonsPlugin
  - upgrade imageio-ext to 1.3.11, batik to 1.6-1, xz to 1.9
  - add robust algo options for geometry eraser and precision reducer (#28)
  - enhanced I18N to be usable for extensions as well
  - started work to remove JUMPWorkbench.getInstance() usage
  - single instance use of FeatureInstaller and EnableCheckFactory
  - moved tests into own src folder, prevents recompiling full source
  - upgrade junit to 5.8.2, mariadb to 2.7.3, sqlite to 3.36, postgres to 42.3
  - revamped BeanToolsPlugin, new icons, better menu creation, fixed scripts
  - adapt GeometryConversionPlugin to new JTS, add icons
  - utilize new JTS overlaying algorithm in 
    OverlayPlugIn, UnionByAttributePlugIn, DissolvePlugIn, Dissolve2PlugIn
  - repair invalid geometries if any before UnionByAttribute & Dissolve
  - add robust and fixed precision algorithms in GeometryFunctionPlugIn for
    Intersection, Union, Difference A-B, Difference B-A, Symmetric difference
  - translation updates for several languages (still looking for translators!)

Bug Fixes (details either on
  https://sourceforge.net/p/jump-pilot/bugs/ or
  https://github.com/openjump-gis/openjump/issues )
  - fix #17 OpenFileWizard with multiple files and options does not work
  - fix #22 about the 0.5 pixel shift of referenced images
  - fix #23 about wms base url including parameters
  - fix #37 and make it possible to have optional attributes in XMLBinder
  - fix #40 GeoJSON manage crs at the FeatureCollection level where possible
  - fix UpdateWithJoinPlugIn not compatible with Database Transaction Manager
  - fix wrong CursorTool hotspot on HiDPI systems
  - fix #42 select layers with selected items
  - don't die on reading srs info from invalid GeoTIFFs
  - fix WMS parameters encoding