Filename: "ReadMe-ULCN2005.txt" Version: 2007.01.10 Included here is a description of the Unified Lunar Control Network 2005 files and topographic model files produced from Unified Lunar Control Network 2005 (ULCN2005) solution. The directory structure used for the files separates them into three categories: 1) solution input and output files (sub directory "solution"); 2) Miscellaneous derived files of interest (sub directory "derived"); and 3) global DEMs and DEM images (sub directory "dems"). Where appropriate, text explanations of file formats are also included as ASCII (ASC) and Adobe Acrobat (PDF) files. Some further details on the files are given in the "Available Files" section of the main Open File Report write-up. The points from the ULCN2005 solution were used to create the global DEM (topographic grid) files. There were two different processes used to create the grids and they are explained below in the explanation for the ../dems/Arc_grids directory. Depending on the process the relevant files will have either 1) "grid" or 2) "lpo" or "LPOLY" in the filename. All processing for creating the grids was done in ArcMap 9.1. Note that for clarity, some files have been renamed from their original solution processing filenames, as noted below. Files with *.zip in the filename were compressed with ZIP compression and files with *.gz were compressed with gzip compression. Directory Structure: =================== ../ ../dems ../dems/Arc_grids ../dems/Images_16 ../dems/ISIS_BIL ../derived ../solution This (upper level) directory: ============================ Filename: Description: ReadMe-ULCN2005.txt - This file. ULCN2005-OpenFile.pdf - Primary text for USGS Open File report. In Adobe PDF format. ../dems directory: ================= Filename: Description: ULCN2005_DEMS_data_thumbnail.gif - Thumbnail view, 350 x 184 pixels, of overall DEM in GIF format. ../dems/Arc_grids directory: =========================== This directory contains the elevation data in formats that can be read directly by ESRI products. ARC GRID format has two sub directories; an INFO sub- directory with geo-location information and a subdirectory with the elevation information. The second format is an ESRI ASCII format that can be read by different software packages. The ESRI ASCII grid files consist of a 6 line header and then the topographic values. An example of the header is as follows: ncols 5760 nrows 2880 xllcorner -180 yllcorner -90 cellsize 0.0625 NODATA_value -32768 This header provides ncols for number of columns, nrows for number of rows, xllcorner is the x location of the lower left grid cell and is the lower left corner of the grid cell (here -180 degrees longitude), yllcorner is the y location of the lower left grid cell and is the lower left corner of the grid cell (here -90 degrees latitude), cellsize is the size of the grid cell, and NODATA_value is a value that signifies that the grid cell does not contain a topographic value. For these grids, all grid cells have a topographic value. Filename: Description: ULCN2005_GRID.zip - ARC Grid format. This grid minimizes the differences between the points and the topographic value assigned to the grid cell. The points were buffered mirroring the edges with their adjacent edges. This resulted in having the points cover a spatial area of +/- 185 degrees in longitude and +/- 95 degrees in latitude. The points were displayed in a simple cylindrical projection and a triangulated irregular network (TIN) topographic file was constructed from these points. This was converted to a grid with an extent +/- 180 degrees longitude and +/- 90 degrees of latitude and a cell size of 0.0625 degrees (16 cells per degree and approximately 1.8 km per cell.) Topographic files produced from this grid will have "grid" in the filename. ULCN2005_LPOLY.zip - ARC Grid format. This grid removes outliers in the topographic data by smoothing the data. A local polynomial of degree 1, with a segmented a circular search area having four segments to select the closest points (minimum of 5 maximum of 25 points per segment) was used to create a surface. The points were divided into three overlapping regions: north polar, equatorial, and south polar. The points in the equatorial region were mirrored to reflect the points at the +/- 180 degree edges. The local polynomial interpolator, with the same parameters, was run on the three regions. The polar regions were in a stereographic polar projection and the equatorial region was in a simple cylindrical projection. The polar regions were projected back into a simple cylindrical projection and clipped. The north polar region was clipped to cover an area from +/- 180 degrees in longitude and 90 to 58 degrees in latitude, the south polar region was clipped from +/- 180 degrees in longitude and -90 to -58 degrees in latitude, and the equatorial region was clipped from +/- 180 degrees in longitude and +/- 58.5 degrees in latitude. This provided a half degree overlap between the regions. The grids from the three clipped regions were merged and averaged together to create a grid covering +/- 180 degrees in longitude and +/- 90 degrees in latitude. Topographic files produced from this grid will have lpo or LPOLY in the file name. ULCN2005_grid.txt.gz - Topographic model in ESRI ASCII format. ULCN2005_lpo.txt.gz - Topographic model in ESRI ASCII format. ../dems/Images_16B directory: ============================ This directory contains the elevation data in a TIFF format that can be read by various applications such as ENVI and IDL. The TIFF files are georeferenced and a detached world file is provided (*.tfw). Elevation data is in INTEGER 16 bit signed data format. The world files can be used with many GIS products to geo- locate the image. Projection information is not included in the file. An example of the world file is as follows: 0.0625 0 0 -0.0625 -179.96875 89.96875 The units are degrees. The first value is the size of the grid cell in the x direction. The second and third terms are rotation terms and are not used. The fourth term is the negative of the size of the grid cell in the y direction. This value is negative because the origin is located in the upper left corner. The fifth term is the x coordinate of the center of the upper left grid cell. The sixth term is the y coordinate of the center of the upper left grid cell. Filename: Description: ulcn2005_grid.tfw - World file for the topographic model based on grid interpolation method ulcn2005_grid.tif.gz - Elevation model based on grid interpolation method ulcn2005_lpo.tfw - World file for the topographic model based on local polynomial interpolation method ulcn2005_lpo.tif.gz - Elevation model based on local polynomial interpolation method ../dems/ISIS_BIL directory: ========================== This directory contains the elevation data in formats that can be read by ISIS and other software packages. The ASCII grid files were converted to ISIS cub files and the projection information was entered into the label. The cub files are in a simple cylindrical map projection in the 180 degree longitude system with the positive longitude direction of east and the A_AXIS_RADIUS, B_AXIS_RADIUS, and C_AXIS_RADIUS values are all equal to 1737.4. CORE_NAME is set to PLANETARY_RADIUS; CORE_UNIT is set to METERS; and the CORE_BASE of 1737400. This signifies that the values are meters referenced to a sphere of 1737400 m. The ISIS (cub) files were converted to Band Interleaved Files (BIL) formatted files. The *.bil files and *.cub files are identical. The *.bil files are stored as 16 bit signed data with only one layer. Many image viewers can read BIL format. Projection information is not included in the file. The header file (hdr) can be used with software that understands detached headers to read the BIL and 16 bit cub file. The *.hdr provides a skipbytes parameter that allows programs that understand bil files to skip over the ISIS labels and read the data. An example of a BIL header file is as follows: nrows 2880 ncols 5760 nbands 1 nbits 16 byteorder I layout BIL skipbytes 26112 ulxmap -5457255.47164614 ulymap 2728153.93347269 xdim 1895.20940150934 ydim 1895.20940150934 nodata -32768 NOTE: The ulxmap and ulymap are in simple cylindrical coordinates in meters and xdim and ydim are in meters. Filename: Description: ulcn2005_grid_bil_16b.bil.gz - BIL file format with elevation model based on grid interpolation method. ulcn2005_grid_bil_16b.hdr.gz - Detached header file for file ulcn2005_grid_bil_16b.bil.gz ulcn2005_grid.cub.gz - ISIS file format with elevation model based on grid interpolation method. The following website has information about ISIS: http://astrogeology.usgs.gov/Projects/ISIS/ ulcn2005_lpo_bil_16b.bil.gz - BIL file format with elevation model based on local polynomial interpolation method. ulcn2005_lpo_bil_16b.hdr.gz - Detached header file for file ulcn2005_lpo_bil_16b.bil.gz ulcn2005_lpo.cub.gz - ISIS file format with elevation model based on local polynomial interpolation method. The following website has information about ISIS: http://astrogeology.usgs.gov/Projects/ISIS/ ../derived directory: ==================== Filename: Description: ID_KEY_FSC.csv - Relates the Clementine Image Product ID to the original Product ID to the image number (IMAGE KEY ID) and the orbit. Useful to go from the image number used in the pixel measurement file (see file "ULCN2005-pixel-measures.dat" below) to the filename of an image. Comma separated file that lists: PRODUCT_ID - The product id assigned to a Clementine image. ORIGINAL_PRODUCT_ID - The original product id assigned to a Clementine image. IMAGE_NUMBER - The image number assigned to a Clementine image. id_orbit - The orbit in which the Clementine image was obtained. ISIS-PG-FMT611.asc - Description of format of file ULCN2005-evpest-output.dat. In ASCII format. ISIS-PG-FMT611.pdf - Description of format of file ULCN2005-evpest-output.dat. In Adobe PDF format. ulcn2005_all_points_evp_fieldlist.txt - Describes the fields within the shapefile ULCN2005_shapefile.zip (see below). ULCN2005-evpest-output.dat - Control point estimated expected vertical precision (including range, resolution, and stereo angle information). See file ISIS-PG-FMT611.* for format. (Original name: "evpest-MOON0056-060410a-out.dat"). ULCN2005_POINTS.txt.gz - Text file with points from final solution, expected precision, and spot elevations from grids derived from these points. A simple ASCII listing file that includes, for each ULCN 2005 control point the following information: Pt_name - point name. The 22 points that tied the ULCN to the CLCN are place or feature names (i.e. Clerke). Other points from the ULCN are either a number (i.e. 655) or start with M or P and then a number (e.g. P7084 or M5). The Clementine points are 2 letters, 4 numbers, and then 1 letter. set - a number 1-5 indicating the data source (1 - Apollo Network, 2 - Telescopic Network, 3 - Mariner 10 Network, 4 - Galileo Network, and 5-CLCN.) measures - number of measurements on a point. evp_m - expected vertical precision in meters. lat - latitude (degrees) from final solution of ULCN2005. lon_360 - longitude (degrees) in positive east 360 longitude system from final ULCN2005 solution. lon_180 - longitude (degrees) in positive east 180 longitude system from final ULCN2005 solution. radius_km - radius value for point in kilometers from final ULCN2005 solution. ht_m - height in meters referenced to a sphere of 1,737,400 meters based on radius_km value. lpo_ht - height in meters referenced to a sphere of 1,737,400 meters based on interpolating a grid using a local polynomial interpolator on the radius_km values. lpo_diff - difference between the lpo_ht and the ht_m. grid_ht - height in meters referenced to a sphere of 1,737,400 meters based on interpolating a grid using a bilinear interpolator between the radius_km values. grid_dif - difference between the grid_ht and the ht_m. ULCN200_shapefile.zip - ARC shape file with the ULCN2005 points. ULCN2005-sorted-residuals.dat - Measurement residuals in mm and pixels, from last iteration, sorted with largest first. (Original name: "zcheMOON0056-060111-rms-sort.dat"). ../solution directory: ===================== Filename: Description: ISIS-PG-FMT101.asc - Description of format of file ULCN2005-pixel-measures.dat. In ASCII format. ISIS-PG-FMT101.pdf - Description of format of file ULCN2005-pixel-measures.dat. In Adobe PDF format. ISIS-PG-FMT501.asc - Description of format of file ULCN2005-control.dat. In ASCII format. ISIS-PG-FMT501.pdf - Description of format of file ULCN2005-control.dat. In Adobe PDF format. ISIS-PG-FMT502.asc - Description of format of file ULCN2005-input.dat. In ASCII format. ISIS-PG-FMT502.pdf - Description of format of file ULCN2005-input.dat. In Adobe PDF format. ISIS-PG-FMT503.asc - Description of format of file ULCN2005-mm-measures.dat. In ASCII format. ISIS-PG-FMT503.pdf - Description of format of file ULCN2005-mm-measures.dat. In Adobe PDF format. ISIS-PG-FMT511.asc - Description of format of file ULCN2005-printout.dat. In ASCII format. ISIS-PG-FMT511.pdf - Description of format of file ULCN2005-printout.dat. In Adobe PDF format. ULCN2005-commandfile.cmd - Linux processing solution command file. This file has been rewritten for clarity from the original command file ("randlsq-MOON0056-060111.cmd"). ULCN2005-control.dat - Input control records to the randlsq solution program. See file ISIS-PG-FMT501.* for format. (Original name: "zparMOON0054-051211.dat"). ULCN2005-input.dat - Input a priori information file. See file ISIS-PG-FMT502.* for format. (Original name: "zinpMOON0056-060111.dat"). ULCN2005-mm-measures.dat - Measurement input file, with measures expressed as mm in X and Y in the image plane. See file ISIS-PG-FMT503.* for format. (Original name: "clem-new_051211.dat"). ULCN2005-pixel-measures.dat - Measurement input file, with measures in pixels of line and sample. See file ISIS-PG-FMT101.* for format. (Original name: "Clem-ULCN05-051211-edit.dat"). ULCN2005-output.dat - Main ULCN 2005 solution output file, with updated control point positions and camera angle information. See file ISIS-PG-FMT512.* for format. (Original name: "zoutMOON0056-060111.dat"). ULCN2005-printout.dat - Main solution printout file, containing initial solution setup information and residuals and solution RMS information from each iteration. See file ISIS-PG-FMT511.* for a description of this output. (Original name: "zcheMOON0056-060111.dat"). ULCN2005-progress-output.dat - Solution progress (system) output file, containing information on progress, including execution timing, of solution. (Original name: "randlsq-MOON0056-060111.out"). End of file "ReadMe-ULCN2005.txt".