aboutsummaryrefslogtreecommitdiff
path: root/docs/source/usage
AgeCommit message (Collapse)Author
2021-11-20Docs: Add new Ellipsoids page to explain ellipsoidal parameters (#2922)Brendan Jurd
Co-authored-by: Rohit <rohitpingale103@gmail.com> Co-authored-by: Brendan Jurd <brendan.jurd@geoplex.com.au> Co-authored-by: Mike Taves <mwtoews@gmail.com>
2021-05-04DOC: configure and add spelling wordlist; fix typos, apply Sphinx syntax (#2705)Mike Taves
2021-03-15Add support for PROJ_AUX_DB environment variable to set the path to one or ↵Even Rouault
several auxiliary DBs
2020-10-14Plot building Github Action (#2377)Howard Butler
* implement conda package building * paths * need libtool * PLATFORM check * point to my PROJ feedstock for now * point to PROJ repos * plot building and artifact upload * syntax * add proj conda package for plotting * retab * no doxygen * syntax * update docs Makefile * doc building * needs * consolidate doc/plots * plot updates * put updated plot output into docs * register spelling module * use v2 download-artifact * artifact upload
2020-08-16ENH: Add support for custum CA Bundle path (#2323)Alan D. Snow
Fixes #2320
2020-08-06Fix url for CDN GitHub project (#2313)Javier Jimenez Shaw
2020-05-09scripts/fix_typos.sh: fix URLs to dictionaries, and fix typos spottedEven Rouault
2020-03-06Typo fixes identified by scripts/fix_typos.shEven Rouault
2020-02-04Add projsync utilityEven Rouault
Fixes #1750
2020-01-22Merge RFC4 (#1865)Even Rouault
This commit is the result of the squashing of rfc4_dev branch in a single commit. It implements mostly RFC 4 related work. * Grid handling: - remove obsolete and presumably unfinished implementation of grid catalog functionality - all grid functionality is in grids.cpp/.hpp - vertical and horizontal grid shift: rework to no longer load whole grid into memory - remove hgrids and vgrids member from PJ structure, and store them in hgridshift/vgridshift/deformation structures - build systems: add optional libtiff dependency. Must be explicitly disabled if not desired - add support for horizontal and vertical grids in GeoTIFF, if libtiff is available - add GenericShiftGridSet and GenericShiftGrid classes, relying on TIFF grids, that can be used for generic purpose grid-based adjustment - add a +proj=xyzgridshift method to perform geocentric translation by grid. Used for French NTF to RGF93 transformation using gr3df97a.tif grid - deformation: add support for +grids= for GeoTIFF grids - horizontal grid shift: fix failures on points slightly outside a subgrid (fixes #209) * File management: - add a filemanager.cpp/.hpp to deal with file related work - test for legacy proj_api.h fileapi - proj.h: add proj_context_set_fileapi() and proj_context_set_sqlite3_vfs_name() (fixes #866) - add capability to read resource files from the user writable directory * Network access: - build systems: add optional curl dependency - add a curl-based default implementation for network related functionality - proj.h: add C API to control network functionality, and optionaly provide network callbacks - add data/proj.ini with default settings - add a SQLite3 local cache of downloaded chunks - add proj_is_download_needed() and proj_download_file() * Use Win32 Unicode APIs and expect all strings to be UTF-8 (fixes #1765) For backward compatibility, if PROJ_LIB content is found to be not UTF-8 or pointing to a non existing directory, then an attempt at interpretating it in the ANSI page encoding is done. proj_context_set_search_paths() now assumes strings to be in UTF-8, and functions returning paths will also return values in UTF-8.
2020-01-13Remove -ld option from proj and cs2csKristian Evers
It promotes use of deprecated paramters +datum and +towgs84 which we don't want to encourage. Closes #1308
2019-12-25Doc: differences.rst: add note about WKT1:GDAL no longer implicitly calling ↵Even Rouault
--boundcrs-to-wgs84
2019-11-21projjson.rst: typo fixEven Rouault
2019-11-05Doc: fix formatting in usage/transformation.rstKristian Evers
2019-11-04Merge pull request #1710 from rouault/geoid_modelEven Rouault
Add support for GEOIDMODEL
2019-11-04Doc: projjson: mention v0.2Even Rouault
2019-11-04Doc: fixes in usage/transformation.rstEven Rouault
- Section about cs2cs no longer applies to PROJ 6. Ammended to underline that. - Remove no longer relevant/unclear caveats.
2019-10-30Document PROJJSONEven Rouault
More could probably be written, but at least this can serve as a landing/reference page for other documents/specifications to point to.
2019-05-30Add information about proj.db. (#1491)Andrew Bell
2019-05-27doc:Update cs2cs return values to reflect PROJ 6 changesKristian Evers
2019-04-02added documentation for the priority of searcing for PROJ resource filessnowman2
2019-03-06Fix bad rst formattingKristian Evers
2019-02-14deformation: Replace +t_obs with +dtKristian Evers
The +t_obs parameter was confusing for users since it effectively overwrote the observation time in input coordinates. To make it more clear what is the operation is doing, users are now required to directly specify the time span for which they wish to apply a given deformation. The parameter +dt has been added for that purpose. The new parameter is mutually exclusive with +t_epoch. +dt is used when deformation for a set amount of time is needed and +t_epoch is used (in conjunction with the observation time of the input coordinate) when deformation from a specific epoch to the observation time is needed.
2019-02-14Merge remote-tracking branch 'osgeo/master' into remove-t_obsKristian Evers
2019-02-14Cosmetical changes to differences.rstKristian Evers
2019-02-14Reverse direction of deformation operations/transformations/deformationKristian Evers
Changed the direction of dt-calculation to follow the same convention as helmert. Changed from dt = t_c - t_obs to dt = t_obs - t_c, which effectively reverses the direction of the operation. Existing projstrings using deformation can simply reverse the direction of the operation to achieve the same results as before this commit.
2019-02-04Remove all traces of nad2bin and nad2nadKristian Evers
The source material for the default grids used by PROJ has been moved to the proj-datumgrid repository. For that reason it is no longer necessary to include the nad2bin program in the PROJ repository and source distribution. From now on the nad2bin application will be kept in the proj-datumgrid repo. Previously the null grid was generated by running nad2bin on the null.lla file. Since nad2bin is no longer available null.lla has been replaced by its binary counterpart null. This file will be distributed and installed alongside PROJ. Build scripts and documenation has been adjusted so that nad2bin is not mentioned anywhere. Additionally all references to nad2nad has been removed as well. nad2nad has not been part of the PROJ distribution for quite some time so this has been long overdue.
2019-01-09PROJ_LIB: support multiple paths supported by colon on Unix and semi-colon ↵Even Rouault
on Windows (fixes #1150)
2018-12-27Add an hardcoded +ellps=GRS80 when there is no datum/ellipsoid specification ↵Even Rouault
(refs #201)
2018-12-27Remove proj_def.dat (fixes #201)Even Rouault
2018-09-20Clean up FAQKristian Evers
This removes some questions that are no longer valid (covered elsewhere in the docs), adjusts the wording in other questions and fixes formatting and making it proper rst/sphinx syntax. With this, #1070 is almost fixed.
2018-09-18Remove free grids from 'Non-Free Grids' sectionMike Toews
These are included with proj-datumgrid: - Australia - Canada: ntv2_0.gsb - Germany: BETA2007.gsb
2018-08-21[BREAKING] Hermert: add +convention=position_vector/coordinate_frame, ↵Even Rouault
forbids +transpose (fixes #1091) As identified in #1091, Helmert implementation in PROJ 5.0 and 5.1 is confusing. It happens that by default it used the coordinate_frame convention, contrary to the position_vector convention used traditionaly for +towgs84. The documentation of Helmert was also wrongly specifying that the default convention was position_vector. This commit: - bans the confusing +transpose parameter - removes the concept of a default convention, since in practice both are equally found, and requires +convention as soon as a rotational term parameter is present. For translation only, convention is ignored and optional, as having no effect. - fixes all the identified uses of proj=helmert in code, doc and tests This is obviously a breaking change: - users will have to adapt their pipeline expressions - in particular, init files that would use helmert must be adapted However, as designed, the break will be explicit, and not silent.
2018-06-10rewrite references using BibTeX and sphinxcontrib-bibtexMike Toews
2018-06-01Fix a fix sphinx warnings about unknown optionsKristian Evers
2018-05-24Docs: fix wrong spelling of t_obs and t_epochEven Rouault
2018-05-24Add doc section with description of behavioural changes between PROJ versionsKristian Evers
2018-05-12Remove annotations from old version of exampleKristian Evers
2018-03-17Move application docs to top level.Kristian Evers
The 'Applications' chapter is moved to the top level of the website in order to make it easier for users to find the pages quickly instead of having to search through sub-sections in other chapters.
2018-03-17Reformat doc pages for cct, cs2cs, geod and projKristian Evers
The doc pages are reformatted to better use the features of the Sphinx documentation system. All four pages has been formatted such that they can serve as the basis for both the website and UNIX man-pages. This will make it easier to keep the man-pages aligned with the main documentation in the future.
2018-03-06fix a few typos (again)Mike Toews
2018-02-28Move 'Coordinate operations' to top level of docs [skip ci]Kristian Evers
2018-02-28Add section on PROJ resource files to docs [skip ci]Kristian Evers
Added new section on PROJ resource files to the top level of the documentation. Moved information on init-file from the 'usage' chapter to the new section. Also moved pages on grids and HTPD to the new resource files section. Finally links and information on the new regional datumgrids packages is added.
2018-02-27Add cct description to indexThomas Knudsen
2018-02-27Add usage description for the cct programThomas Knudsen
2018-02-23Merge remote-tracking branch 'osgeo/master' into docs-release-4.10.0Kristian Evers
2018-02-19Change most occurences of PROJ.4 to PROJ [skip ci]Kristian Evers
2018-01-22Adding rudimentary docs for the pipeline operation [skip ci].Kristian Evers
2018-01-22Add details about grid file formats in relevant sections of the ↵Kristian Evers
documentation [skip ci]
2018-01-22Add deformation docs-page (missing from previous commit) [skip ci]Kristian Evers