ESABASE2 - Framework

piteousnessbutterSoftware and s/w Development

Jul 14, 2012 (5 years and 4 months ago)

891 views


© etamax space GmbH





ESABASE2
-

Framework

Software User Manual





Contract No:

16852/02/NL/JA

Title:

PC Ve
r
sion of DEBRIS Impact Analysis Tool

ESA Technical Officer:

G. Drolshagen
, J. Sørense
n

Prime Contractor:

et
amax space GmbH

Authors:

K.Ruhl
, K.Bunte

Date:

2009
-
1
0
-
2
2

Reference:

R077
-
230rep_01_01_Software_User_Manual_Framework.doc

Revision:

1
.
1

Status:

Final

Confidentiality:


etamax space GmbH

Richard
-
Wagner
-
Str.
1

D
-
38106 Braunschweig

Germany


Tel.:

+49 (0)531.3802.
404

Fax:

+49 (0)531.3802.
401

email:

esabase2@etamax.de

http://www.etamax.de




Date:

2009
-
1
0
-
2
2

ESABASE
2
-

Framework

Revision

1
.
1

Software User Manual

St
a
te:

Final

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

Page
2

/
156

etamax space GmbH . Richard
-
Wagner
-
St
raße 1 . 38106 Brau
n
schweig


Table of Cont
ents

Document Information

................................
................................
..........................

6

I.

Release Note

................................
................................
................................
..

6

II.

Revision History

................................
................................
..............................

6

III.

Distribution List

................................
................................
..............................

6

IV.

List of References

................................
................................
...........................

7

V.

Glossary

................................
................................
................................
..........

8

VI.

List of Abbreviations

................................
................................
......................

8

VII.

List of Figures

................................
................................
................................
.

9

VIII.

List of Tables

................................
................................
................................

13

1

Introduction
................................
................................
................................
....

14

1.1

The Big Picture

................................
................................
.............................

14

1.2

Chapter Overview

................................
................................
........................

15

1.3

Problem Reporting

................................
................................
.......................

15

2

Getting Started with ESABASE2

................................
................................
.....

16

2.1

Installation

and

Start

................................
................................
...................

16

2.1.1

Hardware Requirements

................................
................................
..................

16

2.1.2

Installation

................................
................................
................................
........

17

2.1.3

Operating System Adaptations

................................
................................
........

18

2.1.4

Upgrade

................................
................................
................................
............

19

2.1.5

Starting ESABASE2

................................
................................
...........................

20

2.2

Basic GUI Usage

................................
................................
............................

21

2.2.1

GUI Overv
iew

................................
................................
................................
....

21

2.2.2

GUI Adaptation

................................
................................
................................

24

2.2.3

Project Organisation

................................
................................
........................

25

3

Mission and Spacecraft Definition

................................
................................
..

29

3.1

Mission

................................
................................
................................
..........

29

3.1.1

Mission File

................................
................................
................................
.......

30



ESABASE2
-

Framework

Date:

2009
-
1
0
-
2
2

Software User Manual

Revis
i
on:

1
.
1

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

St
a
te:

Final

etamax space GmbH . Richard
-
Wagner
-
Straße 1 . 38106 Brau
n
schweig

Page
3

/
156

3.1.2

Mission Editor

................................
................................
................................
...

31

3.1.3

Mission Outline and Properties View

................................
..............................

33

3.1.4

Mission Visualisation

................................
................................
........................

34

3.1.5

Import of INP Files

................................
................................
............................

35

3.1.6

Orbit Propagator

................................
................................
..............................

36

3.2

Geometry

................................
................................
................................
......

39

3.2.1

Geometry File

................................
................................
................................
...

40

3.2.2

Geometry Viewing

................................
................................
...........................

41

3.2.3

Geometry Editing

................................
................................
.............................

44

3.2.4

Geometry

Outline and Properties View

................................
..........................

59

3.2.5

STEP and BAS File Import

................................
................................
.................

66

3.3

Kinematics

................................
................................
................................
....

73

3.3.1

Bodies

................................
................................
................................
...............

74

3.3.2

Degrees of Freedom

................................
................................
.........................

74

3.3.3

The Central Body

................................
................................
..............................

75

3.3.4

Articulated Bodies

................................
................................
............................

75

3.4

Pointing

................................
................................
................................
........

76

3.4.1

Pointing Introduction

................................
................................
.......................

76

3.4.2

Pointing Parameters

................................
................................
.........................

79

3.4.3

Relationship with Mission Specification

................................
..........................

85

3.4.4

Pointing the Bodies and Indeterminacies

................................
........................

88

3.4.5

Pointing Output

................................
................................
...............................

91

3.4.6

Pointing Calculation Method

................................
................................
...........

92

4

Solvers

................................
................................
................................
.............

94

5

Troubleshooting

................................
................................
.............................

95

5.1

Precautions

................................
................................
................................
...

95

5.2

Trouble Information

................................
................................
....................

95

5.
3

Program Messages

................................
................................
.......................

96

5.3.1

Messages: ESABASE2

................................
................................
........................

96




Date:

2009
-
1
0
-
2
2

ESABASE
2
-

Framework

Revision

1
.
1

Software User Manual

St
a
te:

Final

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

Page
4

/
156

etamax space GmbH . Richard
-
Wagner
-
St
raße 1 . 38106 Brau
n
schweig


5.3.2

Messages: Eclipse and JVM

................................
................................
..............

97

5.3.3

Messages: Solver

................................
................................
...............................

97

5.4

Known Issues

................................
................................
................................

99

5.4.1

Import of complex BAS files

................................
................................
.............

99

5.4.2

Memory leak caused by Open Cascade

................................
...........................

99

6

Annex A: Geometry Shapes

................................
................................
..........

100

6.1

Basic 3D Shapes

................................
................................
..........................

100

6.1.1

B
ox

................................
................................
................................
..................

101

6.1.2

Cone

................................
................................
................................
................

103

6.1.3

Cylinder

................................
................................
................................
...........

107

6.1.4

Ellipsoid

................................
................................
................................
..........

111

6.1.5

Ogive

................................
................................
................................
...............

115

6.1.6

Paraboloid

................................
................................
................................
......

120

6.1.7

Sphere

................................
................................
................................
.............

125

6.2

Basic 2D Shapes

................................
................................
..........................

129

6.2.1

Disc

................................
................................
................................
..................

130

6.2.2

Plate

................................
................................
................................
................

132

6.3

Specific Shapes

................................
................................
...........................

134

6.3.1

Facet

................................
................................
................................
................

135

6.3.2

Prism

................................
................................
................................
...............

136

6.3.3

Surface

................................
................................
................................
............

138

6.4

Complex Shapes

................................
................................
.........................

139

6.4.1

Antenna

................................
................................
................................
..........

140

6.4.2

Beam

................................
................................
................................
...............

143

6.4.3

Pipe

................................
................................
................................
.................

144

6.4.4

Tank

................................
................................
................................
................

146

6.4.5

Truss

................................
................................
................................
................

149

7

Annex B: Additional GUI Elements

................................
...............................

154

7.1

Application Menubar

................................
................................
.................

154



ESABASE2
-

Framework

Date:

2009
-
1
0
-
2
2

Software User Manual

Revis
i
on:

1
.
1

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

St
a
te:

Final

etamax space GmbH . Richard
-
Wagner
-
Straße 1 . 38106 Brau
n
schweig

Page
5

/
156

7.2

Geometry Editor Toolbar

................................
................................
...........

156





Date:

2009
-
1
0
-
2
2

ESABASE
2
-

Framework

Revision

1
.
1

Software User Manual

St
a
te:

Final

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

Page
6

/
156

etamax space GmbH . Richard
-
Wagner
-
St
raße 1 . 38106 Brau
n
schweig


Document Information

I.

Release Note


Name

Fun
ction

Date

Signature

Established by:

K.Ruhl

Technical Project
Manager

2009
-
1
0
-
2
2


Released by:

K.D. Bunte

Project Manager

2009
-
11
-
0
2



II.

Revision History

Vers
i
on

Date

Initials

Changed

Reason for Revision

0.1

2009
-
06
-
12

KR

A
ll

Taken over from ESABASE2/Debris SUM
, restru
c-
tured

chapters, and

rewrote introduction
and
ge
t
ting started
chapter
s
.

0.2

2009
-
06
-
22

KR

C
hapter 3

Rewrote m
ission and S/C handling.

0.3

2009
-
07
-
06

KR

C
hapter 4
, 7
;
A
nnex A and B

Rewrote debris
/
meteoroids

chapter
, troubl
e-
shooting section, Annex A and B

0.4

2009
-
07
-
28

KR

Chapter 2, 3, 4

Enhancements after PM5.

0.5

2009
-
08
-
03

KR

All

Split into Framework, Solver documents

0.9

2009
-
09
-
23

KB

All

Review for Final Draft

1
.0

2009
-
09
-
28

KR

All

Adapted to review results

1.1

2009
-
1
0
-
2
2

KR
, KB

Chapters 2, A

User feedback recognition.


III.

Distribution List

Institution

Name

Remarks

ESTEC

G
erhard

Drolshagen

ESTEC

Jo
h
n Sørens
e
n

diverse

n/a

ESABASE2


licensees




ESABASE2
-

Framework

Date:

2009
-
1
0
-
2
2

Software User Manual

Revis
i
on:

1
.
1

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

St
a
te:

Final

etamax space GmbH . Richard
-
Wagner
-
Straße 1 . 38106 Brau
n
schweig

Page
7

/
156

IV.

List of Referen
ces


ESABASE2 homepage,
http://www.esabase2.net/



K. Ruhl, K.D. Bunte,
ESABASE2/Debris software user manual, R077
-
232rep,
ESA/ESTEC Contract 16852/02/NL/JA "PC Version of DEBRIS Impact Analysis
Tool", etamax space,
2009


K. Ruhl,
ESABASE2/At
m
-
Ion

software user manual, R077
-
233rep, ESA/ESTEC Co
n-
tract 16852/02/NL/JA "PC Version of DEBRIS Impact Analysis Tool", etamax space,
2009


K. Ruhl,
ESABASE2/C
OMOVA

software user manual, R077
-
234rep, ESA/ESTEC
Contract 16852/02/NL/J
A "PC Version of DEBRIS Impact Analysis Tool", etamax
space, 2009


K. Ruhl,
ESABASE2/Sunlight software user manual, R077
-
235rep, ESA/ESTEC Co
n-
tract 16852/02/NL/JA "PC Version of DEBRIS Impact Analysis Tool", etamax space,
2009


ESABASE User Manual, ESABASE/G
EN
-
UM
-
070, Issue 1, Mathematics & Software
Division, ESTEC, March 1994


SWENET, ESA's Space Weather European Network, since 2004,

http://www.esa
-
spaceweather.net/swenet/



STEP file format,
http://en.wikipedia.org/wiki/ISO_10303



Netgen mesher user manual,


http://www.mathcces.rwth
-
aachen.de/netgen/doku.php/docu/ng
usermanual





Date:

2009
-
1
0
-
2
2

ESABASE
2
-

Framework

Revision

1
.
1

Software User Manual

St
a
te:

Final

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

Page
8

/
156

etamax space GmbH . Richard
-
Wagner
-
St
raße 1 . 38106 Brau
n
schweig


V.

Glossary

Term

Description

Application

ESABASE application such as e.g. the "Debris" or the
"Sunlight" applic
a
tion.

Eclipse

Eclipse is an open source community whose projects are
focused on providing an extensible development pla
t-
form and ap
plication frameworks for building software.
For detailed inform
a
tion refer to
http://www.eclipse.org/
.

ESABASE

Unix
-
based analysis software for various space applic
a-
tions. For details refer to the
ESABASE User Manual

/6/
.

ESABASE2

New ESABASE version running on PC
-
based Windows
platforms (to be distinguished from the "old" Unix
-
based
ESABASE).

Geometric(al) (anal
y
sis)

A
nalysis of a full geome
tric model.

Georelay

O
bject pointing keyword: tracking of a GEO satellite.

N
on
-
geometric(al) (anal
y-
sis)

A
nalysis of a plate
; faster than analysing a full geometr
i-
cal model.

STEP

Acronym which stands for the Standard for the Exchange
of Pro
d
uct model dat
a
/8/
.


VI.

List of Abbreviations

Abbrevi
a
tion

Description

GUI

Graphical User Interface

JVM

Java Virtual Machine

NASA

National Astronautics and Space A
d
ministration

OCAF

Open CASCADE Application Framework (co
n
tains the ESABASE
2 data
model)

RTP

Randomly Tumbling Plate





ESABASE2
-

Framework

Date:

2009
-
1
0
-
2
2

Software User Manual

Revis
i
on:

1
.
1

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

St
a
te:

Final

etamax space GmbH . Richard
-
Wagner
-
Straße 1 . 38106 Brau
n
schweig

Page
9

/
156

VII.

List of Figures

Figure 2.1:

ESABASE2 directory tree

................................
................................
..............

17

Figure 2.2:

ESABASE2 directory tree: install supplements

................................
............

18

Figure 2.3:

ESABASE2 user interface

................................
................................
..............

20

Figure 2.4:

User interface overview

................................
................................
...............

21

Figure 2.5:

Menubar and Toolbar

................................
................................
..................

22

Figure 2.6:

Exp
lorer, Outline, Properties view

................................
..............................

23

Figure 2.7:

Common View buttons

................................
................................
................

24

Figure 2.8:

"New Project" wizard, page 1

................................
................................
.....

25

Figure 2.9:

"
New Project" wizard, page 2

................................
................................
.....

26

Figure 2.10:

A new project and its three default files

................................
....................

26

Figure 2.11:

Creating new files within a project

................................
.............................

27

Figure 2.12:

Creating folders within a project, using the context menu

.......................

28

Figure 3.1:

Mission file creation wizard

................................
................................
........

30

Figure 3.2:

Mission Editor, Outline and Properties view

................................
...............

31

Figure 3.3:

Mission Editor, with Pertubations in Outline.

................................
.............

33

Figure 3.4:

Mission Editor, Visualisation page

................................
..............................

34

Figure 3.5:

Mission file creation wizard, for INP files

................................
...................

35

Figure 3.6:

Geometry file creation wizard

................................
................................
.....

40

Figure 3.7:

Geometry editor, empty file

................................
................................
........

41

Figure 3.8:

Geometry editor, first box

................................
................................
...........

42

Figure 3.9:

Geometry editor, Toolbar (left side)

................................
...........................

42

Figu
re 3.10:

Geometry editor, example satellite

................................
.............................

44

Figure 3.11:

Geometry editor, Box wizard, Size page

................................
.....................

46

Figure 3.12:

Geometry editor, Box wizard, Meshing page

................................
.............

47

Figure 3.13:

Geometry editor, default Cone

................................
................................
...

48

Figure 3.1
4:

Geometry editor, Cone wizard, Position and Attitude page
......................

49

Figure 3.15:

Geometry editor, Wizard header

................................
................................

50

Figure 3.16:

Geometry editor, Material page

................................
................................
.

50




Date:

2009
-
1
0
-
2
2

ESABASE
2
-

Framework

Revision

1
.
1

Software User Manual

St
a
te:

Final

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

Page
10

/
156

etamax space GmbH . Richard
-
Wagner
-
St
raße 1 . 38106 Brau
n
schweig


Figure 3.17:

Geometry editor, Material properties

................................
.........................

51

Figure 3.18:

Geometry editor, example satellite with antenna dish at bottom

............

52

Figure 3.19:

Geometry editor, Pointing page (antenna dish)

................................
.........

53

Figure 3.20:

Geometry editor, Kinematic page
(antenna dish)

................................
......

54

Figure 3.21:

Geometry editor, Pointing page (System node)

................................
.........

55

Figure 3.22:

Geometry editor, Kinematic page (solar panel)

................................
.........

56

Figure 3.23:

Geometry editor, Pointing page (solar panel)

................................
............

57

Figure 3.24:

Geometry editor, examp
le satellite with two solar panels

........................

58

Figure 3.25:

Orbital point configurations, example satellite

................................
..........

58

Figure 3.26:

Geometry editor, Outline, Cone selected

................................
...................

59

Figure 3.27:

Geometry editor, Outline, Cone renaming

................................
.................

60

Figure 3.28:

Geometry editor, Outline, node ren
aming

................................
.................

61

Figure 3.29:

Geometry editor, Outline, Copy & Paste

................................
.....................

62

Figure 3.30:

Geometry editor, Outline, expanded

................................
..........................

63

Figure 3.31:

Geometry editor, Outline and Properties view

................................
...........

64

Figure 3.32:

Geometry editor, Outline and Properties view, editing

.............................

65

Figure 3.33:

Geometry file creation wizard, STEP varian
t

................................
..............

66

Figure 3.34:

Geometry editor, imported STEP ATV model

................................
.............

67

Figure 3.35:

Geometry editor, STEP import, Meshing adjustments

................................

67

Figure 3.36:

Geometry editor, imported STEP ATV model, remeshed

...........................

68

Figure 3.37:

Geometry editor, STEP import, Meshing in
tervention dialog

....................

69

Figure 3.38:

Geometry editor, imported STEP ATV model, missing body

......................

69

Figure 3.39:

Geometry file creation wizard, BAS variant

................................
................

71

Figure 3.40:

Geometry editor, imported ROSAT.BAS

................................
......................

72

Figure 3.41:

Spacecraft model

................................
................................
.........................

77

Figure 3.42:

Pointing realisation

................................
................................
......................

88

Figure 3.43:

Attitude indeterminacy (central body)

................................
.......................

89

Figure 3.44:

Attitude indeterminacy (2 degrees of freedom)
................................
.........

90

Figure 5.1:

Troubleshooting, Messages, ESABASE2 Debris analysis

..............................

96

Figure 5.2:

Troubleshooting, Messages, Eclipse and JVM abnormal termination

.......

97



ESABASE2
-

Framework

Date:

2009
-
1
0
-
2
2

Software User Manual

Revis
i
on:

1
.
1

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

St
a
te:

Final

etamax space GmbH . Richard
-
Wagner
-
Straße 1 . 38106 Brau
n
schweig

Page
11

/
156

Figure 5.3:

Troubleshooting, Messages, Solver warning (kinematic)

...........................

98

Figure 6.1:

Basic 3D geometry shapes

................................
................................
.........

100

Figure 6.2:

Parameters of a box object

................................
................................
........

101

Figure 6.3:

Outer shape parameters of a cone object

................................
................

103

Figure 6.4:

Inner shape parameters of a cone object

................................
.................

103

Figure 6.5:

Border parameters of a cone object
................................
..........................

104

Figure 6.6:

Parameters of a cylinder object

................................
................................
.

107

Figure 6.7:

Meshing parameters of the

cylinder

................................
.........................

110

Figure 6.8:

Parameters of an ellipsoid object

................................
..............................

111

Figure 6.9:

Additional parameters of an ellipsoid object

................................
...........

111

Figure 6.10:

Meshing parameters of the ellipsoid

................................
........................

114

Figu
re 6.11:

Parameters of an ogive object
................................
................................
...

115

Figure 6.12:

Additional parameters of an ogive object

................................
................

115

Figure 6.13:

Construction of an ogive

................................
................................
...........

118

Figure 6.14:

Parameters of a paraboloid object

................................
............................

120

Figure

6.15:

Additional parameters of a paraboloid object

................................
.........

1
20

Figure 6.16:

Meshing parameters and element numbering of the paraboloid

...........

124

Figure 6.17:

Parameters of a sphere object

................................
................................
...

125

Figure 6.18:

Inner view of the sphere

................................
................................
............

125

Figure 6.19:

Me
shing parameters of the sphere

................................
...........................

128

Figure 6.20:

Basic 2D geometry shapes

................................
................................
.........

129

Figure 6.21:

Parameters of a disc object

................................
................................
........

130

Figure 6.22:

Parameters of a plate object

................................
................................
.....

132

Figure 6.23:

Meshing parameters of the PLATE

................................
............................

133

Figure 6.24:

Specific geometry shapes

................................
................................
...........

134

Figure 6.2
5:

Parameters of a prism object

................................
................................
.....

136

Figure 6.26:

Parameters of a surface object

................................
................................
..

138

Figure 6.27:

Complex geometry shapes

................................
................................
.........

139

Figure 6.28:

Parameters of an antenna object

................................
..............................

140

Figure 6.29:

Meshing parameters of an antenna object

................................
...............

140




Date:

2009
-
1
0
-
2
2

ESABASE
2
-

Framework

Revision

1
.
1

Software User Manual

St
a
te:

Final

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

Page
12

/
156

etamax space GmbH . Richard
-
Wagner
-
St
raße 1 . 38106 Brau
n
schweig


Figure 6.30:

Parameters of a beam object

................................
................................
....

143

Figure 6.31:

Parameters of a pipe object

................................
................................
......

144

Figure 6.32:

Parameters of a tank object

................................
................................
......

146

Figure 6.33:

Meshing parameters of the tank

................................
...............................

147

Figure 6.34:

Overview of the truss object

................................
................................
.....

149

Figure 6
.35:

Points of the truss object

................................
................................
...........

149

Figure 6.36:

Additional parameters of the truss object

................................
................

150

Figure 6.37:

Overview of the four sided truss object

................................
....................

151

Figure 6.38:

Points of the four sided truss object

................................
.........................

152

Figure 6.39:

Additional parameters of the four sided truss object

..............................

152

Figure 7.1:

ESABASE2 menu bar

................................
................................
..................

154

Figure 7.2:

ESABASE2 help system

................................
................................
...............

155

Figure

7.3:

Geometry editor, Toolbar (right side)

................................
.......................

156




ESABASE2
-

Framework

Date:

2009
-
1
0
-
2
2

Software User Manual

Revis
i
on:

1
.
1

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

St
a
te:

Final

etamax space GmbH . Richard
-
Wagner
-
Straße 1 . 38106 Brau
n
schweig

Page
13

/
156

VIII.

List of Tables

Table 2.1:

Hardware

Requirements

................................
................................
..............

16

Table 3.1:

Orbit input parameters

................................
................................
................

38

Table 3.2:

Examples for Degree of Freedom specifications

................................
.........

74

Table 3.3:

The "Inherit parent values" parameter

................................
......................

81

Table 3.4:

The "VEC1" parameter

................................
................................
................

82

Table 3.5:

The "VEC2" parameter

................................
................................
................

82

Table 3.6:

The "pdir" parameter

................................
................................
..................

83

Table 3.7:

The "track" parameter

................................
................................
................

84

Table 3.8:

The "inverse" parameter

................................
................................
.............

84

Table 6.1:

Definition of the BOX shape

................................
................................
.....

101

Table 6.2:

Definition of the CONE shape

................................
................................
...

105

Table 6.3:

Definition of the CYLINDER shape

................................
............................

108

Table 6.4:

Definition of the ELLI
PSOID shape

................................
............................

113

Table 6.5:

Definition of the OGIVE shape

................................
................................
..

117

Table 6.6:

Definition of the PARABOLOID shape

................................
......................

122

Table 6.7:

Definition of the SPHERE shape

................................
................................

126

Table 6.8:

Definition of the DISC shape

................................
................................
.....

131

Table 6.9:

Definition of the PLATE shape

................................
................................
..

132

Table 6.10:

Definition of the FACET dummy shape

................................
.....................

135

Table 6.11:

Definition of the PRISM sha
pe

................................
................................
..

136

Table 6.12:

Definition of the SURFACE shape

................................
..............................

138

Table 6.13:

Definition of the ANTENNA shape

................................
............................

142

Table 6.14:

Definition of BEAM shape

................................
................................
.........

143

Table 6.15:

Definition of the PIPE shape

................................
................................
......

144

Table 6.16:

Definition of the TANK shape

................................
................................
...

146

Table 6.17:

Definition of the TRUSS3 shape

................................
................................

150

Table 6.18:

Definition of the TRUSS4 shape

................................
................................

153





Date:

2009
-
1
0
-
2
2

ESABASE
2
-

Framework

Revision

1
.
1

Software User Manual

St
a
te:

Final

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

Page
14

/
156

etamax space GmbH . Richard
-
Wagner
-
St
raße 1 . 38106 Brau
n
schweig


1


Introduction

Before you dive into the ESABASE2 analysis work, this short introduction will
provide
yo
u with a birds
-
eye
-
view understanding
,

with the help of the following items:



The Big Picture
: Where does ESABASE2 stand?



Chapter overview
: So you find your way through the chapters more quickly.



Problem Reporting
:

What to do if you encounter troubles
.


1.1

The

Big Picture

ESABASE2

is a software

application (and framework) for space environment analyses,
which play a vital role in
spacecraft

mission plann
ing. Currently (2009), it encompasses
D
ebris/mete
o
roid

/2/
,
A
tmosphere/ionosphere

/3/
, C
ontamination/outgassing
/4/

and
Sunlight
/5/

analyse
s
; with this, it complements other aspects of mission pla
n
ning like
thermal or power

generator

d
e
sign.

The application grew from ESABASE2
/Debris
, an application

for space debris and micro
-
meteoroid impact and damage analy
sis, which in turn
is based on
the original
ESABASE/Debris

software
/6/

develop
ed
by
different companies under
ES
A contract
.
ESABASE2
adds a
modern graphical user interface enabling the user to intera
c
tively
establish and manipulate three
-
dimensional spacecraft models and to display the s
e-
lected orbit.

Analysis resul
ts can be displayed by means of
the
colour
-
coded surfaces of
the 3D spacecraft model, and by means of various di
a
grams.

The development of ESABASE2 was undertaken by etamax space GmbH under the
European Space Agency contract No. 16852/02/NL/JA. The
first
g
oal was to port
ESABASE/Debris

and its framework/user interface to the PC platform (Microsoft Wi
n-
dows) and to create a modern user interface.


From the start, the software architecture
has been

expressively designed to accomm
o-
da
te fur
ther applications:

the solvers outlined in the first paragraph

were added, and
more modules like
e.g.

R
adiation are to follow.

ESABASE2 is written in Fortran 77, ANSI C++ and Java 6. The GUI is built on top of the
Eclipse rich client platform, with

3D visualisation and STEP import realised by Open
CASCADE. Report and graphs are based on the JFreeReport/JFree
Chart
libra
r
ies.





ESABASE2
-

Framework

Date:

2009
-
1
0
-
2
2

Software User Manual

Revis
i
on:

1
.
1

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

St
a
te:

Final

etamax space GmbH . Richard
-
Wagner
-
Straße 1 . 38106 Brau
n
schweig

Page
15

/
156

1.2

Chapter Overview

This software user manual is intended to be read by persons running the program and
interpreting or usi
ng th
e results of ESABASE2. It contains

the follo
w
ing chapters:



Chapter

1
,
Introduction
:
You are reading it right now.



Chapter

2
,
Getting Started
:
How to install, start an
d use the software, without
going into particular solvers (debris, atmosphere, ionosphere).



Chapter

3
,
Mission and Spacecraft Definition
: How to specify the basics:
mission
parameters
and spac
e
craft geometry. C
an be re
-
used wit
h all solvers.



Chapter
4
,
Solvers
: Pointers to the solver handbooks, e.g. Debris or Sunlight.



Chapter

5
,
Troubleshooting
:
What to do in case of errors.


Each solver (e.g. Debris

/2/
, Atmosphere/Ionosphere

/3/
, Sunlight

/5/
) has its own han
d-
book; this manual e
x
plains only the functionality common to all.

This
user manual
refers to
ESABASE2 version 2.0.0
. Other versi
on
s of ESABASE2 (and of
course
the
original
Unix implementation of
ESABASE
) are not co
v
ered.


1.3

Problem Reporting

ESABASE2 has been extensively tested. However, errors might occur at different layers
of the software (GUI,
business

layer, data handling
).
Aside from the GUI messages, the
log files in the
ESABASE2
logs

d
i
rectory

may yield further information
.

If
a
proble
m cannot be solved, you

should

contact the ESABASE2
team at etamax space
to
investigate the issue

in detail.
Please
do not
hesitate

to visit
http://www.esabase2.net

for co
ntact information.

You will also find a pro
b
lem reporting form in the User’s area
of the ESABASE2 website.



Date:

2009
-
1
0
-
2
2

ESABASE2
-

Framework

Revision

1
.
1

Software User Manual

St
a
te:

Final

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

Page
16

/
156

etamax space GmbH . Richard
-
Wagner
-
Straße 1 . 38106 Brau
n
schweig


2

Getting Started

with ESABASE2

This chapter describes

how you
can
install and run ESABASE2 in a basic way. If you have
already created
a spacecraft
geometry and a mission and/or made an analysis, you can
safely skip this cha
p
ter. It is divided into the following subsections:



Installation and Start
: How to in
stall ESABASE2 and start it; you should end with
the application on your screen.



Basic GUI Usage
:
E
xplanation of the
ESABASE2
graphical user inter
face concept;

how to perform tasks
that
are common to all
ESABASE2

solvers
.


2.1

Installation

and

Start

In this se
ction, you will learn how to install and start ESABASE2:



Hardware

Requirements
: Just to make sure your PC is suffi
ci
ently powerful. Esp
e-
cially large geometries and many orbital points can be quite taxing.



Installation
: How to install the ESABASE2 software
on your harddisk.



Operating System Adaptations
: For older operating systems (e.g. Windows 2000),
some adap
t
ations are necessary in order to run ESABASE2.



Upgrade
: Notes for users upgrading from a previous version of ESABASE2.



Starting ESABASE2
: The differe
nt ways to start the application, and details about
where your files are on the harddisk.


2.1.1

Hardware

Requirements

Before installing
ESABASE2, you
should make sure that the system requirements listed
in
Table
2
.
1

are met.
Otherwise, large geometries or analysis runs with a large number
of orbital points could take very long or fail due to insufficient memory.





Minimum

Reco
m
mended

Operating System

Windows 2000

Windows
XP, Vista

RAM

1 GB
yte

4 GBytes

Free Disk Space

1 GByte

2 GBytes

CPU (Clock frequency)

2 GHz single core

2 GHz dual core

Graphics Card

Nvidia Geforce

6
200

or ATI Radeon
7000

Nvidia Geforce

98
00

or ATI Radeon

X1600

Table
2
.
1
:

Hardware

Requirements





ESABASE2
-

Framework

Date:

2009
-
1
0
-
2
2

Software User Manual

Revis
i
on:

1
.
1

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

St
a
te:

Final

etamax space GmbH . Richard
-
Wagner
-
Straße 1 . 38106 Brau
n
schweig

Page
17

/
156


2.1.2

Installation

To install ESABASE2
,

unzip the

ESABASE2_2.0.0_
final
.zip

archive

from the install
a
tion
DVD

to a location of your choice
. We recommend deactivating anti
-
virus software as its
file scanning activities can considerably slow

down the
unpac
k
ing process.

If you open a Windows Explorer and navigate to the
ESABASE2 application
directory,
the
la
y
out shown in the following figure will
be presented to you:



Figure
2
.
1
:

ESABASE2 dire
ctory tree


In the
logs

folder, you can find the application log files (named with application start
date), useful for troubl
e
shooting. If you report a problem to the etamax team, please
attach the pertinent log file.

In case you are an original ESABASE e
xpert, the contents of the
Solver

directory could
be of interest to you. Here, expert users can manipulate population data and data t
a-
bles. Do so at your own risk, and always keep a backup.

Please do not touch the
components
,
configuration
,
plugins
, and
re
lease_
dlls

fol
d
ers
.

Only look into the
temp

directory for curiosity; do not change anything there.

Once you run the application, a
workspace

folder will be added. All of your files are
saved here.




Date:

2009
-
1
0
-
2
2

ESABASE2
-

Framework

Revision

1
.
1

Software User Manual

St
a
te:

Final

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

Page
18

/
156

etamax space GmbH . Richard
-
Wagner
-
Straße 1 . 38106 Brau
n
schweig


2.1.3

Operating System Adaptations

The

operating system
for ESAB
ASE2 is

Windows 2000 SP4, XP SP3 or Vista SP1.
With the
older OS versions
, the following components
may

not
be
present and must
then

be i
n-
stalled man
u
ally:



Windows
installer

(
version

"KB884016
-
v2
-
x86")



DLLs for generic Windows functions (version "x86_2009_
sp2").


To install the missing

components, locate the
components
\
install
-
supplements

d
i
rectory
below the ESABASE2
base
directory, as shown in the figure below

(this is an exception
to the "don’t touch the
components

directory" from the previous subsection)
.



Figure
2
.
2
:

ESABASE2 directory tree: install supplements


Doubleclick
WindowsInstaller
-
KB884016
-
v2
-
x86.exe

and follow the instru
c
tions. Then
repeat the same procedure for
vcredist_x86_2009_sp2.exe
.

You
r system is now equipped
with the newest version of central DLLs used by ESABASE2.





ESABASE2
-

Framework

Date:

2009
-
1
0
-
2
2

Software User Manual

Revis
i
on:

1
.
1

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

St
a
te:

Final

etamax space GmbH . Richard
-
Wagner
-
Straße 1 . 38106 Brau
n
schweig

Page
19

/
156


2.1.4

Upgrade

If you are a first
-
time user of ESABASE2, you can safely skip this chapter. If you are u
p-
grading, the following hints may be useful for you.

The new installation is

in a separate directory from your old installation. It is possible to
have several versions on harddisks; the development team is doing it all the time.


To keep your workspace

from a previous version (e.g. ESABASE2 1.4.2)
, delete the
wor
k-
space

directory
from the
new
application directory
,

and move your original
workspace

directory here.

Th
e
n start the new application; y
our workspace should be immediately visible
.

This is all
you need to do
to the workspace replacement.


Please note that with ESABASE2 vers
ion 2.0.0, a new file storing format has been intr
o-
duced.
Files from earlier versions are readable (they are converted automatically to the
new version), but it is not possible the other way round.

For example, a geometry file created or modified with ESAB
ASE2 version 2.0.0 will not
be readable by ESABASE2 ve
r
sion 1.4.2.

The change was caused by an upgr
ade from OpenCascade 6.1 to 6.3, which fixed some
bugs

in this external component.




Date:

2009
-
1
0
-
2
2

ESABASE2
-

Framework

Revision

1
.
1

Software User Manual

St
a
te:

Final

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

Page
20

/
156

etamax space GmbH . Richard
-
Wagner
-
Straße 1 . 38106 Brau
n
schweig


2.1.5

Start
ing

ESABASE2

To
launch the ESABASE2
application
, double
-
click the fi
le
esabase2.exe

in the applic
a-
tion directory.

A splash screen will appear

to accompany the loading process, after which
the
main
GUI
will become visible on screen, as illustrated by the fo
l
lowing screenshot.



Figure
2
.
3
:

ESABASE2 user interface


You will notice

that the GUI consists of multiple sub
-
windows (
called
"views
").
In the
figure above, the left column
consists of

an
"E
SABASE2

Explorer"

and

an "Out
line"; to
the right
,

most of the place is taken
by
a spacecraft geometry edi
tor
;

and at the bo
t-
tom,

you can see

a "Properties"

view
.

The next section will explain the usage of the GUI.




ESABASE2
-

Framework

Date:

2009
-
1
0
-
2
2

Software User Manual

Revis
i
on:

1
.
1

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

St
a
te:

Final

etamax space GmbH . Richard
-
Wagner
-
Straße 1 . 38106 Brau
n
schweig

Page
21

/
156


2.2

Basic GUI Usage

After reading this chapter, you will be able to navigate the GUI and make sense of the
ESABASE2 workflow,
in the following steps:



GUI Overview
:
Explains the contents of each view within the application, and its
purposes.



GUI Adaptation
: How to customise the view arrangement to suit your inform
a-
tional needs.



Project organisation
: How to create and organise proj
ects and geometry, mission
and solver files.


2.2.1

GUI Overview

This subsection will give you an overview of the main GUI parts, enumerated from 1 to
6 in the following figure.


Figure
2
.
4
:

User interface overvi
ew


T
here is a
menu bar (1), a toolbar (2), an editor (3) and

then a number of
supporting
views (4
) to (6).



Date:

2009
-
1
0
-
2
2

ESABASE2
-

Framework

Revision

1
.
1

Software User Manual

St
a
te:

Final

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

Page
22

/
156

etamax space GmbH . Richard
-
Wagner
-
Straße 1 . 38106 Brau
n
schweig


They serve the following purposes:



The menu bar gives full (but complex) access to all major operations concerning
projects and files.



The tool bar

gives easy (but incomplete) access to the most frequently used fun
c-
tionalities.



The editor area contains an editor for a file (here, a geometry editor on a
ROSAT

spacecraft geometry). Each file has its own editor.



The workspace explorer shows your project
s and the folders and
the
files within
it.



Each file is
modelled

as a tree structure (think "directories" and "files" like in
your file system). The Ou
t
line shows the "directory" nodes.



Complementary, the Properties view shows the "file" nodes.


The menu b
ar contains "File", "Edit", "Help" entries (probably familiar to you from
other applications) and a "Wi
n
dow" menu, which allows you to
customize the GUI both
through Perspective

settings and the Preferences. Please see Annex B for d
e
tails, and
the followin
g figure for overview.



Figure
2
.
5
:

Menubar and Toolbar


The toolbar contains "New", "Save

/

Save All
" and "Run"
buttons
. The "New" (project,
g
e
ometry, mission, etc.) entry is explained in section
2.2.3

"Project Organisation"; the
"Run" entries apply to the different Solvers (e.g. Debris, Sunlight, Atmosphere) and are
explained in the respective
solver handbooks.

If you hopelessly
d
is
arrang
ed the application window, you can pre
ss the "Reset Perspe
c-
tive" button as a last resort. It will restore the standard GUI settings.

The

"Next

/

Prev Change" and "Back" buttons are shortcuts to menu entries. They will
be removed in future ve
r
sions of ESABASE2.


The editor area contains the act
ive editors. Whenever there is more than one editor
open, tabs will show the list, and the active tab belongs to the active editor. Please see
chapter
3

"Mission and Spacecraft" definition, for d
e
tails.





ESABASE2
-

Framework

Date:

2009
-
1
0
-
2
2

Software User Manual

Revis
i
on:

1
.
1

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

St
a
te:

Final

etamax space GmbH . Richard
-
Wagner
-
Straße 1 . 38106 Brau
n
schweig

Page
23

/
156



Explorer, Outline and
Properties
view give you information about

the
data

contents in a
file. This is done
in 3 d
e
tail levels, as the following figure
s show
.





Figure
2
.
6
:

Explorer, Outline, Properties view


The
E
xplorer sh
ows the workspace with projec
ts, directories and files; the O
utline shows
the tree structure

of an open file; and the P
ro
p
erties view
shows detailed data entries
of one specific node.

In the above example,
a ROSAT geometry is shown (see E
xplorer). This in
turn consists of
a tree with a System and a main body "ROSAT", which has a "CentralBody" with a
"STA
TE_1", describing an "Axis" (see

O
utline). To see exactly how the ax
is is specified,
refer to the Pr
operties view,
which shows

e.g. a "Rotation" attribute.




Date:

2009
-
1
0
-
2
2

ESABASE2
-

Framework

Revision

1
.
1

Software User Manual

St
a
te:

Final

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

Page
24

/
156

etamax space GmbH . Richard
-
Wagner
-
Straße 1 . 38106 Brau
n
schweig


2.2.2

GUI Adaptation

In this section, you will learn how to customise the views of the ESABASE2 application
window. If you are already familiar with GUI handling of multi
-
window application
s
,
you can safely skip this chapter.

The first thing to know is how to m
anipulate the views within the main application
window. For this purpose, each view has a tab with i
ts name, and additional buttons, as
shown in the following figure.



Figure
2
.
7
:

Common View buttons


To
the right, t
he first button is to minimise the view, the second one is to max
i
mise it.
You can also maximise a view

by double clicking its name tab (left)
. By double clicking
the
tab

of an already maximised view, the size is norma
l
ised.

You can also grab t
he
tab and move the view around, and snap it into different pos
i-
tions within the main window. This includes tabbing views, i.e. layering several views on
top of each other.

Lastly, the edges of each view can be grabbed for resizing. Depending on the positi
on
of the view in the main window, only the view or a whole column is resized.


All of your changes are saved automatically in the current perspective ("arrangement of
views"). To reset the perspective to the original settings, choose "Window


Reset Pe
r-
sp
ective" in the menubar.






ESABASE2
-

Framework

Date:

2009
-
1
0
-
2
2

Software User Manual

Revis
i
on:

1
.
1

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

St
a
te:

Final

etamax space GmbH . Richard
-
Wagner
-
Straße 1 . 38106 Brau
n
schweig

Page
25

/
156


2.2.3

Project Organisation

In order to work with ESABASE2, you will work with input and output files. Both are
organised in projects.

This subsection deals with the following cases:



Creating a project



Creating input files (e.g. mission,

spacecraft)



Moving files around


2.2.3.1

Creating a Project

The first thing to do after starting ESABASE2 is to create a new project (which will co
n-
tain S/C geometry, orbit and solver parameters). We recommend creating one project
per mission. To do so, click
"
Fi
le


New


Pr
o
ject
"

in the menubar
; the wizard shown
in the fo
l
lowing figure will open.



Figure
2
.
8
:

"New Project" wizard, page 1


On this first page, you can select the type of project; choose "ESABASE2
Project" (in f
u-
ture versions of ESABASE2, other kinds of project may be possible). Then, click next. This
will lead to the second wizard page, illustrated in the following figure:




Date:

2009
-
1
0
-
2
2

ESABASE2
-

Framework

Revision

1
.
1

Software User Manual

St
a
te:

Final

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

Page
26

/
156

etamax space GmbH . Richard
-
Wagner
-
Straße 1 . 38106 Brau
n
schweig



Figure
2
.
9
:

"New Project
" wizard, page 2


C
hoose a project name

in the first text field
; we recommend "<S/C name>_project".
Then click the "Finish" button.

When look
ing

at the ESABASE2 Explorer (top
-
left in the window), you will see that the
project has been created with three d
efault files, shown in the following figure:



Figure
2
.
10
:

A new project and its three default files


The "geometry" file contains the S/C geometry, the "mission" file describes the orbit,
and the "debris
" solver input file contains parameters for ESABASE2/Debris.





ESABASE2
-

Framework

Date:

2009
-
1
0
-
2
2

Software User Manual

Revis
i
on:

1
.
1

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

St
a
te:

Final

etamax space GmbH . Richard
-
Wagner
-
Straße 1 . 38106 Brau
n
schweig

Page
27

/
156


2.2.3.2

Creating Input Files

When you created a

project, 3 default files for S/C geometry, mission specification, and
Debris solver were cr
e
ated. To create additional files, choose "File


New


<Type>"

in
the menubar, as illustrated by the following figure:



Figure
2
.
11
:

Creating new files within a project


All possible input files are listed here. In the example above, you see "New" options for
projec
ts (see previous subsection), geometry, mission, folder; and solver input files for
Atmosphere/Ionosphere and Debris.

For each file type, an appropriate wizard will be opened; at the minimum, it will ask
you for the filename and where to save it in the pro
ject structure. Import options, if
applicable, will also be presented here; please see the respective chapters for more i
n-
formation.


All
newly created
input files
are

filled with default values, such that you can immed
i-
ately pe
r
form a solver run with it.
This means that with the 3 default files, you could
initiate a
n

ESABASE
2
/Debris analysis (see
Debris solver handbook).




Date:

2009
-
1
0
-
2
2

ESABASE2
-

Framework

Revision

1
.
1

Software User Manual

St
a
te:

Final

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

Page
28

/
156

etamax space GmbH . Richard
-
Wagner
-
Straße 1 . 38106 Brau
n
schweig


2.2.3.3

Moving Files Around

In larger projects, you may wish to organise
your input (and output)

files into folders.
To d
o so, rightclick on the

project (this will open a context menu, as shown in the fo
l-
lowing figure) and cr
e
ate a new folder.




Figure
2
.
12
:

Creating folders within a project, using the context menu


A wizard opens, asking you fo
r a directory name (in the example above, the name "mi
s-
sion_and_spacecraft" is ch
o
sen).
Enter a file name and c
lick "Finish".

To create subfolders, repeat the process on the
desired parent
folder within the
ESABASE2 E
x
plorer (instead of on the project).


T
o move a file to a different fold
er, close any editor operating o
n the file, and then
grab (hold left mouse button) the file, move the mouse cursor to the desired folder, and
drop (release left mouse button)

the file
. To move a file to the project root dir
e
c
tory,
drop the file on the project name.

Drag and drop also works between the ESABASE2 Explorer and the Windows Explorer,
e.g. to
copy

files sent to you by e
mail into the ESABASE2 project
.


The specifics of mission and geometry files will be explained in

the next section
3
; D
e-
bris and other solver files will be explained in
the solver handbooks.





ESABASE2
-

Framework

Date:

2009
-
1
0
-
2
2

Software User Manual

Revis
i
on:

1
.
1

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

St
a
te:

Final

etamax space GmbH . Richard
-
Wagner
-
Straße 1 . 38106 Brau
n
schweig

Page
29

/
156


3

Mission and Spacecraft Definition

Every analysis within ESABASE2 needs a mission specification and a spacecraft geometry
definition
,

as well as a solver
-
specific input file. In this chapter, you will learn how to
specify mission and S/C geometry, in the following steps:



Mission
: How to specify the S/C orbit and timeframe of the mission.



Geometry
: How to build a
3D
spacecraft geometry

i
n a CAD way
, or how to i
m-
port one from BAS or STEP files.



Kinematics
: How to supply the S/C geometry with the ability to move its parts,
both by rotating and tran
s
lating subsystems during a mission.



Pointing
: How to specify pointing on a spacecraft,
both o
n the system and on
subcomponents (e.g. solar panels pointing to the sun). Subsystems need kinema
t-
ics to be able to move.


3.1

Mission

All solvers within ESABASE2 perform their analysis on orbital points, i.e. fixed locations
on a given orbit at a given point
of time. To determine these orbital points, the mission
file is used.

In the following, you will specify a mission in the following steps:



Mission File
: How to create a new mission file.



Mission Editor
: How to specify
the
orbi
t, timeframe, and orbital poin
t param
e-
ters
.



Mission Outline and Properties View
: How to specify additional parameters (for
Expert users only).



Mission Visualisation
: The mission editor contains a preview page, on which you
can see the specified orbit.



Import of INP files
: Alternatively
, you can import original ESABASE .INP files for
the mission specific
a
tion.



Orbit Propagator
: Explains how the orbit propagator works, and its limitations.


We start with the mission editor.



Date:

2009
-
1
0
-
2
2

ESABASE2
-

Framework

Revision

1
.
1

Software User Manual

St
a
te:

Final

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

Page
30

/
156

etamax space GmbH . Richard
-
Wagner
-
Straße 1 . 38106 Brau
n
schweig


3.1.1

Mission File

With the creation of a project, a new mission file h
as been created; however you might
also want to create a new one. To do so, choose "File


New


Mission" in the
menubar. A wizard as shown in the following figure will be opened.




Figure
3
.
1
:

Mission fi
le creation wizard


On the first wizard page, "Create empty file" is selected as default; just press the
"Next" bu
t
ton. The second page asks you for the location of the new file (in the figure
above, "tc_5_01"), and a file name (above, "cub
e
sat_mission").

Upon pressing "Finish", a new mission file is created. It has the file ending ".mission",
which is not shown in the ESABASE2 Explorer, and does not need to be specified in the
wizard.

A mission editor is automatically opened on the newly created file.





ESABASE2
-

Framework

Date:

2009
-
1
0
-
2
2

Software User Manual

Revis
i
on:

1
.
1

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

St
a
te:

Final

etamax space GmbH . Richard
-
Wagner
-
Straße 1 . 38106 Brau
n
schweig

Page
31

/
156


3.1.2

Mi
ssion

Editor

If the mission editor is not already open, go to the ESABASE2 Explorer view and

doubl
e-
click the

mission file (recognisable via the planet
-
plus
-
orbit icon)
. A mission

editor will

be

open
ed
, and the Outline and
Properties view will be updated.

T
he following figure shows the application with an opened mission editor.



Figure
3
.
2
:

Mission Editor, Outline and Properties view


The
mission

file is circled in red. Below, you see the "Orbit" node sele
cted in the Ou
t-
line, and further below, the "A" (semi
-
major axis) and other attributes

in the "Prope
r-
ties" view
. On the right side, the mission editor itself is shown.


The mission editor contains all necessary parameters to specify an orbit and th
e number

of orbital points to
be
used

during an analysis.
It has three sections:



Orbit



Mission Time



Time Inte
r
val or Number of Orbital Points





Date:

2009
-
1
0
-
2
2

ESABASE2
-

Framework

Revision

1
.
1

Software User Manual

St
a
te:

Final

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

Page
32

/
156

etamax space GmbH . Richard
-
Wagner
-
Straße 1 . 38106 Brau
n
schweig


Starting with the "Orbit" section,
you can choose between
a predefined geostationary
(
"
GEO
"
), a predefined sun
-
synchrono
us (
"
SUN
"
) or
a custom ("GEN") orbit

in the first
com
b
obox of the editor.

In most cases, you will probably

want
a custom orbit; for that, specify the Keplerian
elements in the
text fields

below the first combobox.



semi
-
major axis

[km]



eccentricity
]0..1
]



i
nclination
[deg]



right ascension of the ascending node
[deg]



argument of perigee
[deg]



true anomaly
[deg]


Semi
-
major axis
(A)
and eccentricity
(E)
can alternatively be defined using apogee

alt
i-
tude

and perigee

altitude

(
text fields

to the right)
. Whenever

you leave
("unfocus")
one
of the latter
text fields
, A and E will be
re
-
calculated

automatically.

Note that for analysis purposes, A and E are always the values that will be evaluated;
apogee and perigee
alt
i
tudes
are only helper input methods.


In the ne
xt section ("Mission Time"), you specify

start and end date of the mission
, and
the number of orbits. Please note
that some solvers (e.g. Debris)
will

always use number
of orbits = 1
, ignoring
deviant input
; t
his is hardcoded into
the
Debris

solver

and can
not
be changed by ESABASE2.


The last section, "Time Interval or Number of Orbital Points", is used to specify how
many orbital points you want. A higher number of orbital points will increase the acc
u-
racy of
analysis

results, but take longer to compute.

W
henever you make changes in one of the text fields, press the "Apply" button next to
it. If time interval and number of orbital points are not in sync, results may vary depen
d-
ing on the solver you use.





ESABASE2
-

Framework

Date:

2009
-
1
0
-
2
2

Software User Manual

Revis
i
on:

1
.
1

Reference:
R077
-
230rep_01_01_Software_User_Manual_Framework.doc

St
a
te:

Final

etamax space GmbH . Richard
-
Wagner
-
Straße 1 . 38106 Brau
n
schweig

Page
33

/
156


3.1.3

Mission Outline and Properties View

Expert users of t
he original ESABASE may edit further properties using