J-074 SW User Manual Part 1
Contents
1. 2 Table 4 1 Compile time Environment 22 4 Table 6 1 Dynamic IDPS Binaty PrOOUCIS cicer ine kp ni ae Re red ee tinc 12 JPSS CGS Form J 074A 04 20 2011 HARDCOPY UNCONTROLLED Doc UG60917 IDP 042 Rev Date 04 January 2012 Contract No NNG10XA03C Page 1 1 SCOPE The Binary Editor allows users to export and import data into a binary file that is defined by PRO XML The tool does not generate files from scratch but instead updates an existing binary file Users can import and export data as binary or ASCII text Users may also edit individual fields in the binary file with a graphical user interface 1 1 DOCUMENT OVERVIEW This document provides information to understand the PRO Binary Editor functionality specifically how the tool works inputs necessary to execute the tool outputs that the tool generates the Human Machine Interface HMI and tool limitations The person using this tool is generally referred to as the User HARDCOPY UNCONTROLLED JPSS CGS Form J 074A 04 20 2011 Doc UG60917 IDP 042 Rev Date 04 January 2012 Contract No NNG10XA03C Page 2 2 REFERENCE DOCUMENTS This section identifies the documents referenced in this document TABLE 2 1 REFERENCED DOCUMENTS Document Number Title UG6091 7 IDP 036 PRO XML Editor Users Manual LI60917 GND 005 JPSS CGS Acronyms amp Glossary UG6091 7 IDP 034 IDPS AD2. Then go to INSTALL DIR java and execute ant This will compile the tool with the output JAR files in a subdirectory called dist Other build targets include javadocs to build the javadoc and clean to remove all compiled byte code the JAR files javadocs log file created after running the tool and directories created by the original ant build If you have followed the build instructions in ADL User s Manual Part 1 then the binary editor is already built 4 4 RUNNING THE BINARY EDITOR To run the Binary Editor execute one of the following scripts HARDCOPY UNCONTROLLED JPSS CGS Form J 074A 04 20 2011 Doc UG60917 IDP 042 Rev Date 04 January 2012 Contract No NNG10XA03C Page 5 For ADL users ADL_HOME script bined e For development users PRO_HOME script bined For users DPE ROOT PATHycat3 script runAdaBinaryEditor csh HARDCOPY UNCONTROLLED JPSS CGS Form J 074A 04 20 2011 Doc No UG60917 IDP 042 Rev Date 04 January 2012 Contract No NNG10XA03C Page 6 5 USING THE BINARY EDITOR The following sections will only explain how the import export and edit features of this tool work If you need further direction on how the XML format works see the UG60917 IDP 036 PRO XML Editor Users Manual The tool also provides basic metric information about a given binary and can provide basic IPAC analysis when compared to another binary in the same format The binary file s being
3. 64 Apache Ant and Apache log4j The environment variable JAVA HOME must point to the Java 1 6 64 bit install directory and JAVA_HOME bin must be in your PATH variable Table 4 1 shows the needed environment variables that must be defined to compile and run the editor TABLE 4 1 COMPILE TIME ENVIRONMENT VARIABLES Variable Name Value HOME User home directory path JAVA HOME Path to Java 1 6 64 bit version ANT HOME Path to the Apache Ant build utility s home directory LOG4J JAR FILE Path to log4j JAR file XML EDITOR BASEDIR The base directory of the XML editor s source and configuration files This variable is necessary for disambiguating the directory structures of the IDPS processing and ADL development environments PRO XML SCHEMA Path to the PRO XML schema correct setting of this variable depends on the correct setting of the XML EDITOR BASEDIR variable DFCB XML SCHEMA Path to the CDFCB XML schema correct setting of this variable depends on the correct setting of the XML EDITOR BASEDIR variable PATH User s PATH variable must contain so that the ant process is able to execute the xjc schema compiler 4 2 RUNTIME ENVIRONMENT VARIABLES The run time environment also depends on the correct setting of the environment variables listed in Table 4 1 4 3 COMPILING THE BINARY EDITOR To compile the Binary Editor the environment variables in Table 4 1 must be set properly
4. used must be of the same endian type as the platform the tool is being run on the tool does not byte swap data For example if you are running on a little endian platform and want to use a binary that was created on a big endian platform that binary must first be byte swapped One option is to use the ADL data product endian conversion tool AdlFileEndianConverter exe which is utility tool provided in the ADL 5 1 OPEN DIALOG The Open dialog under the File menu item requires users to select both the binary and XML format file The files are then compared to verify that the binary file and the XML definition file agree on the size of the data If they do not agree the status button will be red and the files will not open Binary Edt Binary File 1010100002 eeo00000000000002 PS5 1 D NPP 1 PE dewvl dev all all bin Open XML File jnpdjjidol binany ATMS xml Open 1 Close L FIGURE 5 1 1 OPEN DIALOG 5 2 ACTIONS Each field in the binary file as described by the XML can be exported but only one at a time The Import Export Edit options will be displayed by selecting a field and right clicking The metric check must be done on the full product by clicking the top level item and selecting metrics Compare can be done on all fields by clicking the top level item or on a given field by selecting the singular field HARDCOPY UNCONTROLLED JPSS CGS Form J 074A 04 20 2011 Doc UG
5. 60917 IDP 042 Rev Date 04 January 2012 Contract No NNG10XA03C Page 7 File Help ATMS xml 5 5 FOOTPRINT MATCHING lt C Product Data maxPosTrackOffset C Product Data maxNegTrackOffset 9 Product Data numResBeamPos Product Field Type Regular D Number of Dimensions O 3 Number of Fields 1 Field numResBeamPos symbol null D Comments Number of Dimensions 2 J Dimension crisFor gt Dimension atmsChannel 5 Inital Fill D Data Type Int32 3 Dictionary Data Int32 Data Size 4 3 Number of Data 1 gt C Datum numResBeamPos C Product Data scanPos C Product Data trackOff Total product size 1058648 ATMS xml successfully read FIGURE 5 2 1 BINARY EDITOR XML VIEW 5 3 IMPORT The Import option will replace the data in the selected field with data from a file The file can be space delimited ASCII text or binary files The data must be the exact size of the field being replaced Once the import button is pressed a file dialog will open allowing the user to select the file to import into the binary 5 3 1 Export The Export option will export the field from the binary that you have selected If you give the file a txt extension the output will be in ASCII All other extensions will result in a binary file being exported HARDCOPY UNCONTROLLED JPSS CGS Form J 074A 04 20 2011 Doc UG60917 IDP 042 R
6. Contract No NNG10XA03C Page 12 6 NOTES 6 1 ACRONYMS AND ABBREVIATIONS Refer to document LI60917 GND 005 JPSS CGS Acronyms amp Glossary 6 2 EDITING DYNAMIC BINARY OBJECTS A few IDPS products are dynamic in size or structure This means that rather than having fixed sized data structures organized statically with a static XML which describes the internal components in detail these products may have variably sized components in a changeable arrangement Because the Binary Editor requires the Product XML to accurately describe all internal data structures of a Product in a static fashion Binary Editor will not be able to access all the data elements of a dynamic binary product unless the Product XML is edited to accurately describe the data organization of the specific instance of the binary product being edited Please refer to UG60917 IDP 036 PRO XML Editor Users Manual for guidance on editing the Product XML The following baseline IDPS data products are considered Dynamic Binary Objects for the purposes of editing with the PRO Binary Editor TABLE 6 1 DYNAMIC IDPS BINARY PRODUCTS Product or Product Type Associated XML Indirectly Indexed Gridded IP Tile GRIDIP VIIRS ANN MAX MIN QUARTERLY TILE xml Products GRIDIP VIIRS BRDF ARCH 17DAY TILE xml GRIDIP VIIRS DAILY SURF REFL DAILY TILE xml GRIDIP VIIRS DAILY SURF REFL TEMPLATE DAILY TILE xml GRIDIP VIIRS LAND SURF ALBEDO 17DAY TILE xml GRIDIP VIIRS M
7. Doc No UG60917 IDP 042 Rev Date 04 January 2012 Contract No NNG10XA03C CGS JOINT POLAR SATELLITE SYSTEM JPSS COMMON GROUND SYSTEM CGS IDPS PRO BINARY EDITOR TOOL USER S MANUAL CDRL No A032 RAYTHEON COMPANY INTELLIGENCE AND INFORMATION SYSTEMS IIS JPSS CGS PROGRAM AURORA COLORADO Copyright 2012 Raytheon Company Unpublished Work ALL RIGHTS RESERVED This data was developed pursuant to Contract Number NNG10XA03C with the US Government The US government s rights in and to this copyrighted data are as specified in DFAR 252 227 7013 which was made part of the above contract HARDCOPY UNCONTROLLED JPSS CGS Form J 074A 04 20 2011 Doc UG60917 IDP 042 Rev Date 04 January 2012 Contract No NNG10XA03C Page ii IAW DFARS 252 227 7036 Raytheon hereby declares that to the best of its knowledge and belief the technical data delivered under Contract No NNG10XAO03C is complete accurate and complies with all requirements of the Contract TITLE JOINT POLAR SATELLITE SYSTEM JPSS COMMON GROUND SYSTEM CGS IDPS PRO BINARY EDITOR TOOL USER S MANUAL APPROVAL SIGNATURES Signatures indicate compliance with these requirements William Digital od by Wiliam Sullivan Dat sp TO 7 William Sullivan Date Program Manager ee igni np el ed n Franl d Fran k ZO 18 S Samat email fgzorn raythe 5 Date 2012 01 06 13 55 02 07 00 Frank Zor
8. L User Manual Part 1 HARDCOPY UNCONTROLLED JPSS CGS Form J 074A 04 20 2011 Doc UG60917 IDP 042 Rev Date 04 January 2012 Contract No NNG10XA03C Page 3 3 OVERVIEW The PRO Binary Editor operations are governed by the PRO Binary Editor operators actions The operator invokes the PRO Binary Editor which results in the tool s HMI being displayed The PRO Binary Editor s HMI allows users to export import and edit individual fields within a PRO binary large object BLOB using the appropriate PRO XML as input Note that the PRO Binary Editor cannot edit a PRO BLOB which is variably sized or dynamically structured unless the PRO XML associated with it is edited to accurately describe the specific instance of the BLOB being edited structuring the XML as if the product were static instead of variable See Section 6 2 for more information 3 1 SUPPORTED PLATFORMS The PRO Binary Editor is currently supported on IBM computers running the IBM AIX operating system and on platforms running Red Hat Enterprise Linux 5 for the Algorithm Development Library ADL resource requirements in terms of memory storage computing cycles etc are currently unavailable HARDCOPY UNCONTROLLED JPSS CGS Form J 074A 04 20 2011 Doc UG60917 IDP 042 Rev Date 04 January 2012 Contract No NNG10XA03C Page 4 4 ENVIRONMENT SETUP 4 1 PREPARATION The PRO Binary Editor requires the following software packages Java 1 6
9. NING THE BINARY EDITOR sseseeeeeeeenennennennnnnnne nennen 4 5 USING THEJBINARY EDEITORBS s e ee eee 6 51 OPEN DIALOG 6 5 05 CE 6 MESI Le T M 7 5 3 1 7 Ouod EOI 8 5 4 COMPARE cumbia dad Led s ERR NA 9 5 57 10 ep cT 12 6 1 ACRONYMS AND ABBREVIATIONS sess 12 62 EDITING DYNAMIC BINARY OBJEG TS 12 HARDCOPY UNCONTROLLED JPSS CGS Form J 074A 04 20 2011 Doc UG60917 IDP 042 Rev Date 04 January 2012 Contract No NNG10XA03C Page v List of Figures Pics wESEG Bcc 6 Figure 5 2 1 Binary Editor XML 44 nnn nnne 7 Figure 5 3 1 Binary Editor Edit Field 0 424442202 000 00 0 8 Figure 5 3 2 Binary Editor Close Edit Field 9 Figure 5 4 1 Binary Editor Compare Field Name 9 Figure 5 4 2 Binary Editor Tolerance 0 10 List of Tables Table 2 1 Referenced 2 0000
10. TH SR BT VI MONTHLY FINAL TILE xml GRIDIP VIIRS MTH SR BT VI MONTHLY TILE xml GRIDIP VIIRS MTH SR BT VI TEMPLATE MONTHLY TILE xml GRIDIP VIIRS NBAR NDVI 17DAY TILE xml GRIDIP VIIRS NBAR NDVI MONTHLY TILE xml GRIDIP VIIRS NBAR NDVI ROLLING TILE xml VIIRS Solar Diffuser History VIIRS SOLAR DIFF HISTORY AUX xml Auxiliary Product VIIRS Active Fires ARP VIIRS EDR xml HARDCOPY UNCONTROLLED JPSS CGS Form J 074A 04 20 2011 Doc UG60917 IDP 042 Rev Date 04 January 2012 Contract No NNG10XA03C Page 13 Product or Product Type Associated XML CrIS CrIMSS Variable Retrieval Products CRIMSS CRIS LOS IR CRIMSS CRIS LOS MW CRIMSS CRIS LOS IR IP xml CRIMSS CRIS LOS MW CRIMSS CRIS CLOUD CLEARED RAD CRIMSS CRIS SURF EMISSIVITY CRIMSS CRIS MW SURF EMISSIVITY CRIMSS CRIS SKIN TEMP CRIMSS EDR xml CRIS OZ PROF JPSS CGS Form J 074A 04 20 2011 HARDCOPY UNCONTROLLED
11. ce the metric selection is made a file save dialog opens for the user to select the name of the output file Metric txt is the default name The metric output will be in the following format HARDCOPY UNCONTROLLED JPSS CGS Form J 074A 04 20 2011 Doc No UG60917 IDP 042 Rev Date 04 January 2012 Contract No NNG10XA03C Field Field name as defined in the XML Histogram of Datum name Number of Buckets lt of Buckets for the histogram Total number of elements f of elements in the histogram Bucket Bucket Value Count Count for the Bucket Range check Results Field name as defined in the XML aximum Range Max range for the field inimum Range Minimum range for the field Number exceeding Max Range of elements exceeding the max range Number exceeding Min Range of elements smaller than the min range Number exceeding Max Range percentage Percentag xceeding max range Number exceeding min Range percentage Percentag xceeding min range Number within range lt in range Percentage within range Percent in range Fill count Total number of fill values detected Fill percentage Percentage of fill Histogram of values exceeding Minimum range Histogram of the values exceeding Maximum range HARDCOPY UNCONTROLLED JPSS CGS Form J 074A 04 20 2011 Page 11 Doc UG60917 IDP 042 Rev Date 04 January 2012
12. ev Date 04 January 2012 Contract No NNG10XA03C Page 8 5 3 2 Edit The Edit option allows the user to do an inline edit of an individual field within a graphical user interface A dialog window will pop up with the field s contents where the contents are editable see Figure 5 3 1 When the user closes the dialog Close button an option to either save the data Yes button not save the data No button or cancel closing the dialog Cancel button will be displayed see Figure 5 3 2 ESRealL W 51539 FIGURE 5 3 1 BINARY EDITOR EDIT FIELD DIALOG HARDCOPY UNCONTROLLED JPSS CGS Form J 074A 04 20 2011 Doc UG60917 IDP 042 Rev Date 04 January 2012 Contract No NNG10XA03C Page 9 Accept Changes Save changes and close Warning Clicking No closes the window without saving Yes No Cancel FIGURE 5 3 2 BINARY EDITOR CLOSE EDIT FIELD DIALOG 5 4 COMPARE The compare logic provides a quick analysis of the binary fields against another binary of the same format The output of the compare will be binary images of the same size and type of the compared field The compare produces both a relative compare and an absolute compare The image outputs are also generated for each binary flag field on a flag basis for ease of analysis The binary images are output in the name convention of Abs FieldName bin for the absolute compare and Rel FieldName bin for the relative differe
13. n Date Sustainment IPT Lead Digitally signed by ae Lee n Harvey Lee o JPSS Harvey Lee s email hylee raytheon com c U Date 2012 01 10 09 44 21 pins Harvey Lee Date IDPS Sustainment Manager Digitally signi ed by Ju Justin Lee IDPS istainment Justin Date 2012 01 pen oroo Justin Lee Date Software Manager UNE 7 Fertman S mi Sheryl Fertman Date Quality HARDCOPY UNCONTROLLED JPSS CGS Form J 074A 04 20 2011 Doc UG60917 IDP 042 Rev Date 04 January 2012 Contract No NNG10XA03C JPSS CGS Form J 074A 04 20 2011 Page iii Revision Change History Revision Document Date Revision Change Description Pages Affected 04 Jan 12 Initial release per ECR IDP 004961 All HARDCOPY UNCONTROLLED Doc No UG60917 IDP 042 Rev Date 04 January 2012 Contract No NNG10XA03C Page iv Table of Contents pce i PU EE PESO EE 1 1 1 DOCUMENT OVERVIEW VERRE TOF dU EIE 1 REFERENCE DOCUMENTS 2 OVERVIEW Sd SUPPORTED PLATFORMS 4 ENVIRONMENT SETUP 4 BPHEPABRATIONL acad dedi tones 4 4 2 RUNTIME ENVIRONMENT 5 0 0 4 4 3 COMPILING THE BINARY EDITOR eeeeeeeeeeneenennnnn nennen 4 4 4 RUN
14. nce compare An IPAC analysis is also done giving the three sigma results for each field compared The three sigmas used are 68 3 95 5 and 99 7 When selecting the compare utility you are prompted for the file to compare with and the output directory for the binary images as shown in Figure 5 4 1 Compare Field Input File Output Directory Continue Cancel FIGURE 5 4 1 BINARY EDITOR COMPARE FIELD DIALOG After selecting the two values and pressing Continue you are then prompted for the tolerance to use on each field The default is 0 000001 The dialog for entering the tolerance for field compare is shown in Figure 5 4 2 HARDCOPY UNCONTROLLED JPSS CGS Form J 074A 04 20 2011 Doc UG60917 IDP 042 Rev Date 04 January 2012 Contract No NNG10XA03C Page 10 l Comparison Exclusions 2 0 000001 0 000001 0 000001 0 000001 0 000001 0 000001 0 000001 0 000001 0 000001 0 000001 0 000001 0 000001 0 000001 0 000001 0 000001 0 000001 0 000001 0 000001 0 000001 0 000001 0 000001 0 000001 C VIIRS Pixel Trim Elimination Skip FILL in Compare Continue Cancel FIGURE 5 4 2 BINARY EDITOR TOLERANCE DIALOG 5 5 METRIC The metric function takes the XML and compares all the data in the field against the range as defined in the XML In addition it will give a histogram of the fields and information on the FILL values and counts in the data On
Download Pdf Manuals
Related Search