Skip to content

Commit

Permalink
deploy: 2e47416
Browse files Browse the repository at this point in the history
  • Loading branch information
m-franke committed Nov 19, 2021
1 parent e0476cd commit c2e6698
Show file tree
Hide file tree
Showing 10 changed files with 240 additions and 12 deletions.
4 changes: 2 additions & 2 deletions about/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ <h1 style=padding-top:32px;padding-left:10px>space_Veins</h1>
<p><strong>space_Veins</strong> is an extension of <a href=https://veins.car2x.org>Veins</a> which integrates satellites as additional communication partners in vehicular networks.
By using Veins, the discrete event simulator <a href=https://omnetpp.org>OMNeT++</a> and the road traffic simulator <a href=https://www.eclipse.org/sumo>SUMO</a> are used in order to simulate vehicular networks.
In addition, space_Veins provides OMNeT++ modules for modeling satellites.
The satellites' mobility is based on the python library <a href=https://rhodesmill.org/skyfield/>Skyfield</a> which can calculate orbits of satellites based on NASA/NORAD <a href=https://www.celestrak.com/NORAD/elements/>Two-Line Element sets</a>.</p>
The satellites' mobility is based on the <a href=https://celestrak.com/publications/AIAA/2006-6753/>SGP4 model</a> which can calculate orbits of satellites based on NASA/NORAD <a href=https://www.celestrak.com/NORAD/elements/>Two-Line Element sets</a>.</p>
<p>For further information please refer to the documentation.<br></p>
<p><a href=/documentation class="btn btn-lg btn-success">Documentation</a>
<br><br>
Expand All @@ -77,7 +77,7 @@ <h1 style=padding-top:32px;padding-left:10px>space_Veins</h1>
<footer class="footer fixed-bottom mt-auto py-0 bg-light">
<div class="container text-center">
<span class=text-muted>
© <a href=https://www.cms-labs.org/people/franke>Mario Franke</a> 2021 | Last modified: 10 November 2021 | <a href=/imprint-and-privacy/>Imprint and Privacy</a>
© <a href=https://www.cms-labs.org/people/franke>Mario Franke</a> 2021 | Last modified: 19 November 2021 | <a href=/imprint-and-privacy/>Imprint and Privacy</a>
</span>
</div>
</footer>
Expand Down
99 changes: 99 additions & 0 deletions documentation/example/index.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,99 @@
<!doctype html><html class=h-100 lang=en>
<head>
<meta charset=utf-8>
<meta name=viewport content="width=device-width,initial-scale=1,shrink-to-fit=no">
<meta name=description content="Running the example - space_Veins">
<meta name=author content="Mario Franke">
<link href=/assets/bootstrap/bootstrap.min.css rel=stylesheet>
<link rel=apple-touch-icon sizes=180x180 href=/assets/icons/apple-touch-icon.png>
<link rel=icon type=image/png sizes=32x32 href=/assets/icons/favicon-32x32.png>
<link rel=icon type=image/png sizes=16x16 href=/assets/icons/favicon-16x16.png>
<link rel=manifest href=/assets/icons/site.webmanifest>
<link rel=mask-icon href=/assets/icons/safari-pinned-tab.svg color=#00152b>
<meta name=msapplication-TileColor content="#ffffff">
<meta name=theme-color content="#ffffff">
<title>Running the example - space_Veins</title>
</head>
<body style="padding-top:56px;background:url(/assets/pictures/nasa-satellite-earth.jpg)no-repeat 50% fixed;-webkit-background-size:cover;-moz-background-size:cover;-o-background-size:cover;background-size:cover">
<style>.bd-placeholder-img{font-size:1.125rem;text-anchor:middle;-webkit-user-select:none;-moz-user-select:none;user-select:none}@media(min-width:768px){.bd-placeholder-img-lg{font-size:3.5rem}}span.navbar-custom nav.navbar-custom{background-color:#00152b!important}nav.navbar-custom .navbar-brand,nav.navbar-custom .nav-link,nav.navbar-custom .navbar-text{color:#fff!important}nav.navbar-custom .navbar-toggler{border-color:#fff!important}</style>
<span class=navbar-custom><nav class="navbar navbar-expand-md navbar-dark bg-dark fixed-top navbar-custom">
<div class=container>
<a class=navbar-brand onmouseover="style='text-decoration:underline'" onmouseout="style='text-decoration:none'" href=/about>space_Veins</a>
<button class=navbar-toggler type=button data-bs-toggle=collapse data-bs-target=#navbarCollapse aria-controls=navbarCollapse aria-expanded=false aria-label="Toggle navigation">
<span class=navbar-toggler-icon></span>
</button>
<div class="collapse navbar-collapse" id=navbarCollapse>
<ul class="navbar-nav mr-auto">
<li class=nav-item>
<a class=nav-link onmouseover="style='text-decoration:underline'" onmouseout="style='text-decoration:none'" href=/documentation/> Documentation </a>
</li>
<li class=nav-item>
<a class=nav-link onmouseover="style='text-decoration:underline'" onmouseout="style='text-decoration:none'" href=/download/> Download </a>
</li>
<li class=nav-item>
<a class=nav-link onmouseover="style='text-decoration:underline'" onmouseout="style='text-decoration:none'" href=/publications/> Publications </a>
</li>
</ul>
</div>
</div>
</nav></span>
<main>
<div class=container style=padding:1px>
<div class="p-1 mb-4 bg-light rounded-3">
<div class="container-fluid py-5">
<header>
<div>
<table>
<tr>
<td>
<img src=/assets/icons/logo_space_Veins.svg alt=logo_space_Veins.svg style=width:96px>
</td>
<td>
<h1 style=padding-top:32px;padding-left:10px>Running the example</h1>
</td>
</tr>
</table>
</hr>
</div>
</header>
<div id=breadcrumbs>
<a href=/about>space_Veins</a>
> <a href=/documentation/>Documentation</a>
> <a href=/documentation/example/>Example</a>
</div>
<hr>
<h4 id=preparation>Preparation</h4>
<p>The satellites' mobility is modeled by the SGP4Mobility module.
As its name suggests the model is based on the SGP4 model which relys on TLE data.
Due to the unknown licensing of TLE data space_Veins does not include the required TLE data.
Up to date TLE data can be download at e.g., <a href=https://www.celestrak.com/NORAD/elements/>https://www.celestrak.com/NORAD/elements/</a>.
The <a href=https://web.archive.org/>Wayback Machine</a> might be helpful to find older TLE data sets.
Additionally, <a href=https://rhodesmill.org/skyfield/earth-satellites.html>Skyfield</a> might be helpful to detect satellites which fly over Erlangen based on the TLE data used.</p>
<p>The desired TLE set of a single satellite has to be copied in the lines 61-63 of <code>examples/space_veins/omnetpp.ini</code>.
Further, you have to set the corresponding wall clock time in the SGP4Mobility module, see the parameter <code>wall_clock_sim_start_time_utc</code> in <code>src/space_veins/modules/mobility/SGP4Mobility.ned</code>.</p>
<p>Currently, the example consists of a single satellite and a single vehicle which exchange ping messages.</p>
<h4 id=running-the-example>Running the example</h4>
<p>For running the example the Makefile in the root directory of space_Veins provides three targets:</p>
<ol>
<li><code>make run_example</code><br>
This target starts the example scenarion in the <strong>release</strong> mode and in the commandline environment.</li>
<li><code>make run_dbg_example_cmd</code><br>
This target starts the example scenarion in the <strong>debug</strong> mode and in the commandline environment.</li>
<li><code>make run_dbg_example_gui</code><br>
This target starts the example scenarion in the <strong>debug</strong> mode and in the OMNeT++ GUI environment.</li>
</ol>
<hr>
</div>
</div>
</div>
</main>
<footer class="footer fixed-bottom mt-auto py-0 bg-light">
<div class="container text-center">
<span class=text-muted>
© <a href=https://www.cms-labs.org/people/franke>Mario Franke</a> 2021 | Last modified: 19 November 2021 | <a href=/imprint-and-privacy/>Imprint and Privacy</a>
</span>
</div>
</footer>
<script src=/assets/bootstrap/bootstrap.bundle.min.js></script>
</body>
</html>
1 change: 1 addition & 0 deletions documentation/example/index.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Running the example on space_Veins</title><link>https://www.sat.car2x.org/documentation/example/</link><description>Recent content in Running the example on space_Veins</description><generator>Hugo -- gohugo.io</generator><language>en-us</language><lastBuildDate>Fri, 19 Nov 2021 15:43:11 +0100</lastBuildDate><atom:link href="https://www.sat.car2x.org/documentation/example/index.xml" rel="self" type="application/rss+xml"/></channel></rss>
11 changes: 7 additions & 4 deletions documentation/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -62,10 +62,13 @@ <h1 style=padding-top:32px;padding-left:10px>Documentation</h1>
</div>
<hr>
<p><strong>space_Veins</strong> provides satellite models for OMNeT++ which consider satellites' mobility as well as Vehicle-to-Satellite communication.
In near future, a detailed documentation regarding the following aspects can be found here:</p>
Currently, only the following parts of space_Veins are documented since space_Veins is still in the early stages of development:</p>
<ul>
<li><a href=/documentation/installation>Installation</a></li>
<li><a href=/documentation/example>Running the example</a></li>
</ul>
<p>In the future, a detailed documentation regarding the following aspects can be found here:</p>
<ul>
<li>Installation</li>
<li>Running the example</li>
<li>Simulation architecture</li>
<li>Abstractions/models used</li>
<li>Satellites' mobility</li>
Expand All @@ -85,7 +88,7 @@ <h1 style=padding-top:32px;padding-left:10px>Documentation</h1>
<footer class="footer fixed-bottom mt-auto py-0 bg-light">
<div class="container text-center">
<span class=text-muted>
© <a href=https://www.cms-labs.org/people/franke>Mario Franke</a> 2021 | Last modified: 10 November 2021 | <a href=/imprint-and-privacy/>Imprint and Privacy</a>
© <a href=https://www.cms-labs.org/people/franke>Mario Franke</a> 2021 | Last modified: 19 November 2021 | <a href=/imprint-and-privacy/>Imprint and Privacy</a>
</span>
</div>
</footer>
Expand Down
116 changes: 116 additions & 0 deletions documentation/installation/index.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,116 @@
<!doctype html><html class=h-100 lang=en>
<head>
<meta charset=utf-8>
<meta name=viewport content="width=device-width,initial-scale=1,shrink-to-fit=no">
<meta name=description content="Installation - space_Veins">
<meta name=author content="Mario Franke">
<link href=/assets/bootstrap/bootstrap.min.css rel=stylesheet>
<link rel=apple-touch-icon sizes=180x180 href=/assets/icons/apple-touch-icon.png>
<link rel=icon type=image/png sizes=32x32 href=/assets/icons/favicon-32x32.png>
<link rel=icon type=image/png sizes=16x16 href=/assets/icons/favicon-16x16.png>
<link rel=manifest href=/assets/icons/site.webmanifest>
<link rel=mask-icon href=/assets/icons/safari-pinned-tab.svg color=#00152b>
<meta name=msapplication-TileColor content="#ffffff">
<meta name=theme-color content="#ffffff">
<title>Installation - space_Veins</title>
</head>
<body style="padding-top:56px;background:url(/assets/pictures/nasa-satellite-earth.jpg)no-repeat 50% fixed;-webkit-background-size:cover;-moz-background-size:cover;-o-background-size:cover;background-size:cover">
<style>.bd-placeholder-img{font-size:1.125rem;text-anchor:middle;-webkit-user-select:none;-moz-user-select:none;user-select:none}@media(min-width:768px){.bd-placeholder-img-lg{font-size:3.5rem}}span.navbar-custom nav.navbar-custom{background-color:#00152b!important}nav.navbar-custom .navbar-brand,nav.navbar-custom .nav-link,nav.navbar-custom .navbar-text{color:#fff!important}nav.navbar-custom .navbar-toggler{border-color:#fff!important}</style>
<span class=navbar-custom><nav class="navbar navbar-expand-md navbar-dark bg-dark fixed-top navbar-custom">
<div class=container>
<a class=navbar-brand onmouseover="style='text-decoration:underline'" onmouseout="style='text-decoration:none'" href=/about>space_Veins</a>
<button class=navbar-toggler type=button data-bs-toggle=collapse data-bs-target=#navbarCollapse aria-controls=navbarCollapse aria-expanded=false aria-label="Toggle navigation">
<span class=navbar-toggler-icon></span>
</button>
<div class="collapse navbar-collapse" id=navbarCollapse>
<ul class="navbar-nav mr-auto">
<li class=nav-item>
<a class=nav-link onmouseover="style='text-decoration:underline'" onmouseout="style='text-decoration:none'" href=/documentation/> Documentation </a>
</li>
<li class=nav-item>
<a class=nav-link onmouseover="style='text-decoration:underline'" onmouseout="style='text-decoration:none'" href=/download/> Download </a>
</li>
<li class=nav-item>
<a class=nav-link onmouseover="style='text-decoration:underline'" onmouseout="style='text-decoration:none'" href=/publications/> Publications </a>
</li>
</ul>
</div>
</div>
</nav></span>
<main>
<div class=container style=padding:1px>
<div class="p-1 mb-4 bg-light rounded-3">
<div class="container-fluid py-5">
<header>
<div>
<table>
<tr>
<td>
<img src=/assets/icons/logo_space_Veins.svg alt=logo_space_Veins.svg style=width:96px>
</td>
<td>
<h1 style=padding-top:32px;padding-left:10px>Installation</h1>
</td>
</tr>
</table>
</hr>
</div>
</header>
<div id=breadcrumbs>
<a href=/about>space_Veins</a>
> <a href=/documentation/>Documentation</a>
> <a href=/documentation/installation/>Installation</a>
</div>
<hr>
<h4 id=system-requirements>System requirements:</h4>
<ul>
<li>Debian 10, Debian 11, Ubuntu 20.04 (other Linux distribution might work, too, but are not tested yet)</li>
<li>Veins 5.1 (which depends on)
<ul>
<li>OMNeT++ 5.6.2</li>
<li>SUMO 1.8.0</li>
</ul>
</li>
<li><a href=http://conan.io/index.html>Conan</a> 1.42.1 (A C/C++ package manager required to install <a href=https://proj.org/>PROJ</a> 8.1.1)</li>
</ul>
<p>You can find Veins 5.1 and its dependencies already installed in the virtual machines <a href=http://veins.car2x.org/documentation/instant-veins/>Instant Veins 5.1-i2</a></p>
<h4 id=guide>Guide:</h4>
<ol>
<li>
<p>Install Veins, OMNeT++, and SUMO in a single directory e.g., <code>src</code> (already done in Instant Veins 5.1-i2).</p>
</li>
<li>
<p>Download Conan from <a href=http://conan.io/downloads.html>http://conan.io/downloads.html</a> and install it.</p>
</li>
<li>
<p>Clone the space_Veins source files in the same directory as Veins, OMNeT++, and SUMO are located. (For Instant Veins 5.1-i2 it is <code>/home/veins/src</code>.)</p>
<div class=highlight><pre tabindex=0 style=color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-bash data-lang=bash>git clone https://github.com/veins/space_veins.git
</code></pre></div></li>
<li>
<p>Go into the <code>space_veins</code> directory.</p>
</li>
<li>
<p>Run the following Makefile targets</p>
<div class=highlight><pre tabindex=0 style=color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-bash data-lang=bash>make conan_deps
make makefiles
make
</code></pre></div></li>
<li>
<p>If all steps are finished successfully space_Veins is ready to use.</p>
</li>
</ol>
<hr>
</div>
</div>
</div>
</main>
<footer class="footer fixed-bottom mt-auto py-0 bg-light">
<div class="container text-center">
<span class=text-muted>
© <a href=https://www.cms-labs.org/people/franke>Mario Franke</a> 2021 | Last modified: 19 November 2021 | <a href=/imprint-and-privacy/>Imprint and Privacy</a>
</span>
</div>
</footer>
<script src=/assets/bootstrap/bootstrap.bundle.min.js></script>
</body>
</html>
1 change: 1 addition & 0 deletions documentation/installation/index.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Installation on space_Veins</title><link>https://www.sat.car2x.org/documentation/installation/</link><description>Recent content in Installation on space_Veins</description><generator>Hugo -- gohugo.io</generator><language>en-us</language><lastBuildDate>Mon, 23 Aug 2021 12:53:11 +0200</lastBuildDate><atom:link href="https://www.sat.car2x.org/documentation/installation/index.xml" rel="self" type="application/rss+xml"/></channel></rss>
14 changes: 11 additions & 3 deletions download/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -61,9 +61,17 @@ <h1 style=padding-top:32px;padding-left:10px>Download</h1>
> <a href=/download/>Download</a>
</div>
<hr>
<p><a href=https://github.com/veins/space_veins/tree/master class="btn btn-lg btn-success">View the "master" branch at github</a>
<br></p>
<h2 id=space_veins-02>space_Veins 0.2</h2>
<p>space_Veins 0.2 is online. Changes:</p>
<ul>
<li>The satellite mobility model is still based on the SGP4 model but now it is purely written in C/C++ code.</li>
<li>Skyfield and all required dependencies are removed.</li>
<li>Some bug fixes.</li>
</ul>
<h2 id=space_veins-01>space_Veins 0.1</h2>
<p>space_Veins 0.1 is released and ready to download from its github repository. Since it depends on Veins 5.1, space_Veins requires all dependencies of Veins 5.1, like SUMO and OMNeT++, too. Additionally, the source code is only tested on an Ubuntu 20.04 LTS system.</p>
<a href=https://github.com/veins/space_veins/tree/master class="btn btn-lg btn-success">View the "master" branch at github</a>
<p>space_Veins 0.1 is released and ready to download from its github repository. Since it depends on Veins 5.1, space_Veins requires all dependencies of Veins 5.1, like SUMO and OMNeT++, too.</p>
<hr>
</div>
</div>
Expand All @@ -72,7 +80,7 @@ <h2 id=space_veins-01>space_Veins 0.1</h2>
<footer class="footer fixed-bottom mt-auto py-0 bg-light">
<div class="container text-center">
<span class=text-muted>
© <a href=https://www.cms-labs.org/people/franke>Mario Franke</a> 2021 | Last modified: 10 November 2021 | <a href=/imprint-and-privacy/>Imprint and Privacy</a>
© <a href=https://www.cms-labs.org/people/franke>Mario Franke</a> 2021 | Last modified: 19 November 2021 | <a href=/imprint-and-privacy/>Imprint and Privacy</a>
</span>
</div>
</footer>
Expand Down
2 changes: 1 addition & 1 deletion index.html
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<!doctype html><html class=h-100 lang=en>
<head>
<meta name=generator content="Hugo 0.89.2">
<meta name=generator content="Hugo 0.89.4">
<meta charset=utf-8>
<meta name=viewport content="width=device-width,initial-scale=1">
<meta name=description content="space_Veins - space_Veins">
Expand Down
2 changes: 1 addition & 1 deletion index.xml
Original file line number Diff line number Diff line change
Expand Up @@ -2,5 +2,5 @@
Langer Weg 52
33100 Paderborn
E-Mail: contact[at]m-franke[dot]net Impressum: https://sat.car2x.org/imprint-and-privacy/ Social Media und andere OnlinepräsenzenDieses Impressum gilt auch für die folgenden Social-Media-Präsenzen und Onlineprofile: https://linkedin.com/in/mario-franke-9497621b5
Haftungs- und SchutzrechtshinweiseHaftungsausschluss: Die Inhalte dieses Onlineangebotes wurden sorgfältig und nach unserem aktuellen Kenntnisstand erstellt, dienen jedoch nur der Information und entfalten keine rechtlich bindende Wirkung, sofern es sich nicht um gesetzlich verpflichtende Informationen (z.B. das Impressum, die Datenschutzerklärung, AGB oder verpflichtende Belehrungen von Verbrauchern) handelt.</description></item><item><title>space_Veins</title><link>https://www.sat.car2x.org/about/</link><pubDate>Wed, 25 Aug 2021 11:27:11 +0200</pubDate><guid>https://www.sat.car2x.org/about/</guid><description>space_Veins is an extension of Veins which integrates satellites as additional communication partners in vehicular networks. By using Veins, the discrete event simulator OMNeT++ and the road traffic simulator SUMO are used in order to simulate vehicular networks. In addition, space_Veins provides OMNeT++ modules for modeling satellites. The satellites' mobility is based on the python library Skyfield which can calculate orbits of satellites based on NASA/NORAD Two-Line Element sets.
Haftungs- und SchutzrechtshinweiseHaftungsausschluss: Die Inhalte dieses Onlineangebotes wurden sorgfältig und nach unserem aktuellen Kenntnisstand erstellt, dienen jedoch nur der Information und entfalten keine rechtlich bindende Wirkung, sofern es sich nicht um gesetzlich verpflichtende Informationen (z.B. das Impressum, die Datenschutzerklärung, AGB oder verpflichtende Belehrungen von Verbrauchern) handelt.</description></item><item><title>space_Veins</title><link>https://www.sat.car2x.org/about/</link><pubDate>Wed, 25 Aug 2021 11:27:11 +0200</pubDate><guid>https://www.sat.car2x.org/about/</guid><description>space_Veins is an extension of Veins which integrates satellites as additional communication partners in vehicular networks. By using Veins, the discrete event simulator OMNeT++ and the road traffic simulator SUMO are used in order to simulate vehicular networks. In addition, space_Veins provides OMNeT++ modules for modeling satellites. The satellites' mobility is based on the SGP4 model which can calculate orbits of satellites based on NASA/NORAD Two-Line Element sets.
For further information please refer to the documentation.</description></item></channel></rss>
Loading

0 comments on commit c2e6698

Please sign in to comment.