prepare a quick-start tutorial

Author: pfandzelter

.gitignore

@@ -8,7 +8,6 @@ test.toml
 .idea/
 .mypy_cache/
 *.bin
-/animation/
 
 ~$*
 

Makefile

@@ -15,31 +15,21 @@
 # along with this program. If not, see <http://www.gnu.org/licenses/>.
 #
 
-.PHONY: build client server container binary runclient runserver installserver cleanupserver
+.PHONY: build container celestial-make rootfs-builder
 
-build: proto container binary
-client: proto container runclient
-server: proto binary runserver
+build: proto celestial.bin
 
 container: proto Dockerfile celestial.py celestial ## build client docker container
 	docker build -t celestial .
 
-binary: celestial.bin
-
 celestial.bin: celestial.go pkg proto ## build go binary
 	go build -o celestial.bin .
 
-proto: ## build proto files
+proto/: ## build proto files
 	cd ./proto ; make ; cd ..
 
-runclient: container ## run client
-	docker run --rm -it -v $(pwd)/config.toml:/config.toml celestial /config.toml
-
-runserver: celestial.bin ## run server
-	sudo ./celestial.bin
-
-cleanupserver: ## run server cleanup
-	bash ./cleanupserver.sh
+celestial-make: ## build the compile container
+	docker build -f compile.Dockerfile -t celestial-make .
 
-installserver: ## install dependencies on server
-	bash ./installserver.sh
+rootfsbuilder: ## build the rootfs builder container
+	cd ./builder ; make rootfsbuilder ; cd ..

animation/README.md

@@ -0,0 +1,24 @@
+# Animation Only
+
+If you would like to animate a satellite constellation, use the `animate.py`
+program in the root of the repository like so:
+
+```sh
+python3 animate.py ./path/to/configuration.toml
+```
+
+![Constellation Animation](../docs/assets/celestial-constellation.gif)
+
+In the [`animation`](./animation) directory, you can find two example
+configuration files.
+
+`starlink.toml` has all parameters for the complete Starlink phase I
+constellation, so use that to animate that constellation:
+
+```sh
+# in /celestial root directory
+python3 animate.py ./animation/starlink.toml
+```
+
+`geostationary.toml` has a single geo-stationary satellite in orbit
+around earth.

examples/animation/geostationary.toml renamed to animation/geostationary.toml

@@ -78,17 +78,20 @@ func main() {
 			panic(err.Error())
 		}
 	}()
+
 	go func() {
 		err := infoserver.Start(*infoServerPort, o)
 		if err != nil {
 			panic(err.Error())
 		}
 	}()
+
 	go func() {
 		err := s.Serve(lisS)
 		if err != nil {
 			panic(err.Error())
 		}
 	}()
+
 	panic(p.Serve(lisP))
 }

examples/animation/iridium.toml renamed to animation/iridium.toml

@@ -103,8 +103,8 @@ def __init__(
             self.shell_actors.append(types.SimpleNamespace())
             self.isl_actors.append(types.SimpleNamespace())
 
-        self.sat_colors = sns.color_palette(n_colors=self.num_shells+3)[3:]
-        self.isl_colors = sns.color_palette(n_colors=self.num_shells+3, desat=0.5)[3:]
+        self.sat_colors = sns.color_palette(n_colors=self.num_shells)
+        self.isl_colors = sns.color_palette(n_colors=self.num_shells, desat=0.5)
 
         self.draw_links = draw_links
 

examples/animation/starlink.toml renamed to animation/starlink.toml

@@ -0,0 +1,44 @@
+FROM debian:bullseye@sha256:bdf44f19d09b558203306836a612cc8e42a1106b2f731fbeb000e2696c04f9c8
+
+RUN apt-get update && apt-get install -y \
+    --no-install-recommends \
+    --no-install-suggests \
+    ca-certificates \
+    wget \
+    make \
+    unzip \
+    python3 \
+    git \
+    python3-pip && \
+    apt-get clean && rm -rf /var/lib/apt/lists/*
+
+RUN wget https://github.com/protocolbuffers/protobuf/releases/download/v3.15.8/protoc-3.15.8-linux-x86_64.zip && \
+    unzip protoc-3.15.8-linux-x86_64.zip -d protoc-3.15.8 && \
+    mv protoc-3.15.8 /usr/local/protoc && \
+    rm protoc-3.15.8-linux-x86_64.zip && \
+    chmod +x /usr/local/protoc/bin/* && \
+    ln -s /usr/local/protoc/bin/protoc /usr/local/bin/protoc
+
+RUN wget https://go.dev/dl/go1.18.1.linux-amd64.tar.gz && \
+    rm -rf /usr/local/go && \
+    tar -C /usr/local -xzf go1.18.1.linux-amd64.tar.gz && \
+    echo 'export PATH="$PATH:/usr/local/go/bin"' >> /etc/profile && \
+    echo 'export PATH="$PATH:/root/go/bin"' >> /etc/profile && \
+    echo 'export GOPATH=/root/go' >> /etc/profile && \
+    echo 'export GOBIN="/root/go/bin"' >> /etc/profile && \
+    rm -rf go1.18.1.linux-amd64.tar.gz
+
+ENV PATH $PATH:/usr/local/go/bin
+ENV PATH $PATH:/root/go/bin
+ENV GOPATH /root/go
+ENV GOBIN /root/go/bin
+
+RUN go install google.golang.org/protobuf/cmd/[email protected] && \
+    go install google.golang.org/grpc/cmd/[email protected]
+
+COPY requirements.txt requirements.txt
+RUN python3 -m pip install -r requirements.txt -U
+
+WORKDIR /celestial
+
+ENTRYPOINT [ "make" ]