EARTH OBSERVATION MISSION CFI SOFTWARE Release
Contents
1. Code EOCFI DMS SRN 004 d gt Rony Date 4 March 2013 Ee l m S u QA Issue 4 5 Re issued 1 S PACE Fi Page l EARTH OBSERVATION MISSION CFI SOFTWARE Release Notes Version 4 5 1 INTRODUCTION This document describes the changes introduced in this release of the Earth Observation Mission CFI Software 2 RELEASE DESCRIPTION 2 1 Software The following table lists the released libraries their version and issue date Lib 4 March 2013 Mach 2003 Mah 2003 only C and JAVA APIs The core API of the above libraries 1s written in C and provides an API for C C and JAVA The libraries installation packages are available for download at the following URL registration required http eop cfi esa int index php mission cfi software eocfi software branch 4 x eocfi v4x download 2 2 Documentation The following documents are available Earth Observation Mission CFI Software Release Notes 4 5 m cn Code EOCFI DMS SRN 004 d Ws ACA Date 4 March 2013 e m S N Stag T Cat es Issue 4 5 Re issued 1 S PA SC EJ Page 2 Visibility Software User Manual The documentation is available for download and on line browsing at the following URL http eop cfi esa int index php mission cfi software eocfi software branch 4 x eocfi v4x documentation More information on the Earth Observation CFI Software can be found at the following URL http eop cfi esa int index php miss2. Init Err mutex contention slows down multithread applications XX Init Err internal function is called several times to verify that the error table has been intialized or not This is not efficient especially because a mutex is locked unlocked to protect a flag indicating if the error tables have been initialized When a multithreaded app runs this mutex is contended very often and the threads are blocked In order to fix this issue error tables are now intialized statically 514 If number of harmonics is set to zero in an OSF the file does not validate against latest version of schema xo orbit init file error with Restituted Orbit File and first OSV close to previous ANX Issue Earth Observation Mission CFI Software Release Notes 4 5 m Code EOCFI DMS SRN 004 d WY s a Date 4 March 2013 e 1 m Y S Issue 4 5 Re issued 1 Ss Sam 3 a Page 7 xo orbit init file error with Restituted Orbit File and last OSV close to next ANX Issue reported by Sentinel 1 project xv station vis time wrong computation when search interval gt cycle length Issue Reported by Sentinel 1 project 509 Mismatch between Reference Frames identifiers in different libraries APIs Memory leak in xo osv compute Issue reported by EarthCARE project Remark the problem was due to a wrong usage of the input model id when not initialized The user has now to explicitely initialized the model id with xl model init function If the m
3. vectors exceeding of a given threshold the state vector expected by interpolation The function 1s described in Section 7 58 of the Orbit User Manual The equivalent method for C and JAVA APIs is OrbitFunc orbitDataFilter e Improvement in xo osv compute Acceleration is now computed also with TLE and precise propagation 3 5 Pointing Library e New Target list extra functions A set of new functions 1s available to compute target extra results from a list of targets previously computed using function xp target list inter for example xp_ target list extra_vector sce Earth Observation Mission CFI Software Release Notes 4 5 m Code EOCFI DMS SRN 004 d Date 4 March 2013 e l m Y S l Issue 4 5 Re issued 1 m e S Page 6 Pointing User Manual Section 7 87 These extra functions can be used in order to improve runtime performance when a large number of computations is requested The computation is optimized with respect to the single extra function and parallelized via multithreading openmp Se also note on multithreading at Section 7 87 1 1 The equivalent methods for C and JAVA APIs have been added in the Target class e g Target extraListVector DEM intersection algorithm extended The DEM intersection algorthm has been extended The extension 1s based on the fact that wide areas of the dataset can be skipped if the Line of Sight is higher than the maximum altitude of the DEM itself The user can now compute
4. and are available for download at the following URL http eop cfi esa int index php mission cfi software eocfi software support files 2 5 Installation Hints The CFI libraries can be installed by expanding the installation package in any directory For specific hints related to the usage of the libraries please consult Section 6 CFI LIBRARIES INSTALLATION of the General SUM and Section 6 LIBRARY USAGE of each Library User Manual In order to be able to use the XML validation function in the explorer data handling library it is necessary to install the xerces libraries and the SAX2Count binary The PATH environment variable shall be pointing at the SAX2Count location As of version 4 3 dynamic linking to libxml2 external libraries is no longer required As of version 4 5 user applications using the pointing library need to be built with openmp support adding fopenmp switch in gcc 3 NEW FEATURES The following sections describe the new features introduced in this release The description refers to the C API Equivalent features and methods are available in the C and JAVA APIs Earth Observation Mission CFI Software Release Notes 4 5 Code EOCFI DMS SRN 004 d m W ACA Date 4 March 2013 e 1 m y S SS 7 amp Issue 4 5 Re issued 1 a a Aa a i n Page 5 3 1 File Handling Library e Limitation to 512 characters in XML fields removed Now the user can read or write strings of any length Fo
5. e g compiler version 4 2 x for LINUX32 LEGACY LINUX64_ LEGACY MACIN64 e g compiler version 4 5 x for LINUX64 e Microsoft Visual C Compiler Visual Studio 2008 for WINDOWS The following are additional requirements for the JAVA API a JAVA SDK 1s required e Java Standard Edition SE version 6 for all platforms 2 4 Installation Packages The CFI libraries are provided as zip packages apr Package Name MDS Checksum e EOCFI 4 5 CLIB LINUX32 LEGACY zip 26a1195b0d3ad2f13fc6laf0455f9b72 e FOCFI 4 5 CLIB LINUX64 zip b30910e586eb5ba49e21dd7c2c145708 lo FOCFI 4 5 CLIB LINUX64 LEGACY zip c3e90908da4c45524860d4012ffb63bc ei FOCFI 4 5 CLIB MACIN64 zip C458229868be48ed3c541lace6e878da3 Earth Observation Mission CFI Software Release Notes 4 5 Code EOCFI DMS SRN 004 4 March 2013 d 2 ea Date e 1 m Y S S Issue 4 5 Re issued 1 S PACE Fi Page 4 EOCFI 4 5 JAVALIB LINUX64 zip 860871b691c86b18e70de76cb095b974 EOCFI 4 5 JAVALIB LINUX32_LEGACY zip 757cd8 117442a59bf190d056da5e08a EOCFI 4 5 JAVALIB LINUX64_ LEGACY zip 347be65c380bb0 6151d37a91c062a7a 2 EOCFI 4 5 CPPLIB WINDOWS STA zip 7cdb6700b497cc9316c724610232b725 EOCFI 4 5 JAVALIB MACIN64 z1p bccab60fb24adalfe0a9a7c99d776c8cc EOCFI 4 5 JAVALIB WINDOWS zip c821a3047c1bba415c505523e2dbfdd3 Dynamic libraries DLLs Static libraries EOCFI 4 5 CPPLIB WINDOWS DLL zip 54247b98bcf c7227994241452 7d79d5 DEM datasets are distributed separately
6. ion cfi software eocfi software 2 3 Supported platforms The following platforms are supported by this release of the CFI the following are requirements for the C API e LINUX32 LEGACY e LINUX 32 bits Legacy e Platform Requirements x86 based PC Linux Operating System Kernel version 2 6 x e Software Requirements gcc compiler version 4 2 x glibc C Library version 2 7 e LINUX64 LEGACY e LINUX 64 bits Legacy e Platform Requirements x86 64 based PC Linux Operating System Kernel version 2 6 x Earth Observation Mission CFI Software Release Notes 4 5 Code EOCFI DMS SRN 004 d KW s mM e Date 4 March 2013 e 1 m Y S Issue 4 5 Re issued 1 S Eo S Ey Page 3 e Software Requirements gcc compiler version 4 2 x glibc C Library version 2 7 e LINUX64 e LINUX 64 bits e Platform Requirements x86 64 based PC Linux Operating System Kernel version 2 6 x e Software Requirements gcc compiler version 4 5 x glibc C Library version 2 12 e WINDOWS e Microsoft WINDOWS PC 32 bits e Platform Requirements x86 based PC Microsoft Windows XP Operating Systems e Software Requirements Microsoft Visual C Compiler Visual Studio 2008 Professional e MACIN64 e MACOSX on Intel 64 bits e Platform Requirements x86 64 based Mac Computer Mac OS X version 10 5 x e Software Requirements gcc compiler version 4 2 x The following are additional requirements for the C API a C compiler is required
7. odel id is passed uninitialized to functions the function will use a temporary model id set to default model gen osf append orbit change unexpected error returned when the MLST jump execeeds the maximum allowed difference Remark a warning is now issued in case of MLST and longitude discontinuities exceeding the acceptable thresholds 495 Computation of UT in precise propagator is not correct 491 Orbit Propagator fails when orbit initialize with Doris file plus Orbit File Issue reported by the SMAT development team 490 xo time to orbit error when orbit id initialized with single OSV Data Handling writing functions Creator Version defined in input fixed header is overwritten by the CFI Remark now the user can pass to the function his own value for the Version If the input is left empty the CFI version is written instead 481 Elevation angle computation not correct if target computed using quaternions file 480 False gap detected when reading DORIS Navigator files Earth Observation Mission CFI Software Release Notes 4 5
8. offline such maximum altitudes and store them in a file using function xp gen dem max altitude file see Section 7 102 of Pointing User Manual The extension can be enabled via the DEM configuration file see above Section 3 2 PointingFunc genMaxAltFile is the equivalent method for C and JAVA APIs e Runtime performance improvement with ACE2 DEM datasets Altitudes in ACE2 datasets are expressed w r t EGM96 geoid In order to compute altitudes w r t the ellipsoid the CFI Software needs to compute at run time at the corresponding longitude and latitude the geoid height w r t the ellipsoid This can be expensive for runtime especially when a large number of geolocations is computed The user has two options o Reduce the number of harmonics used to compute the geoid this can be achieved setting the number of harmoics in the DEM configuration file The result is less accurate but the runtime performance is improved o Generate offline a new dataset based on the original ACE2 dataset but with altitudes expressed w r t the ellipsoid This can be achieved using the new function xp_gen dem _altitudes from_ ellipsoid see Pointing User Manual section 7 103 The user needs to disable the geiod computation in the DEM configuration file In this way the geoid is not computed at runtime PointingFunc genDemAltitudesFromEllipsoid is the equivalent method for C and JAVA APIs 4 SOLVED PROBLEMS The following Anomalies have been solved XX
9. r reading functions as memory is allocated within the CFI function it is the user responsibility to deallocate such memory 3 2 Data Handling Library e New DEM configuration file New tags in DEM configuration file to support DEM minitiles definition and geoid computation The user can now o Enable the extended DEM intersection algorithm o Configure number of harmonics used in geoid computation for ACE2 DEM o Disable geoid computation for ACE2 DEM The DEM configuration file is described in section 9 12 of the Data Handling SUM e EarthCARE support Files are generated according to File Format Standard 2 0 3 3 Lib Library e New function xl geoid calc to compute the height of the geoid over the ellipsoid The geoid is computed at a given longitude and latitude according to the input model default is EGM96 model EGM96 is a geopotential model of the Earth consisting of spherical harmonic coefficients complete to degree and order 360 The user can define the number of harmonics to be used for the computation if this number is less than 360 the result is less accurate but the computation time is shorter The equivalent method for C and JAVA APIs is GeoidCalcInputs geoidCalc 3 4 Orbit Library e New function for filtering Orbit Files The function xo_orbit_data_filter provides the interface of a generic filter for orbit data state vectors The filter implemented in this release is the outlier filter that allows discarding state
Download Pdf Manuals
Related Search