-
Notifications
You must be signed in to change notification settings - Fork 17
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
28 changed files
with
3,686 additions
and
45 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,64 @@ | ||
.. pycraf-gui: | ||
***************************************************************** | ||
Graphical user interface (`pycraf-gui`) | ||
***************************************************************** | ||
|
||
.. currentmodule:: pycraf.gui | ||
|
||
Introduction | ||
============ | ||
|
||
The `~pycraf` GUI is a little graphical application, which is shipped with | ||
the Python `~pycraf` package. It can be used to quickly analyze the path | ||
propogation losses along a transmitter-receiver sight-line and plot the path | ||
geometry. It is also possible to compute attenuation maps. At the moment, it | ||
doesn't come with an amazing amount of features, but it is foreseen to add | ||
more in the future. | ||
|
||
|
||
|
||
Using pycraf-gui | ||
================ | ||
|
||
To run the application, simply run: | ||
|
||
.. code-block:: console | ||
pycraf-gui | ||
.. note:: | ||
|
||
As for the `~pycraf.pathprof` sub-package, SRTM tile data is necessary | ||
to query terrain height profiles. It is possible to have the GUI download | ||
the tiles automatically. Nevertheless, if you already have SRTM (or other | ||
.hgt) tiles, you can use them; see also :ref:`working_with_srtm`. | ||
|
||
The GUI looks like the following: | ||
|
||
.. image:: pycraf-screenshot-low.jpg | ||
:width: 800 | ||
:height: 699px | ||
:scale: 100 % | ||
:alt: pycraf-gui screenshot | ||
:align: left | ||
|
||
In the "General parameters" pane, one can change the environmental properties, | ||
such as temperature and pressure, the desired radio frequency and of course | ||
the location of transmitter and receiver with their antenna heights, etc. | ||
Any change to these numbers will automatically update the "Geometry" display, | ||
i.e., the results of the path loss calculation and the associate path plot. | ||
It is also possible to compute plots of the path losses vs. distance ("Path | ||
profile" pane) and attenuation maps ("Mapping" pane). | ||
|
||
Currently, it is possible to save the plots as images (pdf, png, etc.) but it | ||
is not yet possible to export the data into a disk file. | ||
|
||
See Also | ||
======== | ||
|
||
- `Astropy Units and Quantities package <http://docs.astropy.org/en/stable/ | ||
units/index.html>`_, which is used extensively in pycraf. | ||
- `ITU-R Recommendation P.452-16 <https://www.itu.int/rec/ | ||
R-REC-P.452-16-201507-I/en>`_ | ||
|
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -46,6 +46,7 @@ Available modules | |
geometry/index | ||
mc/index | ||
utils/index | ||
gui/index | ||
|
||
.. automodapi:: pycraf | ||
:no-heading: | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,7 @@ | ||
#!/usr/bin/env python | ||
# -*- coding: utf-8 -*- | ||
''' | ||
Contains a graphical user interface (GUI) for simple tasks. | ||
''' | ||
|
||
from .gui import * |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,17 @@ | ||
#!/usr/bin/python | ||
# -*- coding: utf-8 -*- | ||
|
||
import sys | ||
|
||
|
||
def main(args=None): | ||
'''Launch pycraf GUI.''' | ||
if args is None: | ||
args = sys.argv[1:] | ||
|
||
from pycraf import gui | ||
gui.start_gui() | ||
|
||
|
||
if __name__ == '__main__': | ||
main() |
Oops, something went wrong.