Thank you for downloading this release of the SRM Software Development Kit (SRM SDK). The SRM SDK is the development environment for creating applications that use the Spatial Reference Model (SRM), a conceptual model that allows a set of spatial reference frames to be defined in such a way that they describe geometric properties uniquely. The SRM supports unambiguous specification of the positions, directions, distances, and times associated with spatial information. It also defines algorithms for precise transformation of positions, directions and distances (for a given time) among different spatial reference frames. Its spatial operation algorithms are designed to achieve high accuracy (typically 1 mm "error ball" accuracy), and are optimized to achieve very high performance measures without compromising that accuracy.
This release has been tested on multiple platforms, such as Linux, Irix, Sun, and Windows 98/Me/NT/2000. For detailed information on platform and compiler versions supported see the Build Kit.
For help, comments, and bug reports please send email to help@sedris.org. If you are an associate, please use se-coders@sedris.org.
Return to: Top
This version of the SDK is being made available in three API implementations, and distribution formats. The three API implementations are in C, C++ and Java. In addition to source code, pre-compiled binaries for all supported platforms can be downloaded from the SEDRIS web site (www.sedris.org).
The following matrix table shows the contents of the different packages and the directories you will find in them (note that the links on the column headers take you to the directories, so they may not work depending on your distribution and, as in the case of a source distribution, on whether you have compiled the libraries and/or applications):
Package and Contents bin: Compiled binaries for applications
docs: Documentation, including Release Notes and Reference Manual
include: Header files for applications and libraries
lib: Compiled binaries for libraries
src: Source code and headers for libraries and applications
Complete Suite Source:
- Libraries
- Applications
- Documentation
X X Complete Suite Binary:
- Libraries and available extensions
- Applications
- Documentation
X X X X Return to: Top
The SRM SDK is distributed as a GNU-zipped tar file for Unix systems and a Zip file in Win32 systems.
Note: This is a major release and it is not compatible with the earlier versions of SEDRIS releases.
To install, extract the contents of the compressed file:
- Unix
Use the "tar" and "gzip" commands to extract the contents of the SDK:
using the appropriate filename for "sdk_file.tar.gz".gunzip -c sdk_file.tar.gz | tar xf -If you have GNU tar installed, you can use the following command instead:
tar xzf sdk_file.tar.gz
- Win32
Use WinZip or other decompression utility to extract the contents of the downloaded file.
If you are installing the SRM SDK under the SEDRIS SDK, you will need to extract the contents of the file into the "sedris/src/lib" directory of the SEDRIS SDK, so that the extraction process puts all the files in the "sedris/src/lib/srm" directory.
See the Build Kit page for information on how to compile and link the software, and how to link your applications or libraries against this SDK.
Note that the file name for binary releases includes the OS/System architecture type as part of the name. After extracting the software, users should see a top-level "srm" directory. Binary releases associated with different OS/architecture can be installed on a common "srm" directory. This is to allow users who work on several platforms to install all the releases under a common "srm" directory in a shared network drive. In that case, on each installation, the non-OS-specific files are replaced by the new release and the OS specific libraries and executables are stored under their respective sub-directories under the "lib" and "bin" directories discriminated by their platform/version/architecture combination.
Return to: Top
The SDK Documentation is divided into the following areas:
- Release Notes (this document)
- Describes the capabilities of this release, its contents, and supported platforms and compilers.
- Build Kit.
- SRM API Documentation.
- SRM C API
- SRM C++ API
- SRM Users' Guide
- SRM C API Users' Guide
- SRM C++ API Users' Guide
Return to: Top
This release includes a sample application that demonstrate the use of the SRM SDK.
Applications:
- Sample SRM Access
- An application converts a 3D coordinate from a Celestiodetic SRF to a Celestiocentric SRF.
Return to: Top
The table below summarizes the changes in this release.
Features
- The C++ API is mostly implemented and compatible with SRM FDIS. The C API is compliant with the SRM FDIS C LB. See Limitations.
- Added new functionality:
- Get CS Code function.
- Conversion of coordinate arrays.
- Support for the British OSGRS80 Grid standard SRF.
- Changes due to SRM FDIS
- The new C API is object-based and compliant with the SRM FDIS C LB.
- The M, PS, and EC SRF have their latitude parameter removed. It was previously ovespecified.
- The RT (previously known as HSR) codes are now numbered is sequence.
- The suport for the Europe 1950 and Geocentric Datum Australia 1994 standard SRFs were removed.
- Several ORMs and their corresponding RTs were removed. Most of those are not commonly used.
Fixes
- Fixed conversions involving the LTSAS SRF.
Return to: Top
For users who have developed applications using the SRM C API version 4.0 the SRM C API 4.0 to 4.1 Migration Guide describes the main differences between the two versions.
- The calculateVerticalSeparationOffset() method only supports the EGM96_GEOID and WGS84_ELLIPSOID DSS codes.
- The calculateConvergenceOfTheMeridian() method does not work for Polar Stereographic SRF.
- The instanceAbstractSpaceCoordinate() method is not implemented.
- The "get natural region" methods only support the UTM and GTRS SRF sets.
Questions, comments, and bug reports should be sent to help@sedris.org.
If you are an associate, please send email to se-coders@sedris.org.
Return to: Top
These links require Internet access.
Return to: Top
Copyright © 2006 SEDRIS™