File: planets.1

package info (click to toggle)
planets 0.1.12-7
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 352 kB
  • ctags: 587
  • sloc: ml: 2,894; makefile: 129; ansic: 38
file content (113 lines) | stat: -rw-r--r-- 2,779 bytes parent folder | download | duplicates (10)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
.TH planets 1 "April 20, 2003" 
.SH NAME
planets \- Gravitational simulation of planetary bodies
.\"
.SH DESCRIPTION
.\"
.B Planets 
is a simple interactive program for playing with simulations
of planetary systems. It is great teaching tool for understanding how
gravitation works on a planetary level.

The user interface is aimed at being simple enough for a fairly young
kid can get some joy of it.  There's also a special kid-mode aimed at very
young children which grabs the focus and converts key banging into lots of
random planets.
.\"
.SH KEYBINDINGS
.\"
.SS Universe definition
.\"
.IP a
Add Planet
.IP j
Place random orbital planet
.IP r
Place random planet
.IP u
Undo (undoes last planet insertion)
.IP e
Reset to empty universe
.IP g
Go Back (goes back to just after last planet insertion)
.IP Mouse
Click on a planet to delete it
.\"
.SS Physics
.\"
.IP b
Toggle bounce (experimental)
.\"
.SS Display control
.\"
.TP
Cursor keys
Panning
.\"
.TP 
c, Space
Move display to center of mass
.IP x
Initiate center of mass tracking
.IP =
Zoom in
.IP -
Zoom out
.IP p
Toggle Pause
.IP o
Change all colors randomly
.IP t
Toggle Trace
.IP d
Double Trace Length
.IP h
Halve Trace Length
.IP Mouse
Drag a box around a set of planets to follow the center of mass of
those planets
.\"
.SS Program control
.\"
.IP H
Display help dialog
.IP k
Display option dialog
.IP Ctrl-Shift-k
Toggle kid-mode.  Kid mode locks the keyboard and mouse, so the only way to
get out is to toggle kid-mode again to get out.
.IP l
Load Universe
After pressing l, press any other character to load the universe with
that name. Universes are stored in ~/.planets/ .
.IP s
Save Universe
.\"
After pressing s, press any other character to save the universe with
that name. Universes are saved in ~/.planets/ .
.TP 
q, Esc
Quit
.\"
.SH TECHNICAL DETAILS
.B Planets
uses a fourth-order runge-kutta approximation for the simulation
itself.  Planet bouncing is achieved by adding a repulsive force to planets
at close quarters.  
.B Planets
is fairly flexible: you can change the
gravitational constant, the time-slice of the simulation, and even the
exponent used in the gravitational law.  Universes are saved in the
~/.planets directory, and are simple human readable and editable files.
.SH BUGS
Currently bouncing doesn't work very well unless you make the time-slice
quite small.  Ideally, it would be nice to have a billiard-style bounce
system, but it's not clear how to do this accurately in the presence of a
strong gravitational field.
.SH AUTHOR
.B Planets
was written by Yaron M. Minsky <yminsky@cs.cornell.edu> as a gift for
his nephew, Eyal Minsky-Fenick.

This manpage was contributed originally by Martin Pitt <martin@piware.de> for
the Debian GNU/Linux system (but may be used by others).