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 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
lib: Compiled binaries for libraries
src: Source code for the libraries and applications
Complete Suite Source:
- Libraries
- Applications
- Documentation
X X Complete Suite Binary:
- Libraries and available extensions
- Applications
- Documentation
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 minor release. It is compatible with earlier 4.1.x 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.tgz".gunzip -c sdk_file.tgz | tar xf -If you have GNU tar installed, you can use the following command instead:
tar xzf sdk_file.tgz- Win32
Use WinZip or other decompression utility to extract the contents of the downloaded file.
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 there is only one SRM JAR file and it is compatible with all platforms with the Java 2 Runtime Environment installed.
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 Users' Guide
Return to: Top
This release includes a sample application that demonstrates the use of the SRM SDK.
Applications:
- Sample SRM Access
- This application converts a 3D coordinate from a Celestiodetic SRF to a Celestiocentric SRF.
Return to: Top
The list below summarizes the changes in this release.
- The parameters of the following SRM RTs have been updated to correspond to the draft 3rd edition of the SRM ISO specification:
- GEOMAGNETIC_1945_DGRF
- GEOMAGNETIC_1950_DGRF
- GEOMAGNETIC_1955_DGRF
- GEOMAGNETIC_1960_DGRF
- GEOMAGNETIC_1965_DGRF
- GEOMAGNETIC_1970_DGRF
- GEOMAGNETIC_1975_DGRF
- GEOMAGNETIC_1980_DGRF
- GEOMAGNETIC_1985_DGRF
- GEOMAGNETIC_1990_DGRF
- GEOMAGNETIC_1995_IGRF
- GEOMAGNETIC_2000_IGRF
- JUPITER_MAGNETIC_1993_VOYAGER
- NEPTUNE_MAGNETIC_1993_VOYAGER
- RGF_1993_IDENTITY_BY_MEASUREMENT
- URANUS_MAGNETIC_1993_VOYAGER
Return to: Top
The list below summarizes the changes since 4.0.
- Added the following methods to the BaseSRF class to retrieve ORM parameter values associated with the SRF:
- getA() - method to retrieve the semi-major axis (A) value.
- getF() - method to retrieve the flattening (F) value.
- Updated the validation for SRFs and coordinates to align with SRM edition 2. Consequently, the updated boundaries now recognized in edition 2 are recognized by the implementation (e.g. the poles for Celestiodetic and Planetodetic). However, for chained conversions such as CD - TM, in which the points are valid for an early SRF in the chain but not for a later SRF in the chain, the conversion will be still rejected as having invalid input.
- The valid coordinate range of celestiodetic SRFs previously did not did not include the poles. This has been addressed.
- The valid coordinate range of planetodetic SRFs previously did not did not include the poles. This has been addressed.
- The valid coordinate range of azimuthal spherical SRFs previously did not include the origin. This has been addressed.
- Added experimental ORMs and RTs to support NGA golden data. In the process, added experimental RDs to support NGA golden data, and fixed labels for internal SRM_OBRS_Code, ORMT_Code, and SRM_RD_Code classes' enumerants to comply with the SRM specification.
- Added a static getImplVerInfo() method in the BaseSRF class to return the SRM Java implementation version number.
- Fixed a problem related to geodesic distance computation when the two input coordinates are on the same parallel.
- CD - LCC and LCC - CD coordinate conversions have been updated to prevent a loss of accuracy near the poles.
- CD - TM and TM - CD coordinate conversions have been updated for spherical ORMs.
Return to: Top
- Conversion involving the Local Tangent Space Azimuthal Spherical SRFT is not fully tested.
- The conversion involving Local Space Rectangular 2D SRF only supports positive forward directions.
- The calculateVerticalSeparationOffset() method only supports the EGM96_GEOID and WGS84_ELLIPSOID DSS codes.
- The "get natural region" methods only support the UTM and GTRS SRF sets.
- The instanceAbstractSpaceCoordinate() method is not implemented. It will be eliminated in a future release of the SRM.
- The Local Space Polar coordinate component ordering should be reversed so that it is explicitly treated as a right-handed system. This will be addressed in a future release of the SRM to comply with SRM edition 2.
- The Planetodetic coordinate component ordering for the latitude and longitude values should be reversed, with latitude preceding longitude, so that it is explicitly treated as a right-handed system. This will be addressed in a future release of the SRM to comply with SRM edition 2. The conversions internally correct for this in the meantime.
- Solar Magnetic Dipole should be formulated as a Euclidean rather than an angular coordinate system. This will be addressed in a future release of the SRM to comply with SRM edition 2.
- Solar Magnetic Ecliptic should be formulated as a Euclidean rather than an angular coordinate system. This will be addressed in a future release of the SRM to comply with SRM edition 2.
Return to: Top
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 © 2011 SEDRIS