This is a signficant update from 5.2.0; proj has withdrawn one API and
deprecated another. Packages that have a healthy upstream and are up
to date should be ok, but some will need remedial attention. I have
held off on this update for quite a long time, but it seems we have
arrived at the problems from some packages' failure to cope with proj
6 being less serious than holding back well-maintained packages from
the improvements.
Add an option "proj-grids", default on, to include the optional grid
files. These are large, but necessary for many datum transformations.
Upstream's tests fail with them installed, because the test vectors
are computed without them, so tests are forced to fail if grids are
included.
Upstream NEWS, projected to standard NEWS content follows. (NB: The
6.0.0 content is the most critical to understand.)
6.3.1 Release Notes
-------------------
Updates
-------
o Update the EPSG database to version 9.8.6
o Database: add mapping for gg10_smv2.mnt and gg10_sbv2.mnt French grids
o Database: add mapping for TOR27CSv1.GSB
6.3.0 Release Notes
-------------------
Updates
-------
o Database: tune accuracy of Canadian NTv1 file w.r.t NTv2 (#1812)
o Modify verbosity level of some debug/trace messages (#1811)
o projinfo: no longer call createBoundCRSToWGS84IfPossible() for WKT1:GDAL
(#1810)
o proj_trans: add retry logic to select other transformation if the best one
fails. (#1809)
o BoundCRS::identify(): improvements to discard CRS that aren't relevant
(#1802)
o Database: update to IGNF v3.1.0 (#1785)
o Build: Only export symbols if building DLL (#1773)
o Database: update ESRI entries with ArcGIS Desktop version 10.8.0 database
(#1762)
o createOperations(): chain operations whose middle CRSs are not identical but
have the same datum (#1734)
o import/export PROJJSON: support a interpolation_crs key to geoid_model
(#1732)
o Database: update to EPSG v9.8.4 (#1725)
o Build: require SQLite 3.11 (#1721)
o Add support for GEOIDMODEL (#1710)
o Better filtering based on extent and performance improvements (#1709)
6.2.1 Release Notes
-------------------
Updates
-------
o Update the EPSG database to version 9.8.2
6.2.0 Release Notes
-------------------
Updates
-------
o Introduced PROJJSON, a JSON encoding of WKT2 (#1547)
o Support CRS instantiation of OGC URN's (#1505)
o Expose scope and remarks of database objects (#1537)
o EPSG Database updated to version 9.7.0 (#1558)
o Added C API function proj_grid_get_info_from_database() (#1494)
o Added C API function
proj_operation_factory_context_set_discard_superseded() (#1534)
o Added C API function proj_context_set_autoclose_database() (#1566)
o Added C API function proj_create_crs_to_crs_from_pj() (#1567)
o Added C API function proj_cleanup() (#1569)
6.1.1 Release Notes
-------------------
Updates
-------
o Update EPSG registry to version 9.6.3 (1485)
6.1.0 Release Notes
-------------------
Updates
-------
o Include custom ellipsoid definitions from QGIS (#1337)
o Add "-k ellipsoid" option to projinfo (#1338)
o Make cs2cs support 4D coordinates (#1355)
o WKT2 parser: update to OGC 18-010r6 (#1360#1366)
o Update internal version of googletest to v1.8.1 (#1361)
o Database update: EPSG v9.6.2 (#1462), IGNF v3.0.3, ESRI 10.7.0
and add operation_version column (#1368)
o Add proj_normalize_for_visualization() that attempts to apply axis
ordering as used by most GIS applications and PROJ <6 (#1387)
o Added noop operation (#1391)
o Paths set by user take priority over PROJ_LIB for search paths (#1398)
o Reduced database size (#1438)
o add support for compoundCRS and concatenatedOperation named from
their components (#1441)
6.0.0 Release Notes
-------------------
PROJ 6 has undergone extensive changes to increase its functional scope from a
cartographic projection engine with so-called "early-binding" geodetic datum
transformation capabilities to a more complete library supporting coordinate
transformations and coordinate reference systems.
As a foundation for other enhancements, PROJ now includes a C++ implementation
of the modelisation propopsed by the ISO-19111:2019 standard / OGC Abstract
Specification Topic 2: "Referencing By Coordinates", for geodetic reference
frames (datums), coordinate reference systems and coordinate operations.
Construction and query of those geodetic objects is available through a new C++
API, and also accessible for the most part from bindings in the C API.
Those geodetic objects can be imported and exported from and into the OGC
Well-Known Text format (WKT) in its different variants: ESRI WKT, GDAL WKT 1,
WKT2:2015 (ISO 19162:2015) and WKT2:2018 (ISO 19162:2018). Import and export of
CRS objects from and into PROJ strings is also supported. This functionality
was previously available in the GDAL software library (except WKT2 support
which is a new feature), and is now an integral part of PROJ.
A unified database of geodetic objects, coordinate reference systems and their
metadata, and coordinate operations between those CRS is now available in a
SQLite3 database file, proj.db. This includes definitions imported from the
IOGP EPSG dataset (v9.6.0 release), the IGNF (French national mapping agency)
geodetic registry and the ESRI projection engine database. PROJ is now the
reference software in the "OSGeo C stack" for this CRS and coordinate operation
database, whereas previously this functionality was spread over PROJ, GDAL and
libgeotiff, and used CSV or other adhoc text-based formats.
Late-binding coordinate operation capabilities, that takes metadata such as
area of use and accuracy into account, has been added. This can avoid in a
number of situations the past requirement of using WGS84 as a pivot system,
which could cause unneeded accuracy loss, or was not doable at all sometimes
when transformation to WGS84 was not available. Those late-binding capabilities
are now used by the proj_create_crs_to_crs() function and the cs2cs utility.
A new command line utility, projinfo, has been added to query information about
a geodetic object of the database, import and export geodetic objects from/into
WKT and PROJ strings, and display coordinate operations available between two
CRSs.
UPDATES
-------
o Removed projects.h as a public interface (#835)
o Deprecated the proj_api.h interface. The header file is still available
but will be removed with the next major version release of PROJ. It is
now required to define ACCEPT_USE_OF_DEPRECATED_PROJ_API_H before the
interface can be used (#836)
o Removed support for the nmake build system (#838)
o Removed support for the proj_def.dat defaults file (#201)
o C++11 required for building PROJ (#1203)
o Added build dependency on SQLite 3.7 (#1175)
o Added projinfo command line application (#1189)
o Added many functions to proj.h for handling ISO19111 functionality (#1175)
o Added C++ API exposing ISO19111 functionality (#1175)
o Updated cs2cs to use late-binding features (#1182)
o Removed the nad2bin application. Now available in the proj-datumgrid
git repository (#1236)
o Removed support for Chebyshev polynomials in proj (#1226)
o Removed proj_geocentric_latitude from proj.h API (#1170)
o Changed behaviour of proj: Now only allow initialization of
projections (#1162)
o Changed behaviour of tmerc: Now default to the Extended Transverse
Mercator algorithm (etmerc). Old implementation available by adding
+approx (#404)
o Chaged behaviour: Default ellipsoid now set to GRS80 (was WGS84) (#1210)
o Allow multiple directories in PROJ_LIB environment variable (#1281)
o Added Lambert Conic Conformal (2SP Michigan) projection (#1142)
o Added Bertin1953 projection (#1133)
o Added Tobler-Mercator projection (#1153)
o Added Molodensky-Badekas transform (#1160)
o Added push and pop coordinate operations (#1250)
o Removed +t_obs parameter from helmert and deformation (#1264)
o Added +dt parameter to deformation as replacement for
removed +t_obs (#1264)
pkglint -r --network --only "migrate"
As a side-effect of migrating the homepages, pkglint also fixed a few
indentations in unrelated lines. These and the new homepages have been
checked manually.
Fallout from interface removal is expected, and I want to assess how
many packages are broken from version 6 before committing the update
(which is already prepared).
While this makes the package larger, proj will silently fail to
produce correct results without the datumgrids files. proj does not
have a mechanism to error out when they are needed and missing, so
this is the only safe approach.
(Other regions to follow.)
Add c++ to USE_LANGUAGES because configure throws an error. (This
isn't noted in the release notes, but has been talked about on the
list.)
Upstream changes for proj (datumgrids 1.8 has no Changelog available):
PROJ 5.2.0
September 15th 2018
UPDATES
Added support for deg, rad and grad in unitconvert (#1054)
Assume +t_epoch as time input when not otherwise specified (#1065)
Added inverse Lagrange projection (#1058)
Added +multiplier option to vgridshift (#1072)
Added Equal Earth projection (#1085)
Added “require_grid” option to gie (#1088)
Replace +transpose option of Helmert transform with +convention. From now on the convention used should be explicitly written. An error will be returned when using the +transpose option (#1091)
Improved numerical precision of inverse spherical Mercator projection (#1105)
cct will now forward text after coordinate input to output stream (#1111)
See NEWS for full changelog. Besides Bug fixes, notable changes are:
o Function proj_errno_string() added to proj.h API (#847)
o Validate units between pipeline steps and ensure transformation
sanity (#906)
o Print help when calling cct and gie without arguments (#907)
o CITATION file added to source distribution (#914)
o Webmercator operation added (#925)
o Enhanced numerical precision of forward spherical Mercator near
the Equator (#928)
o Added --skip-lines option to cct (#923)
o Consistently return NaN values on NaN input (#949)
o Removed unused src/org_proj4_Projections.h file (#956)
o Java Native Interface bindings updated (#957, #969)
o Horizontal and vertical gridshift operations extended to
the temporal domain (#1015)
5.0.0 Release Notes
-------------------
This version of PROJ introduces some significant extensions and
improvements to (primarily) the geodetic functionality of the system.
The main driver for introducing the new features is the emergence of
dynamic reference frames, the increasing use of high accuracy GNSS,
and the related growing demand for accurate coordinate
transformations. While older versions of PROJ included some geodetic
functionality, the new framework lays the foundation for turning PROJ
into a generic geospatial coordinate transformation engine.
[see upstream NEWS]
UPDATES
-------
o Introduced new API in proj.h.
- The new API is orthogonal to the existing proj_api.h API and the
internally used projects.h API.
- The new API adds the ability to transform spatiotemporal (4D)
coordinates.
- Functions in the new API use the "proj_" namespace.
- Data types in the new API use the "PJ_" namespace, with a few
historic exceptions such as XY, XYZ, LP and LPZ.
o Introduced the concept of "transformation pipelines" that makes it
possible to do complex geodetic transformations of spatiotemporal
coordinates by daisy chaining simple coordinate operations.
o Introduced cct, the Coordinate Conversion and Transformation
application.
o Introduced gie, the Geospatial Integrity Investigation Environment.
- Selftest invoked by -C flag in proj has been removed
- Ported approx. 1300 built-in selftests to gie format
- Ported approx. 1000 tests from the gigs test framework
- Added approx. 200 new tests
o Adopted terminology from the OGC/ISO-19100 geospatial standards
series. Key definitions are:
- At the most generic level, a *coordinate operation* is a change
of coordinates, based on a one-to-one relationship, from one
coordinate reference system to another.
- A *transformation* is a coordinate operation in which the two
coordinate reference systems are based on different datums, e.g.
a change from a global reference frame to a regional frame.
- A *conversion* is a coordinate operation in which both
coordinate reference systems are based on the same datum,
e.g. change of units of coordinates.
- A *projection* is a coordinate conversion from an ellipsoidal
coordinate system to a plane. Although projections are simply
conversions according to the standard, they are treated as
separate entities in PROJ as they make up the vast majority
of operations in the library.
o New operations:
- The pipeline operator (pipeline)
- Transformations:
+ Helmert transform (helmert)
+ Horner real and complex polynomial evaluation (horner)
+ Horizontal gridshift (hgridshift)
+ Vertical gridshift (vgridshift)
+ Molodensky transform (molodensky)
+ Kinematic gridshift with deformation model (deformation)
- Conversions:
+ Unit conversion (unitconvert)
+ Axis swap (axisswap)
- Projections:
+ Central Conic projection (ccon)
o Significant documentation updates, including
- Overhaul of the structure of the documentation
- A better introduction to the use of PROJ
- A complete reference to the new proj.h API
- a complete rewrite of the section on geodesic calculations
- Figures for all projections
o New "free format" option for operation definitions, which
permits separating tokens by whitespace when specifying key/value-
pairs, e.g. "proj = merc lat_0 = 45".
o Added metadata to init-files that can be read with the
proj_init_info() function in the new proj.h API.
o Added ITRF2000, ITRF2008 and ITRF2014 init-files with ITRF
transformation parameters, including plate motion model
parameters.
o Added ellipsoid parameters for GSK2011, PZ90 and "danish". The
latter is similar to the already supported andrae ellipsoid,
but has a slightly different semimajor axis.
o Added Copenhagen prime meridian.
o Updated EPSG database to version 9.2.0.
o Geodesic library updated to version 1.49.2-c.
o Support for analytical partial derivatives has been removed.
o Improved performance in Winkel Tripel and Aitoff.
o Introduced pj_has_inverse() function to proj_api.h. Checks if an
operation has an inverse. Use this instead of checking whether
P->inv exists, since that can no longer be relied on.
o ABI version number updated to 13:0:0.
o Removed support for Windows CE.
o Removed the VB6 COM interface.
BUG FIXES
------------
[various]
DEPRECATIONS
------------
[see upstream NEWS]
* proj_def.dat was missing from source distribution see
https://github.com/OSGeo/proj.4/issues/274 for more detail
* Update Geodesic library from GeographicLib
* Remove setlocale() use in pj_init_ctx()
* Renamed PVALUE in pj_param.c to prevent clash with Windows
Note that the PVALUE rename is not an ABI change and there is no revbump.
4.9.2 Release Notes
-------------------
o proj_def.dat was missing from source distribution
see https://github.com/OSGeo/proj.4/issues/274 for more detail
o Update Geodesic library from GeographicLib
o Remove setlocale() use in pj_init_ctx()
o Renamed PVALUE in pj_param.c to prevent clash with Windows
Note that this changes the shlib version from 0.8 to 9.0. While
that's bizarre, upstream does not view it as a bug.
(Note that 4.9.0 had an RC but not an actual release.)
Changes from 4.8.0:
4.9.1 Release Notes
-------------------
o 4.9.0RC2 release was abandoned because it was not promoted in a
timely fashion. Subsequent maintenance of tickets has continued,
and a new 4.9.1 release was issued in its place.
o Implement inverse solution for Winkel Tripel from Drazan Tutic #250
o More CMake configuration tweaks. The CMake configuration is probably
not at feature parity with the autotools builds at this point but it
is converging #256
o Tweak initialization ordering around setlocal which may have caused
issues #237
o Support out-of-tree autoconf builds more completely #247
o Fix NaN handling by geod_inverse and geod_polygon_addedge #251 & #253
o Update config.sub and config.guess #257
o Adapt Charles Karney's CMake patches for smoother build #258
o Define default PROJ_LIB location for CMake compilation #261
o Fix Windows compilation on PJ_aitoff.c
o Align CMake SOVERSION with autotools #263
o Regenerate nad/epsg with GDAL r28536 to avoid precision loss in TOWGS84
parameters, e.g. on Amersfoort / RD EPSG:4289 (#260)
o Add CMake project-config.cmake scripts (#264 from Charles Karney)
o Dial back test sensitivity #255
4.9.0 Release Notes
-------------------
o Implement CMake as an option for building PROJ.4
o Implement new virtual file api (projFileAPI) so that all access to grid
shift and init files can be hooked.
o Replace geodesic implementation with one from Charles Karney and add a
supported public interface (geodesic.h).
o Upgraded to EPSG 8.5.
o Removed old (deprecated) Java bindings in favor of the new api introduced
in 4.8.0.
o Implement the calcofi (Cal Coop Ocean Fish Invest Lines/Stations) projection
o Install projects.h again for applications that want access to internal
structures and functions despite the inherent fragility.
o Various bug fixes and cleanup.
o Added the CalCOFI pseudo-projection, #135
has an additional grid shift file. Add a test target; regression
tests now pass at least on NetBSD/i386 5.1_STABLE.
4.8.0 Release Notes
-------------------
o Added the Natural Earth projection.
o Added HEALPIX, rHEALPIX and Icosahedral Snyder Equal Area projections.
o nad2bin now produces "CTable2" format grid shift files by default which
are platform independent.
o nad2nad removed, use cs2cs for datum shift operations.
o projects.h no longer installed as a public include file. Please try to
only use proj_api.h.
o Add pj_get_spheroid_defn() accessor.
o Added an alternate version of pj_init() that takes a projCtx (execution
context) structure to address multithreading issues with error management
and to provide a support for application hookable error reporting and
logging.
o Upgrade to EPSG 7.9. Some changes in ideal datum selection.
o JNI bindings reworked, org.proj4.Projections deprecated in favor of
org.proj4.PJ.
o Added preliminary vertical datum support.
o Fix various multithreading issues, particular in datum grid handling code.
o Added support for the +axis= option for alternate axis orientations as
part of a coordinate system (used for TM South Orientated support).
o +proj=omerc implementatioin replaced with code from libproj4. +rot_conv
flag no longer works, and some coordinate systems (ie. Malaysian) will
need to use +gamma instead. "epsg" init file updated accordingly.
