Point File Conversion works with point data records that are in a tabular format such as a spreadsheet. See Supported File Formats for the list of compatible file types. Coordinate data must be uniformly organized into columns with all coordinates in a given column being relative to the same coordinate reference system. Coordinates are read from the input columns for each row in the table, converted, and written to the specified output columns in a downloaded file. For typing in a single point for testing, use the Point tool.
The following three Operation Types are supported:
- Conversion converts or transforms coordinates between coordinate reference systems.
-
Forward is used to compute a new coordinate that is a given distance and azimuth away from a starting coordinate. Both the source and destination points must be referenced to the same geodetic base coordinate system. Forward calculations follow one of three paths:
- Geodesic ("great circle" or the shortest path between two points on the surface of the ellipsoid)
- Rhumb Line (constant azimuth)
- Grid Distance (valid for projected "grid" coordinates only)
- Inverse computes the distance between two known coordinates on the same datum. The result may be calculated using Geodesic, Rhumb, or Grid (valid for projected coordinates only) calculation methods. Both the source and destination points must be referenced to the same geodetic base coordinate system.
Point File Conversion
Point Conversion converts or transforms coordinates between coordinate reference systems.
To perform point conversion, the following will be needed:
- Enter a coordinate pair
- Select the known source coordinate reference system
- Set the desired target coordinate reference system
- If the source and target coordinate systems use a different geodetic datum, you will be prompted to select an appropriate datum transformation from the GeoCalc Datasource to convert the source point to the target coordinate system
- Optional: Enter the elevation value (Z) associated with the X, Y and set the source/target vertical coordinate reference systems to prompt vertical transformation
- Optional: a source and target date are required to access time-dependent transformations
How to set up the Point File Conversion Operation:
- Load a point file by clicking the Open File button.
- Set the appropriate header options, then click the Reload button to apply to the loaded data.
- Header Rows - The number of rows at the top of the file that either contain the column header (label) or other header information not to be included in processing.
- Label Row - This option appears when multiple header rows are indicated. Use this to identify which row number contains the column labels.
- Preview Rows - the number of rows to display in the browser for preview.
- Choose output file settings.
- Output File extension - choose which file type the completed calculation should be exported as. This can be the same as the input file. The default point file output type is .XLSX.
- Save Header - enabling this option will preserve the existing header row displayed in the datagrid in the output file and preview window after processing. If left disabled, the output file and preview will contain the calculated output without the displayed header.
- Define Output Filename - Leave this field blank unless you would like to change the name of your output file. If left blank, the input filename will be used as the base of the output filename.
-
Use the arrow button to switch between adding a Suffix or Prefix:
- Add Suffix - Use this option to add a suffix to the original file name. Default is "_output".
- Add Prefix - Use this option to add a Prefix to the original file name. Default is "output_".
Point File results are automatically downloaded to your computer in the file location determined by your browser settings. The default option is typically the Downloads folder. Consult your browser settings to determine or change this path.
- Under Transformation Operation Type, choose Conversion.
- Specify the Source and Target Coordinate systems. If available, the Source coordinate system will populate from the Coordinate Reference System (CRS) information associated with the loaded data file. If needed, you can set the coordinate system manually. Select a coordinat
Select a Source and Target Coordinate System
- Use the Search button
next to the Horizontal system field to launch the selection dialog. On the left side of the selection dialog, use the text field to narrow the options or expand the folders to locate your source horizontal CRS on the right side of the dialog.
- The default is WGS 84 [EPSG:4326], but this can be changed in Settings. Recently used coordinate systems will populate the dropdown.
- Use the
icon to see information on the chosen CRS. Click your desired horizontal CRS, and the dialog window will close automatically. The system, datum, and units fields will update accordingly. You may optionally search for and change the source or target units if needed.
- Use the Search button
next to the Vertical coordinate system to launch the selection dialog. Setting a different vertical system on the target will prompt for a vertical transformation. Setting a vertical coordinate system is optional; if the data does not have elevation values, it will not be possible to assign a vertical coordinate system.
- The Date field will display if time-dependent transformations are enabled in Settings. Source and target dates are required for time-dependent transforms to display in the transformation selection choices.
- Set the Target coordinate system using the same steps as above.
- For more information, see Searching the Datasource.
Supported Coordinate Formats
Use the Format button to select the display format and precision for your input and output coordinates. This is very important for angular units.
You can enter latitude and longitude degree coordinate values in many formats, not only decimal degrees. The formats that you can select are shown below with an example (all examples represent the coordinate: South 44 degrees, 30 minutes, 15 seconds):
- DD. (example: -44.50416 or 44.50416 S)
- DD MM. (example: -44 30.2500 or 44 30.2500 S)
- DD-MM. (example: -44-30.2500 or 44-30.2500 S)
- DD MM SS. (example: -44 30 15.000 or 44 30 15.000 S)
- DD-MM-SS. (example: -44-30-15.000 or 44-30-15.000 S)
- DD.MM (example: -44.3025 or 44.3025 S)
- DD.MMSS (example: -44.3015 or 44.3015 S)
- Packed DMS (example: -44301500 or 44301500S)
- Packed DMS. (example: -443015.00 or 443015.00S)
- Packed DM. (example: -4430.2500 or 4430.2500S)
- Brazil ANP (example: -44:30:15,000)
The direction (N/S/E/W) can be entered as either a prefix or suffix.
Select a Coordinate Transformation
If the source and target coordinate systems use different geodetic datums, use the Choose Transformation field or Search button to select a valid transformation.
- Use the Search field to limit the results by text (or EPSG code) or expand the folders on the left side to select the transformation.
- The Datasource Transformations folder will contain any predefined objects organized into subfolders by transformation type (Concatenated, Datum, and Parametric).
- Additionally, when applicable, there may be a folder of Generated Transformations that consists of two transformations via an intermediate datum. Pairs of transformations displayed in this folder are created on-the-fly, and will correlate the Coordinate Transformations that are defined in the Datasource between the underlying geodetic of the source and target coordinate systems.
- The transformations are limited by source and target CRS selections.
- The default Area of Use filtering also limits transformations to the coordinates being transformed. If the desired transform is not showing up, set "Ignore Area of Use" in Settings. This allows using a transformation outside of its defined AOU polygon.
- Click the desired transformation. If a vertical transformation is needed, you will be prompted to select one. Then, the Select Transformation dialog window will close automatically and the selected transformation(s) will be shown.
If no transformation is needed, an alert message stating this will appear in the display box.
If no valid transformations are found between the two datums the box will say "No Choices". If you do not select a CT before processing, you will receive a message similar to: "Info: Transform is not initialized, choose a transformation. If no choices are available, enable Allow “None” Transformations." The "None" transformation can be enabled in Settings.
6. A preview of the loaded data is displayed. Use the Select Column dropdown to assign Input columns in the Datagrid.
- Identify the Input latitude/northing, Input longitude/easting, and Input height (if used). If multiple columns are assigned the same dropdown setting, the first column set in order is the one that is used for input.
-
Create and assign columns for Output Latitude/Northing, Output Longitude/Easting, and Output Height (if used). Scale is optional for projected systems. Use the plus button
to add additional columns.
Use the "..." button in the header of each column to rename, change the order of, or add/remove existing columns if needed.
7. Process the file.
- Use the Preview button to view the calculated coordinates in the designated output columns within the Loaded Point File Datagrid.
- Use the Clear button to remove the loaded point data and reset all options.
- Click the Process button to calculate the output coordinates and download the new output file. Values will be read from the input columns for each row in the table, converted, and written to the specified output columns. Files from finished calculations are listed in the Processing Files section. To clear any of the processes listed, use the "x" button to the right.
Point File Forward Calculation
A Forward Calculation is used to compute a new coordinate that is a given distance and azimuth away from a starting coordinate. Forward calculations follow one of three paths: Geodesic (Great Circle), Rhumb Line (constant azimuth), or Grid distance (valid only for projected coordinates).
For both Forward and Inverse conversions, when height values are entered, the distance is scaled to a height above the ellipsoid.
Forward Calculation requires the following:
- Enter the starting coordinate pair as the source point
- Set the source and target coordinate system (target must be on the same datum as the starting source system)
- Enter the desired distance and azimuth from the starting coordinate
- Choose the line calculation method (Geodesic, Rhumb, or Grid)
How to set up the Point File Forward Calculation:
- Load a point file by clicking the Open File button.
- Set the appropriate header options, then click the Reload button to apply the changes to the loaded data.
- Header Rows - The number of rows at the top of the file that either contain the column header (label) or other header information not to be included in processing.
- Label Row - This option appears when multiple header rows are indicated. Use this to identify which row number contains the column labels.
- Preview Rows - the number of rows to display in the browser for preview.
- Choose output file settings.
- Output File extension - choose which file type the completed calculation should be exported as. This can be the same as the input file. The default point file output type is .XLSX.
- Save Header - enabling this option will preserve the existing header row displayed in the datagrid in the output file and preview window after processing. If left disabled, the output file and preview will contain the calculated output without the displayed header.
-
Define Output Filename - Leave this field blank unless you would like to change the name of your output file. If left blank, the input filename will be used as the base of the output filename.
Use the arrow button to switch between adding a Suffix or Prefix:
- Add Suffix - Use this option to add a suffix to the original file name. The default is "_output".
- Add Prefix - Use this option to add a Prefix to the original file name. The default is "output_".
Point File results are automatically downloaded to your computer in the file location determined by your browser settings. The default option is typically the Downloads folder. Consult your browser settings to determine or change this path.
4. Under Transformation Operation Type, choose Forward.
5. Specify the Source and Target Coordinate systems. If available, the Source coordinate system will populate from the Coordinate Reference System (CRS) information associated with the loaded data file. If needed, you can set the coordinate system manually. The source and destination coordinates must be referenced to the same geodetic datum to calculate Forward.
Select a Source and Target Coordinate System
- Use the Search button
next to the Horizontal system field to launch the selection dialog. On the left side of the selection dialog, use the text field to narrow the options or expand the folders to locate your source horizontal CRS on the right side of the dialog.
- The default is WGS 84 [EPSG:4326], but this can be changed in Settings. Recently used coordinate systems will populate the dropdown.
- Use the
icon to see information on the chosen CRS. Click your desired horizontal CRS, and the dialog window will close automatically. The system, datum, and units fields will update accordingly. You may optionally search for and change the source or target units if needed.
- Use the Search button
next to the Vertical coordinate system to launch the selection dialog. Setting a different vertical system on the target will prompt for a vertical transformation. Setting a vertical coordinate system is optional; if the data does not have elevation values, it will not be possible to assign a vertical coordinate system.
- The Date field will display if time-dependent transformations are enabled in Settings. Source and target dates are required for time-dependent transforms to display in the transformation selection choices.
- Set the Target coordinate system using the same steps as above.
- For more information, see Searching the Datasource.
Supported Coordinate Formats
Use the Format button to select the display format and precision for your input and output coordinates. This is very important for angular units.
You can enter latitude and longitude degree coordinate values in many formats, not only decimal degrees. The formats that you can select are shown below with an example (all examples represent the coordinate: South 44 degrees, 30 minutes, 15 seconds):
- DD. (example: -44.50416 or 44.50416 S)
- DD MM. (example: -44 30.2500 or 44 30.2500 S)
- DD-MM. (example: -44-30.2500 or 44-30.2500 S)
- DD MM SS. (example: -44 30 15.000 or 44 30 15.000 S)
- DD-MM-SS. (example: -44-30-15.000 or 44-30-15.000 S)
- DD.MM (example: -44.3025 or 44.3025 S)
- DD.MMSS (example: -44.3015 or 44.3015 S)
- Packed DMS (example: -44301500 or 44301500S)
- Packed DMS. (example: -443015.00 or 443015.00S)
- Packed DM. (example: -4430.2500 or 4430.2500S)
- Brazil ANP (example: -44:30:15,000)
The direction (N/S/E/W) can be entered as either a prefix or suffix.
- Set the Method (Geodesic, Rhumb, or Grid) along with distance and azimuth from the starting coordinate.
- A preview of the loaded data is displayed. Use the Select Column dropdown to assign Input columns in the Datagrid.
- Identify the columns that contain the Input latitude/northing, Input longitude/easting, and Input Height (if used). If multiple columns are assigned the same dropdown setting, the first column set in order is the one that is used for input.
- Identify the columns that contain the Input Distance and Input Azimuth.
-
Create and assign columns for Output Latitude/Northing, Longitude/Easting, and Output Height (if used). Scale is optional for projected systems. Use the plus button
to add additional columns.
Use the "..." button in the header of each column to rename, change the order of, or add/remove existing columns if needed.
- Process the file.
- Use the Preview button to view the calculated coordinates in the designated output columns within the Loaded Point File Datagrid.
- Use the Clear button to remove the loaded point data and reset all options.
- Click the Process button to calculate the output coordinates and download the new output file. Values will be read from the input columns for each row in the table, converted, and written to the specified output columns. Files from finished calculations are listed in the Processing Files section. To clear any of the processes listed, use the "x" button to the right.
Point File Inverse Calculation
The Inverse Calculation computes the distance between two known coordinates on the same datum. The result may be calculated using Geodesic, Rhumb, or Grid (valid for projected coordinates only) methods. Both the source and destination points must be referenced to the same geodetic base coordinate system.
Inverse Calculation requires the following:
- Under Transformation, click the Operation Type drop-down and select Inverse.
- Source and Target Coordinate Point Definitions
- Source and Target Point Coordinate systems, both on the same Datum
The Distance, Azimuth, and Back Azimuth will be calculated from those parameters.
How to set up the Point File Inverse Calculation:
- Load a point file by clicking the Open File button.
- Header Rows - The number of rows at the top of the file that either contain the column header (label) or other header information not to be included in processing.
- Label Row - This option appears when multiple header rows are indicated. Use this to identify which row number contains the column labels.
- Preview Rows - the number of rows to display in the browser for preview.
- Set the appropriate header options, then click Refresh to apply the changes to the loaded data.
- Choose output file settings.
- Output File extension - choose which file type the completed calculation should be exported as. This can be the same as the input file. The default point file output type is .XLSX.
- Save Header - enabling this option will preserve the existing header row displayed in the datagrid in the output file and preview window after processing. If left disabled, the output file and preview will contain the calculated output without the displayed header.
- Define Output Filename - Leave this field blank unless you would like to change the name of your output file. If left blank, the input filename will be used as the base of the output filename.
-
Use the arrow button to toggle between adding a Suffix or Prefix:
- Add Suffix - Use this option to add a suffix to the original file name. The default is "_output".
- Add Prefix - Use this option to add a Prefix to the original file name. The default is "output_".
Point File results are automatically downloaded to your computer in the file location determined by your browser settings. The default option is typically the Downloads folder. Consult your browser settings to determine or change this path.
- Under Transformation Operation Type, choose Inverse.
- Specify the Source and Target Coordinate systems. If available, the Source coordinate system will populate from the Coordinate Reference System (CRS) information associated with the loaded data file. If needed, you can set the coordinate system manually. The source and destination coordinates must be referenced to the same geodetic datum.
Select a Source and Target Coordinate System
- Use the Search button
next to the Horizontal system field to launch the selection dialog. On the left side of the selection dialog, use the text field to narrow the options or expand the folders to locate your source horizontal CRS on the right side of the dialog.
- The default is WGS 84 [EPSG:4326], but this can be changed in Settings. Recently used coordinate systems will populate the dropdown.
- Use the
icon to see information on the chosen CRS. Click your desired horizontal CRS, and the dialog window will close automatically. The system, datum, and units fields will update accordingly. You may optionally search for and change the source or target units if needed.
- Use the Search button
next to the Vertical coordinate system to launch the selection dialog. Setting a different vertical system on the target will prompt for a vertical transformation. Setting a vertical coordinate system is optional; if the data does not have elevation values, it will not be possible to assign a vertical coordinate system.
- The Date field will display if time-dependent transformations are enabled in Settings. Source and target dates are required for time-dependent transforms to display in the transformation selection choices.
- Set the Target coordinate system using the same steps as above.
- For more information, see Searching the Datasource.
Supported Coordinate Formats
Use the Format button to select the display format and precision for your input and output coordinates. This is very important for angular units.
You can enter latitude and longitude degree coordinate values in many formats, not only decimal degrees. The formats that you can select are shown below with an example (all examples represent the coordinate: South 44 degrees, 30 minutes, 15 seconds):
- DD. (example: -44.50416 or 44.50416 S)
- DD MM. (example: -44 30.2500 or 44 30.2500 S)
- DD-MM. (example: -44-30.2500 or 44-30.2500 S)
- DD MM SS. (example: -44 30 15.000 or 44 30 15.000 S)
- DD-MM-SS. (example: -44-30-15.000 or 44-30-15.000 S)
- DD.MM (example: -44.3025 or 44.3025 S)
- DD.MMSS (example: -44.3015 or 44.3015 S)
- Packed DMS (example: -44301500 or 44301500S)
- Packed DMS. (example: -443015.00 or 443015.00S)
- Packed DM. (example: -4430.2500 or 4430.2500S)
- Brazil ANP (example: -44:30:15,000)
The direction (N/S/E/W) can be entered as either a prefix or suffix.
- Set the Method: Geodesic, Rhumb, or Grid.
- A preview of the loaded data is displayed. Use the Select Column dropdown to assign Input columns in the Datagrid.
- For the first point in each pair, identify the columns that contain the Input latitude/northing, Input longitude/easting, and Input Height (if used). If multiple columns are assigned the same dropdown setting, the first column set in order is the one that is used for input.
- For the second point in each pair, identify the columns these as the Output Distance and Output Azimuth.
- Create and assign columns for Distance, Azimuth, and Back Azimuth. Use the plus button
to add additional columns. Use the "..." button in the header of each column to rename, change the order of, or add/remove existing columns if needed.
- Process the file.
- Use the Preview button to view the calculated values in the designated output columns within the Loaded Point File Datagrid.
- Use the Clear button to remove the loaded point data and reset all options.
- Click the Process button to calculate the values and download the new output file. Values will be read from the input columns for each row in the table, converted, and written to the specified output columns. Files from finished calculations are listed in the Processing Files section. To clear any of the processes listed, use the "x" button to the right.