= Welcome to '''''Proj4J''''' =

[[TOC]]

'''''Proj4J''''' is a Java library to transform point coordinates from one geographic coordinate system to another, including datum transformations. 

The core of this library is a port of the [http://trac.osgeo.org/proj/ PROJ.4] C library. 
The projection algorithms, concepts and coordinate system definitions are all taken directly from PROJ.4.  
These are wrapped in a Java class model which follows standard Java conventions and OO best practices. 

Proj4J is a part of the [http://trac.osgeo.org/metacrs/wiki/WikiStart MetaCRS] group of projects, hosted by [http://osgeo.org OSGeo].  

== Download ==

'''Status: Currently this library is still being created, and is not yet ready for download'''

 * The current development source is available via anonymous SVN from http://svn.osgeo.org/metacrs/proj4j.


== Documentation ==

 * The [http://trac.osgeo.org/proj/#Documentation PROJ.4 documentation] is the best reference for details of 
   the coordinate system specification language, projection algorithms and supported parameters.
 * the [http://trac.osgeo.org/proj4j/browser/trunk/src/doc/Proj4J%20Version%20History.html?format=raw Version History] lists the evolution of features of the library

== Mailing List ==

A mailing list is available for users and developers of Proj4J.  Subscription, unsubscription and a web archive can be found at http://lists.osgeo.org/mailman/listinfo/proj4j.  For convenience, here is a direct link to the  [http://lists.osgeo.org/pipermail/proj4j/ mailing list archive].

== Development ==

 * [wiki:DesignGoals Design Goals]
 * SVN repository: http://svn.osgeo.org/metacrs/proj4j.
 * Browse source [http://trac.osgeo.org/proj4j/browser here].

== Bug Tracking ==

 * [/proj4j/newticket Submit a new bug report] (you need to [http://trac.osgeo.org/proj4j/login login] with an [http://www.osgeo.org/osgeo_userid OSGeo Userid])
 * [query:status!=closed&type=defect&order=id&desc=1 List Open Bugs]
 * [query:status!=closed&type=enhancement&order=id&desc=1,compact List Open Enhancement Requests]


== Related Resources ==

 * The PROJ.4 site has a [http://trac.osgeo.org/proj/#RelatedResources comprehensive list of resources] dealing with Coordinate Systems in general and the PROJ.4 library in particular.


== History ==

The Proj4J codebase is based on a partial port of PROJ.4
carried out by
[http://www.jhlabs.com/java/maps/proj/index.html JHLabs]
circa 2006.  The JHLabs port provided a large number of the
PROJ.4 projections, but did not support some PROJ.4 features
such as datum transformation.