THE USGG2012 README FILE ----------------------- Original: July 16, 2012 (drr) The USGG2012 MODEL ----------------- You have downloaded these files from the National Geodetic Survey (NGS) web site. Files you may have received include: INTG.EXE (PC) or The geoid interpolation program INTG (Solaris) (source code is available) XNTG.EXE (PC) or Program for extracting, translating (ASCII/binary) XNTG (Solaris) and yielding statistics of geoid files (source code is available) Ensure that you have downloaded these programs from this page as these are the most recent versions that will definitely read the GEOID12 and USGG2012 models. Previous versions of INTG and XNTG may not. The following file names are valid for binary files. However, if you downloaded the ASCII versions of these files, the suffix will be ".asc" rather than ".bin"): Grid Name Model Region Covered (latitude & both East/West longitude) s2012u00.bin USGG2012 entire grid for CONUS (24-58N, 230-300E/130-60W) s2012u01.bin USGG2012 grid #1 for CONUS (40-58N, 230-249E/130-111W) s2012u02.bin USGG2012 grid #2 for CONUS (40-58N, 247-266E/113-94W) s2012u03.bin USGG2012 grid #3 for CONUS (40-58N, 264-283E/96-77W) s2012u04.bin USGG2012 grid #4 for CONUS (40-58N, 281-300E/79-60W) s2012u05.bin USGG2012 grid #5 for CONUS (24-42N, 230-249E/130-111W) s2012u06.bin USGG2012 grid #6 for CONUS (24-42N, 247-266E/113-94W) s2012u07.bin USGG2012 grid #7 for CONUS (24-42N, 264-283E/96-77W) s2012u08.bin USGG2012 grid #8 for CONUS (24-42N, 281-300E/79-60W) s2012a00.bin USGG2012 entire grid for Alaska (60-72N, 172-204E/188-126W) s2012a01.bin USGG2012 grid #1 for Alaska (60-72N, 172-204E/188-156W) s2012a02.bin USGG2012 grid #2 for Alaska (60-72N, 202-234E/158-126W) s2012a03.bin USGG2012 grid #3 for Alaska (49-61N, 172-204E/188-156W) s2012a04.bin USGG2012 grid #4 for Alaska (49-61N, 202-234E/158-126W) s2012h00.bin USGG2012 entire grid for Hawaii (18-24N, 199-206E/161-154W) s2012g00.bin USGG2012 entire grid for Guam/CNMI (11-18N, 143-146E/217-214W) s2012p00.bin USGG2012 entire grid for Puerto Rico and U.S. Virgin Islands (13-21N, 291-296E/69-64W) s2012s00.bin USGG2012 entire grid for American Samoa (17-11S, 186-192E/174-168W) To Install: 1) Make a subdirectory on your hard disk. 2) Copy the various geoid files into that subdirectory. You need not put the geoid files in the same directory as the INTG and XNTG programs though you will need to then specify the path. If you have also received GEOID12 or any other model files, you may safely place them in the same directory as USGG2012, if you like. To Execute (PC or Sun) Type INTG, and follow the prompts in a Command Prompt shell in Windows or a Unix terminal to ensure that it doesn't close immediately after completion to permit examination of the output statistics. To Terminate You can stop the program at any time using C. File Structure --------------- The files (ASCII and binary) all follow the same structure of a one line header followed by the data in row-major format. The one line header contains 4 double (real*8) words followed by three long (int*4) words. These parameters define the geographic extent of the area: SLAT: Southernmost North latitude in whole degrees. Use a minus sign (-) to indicate South latitudes. WLON: Westernmost East longitude in whole degrees. DLAT: Distance interval in latitude in whole degrees (point spacing in E-W direction) DLON: Distance interval in longitude in whole degrees (point spacing in N-S direction) NLAT: Number of rows (starts with SLAT and moves northward DLAT to next row) NLON: Number of columns (starts with WLON and moves eastward DLON to next column) IKIND: Always equal to one (indicates data are real*4 and endian condition) After this one line header, the data follow. The first row represents the southernmost row of data with the first data point being in the SW corner. The row is NLON values wide spaced at DLAT intervals, and then increments to the next row which is DLAT to the north. This continues until the last row where the last value represents the northeast corner. The easternmost longitude is = WLON + (NLON - 1) * DLON, while the northernmost latitude is = SLAT + (NLAT - 1) * DLAT. Check The Byte Counts of all Downloaded Files --------------------------------------------- Before beginning, it will be useful to ensure that all files you have received are the correct size. (Download problems are often manifested by incorrect byte counts in the files). Check with the list below to make sure your files match these numbers exactly. These values are good for the PC and Sun versions of the data. PC or Sun Data: s2012u00.bin 34,297,008 bytes s2012u**.bin 4,933,728 bytes s2012a00.bin 20,554,848 bytes s2012a**.bin 5,540,208 bytes s2012h00.bin 607,968 bytes s2012g00.bin 304,848 bytes s2012p00.bin 434,688 bytes s2012s00.bin 521,328 bytes ASCII Data (uncompressed): s2012u00.asc 86,816,078 bytes s2012u**.asc 12,488,895 bytes s2012a00.asc 52,030,658 bytes s2012a**.asc 14,024,273 bytes s2012h00.asc 1,539,045 bytes s2012g00.asc 771,795 bytes s2012p00.asc 1,100,430 bytes s2012s00.asc 1,319,918 bytes C Program Source Code: INTG_V314.ZIP 106,269 bytes XNTG_V12.ZIP 28,914 bytes PC executables: INTG.EXE 122,331 bytes XNTG.EXE 127,414 bytes Sun executables: INTG 186,500 bytes XNTG 95,212 bytes How Program INTG Works ----------------------- The various geoid height grids are stored in the ".bin" files. Program INTG will prompt you for the name of the directory where you have chosen to store the .bin files, as well as prompting you for which geoid model you wish to use. You can operate with as few as one .bin file, or the entire geoid model data set. If a master file is given (e.g., s2012u00.bin for CONUS), then this will be preferentially used over the individual subgrids. When the program interpolates a given point, it checks an internal list of .bin boundaries, and uses the earliest list entry whose boundaries contain the best data scheme to interpolate that point. The order in which the .bin file names appear on the opening screen indicates the order in which the .bin files are searched. This applies especially to where the CONUS and Alaska grids overlap. When running program INTG.EXE (PC) or INTG (Sun), the latitude and longitude of each point must be input. USGG2012 models are all in IGS08 (2005.00) for all regions and refer to the same geopotential (W0) surface of 62,636,856.00 m**2/s**2. While the latitudes and longitudes in the NAD 83 and WGS84 systems are very close to those of the IGS08 system (with only 1-2 meters of horizontal shift), IGS08 coordinates should exclusively be used. If necessary, use HTDP (which is available in the NGS Tool Kit) to convert into IGS08. USGG2012 geoid heights will always reference IGS08/GRS-80, not NAD 83. GEOID12 geoid heights will always reference NAD 83, not IGS08/GRS-80. Do *NOT* use NAD 27 latitudes and longitudes. The horizontal shifts between IGS08 and NAD 27 can exceed 100 meters, causing a noticeable difference in the interpolated geoid value. To convert from NAD 27 to IGS08 latitudes and longitudes you may use program NADCON and the HTDP, both of which are available from the NGS Tool Kit. Data Input ---------- You can key data by hand, point by point, or you can create an input file using a text editor. Several file formats are provided, including the NGS "Blue Book" format. These formats are detailed in a "Help" menu option which appears if you specify that you wish to use an input file. Data Output ----------- Results may be collected into an output file. There is no default output file name. The format of the output file is linked to the format of the input file to maintain consistency. If, however, you input your data by keyboard, and ask for an output file, the format of that output file will be in the format known as "Free Format, Type 1". The USGG2012 Model ----------------- The USGG2012 model is known as a gravimetric geoid, as it is determined entirely from gravity field information from satellite and terrestrial sources. No effort is made to tie the potential surface to vertical control. The gravity field data are indicative of the changes in the geopotential surface and show the actual change in the vertical datum for physical (as in based on physics) heights. The W0 surface used to define USGG2012 is 62,636,856.00 m**2/s**2. It does not match any of the established, official vertical datums such as NAVD88, GUVD04, NMVD03, PRVD03, VIVD09, and ASVD03 orthometric heights. Use with OPUS Solutions ------------------------------------- Solutions from OPUS will generate derived orthometric heights that are representative of the future vertical datum surface. In 2022, NGS will adopt a gravimetric geoid model as the basis for determining physical heights. As such, the values derived on OPUS solution pages derives from the IGS08 solutions of the input GPS coordinates and the use of the USGG2012 model, which is also in IGS08. These heights are not official heights and differ significantly from heights above NAVD 88. Do not use them for that. Use them as a proxy indicator of what your future heights will be. The XNTG Utility Program ------------------------ The XNTG program can perform various functions, none of which are required to use the INTG program. The functions of XNTG are the extraction of sub-grids from the provided geoid grids, the translation between ASCII and binary grids, and the reporting of basic statistics for geoid grids. For More Information -------------------- For Products Available From the National Geodetic Survey: Information Services Branch National Geodetic Survey, NOAA, N/NGS12 301-713-3242 fax: 301-713-4172 For Information on GEOID12 and Future Research: Dr. Daniel Roman National Geodetic Survey, NOAA, N/NGS6 301-713-3202 Email: dan.roman@noaa.gov Dr. Yan Ming Wang National Geodetic Survey, NOAA, N/NGS6 301-713-3202 Email: yan.wang@noaa.gov Visit our web site: http://www.ngs.noaa.gov/GEOID/USGG2012