esa · albertNos · Dec 14, 2021 · Dec 14, 2021 · Dec 14, 2021 · Dec 15, 2021
diff --git a/README.md b/README.md
@@ -53,6 +53,22 @@ the `yaml` file. See `default_cfg.yaml` for the syntax.
 ## Processing TLE Input 
 Data on current satellites etc. is often found [online](https://www.space-track.org/) in the [TLE format](https://en.wikipedia.org/wiki/Two-line_element_set). We include a Jupyter notebook which can be used to process TLE data with pykep to create and analyze suitable datasets. Detailed instructions can be found in the notebook in `notebooks/Data Processing.ipynb`.
 
+## Generating Constellation Input
+Satellite constellations (e.g. Starlink, OneWeb) are usually described by a list of orbital shells.
+An orbital shell is described by a 4-tuple with information about `altitude`, `inclination`, `number of
+planes`, and `number of satellites` per plane. We provide a notebook 
+`notebooks/ConstellationGeneration/ConstellationGeneration.ipynb` that can be used 
+to generate constellation data from orbital shell parameters.
+
+Quick guide:
+* Initialize the constellation by executing the first cell and providing metadata in the second cell (1)
+* create a shell by providing the 4 shell arguments, and further parameters (extra params) if necessary (2.1).
+Store the temporary shell data by executing the cell (2.2)
+* turn satellites into position and velocity vectors by executing cell (3)
+* write the files by executing cell (4) and save them by executing cell (5)
+
+A detailed guide is located in the directory of the notebook.
+
 ## Output
 
 LADDS has multiple options for output that can be (de)activated mostly independent of each other via YAML. See `cfg/default_cfg.yaml` for relevant options.
@@ -83,3 +99,4 @@ Collision data is tracked every iteration, particle data only in intervals that
 ### CSV
 If HDF5 output is disabled entirely, collision data is written in a `.csv` file in ASCII layout.
 
+
diff --git a/cfg/default_cfg.yaml b/cfg/default_cfg.yaml
@@ -27,7 +27,7 @@ io:
     writeFrequency: 1000 # Frequency of writing to the hdf5 file [iterations]
     compressionLevel: 4 # Valid Levels: 0 (no compression) - 9 (max compression)
 
-  #constellationList: AstraPhase2,100,7200 # ';'-seperated constellations consisting of path (to constellation directory), start time, duration
+  #constellationList: AstraPhase2 # ';'-seperated constellations consisting of path (to constellation directory), start time, duration
   constellationFrequency: 10 # Frequency of adding satellites to simulation [iterations]
   constellationCutoff: 0.1 # satellites of constellations are only inserted when there is no object within constellationCutoff range
   altitudeSpread: 1.0 # [km] normal distributed altitude deviations are usually smaller than this value (~99.74% chance)

diff --git a/data/Amazon/pos_Amazon.csv b/data/Amazon/pos_Amazon.csv
diff --git a/data/Amazon/shells_Amazon.txt b/data/Amazon/shells_Amazon.txt
diff --git a/data/Amazon/v_Amazon.csv b/data/Amazon/v_Amazon.csv
diff --git a/data/Amazon/xparams_Amazon.txt b/data/Amazon/xparams_Amazon.txt
diff --git a/data/AstraPhase1/pos_AstraPhase1.csv b/data/AstraPhase1/pos_AstraPhase1.csv
diff --git a/data/AstraPhase1/shells_AstraPhase1.txt b/data/AstraPhase1/shells_AstraPhase1.txt
diff --git a/data/AstraPhase1/v_AstraPhase1.csv b/data/AstraPhase1/v_AstraPhase1.csv
diff --git a/data/AstraPhase1/xparams_AstraPhase1.txt b/data/AstraPhase1/xparams_AstraPhase1.txt
diff --git a/data/AstraPhase2/pos_AstraPhase2.csv b/data/AstraPhase2/pos_AstraPhase2.csv
diff --git a/data/AstraPhase2/shells_AstraPhase2.txt b/data/AstraPhase2/shells_AstraPhase2.txt
diff --git a/data/AstraPhase2/v_AstraPhase2.csv b/data/AstraPhase2/v_AstraPhase2.csv
diff --git a/data/AstraPhase2/xparams_AstraPhase2.txt b/data/AstraPhase2/xparams_AstraPhase2.txt
diff --git a/data/AstraPhase3/pos_AstraPhase3.csv b/data/AstraPhase3/pos_AstraPhase3.csv
diff --git a/data/AstraPhase3/shells_AstraPhase3.txt b/data/AstraPhase3/shells_AstraPhase3.txt
diff --git a/data/AstraPhase3/v_AstraPhase3.csv b/data/AstraPhase3/v_AstraPhase3.csv
diff --git a/data/AstraPhase3/xparams_AstraPhase3.txt b/data/AstraPhase3/xparams_AstraPhase3.txt
diff --git a/data/GuoWang/pos_GuoWang.csv b/data/GuoWang/pos_GuoWang.csv
diff --git a/data/GuoWang/shells_GuoWang.txt b/data/GuoWang/shells_GuoWang.txt
diff --git a/data/GuoWang/v_GuoWang.csv b/data/GuoWang/v_GuoWang.csv
diff --git a/data/GuoWang/xparams_GuoWang.txt b/data/GuoWang/xparams_GuoWang.txt
diff --git a/data/OneWebPhase1/pos_OneWebPhase1.csv b/data/OneWebPhase1/pos_OneWebPhase1.csv
diff --git a/data/OneWebPhase1/shells_OneWebPhase1.txt b/data/OneWebPhase1/shells_OneWebPhase1.txt
diff --git a/data/OneWebPhase1/v_OneWebPhase1.csv b/data/OneWebPhase1/v_OneWebPhase1.csv
diff --git a/data/OneWebPhase1/xparams_OneWebPhase1.txt b/data/OneWebPhase1/xparams_OneWebPhase1.txt
diff --git a/data/OneWebPhase2/pos_OneWebPhase2.csv b/data/OneWebPhase2/pos_OneWebPhase2.csv
diff --git a/data/OneWebPhase2/shells_OneWebPhase2.txt b/data/OneWebPhase2/shells_OneWebPhase2.txt
diff --git a/data/OneWebPhase2/v_OneWebPhase2.csv b/data/OneWebPhase2/v_OneWebPhase2.csv
diff --git a/data/OneWebPhase2/xparams_OneWebPhase2.txt b/data/OneWebPhase2/xparams_OneWebPhase2.txt
diff --git a/data/StarlinkGen1/pos_StarlinkGen1.csv b/data/StarlinkGen1/pos_StarlinkGen1.csv
diff --git a/data/StarlinkGen1/shells_StarlinkGen1.txt b/data/StarlinkGen1/shells_StarlinkGen1.txt
diff --git a/data/StarlinkGen1/v_StarlinkGen1.csv b/data/StarlinkGen1/v_StarlinkGen1.csv
diff --git a/data/StarlinkGen1/xparams_StarlinkGen1.txt b/data/StarlinkGen1/xparams_StarlinkGen1.txt
diff --git a/data/StarlinkGen2/pos_StarlinkGen2.csv b/data/StarlinkGen2/pos_StarlinkGen2.csv
diff --git a/data/StarlinkGen2/shells_StarlinkGen2.txt b/data/StarlinkGen2/shells_StarlinkGen2.txt
diff --git a/data/StarlinkGen2/v_StarlinkGen2.csv b/data/StarlinkGen2/v_StarlinkGen2.csv
diff --git a/data/StarlinkGen2/xparams_StarlinkGen2.txt b/data/StarlinkGen2/xparams_StarlinkGen2.txt
diff --git a/data/Telesat/pos_Telesat.csv b/data/Telesat/pos_Telesat.csv
diff --git a/data/Telesat/shells_Telesat.txt b/data/Telesat/shells_Telesat.txt
diff --git a/data/Telesat/v_Telesat.csv b/data/Telesat/v_Telesat.csv
diff --git a/data/Telesat/xparams_Telesat.txt b/data/Telesat/xparams_Telesat.txt