The jCRS extension intends to bring rigorous CRS handling capacity to gvSIG, as well as the incorporation of the standard CRS operations and repositories like, in this version: EPSG, ESRI, IAU2000 and user-defined CRS.
These added functions provide a solution to the ED50-ETRS89 transition problem, and in accordance with the implementation of the Royal Decree 1071/2007, two solutions are integrated that were achieved by the National Geographic Institute (IGN):
Further in this document, the user interface for this extension will be described, using the most common cases.
In the description of these cases, there might be an overlap in CRS selection methods and dialogs. To avoid repetitions, it was considered convenient to explain a dialog in detail the first time that it appears in the manual, and therefore users are advised to read the sections in the correct order.
In this latest version of the jCRS extension, users can define a custom CRS. This functionality is available through the CRS selection dialog, see figure 14.
Figure 14: Selection of a user-defined CRS
When selecting User CRS as the type of CRS, you can choose from the following options:
- Choose a custom CRS that was previously defined, by selecting it from the table and click on OK. To facilitate the selection when there are many user-defined CRS, there are two search options to find common CRS: by code and by name.
- To find information on the selected CRS, you can click on the CRS info button, after which a window with the available information will appear.
- To edit the selected CRS, click on the Edit button. A dialog with different tabs will appear which is similar to the dialog in which you can define a new custom CRS. These dialogs will be described later on in this document.
- To delete the selected CRS, click on the Remove button.
- Create a new custom CRS, as described here below.
To create a new custom CRS, click on the New button in the dialog shown in Figure 14, after which the dialog User defined CRS will open (see figure 15) to guide you through the process of creating a custom CRS.
This dialog includes three tabs:
Figure 15: Create a new custom CRS
By clicking the button Next you can move from one tab to the next.
In figure 16, the panel of the Datum tab is shown. In this tab, the following information must be filled:
The default ellipsoid and meridian for user defined CRS are the GRS80 ellipsoid and Greenwich meridian.
Figure 16: Definition of the datum for the CRS
When the datum parameters are defined, the Coordinate system information associated with the CRS must be filled in the next tab as shown in figure 17.
Figure 17: Selection of the coordinate system for the CRS
The following Coordinate system information must be filled:
To edit a custom CRS that was previously defined (see figure 14), select this CRS from the table and click on Edit.
Below in figure 18 the dialog Definition of a new custom CRS is displayed, where the tab User CRS is disabled as well as the CRS code in the Datum tab. The reason why you can not modify the CRS code is that this code is used for the indexation of the user database. The other values for the datum are editable, as well as the values for the Coordinate system tab (see figure 19).
Figure 18: Editing of the datum values
Figure 19: Editing of the coordinate system of the CRS
The selection of the CRS for a layer can be done by adding the layer to a view, and clicking on the button labelled Current projection in the Add layer dialog (see figure 12).
Figure 12: Add layer
Then the dialog CRS and transformation will open where you can select the CRS for the layer, and, if needed, a transformation to load the layer into the view (see figure 13).
Figure 13: Selection of the CRS for a layer
Compared to the New CRS dialog that was described before, what is new here is that the table of used CRS includes a Transformation column. This column facilitates the simultaneous selection of the CRS and the transformation for a layer, but only if these have been used before.
The selection of a transformation will be described hereafter.
The CRS for the View must be defined through the dialog View properties which can be accessed by clicking on the Properties button in the Project manager of gvSIG (see figure 9).
Figure 9: Project manager of gvSIG
After clicking on the Current projection button of the View properties dialog (see figure 10), the New CRS dialog will open (see figure 11) which has been described in the previous section.
IMPORTANT: Currently it is not possible to re-project an open view, so if you change the CRS while the view is open, the results may be erroneous.
Figure 10: View properties dialog
Figure 11: Selection of the CRS
This section describes how to set the default CRS for every new View that is created in gvSIG.
The default CRS is defined in the Preferences window of gvSIG which can be accessed through the menu (Window->Preferences) or with the corresponding button in the toolbar , see figure 1.
Figure 1: View Preferences
When clicking on the Change button, the New CRS dialog is displayed which lets you select the default CRS, see figure 2.
Figure 2: Select CRS. Recent CRS
In this dialog you can select CRS from five different repositories:
Below, a brief description of each option is presented.
Figure 3: EPSG repository
The selection of CRS from the EPSG database can be done through three search criteria: through the EPSG code (for example 4230), through the name of the CRS (for example ETRS89), or by the area where the CRS is used (for example Spain). The two last cases are character string searches, resulting in those CRS where the name or area description includes the introduced string.
By clicking on the Info CRS button, you can access detailed information about the CRS that is selected in the table at the moment when you click the button, see figure 4 and 5:
Figure 4: Information of the selected CRS
In the information that is shown for the selected CRS, it is important to note the Proj4 string (at the bottom). The jCRS library includes CRS operations through the Proj4 library (link), where the results will be correct if this string has been correctly constructed. This information could be useful for advanced users.
Figure 5: Information of the selected CRS, including the proj4 string
This information sheet for selected CRS is available for all repositories included in the extension.
The selection of CRS from the IAU2000 and ESRI databases, (see figure 6 and 7, respectively) can be done by searching on the CRS code or name of the CRS.
Figure 6: IAU2000 repository
Figure 7: ESRI repository
The User CRS dialog allows for the management of the user database including select, edit or delete existing CRS, or create new CRS.
The selection of existing user-defined CRS (see figure 8) can be done by searching on the CRS code or the name of the CRS. Since there are normally only a few user-defined CRS, all user-defined CRS will appear in the table by default when the New CRS dialog is opened or when a search is performed without any code or search string.
The process of creating, editing and deleting of user-defined CRS will be explained in a later section of this manual.
Figure 8: Repository of user-defined CRS
In accordance with ISO 19111, there are two types of operations to relate two different CRS: conversion operations and transformation operations:
If a transformation is needed, you must choose the type of transformation for the layer in the CRS selection dialog (see Figure 20) and click the Next button to continue to the corresponding transformation dialog.
Figure 20: Select the type of transformation
The transformation dialog depends on the type of transformation to be performed:
Figure 21: Transformación EPSG
Keep in mind that the transformation operations of this type are always between the base CRS (i.e. non-projected CRS), and therefore if the CRS of the view or the CRS of the layer is projected, the corresponding base CRS will appear in the fields Source CRS and Destination CRS. Keep also in mind that for this type of transformation, the CRS for the View and the CRS for the layer must come from the same EPSG repository. If they come from different repositories, the table will appear empty.
Figure 22: Manual transformation
IMPORTANT: The grid file has a specific scope, which can be deduced from the file information that is displayed in the processing panel. Transformation is not applied beyond this scope, so the re-projection accuracy will be considerably lower, since only the corresponding coordinate system conversion would be applied.
Figure 23: Grid based transformation
Recent transformations (see Figure 24). With this option, you can select a transformation that has been used before. The list of recent transformations will be available in the current and future executions of gvSIG and is not linked to any specific project.
There are two ways to select a recent transformation. The first way is through the CRS selection panel for the layer. There is now an additional field in the table to indicate if the selected CRS has been used together with a transformation in any recent execution of the program. If you select the CRS and recent transformation, you can do two things:
- Accept the CRS and transformation.
- Continue the process of selecting the transformation. This will be helpful to review the selected transformation, because in the next panels the information of the selected transformation will be loaded, so that you can still change it or select another transformation, in which case in the next CRS selection for the layer, a new recent transformation will be added with the chosen settings. To access the information of the CRS and the transformation, just click on the Info CRS button (see Figure 25).
Figure 24: Selection of the CRS for the layer and recent transformation
Figure 25: Information of the CRS for the layer and the selected transformation
The second way to select a recent transformation is through the selection of CRS without transformation and then select Recent transformations as the type of transformation, after which a panel is displayed where you can choose from transformations that were previously defined (see Figure 26).
Figure 26: Recent transformations
Composite transformation. This type of transformation is new for this version. The objective of composite transformations is to provide gvSIG users with the possibility to represent two CRS with different datums without the transformation between those two CRS, but with a transformation of those two CRS into a third CRS.
The composite transformation can play an important role when you need to define two transformations, one that refers to the CRS of the layer and the other to the CRS that has been defined for the view.
With this mechanism, you can set the CRS for the layer and the CRS of the View through an intermediate CRS that connects the two CRS.
To do this, after selecting the CRS of the layer and setting the type of transformation to Compound transformation, you need to:
Figure 27: Select the transformation for the CRS of the layer
Figure 28: Select the transformation for the CRS of the view