ESABASE2 12.0 Release Notes

These release notes include all features, updates, extensions, and bug fixes
included in ESABASE2 since release 12.0.

Versions

Changed to Windows 64bit (no 32bit versions for ESABASE2 release < 11)

Changed to Linux 64bit (no 32bit version for ESABASE2/Debris release 11).

Changed to Linux 64bit (no 32bit version for ESABASE2/Debris release 11).

Tested on Ubuntu 18.04 LTS 64bit, will most probably run under all common 64bit Linux distributions.

In the case of a Demo version, you should get the according hint and proceed by clicking the OK button, in the case of a bundle (e.g. Debris) you need to perform the machine binding (live or per Email).

Framework

ESABASE2 is now started via “startEsabase2.bat” script. Please note that the direct start via the executable is not possible.

Upgraded Eclipse version.

Upgraded NetGen mesher (R12 only)

Extension of the geometry file data structure, e.g. for the handling of the SPICE based pointing. (R12 only)

Extension of the mission file data structure, for the handling of interplanetary missions. (R12 only)

Mercury, Venus, and Mars can be selected for mission definition (usable only for Debris with MEM 3) (R12 only)

Older files are converted to be applicable with the new ESABASE2 version, however, compatibility is not guaranteed in every case.

The STEP (AP 203/214) import of large geometrical models is improved.

ESABASE2 is not crashing anymore upon an allocated memory size of over 1GB. Nevertheless, it is reasonable to restart ESABASE2 occasionally, especially if working with big geometries.

Debris

SPICE and OEM trajectory information can be used for interplanetary analysis mode. (R12 only)

Changed to Linux 64bit (no 32bit version for ESABASE2/Debris release 11).

An individual kernel containing the trajectory of the S/C (“Trajectory File”)

A Meta Kernel includes the leap seconds kernel, the planetary kernel, and the kernel of bodies that are referenced or wished to be considered.

A default Meta Kernel is provided listing the provided kernels:
latest_leapseconds.tls.pc, earth_assoc_itrf93.tf (for considering ITRF-93 reference frame in OEM files), de438.bsp, mar097.bsp.

An individual Meta Kernel can be defined and provided a listing of the kernels to be considered.

All referred objects, e.g. via the pointing based on SPICE, need to be listed within the mentioned Meta Kernel.

The default Meta Kernel is applied upon changing to interplanetary mode (placed in the “SPICEKernels” folder) but can be changed.

Tested on Ubuntu 18.04 LTS 64bit, will most probably run under all common 64bit Linux distributions.

Extended mission file providing new functionalities concerning interplanetary analyses (R12 only)

Orbit selection extracted and independent from the orbit parameters with the selections:

Mercury

Venus

Earth (Orbit Type selections available, else generic (GEN))

Moon

Mars

Interplanetary (SUN)

Mission Editor is divided in two parts now:

Left side: orbital/trajectory/mission parameters

Right side: 3D visualization of the trajectory/orbit (only Earth and Interplanetary mode are visualized)

Interplanetary Mission:

An individual kernel containing the trajectory of the S/C (“Trajectory File”)

The S/C trajectory file is the basis for the mission definition

Probe selection (in case of multiple): The probe name and its ID are displayed.

The minimum and maximum dates of the trajectory are shown and are the default simulation start and end dates.

A stepping algorithm splits the considered trajectory duration in a number of orbital points based on the spatial density variation along the trajectory. The orbital points are listed in the “Trajectory Points” table.

Trajectory points can be added or removed by the user.

The default Meta Kernel is applied upon changing to interplanetary mode (placed in “SPICEKernels” folder) but can be changed. The S/C trajectory file is the basis for the mission definition

3D trajectory visualization:

Different information to be visualized can be activated or deactivated:

S/C trajectory (the straight connection between selected trajectory points).

Color coding of the S/C trajectory according to the spatial density (IMEM based, densities can be displayed).

Names of the planets.

The densities can be indicated by the trajectory path, coloring the trajectory part based on the previous orbital point.

Highlighting trajectory points.

Planetary orbital arcs passed during the S/C trajectory time (additionally to thin lines that visualize the orbits of the planets for slightly more than one orbit).

Cartesian grid visualization.

Coordinate system visualization, centered in each planet and the Sun.

Visualization of model range (IMEM or IMEM2 or MEMR2 Interplanetary or MEM 3). Also, it is highlighted whether the trajectory is inside the range of a model.

ESA’s most current space environment model MASTER 8 (including Divine-Staubach meteoroid model) is now integrated and can be used for analysis.

Please consider that the Divine-Staubach model of MASTER 8.0.2 (used by ESABASE2) has a bug and overestimates the fluxes. MASTER 8 executable will need an update after this problem is fixed by the MASTER developer.

Please consider that only the reference data (November 2016) is provided with ESABASE2 and you require the population data from https://sdup.esoc.esa.int/ to run other epochs.

If you encounter the error message “FATAL ERROR in subroutine ‘prbindexcheck’:…” running MASTER 8, please check if the population data for your epoch is available to MASTER 8.

NASA’s MEMR2 Interplanetary is implemented and is activated if it is combined with an interplanetary mission. (R12 only)

IMEM model is implemented and can be used in combination with an interplanetary mission. (R12 only)

IMEM accumulates orbital points with the same step size in groups and is executed for each group multiple times to achieve all required information per group considered.

IMEM2 model is implemented and can be used in combination with an interplanetary mission. (R12 only)

IMEM2 accumulates orbital points with the same step size in groups and is executed once for each group to achieve all required information (one STENVI file per group).

NASA’s MEM 3 model implemented and can be used conventionally for Earth, Moon, Mercury, Venus and Mars, with trajectory mode (Earth and Moon) and with interplanetary mode. (R12 only) IMPORTANT: To make use of MEM 3 NASA requires to close a Software Usage Agreement. After reception of the signed document we will provide an MEM 3 installation package.

MEM 3 is executed once for all considered points before the orbital points loop, except in the trajectory mode it is executed for each orbital point individually.

SPICE pointing is available (R12 only)

Pointing based on a NAIF ID is possible now:

For pointing, in the geometry file, “SPICE” can be selected and a NAIF ID can be defined

A SPICE kernel containing the object to be pointed at needs to be available and listed in the Meta Kernel (for the analysis).

5-Figures statistics (Weak-Spots) is implemented (R12 only)

Median, minimum-, and maximum values and both quartiles in-between for impact -azimuth, -elevation, and -velocity can be visualized in the 3D results.

The impact angles are visualized on an element by an arrow and the velocity by the color of the element with color code.

The angle definition is based on the S/C velocity and the direction to the central body.
Note: Please consider, due to the dependency on the S/C velocity the direction is only available for orbital points visualisation not for mission (changing velocity direction from OP to OP). Error message is shown in the case Weak-Spot visualisation is selected for mission results and the arrows are not visualised, only the velocity colour code.

Element results have been extended with additional visualization capabilities. Also, various export features are available for the element results. The selected exports will be stored in a folder with the name of the element’s object shape within the chosen destination folder. (R12 only)

Notes

Please be aware that the Divine-Staubach model of MASTER 8.0.2 (used by ESABASE2) has a bug and overestimates the fluxes. MASTER 8 executable will need an update after this problem is fixed by the MASTER developer.

Please be aware that the scripting editor is not compatible with interplanetary mission definitions. You can use such files only for batch configuration (basis file as is without modifications).

Please be aware that the current GUI design is mainly designed for full-HD resolution and a Windows visualization scale of 100%. Lower resolutions/a higher scale can lead to some windows not showing all its contents. E.g. for the frame pointing option window, the “ok” and “cancel” buttons might not be visible. Hence, the setting can not be confirmed and applied. In this case, please try to apply a smaller Windows visualization scaling as a first approach or a higher resolution.

If not everything is visible in the mission file, make ESABASE2 full screen and double click the mission file tab to make it also in E2 full screen (double click on the tab again to revert it).

Please consider that MEMR2 relies on Microsoft Visual Studio C++ Redistributables 2008 (32bit). If you have the problem that during the analysis with MEMR2 the Spd… files are not found, please go to “ESABASE2-ROOTFOLDER\Solver\DEBRIS\MEMR2” and double click on “MEMR2CLW.exe”. If you get a message pointing out a problem with “Side-by-Side” installation, then you need to install the MSVC 2008 Redistributables (32bit), e.g. can be found in E2_ROOT\components\install-supplements.

When using the OEM2SPK converter, please make sure no major step size from one step to another occurs, since this exceeds the default threshold for the MAXIMUM_SEP_QUOTIENT parameter of OEM2SPK which is currently used. For more information, refer to https://naif.jpl.nasa.gov/pub/naif/utilities/PC_Windows_64bit/spk2oem.ug.

The externally provided OEM2SPK only processes input arguments with a maximum of 80 characters within its setup file. This may lead to problems when trying to use the meta kernel e.g. keep in mind to keep the number of characters lower this threshold to avoid errors during the conversion process.

Please consider that the maximum time span for an S/C trajectory is 100 years, you will not be able to use trajectory kernels including longer mission durations. (This does not apply to the basic kernels provided by the Meta Kernel, but only the trajectory kernel with the trajectory to be analyzed.)

There are inconsistencies with the time representation in the mission file. Each point of the generated trajectory points lists is having an offset of one hour (plus one hour). Manually added trajectory points appear with the exact user-defined date. However, it can be generalized that internal processing works by subtracting one hour from the times of the visualized trajectory list. As a consequence, for manually adding individual trajectory points, one one-hour offset needs to be foreseen.

Bug Fixes

Fixed bug in GDML interface.

Fixed transparency configuration passing to the results, result geometry now is not transparent.

Fixed bug concerning incorrect replication for non-centered objects.

Fixed bug of non-movable origin object after replication.

Fixed minor bugs concerning the shape generation editor.

Fixed non-responding Finish button if a manipulation on the assembly node is performed.

Fixed bug concerning reopening a Moon mission file error due to a semi-major axis less than Earth radius.

Several minor bugs have been fixed.

Documentation

A new version (1.21) of the Framework User Manual was established.

A new version (1.17) of the ESABASE2/Debris User Manual was established.

A new version (1.10) of the ESABASE2/Debris Technical Description was established.

Known Issues

Postprocessor is currently not available.

NetGen is currently not available in ESABASE2 Linux Version.

If a high memory amount is allocated (several GB) crashes are possible.

ORDEM2K is currently not usable under Linux.

An insufficient error message is provided in the case that Weak-Spot visualization is selected for mission results.

Currently, the direct definition of minimum and maximum values in the 2D diagrams are not applied correctly. However, the zoom function can be used to get the desired closer look.

There are inconsistencies with the time representation in the mission file. (See Notes).