~ubuntu-branches/ubuntu/precise/stellarium/precise

« back to all changes in this revision

Viewing changes to plugins/Satellites/README

• browse files at revision 7
• compare with another revision
• download diff
• download tarball
• view history from revision 7

Show diffs side-by-side

added

removed

plugins/Satellites/README

 

1

Satellites Plugin for Stellatium

 

2

================================

 

3

 

 

4

INTRODUCTION

 

5

============

 

6

 

 

7

This feature has been requested so many times it's not funny.  Several

 

8

people have posted to the developer list saying they would like to have a

 

9

go and then the Yeti seem to get them and we never hear another thing.

 

10

 

 

11

Well, dagnammit, I thought I'd have a go.

 

12

 

 

13

I took the SDP4/SGP4 implementation from ktrack, adapting the use of

 

14

the library.

 

15

 

 

16

Projection is done from the azimuth/elevation data which the SDP4/SGP4

 

17

library handily produces.  Probably not the "right" way to do it, but 

 

18

it works and I am lazy.

 

19

 

 

20

 

 

21

TODO

 

22

====

 

23

 

 

24

+ When restoring default satellites.json, deleted satellites are

 

25

  somewhow not working right.  Something to do with deleteing a SatelliteP

 

26

  investigate and fix.

 

27

+ Fix data: trawl amsat site for updates and modify satellites.json

 

28

+ Do less frequent calls to the position calculation when a satellite

 

29

  is not near the observer

 

30

+ Rendering of the actual satellite, not just a hint/label

 

31

  - calculation of brightness, eclipse etc.

 

32

  - iridium flares?

 

33

+ Implement grouping so we can enable/disable groups, e.g.

 

34

  - gui widget with options to show/hide groups of satellites

 

35

+ gravity labels

 

36

 

 

37

Longer term:

 

38

+ proper 3d positions (when SolarSystem is refactored so we can see

 

39

  satellite cloud from the moon / other bodies.

 

40

+ trails (also after SolarSystem refactor)

 

41

 

 

42

 

 

43

BUILDING THE PLUGIN

 

44

===================

 

45

 

 

46

Please note, these instructions are only directly applicable to Linux.

 

47

Windows and OSX targets will probably require modification of the

 

48

CMakeLists.txt file.

 

49

 

 

50

0.  Install and build the SVN version of Stellarium as per the 

 

51

instructions on the Stellarium wiki:

 

52

 

 

53

  http://stellarium.org/wiki/index.php/Compilation_on_Linux

 

54

 

 

55

1.  Set the environment variable STELROOT to the root of the Stellarium

 

56

source tree.  The Stellarium build directory is expected to be:

 

57

 

 

58

  $STELROOT/builds/unix 

 

59

 

 

60

2.  Create a sub-directory builds/unix and change into that directory.

 

61

 

 

62

3.  Run:

 

63

 

 

64

  cmake ../.. 

 

65

  make

 

66

  make install

 

67

 

 

68

If all goes well, the relevant files should be built and copied to your 

 

69

~/.stellarium/modules directory.

 

70

 

 

71

 

 

72

ACKNOWLEGDEMENTS

 

73

================

 

74

 

 

75

SGP4/SDP4 implementation taken from KTrack codebase. There were some

 

76

minor modifications to prevent conflicts with #defines and enums from 

 

77

the core Stellarium code, but nothing significant.

 

78

 

 

79

The code which uses the SGP4/SDP4 library was copied more or less 

 

80

verbatim from KTrack up to the point of getting the alt/azi and other

 

81

data out.

 

82

 

 

83

 

 

84

 

• Older »

Loggerhead is a web-based interface for Breezy
Version: 2.0.1