From e9612c7a72b362d5d6744f280c6454d9ecbb2c04 Mon Sep 17 00:00:00 2001 From: Anthony Romaniello <66272872+aromanielloNTIA@users.noreply.github.com> Date: Fri, 1 Nov 2024 19:43:27 -0400 Subject: [PATCH 01/21] Add pip-install instructions for P2108 --- includes/_pypi_distribution.qmd | 5 +++++ models/P2108/python.qmd | 10 ++++++---- 2 files changed, 11 insertions(+), 4 deletions(-) create mode 100644 includes/_pypi_distribution.qmd diff --git a/includes/_pypi_distribution.qmd b/includes/_pypi_distribution.qmd new file mode 100644 index 0000000..f7bc48c --- /dev/null +++ b/includes/_pypi_distribution.qmd @@ -0,0 +1,5 @@ +This Python package is distributed through the +[Python Package Index (PyPI)](https://pypi.org/). All ITS PropLib Python +packages required a [currently-supported](https://devguide.python.org/versions/) +version of Python. Run the following command to install the package, and any required dependencies, into your Python environment: + diff --git a/models/P2108/python.qmd b/models/P2108/python.qmd index ceafb76..a9340a3 100644 --- a/models/P2108/python.qmd +++ b/models/P2108/python.qmd @@ -1,7 +1,7 @@ --- title: "ITU-R P.2108 – Python" date: 2024-06-25 -date-modified: 2024-06-25 +date-modified: 2024-11-01 --- This page details the installation and usage of the Python version of the U.S. Reference Implementation of Recommendation ITU-R P.2108. @@ -10,7 +10,11 @@ This page details the installation and usage of the Python version of the U.S. R ## Installation -{{< include /includes/_package_install_not_ready.qmd >}} +{{< include /includes/_pypi_distribution.qmd >}} + +```default +pip install proplib-p2108 +``` The following code snippet shows how to import the package and check the installed version: @@ -19,8 +23,6 @@ from ITS.ITU.PSeries import P2108 print(P2108.__version__) ``` -This package has no external Python dependencies. - {{< include /includes/_py_documentation_block.qmd >}} ```python From a8016215d0685b042267bba588785d8229660aa2 Mon Sep 17 00:00:00 2001 From: Anthony Romaniello <66272872+aromanielloNTIA@users.noreply.github.com> Date: Wed, 6 Nov 2024 18:03:51 -0500 Subject: [PATCH 02/21] fix Python example output values and add example enum usage --- models/P2108/python.qmd | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) diff --git a/models/P2108/python.qmd b/models/P2108/python.qmd index a9340a3..e0c5dbe 100644 --- a/models/P2108/python.qmd +++ b/models/P2108/python.qmd @@ -45,14 +45,12 @@ clutter_type = 6 # Clutter type, enum # Call height gain terminal correction model (P.2108 Section 3.1) A_h__db = P2108.HeightGainTerminalCorrectionModel(f__ghz, h__meter, w_s__meter, R__meter, clutter_type) -assert(A_h__db == 8.769394261533549) +# A_h__db is approximately 25.54 dB -# can also use clutter type IntEnum -clutter_type = P2108.ClutterType.DenseUrban - -# call clutter model +# can also use enum to provide clutter type +clutter_type = P2108.ClutterType.DenseUrban # int value is 6 A_h__db = P2108.HeightGainTerminalCorrectionModel(f__ghz, h__meter, w_s__meter, R__meter, clutter_type) -assert(A_h__db == 8.769394261533549) +# A_h__db is approximately 25.54 dB ``` ### Terrestrial Statistical Model @@ -65,7 +63,7 @@ p = 50 # Percentage of locations, in % # call terrestrial statistical model L_ctt__db = P2108.TerrestrialStatisticalModel(f__ghz, d__km, p) -assert(L_ctt__db == 26.10075036783342) +# L_ctt__db is approximately 26.63 dB ``` ### Aeronautical Statistical Model @@ -78,5 +76,5 @@ p = 50 # Percentage of locations, in % # call clutter model L_ces__db = P2108.AeronauticalStatisticalModel(f__ghz, theta__deg, p) -assert(L_ces__db == 14.333686040067786) +# L_ces__db is approximately 14.33 dB ``` From b3ae6f5ebfec6104963a765f622fe5cd7efb5705 Mon Sep 17 00:00:00 2001 From: Anthony Romaniello <66272872+aromanielloNTIA@users.noreply.github.com> Date: Thu, 21 Nov 2024 10:41:07 -0500 Subject: [PATCH 03/21] Update setup-python workflow version To use a non-deprecated version of node --- .github/workflows/quarto-publish.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/quarto-publish.yml b/.github/workflows/quarto-publish.yml index c013c3f..f6acf20 100644 --- a/.github/workflows/quarto-publish.yml +++ b/.github/workflows/quarto-publish.yml @@ -28,7 +28,7 @@ jobs: uses: quarto-dev/quarto-actions/setup@v2 - name: Setup Python - uses: actions/setup-python@v4 + uses: actions/setup-python@v5 with: python-version: '3.10' - run: pip install jupyter From ececeb0007c45ec15a50839f4ead6df9797005a1 Mon Sep 17 00:00:00 2001 From: Anthony Romaniello <66272872+aromanielloNTIA@users.noreply.github.com> Date: Thu, 21 Nov 2024 12:17:23 -0500 Subject: [PATCH 04/21] consistent name for P2108 --- models/P2108/cpp.qmd | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/models/P2108/cpp.qmd b/models/P2108/cpp.qmd index 0e60fc3..0d69085 100644 --- a/models/P2108/cpp.qmd +++ b/models/P2108/cpp.qmd @@ -1,7 +1,7 @@ --- -title: "ITU-R P.2108 – C++" +title: "Recommendation ITU-R P.2108 – C++" date: 2024-07-09 -date-modified: 2024-11-20 +date-modified: 2024-11-21 --- {{< include /includes/_under_construction.qmd >}} From b39e3c1ca4fe61c4a22b93976c4dc35d1beb6543 Mon Sep 17 00:00:00 2001 From: Anthony Romaniello <66272872+aromanielloNTIA@users.noreply.github.com> Date: Thu, 21 Nov 2024 12:19:08 -0500 Subject: [PATCH 05/21] Remove "U.S. Reference Implementation" --- models/P2108/cpp.qmd | 2 +- models/P2108/python.qmd | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/models/P2108/cpp.qmd b/models/P2108/cpp.qmd index 0d69085..21d397d 100644 --- a/models/P2108/cpp.qmd +++ b/models/P2108/cpp.qmd @@ -6,7 +6,7 @@ date-modified: 2024-11-21 {{< include /includes/_under_construction.qmd >}} -This page details the installation and usage of the C++ version of the U.S. Reference Implementation of Recommendation ITU-R P.2108. +This page details the installation and usage of the C++ version of the PropLib implementation of Recommendation ITU-R P.2108. {{< include /includes/_link_to_model_home.qmd >}} diff --git a/models/P2108/python.qmd b/models/P2108/python.qmd index ad896b7..b9a8353 100644 --- a/models/P2108/python.qmd +++ b/models/P2108/python.qmd @@ -4,7 +4,7 @@ date: 2024-06-25 date-modified: 2024-11-20 --- -This page details the installation and usage of the Python version of the U.S. Reference Implementation of Recommendation ITU-R P.2108. +This page details the installation and usage of the Python version of the PropLib implementation of Recommendation ITU-R P.2108. {{< include /includes/_link_to_model_home.qmd >}} From 08b03f284d0669d8d8c8a371d041af1dec989a03 Mon Sep 17 00:00:00 2001 From: Anthony Romaniello <66272872+aromanielloNTIA@users.noreply.github.com> Date: Mon, 2 Dec 2024 21:23:25 -0500 Subject: [PATCH 06/21] Update .gitignore --- .gitignore | 1 + 1 file changed, 1 insertion(+) diff --git a/.gitignore b/.gitignore index 997d493..6e30b19 100644 --- a/.gitignore +++ b/.gitignore @@ -7,3 +7,4 @@ models/P528 **/index_files/ **/*_files /env/ +.vscode From a4922b43203f9cf4cc1641087f7b2aae43a230cc Mon Sep 17 00:00:00 2001 From: Anthony Romaniello <66272872+aromanielloNTIA@users.noreply.github.com> Date: Mon, 2 Dec 2024 21:24:07 -0500 Subject: [PATCH 07/21] Add initial LFMF documentation Still a lot of information to add --- _quarto.yml | 2 +- models/LFMF/_metadata.yml | 15 +++++++++ models/LFMF/cpp.qmd | 68 +++++++++++++++++++++++++++++++++++++++ models/LFMF/index.qmd | 67 ++++++++++++++++++++++++++++++++++++++ references.bib | 11 +++++++ 5 files changed, 162 insertions(+), 1 deletion(-) create mode 100644 models/LFMF/_metadata.yml create mode 100644 models/LFMF/cpp.qmd create mode 100644 models/LFMF/index.qmd diff --git a/_quarto.yml b/_quarto.yml index 041574b..98be985 100644 --- a/_quarto.yml +++ b/_quarto.yml @@ -32,7 +32,7 @@ website: text: Home - text: "U.S. Models" menu: - - Coming Soon + - models/LFMF/index.qmd - text: "ITU-R Models" menu: - models/P2108/index.qmd diff --git a/models/LFMF/_metadata.yml b/models/LFMF/_metadata.yml new file mode 100644 index 0000000..0153fe3 --- /dev/null +++ b/models/LFMF/_metadata.yml @@ -0,0 +1,15 @@ +format: + html: + code-links: + - text: NTIA/LFMF + icon: github + href: https://github.com/NTIA/LFMF + - text: NTIA/LFMF-dotnet + icon: github + href: https://github.com/NTIA/LFMF-dotnet + - text: NTIA/LFMF-matlab + icon: github + href: https://github.com/NTIA/LFMF-matlab + - text: NTIA/LFMF-python + icon: github + href: https://github.com/NTIA/LFMF-python \ No newline at end of file diff --git a/models/LFMF/cpp.qmd b/models/LFMF/cpp.qmd new file mode 100644 index 0000000..8c8954d --- /dev/null +++ b/models/LFMF/cpp.qmd @@ -0,0 +1,68 @@ +--- +title: "Low Frequency / Medium Frequency Propagation Model – C++" +date: 2024-12-02 +date-modified: 2024-12-02 +--- + +This page details the installation and usage of the C++ version of the Low Frequency / Medium Frequency (LF/MF) Propagation Model, developed by NTIA/ITS. + +{{< include /includes/_link_to_model_home.qmd >}} + +## Installation + +{{< include /includes/_package_install_not_ready.qmd >}} + +To use the C++ library in your code, you'll need to download the shared library (`.dll` on Windows, `.dylib` on macOS, or `.so` on Linux) and the header file. These are distributed for each supported platform as part of the [GitHub Releases](https://github.com/NTIA/LFMF/releases/) starting with v2.0. Prior to v2.0, support was only provided for Windows platforms. + +To use the shared library in your project, you'll need to link against it. The details for this process differ depending on your compiler and/or IDE, but generally you will need to somehow provide the path to the files you downloaded from the GitHub release. + +Once you've linked the dynamic library to your project, all you need to do is include the appropriate header file and, optionally, use its namespace: + +```cpp +#include "LFMF.h" + +using namespace ITS::Propagation::LFMF; // Optional: makes later code more concise +``` + +This library has no external C++ dependencies. + +{{< include /includes/_cpp_documentation_block.qmd >}} + +[Docs](https://ntia.github.io/lfmf){.btn .btn-secondary .btn role="button"} + +## Examples + +The following code example shows how the LF/MF model can be called in a C++ program. + +### Calling the Model + +```cpp +#include "LFMF.h" +using namespace ITS::Propagation; + +int main() { + // Define inputs + double h_tx__meter = 0.0; // Height of the transmitter + double h_rx__meter = 0.0; // Height of the receiver + double f__mhz = 0.01; // Frequency + double P_tx__watt = 1000.0; // Transmitter power + double N_s = 301.0; // Surface refractivity + double d__km = 1000.0; // Path distance + double epsilon = 15.0; // Relative permittivity + double sigma = 0.005; // Conductivity + LFMF::Polarization pol = LFMF::Polarization::HORIZONTAL; // Polarization + + // Create struct to store outputs + LFMF::Result result; + LFMF::ReturnCode rtn; // Return code + + // Call the model + rtn = LFMF::LFMF(h_tx__meter, h_rx__meter, f__mhz, P_tx__watt, N_s, d__km, epsilon, sigma, pol, &result); + + // rtn is 0 (SUCCESS) + // result.A_btl__db is 184.49 dB + // result.E_dBuVm is -82.50 dB(uV/m) + // result.P_rx__dbm is -114.93 dBm + // result.method is 1 (residue series) +} +``` diff --git a/models/LFMF/index.qmd b/models/LFMF/index.qmd new file mode 100644 index 0000000..14c7691 --- /dev/null +++ b/models/LFMF/index.qmd @@ -0,0 +1,67 @@ +--- +title: "Low Frequency / Medium Frequency Propagation Model" +date: 2024-12-02 +date-modified: 2024-12-02 +--- + +The Low Frequency / Medium Frequency (LF/MF) Propagation Model predicts basic transmission loss in the frequency range 0.01 - 30 MHz for propagation paths over a smooth Earth and antenna heights less than 50 meters. [@ntia-tr-99-368] + +{{< include /includes/_getting_started.qmd >}} + +## Model Usage + +TODO Background information about how and when to use this model. + +## Functions + +### Low Frequency / Mid Frequency Propagation Model + +This model's functionality is exposed through a single function. The inputs for this function are shown below in @tbl-lfmf-inputs. +The model outputs are provided in @tbl-lfmf-outputs. +TODO refine this table and add more detail + +| Variable | Type | Units | Limits | Description | +|---------------|--------|--------|-------------------------|------------------------------| +| `h_tx__meter` | double | meter | $0 \leq h_{tx} \leq 50$ | Height of the transmitter | +| `h_rx__meter` | double | meter | $0 \leq h_{rx} \leq 50$ | Height of the receiver | +| `f__mhz` | double | MHz | $0.01 \leq f \leq 30$ | Frequency | +| `P_tx__watt` | double | watt | $0 < P_{tx}$ | Transmitter power | +| `N_s` | double | N-Unit | $250 \leq N_s \leq 400$ | Surface refractivity | +| `d__km` | double | kilometer | $0 < d$ | Path distance | +| `epsilon` | double | none | $1 \leq \epsilon$ | Relative permittivity | +| `sigma` | double | siemens per meter | $0 < \sigma$ | Conductivity | +| `pol` | `Polarization` enum | N/A | enum | See @tbl-lfmf-polarizations | +: Inputs for the LF/MF model {#tbl-lfmf-inputs} + +The `pol` input must be one of the two valid supported polarization types, as defined in @tbl-lfmf-polarizations. + +| Enum Value | Polarization | +|------------|--------------| +| 0 | Horizontal | +| 1 | Vertical | +: Allowed polarization values for the LF/MF model {#tbl-lfmf-polarizations} + +TODO add more information + +| Variable | Type | Units | Description | +|-------------|---------|-------------------|-------------------------| +| `A_btl__db` | double | dB | Basic transmission loss | +| `E_dBuVm` | double | dB(μV/m) | Electric field strength | +| `P_rx__dbm` | double | dBm | Received power | +| `method` | `SolutionMethod` enum | N/A | Solution method; see @tbl-lfmf-solution-methods | +: Outputs of the LF/MF model {#tbl-lfmf-outputs} + +The `method` output indicates the solution method used internally by the model while generating the other outputs. The possible returned values are provided in @tbl-lfmf-solution-methods. + +| Enum Value | Solution Method | +|------------|----------------------------------| +| 0 | Flat earth with curve correction | +| 1 | Residue series | +: Possible solution methods used by the LF/MF model {#tbl-lfmf-solution-methods} + +{{< include /includes/_code_examples.qmd >}} + +[C++](cpp.qmd#calling-the-model){.btn .btn-secondary .btn role="button"} +[.NET](dotnet.qmd#calling-the-model){.btn .btn-secondary .btn role="button"} +[MATLAB](matlab.qmd#calling-the-model){.btn .btn-secondary .btn role="button"} +[Python](python.qmd#calling-the-model){.btn .btn-secondary .btn role="button"} \ No newline at end of file diff --git a/references.bib b/references.bib index 7bbb5b2..04a7321 100644 --- a/references.bib +++ b/references.bib @@ -35,4 +35,15 @@ @misc{itu-r-recommendations title = {{ITU-R Recommendations}}, howpublished = "\url{https://www.itu.int/pub/R-REC}", note = "Accessed: 2024-06-11" +} + +@techreport{ntia-tr-99-368, + author = "Nicholas DeMinco", + title = {{Medium Frequency propagation prediction techniques and antenna modeling for Intelligent Transportation Systems (ITS) broadcast applications}}, + institution = "U.S. Department of Commerce, National Telecommunications and Information Administration, Institute for Telecommunication Sciences", + year = "1999", + type = "NTIA Technical Report", + number = "TR-99-368", + month = "8", + url = "https://its.ntia.gov/publications/2399.aspx" } \ No newline at end of file From 838c866c545ec4af99b4d7e35673c5ccd7e983f9 Mon Sep 17 00:00:00 2001 From: Anthony Romaniello <66272872+aromanielloNTIA@users.noreply.github.com> Date: Mon, 2 Dec 2024 21:24:29 -0500 Subject: [PATCH 08/21] Add legacy models to index table, add link to LFMF --- index.qmd | 42 ++++++++++++++++++++++++++---------------- 1 file changed, 26 insertions(+), 16 deletions(-) diff --git a/index.qmd b/index.qmd index a531ea7..93791e6 100644 --- a/index.qmd +++ b/index.qmd @@ -1,7 +1,7 @@ --- title: "ITS Propagation Library Wiki" date: 2024-06-11 -date-modified: 2024-11-20 +date-modified: 2024-12-02 --- The ITS Propagation Library (**"PropLib"**) is a collection of open source software developed by [ITS](about.qmd), focused on modeling radio wave propagation under a wide variety of circumstances. The library currently supports C++, .NET, MATLAB®, and Python users through exposing common functionality across multiple programming environments. One of the key benefits of this approach is that users are assured of identical results across languages, allowing researchers to work in their most efficient development environment while benefitting from common library improvements. @@ -12,25 +12,35 @@ Currently, PropLib includes implementations of propagation models developed by t ### U.S. Propagation Models +Over the years, ITS has developed and refined various programs for the prediction of radio propagation in a wide range of situations. + Documentation pages are being worked on, and will soon be available through links in the following table, for the following U.S. propagation models: ::: {.callout-warning} ## Page Under Construction -The listed U.S. propagation models have public code repositories, but +The HF, IF77, and MPM models are distributed as legacy software, and do not +yet have public GitHub repositories. +The eHata and ITM models have public code repositories, but documentation is not yet available on this website. Please check back later, and contact [code@ntia.gov](mailto:code@ntia.gov) with questions in the meantime. ::: -+----------:+:-------------------------------------:+:----:+:---------------------------------------------------+ -| **eHata** | [Repo](https://github.com/NTIA/eHata) | Docs | Extended Hata Urban Propagation Model | -+-----------+---------------------------------------+------+----------------------------------------------------+ -| **ITM** | [Repo](https://github.com/NTIA/ITM) | Docs | Irregular Terrain Model | -+-----------+---------------------------------------+------+----------------------------------------------------+ -| **LFMF** | [Repo](https://github.com/NTIA/LFMF) | Docs | Low Frequency / Medium Frequency Propagation Model | -+-----------+---------------------------------------+------+----------------------------------------------------+ -: U.S. propagation models available in the ITS Propagation Library {tbl-colwidths="[15,10,10,65]"} ++----------:+:-------------------------------------:+:-----------------------------------------------------------------------:+:---------------------------------------------------+ +| **eHata** | [Repo](https://github.com/NTIA/eHata) | Docs | Extended Hata Urban Propagation Model | ++-----------+---------------------------------------+-------------------------------------------------------------------------+----------------------------------------------------+ +| **HF** | [Legacy Software](https://its.ntia.gov/software/high-frequency/high-frequency-propagation-models/) | High Frequency Propagation Models | ++-----------+---------------------------------------+-------------------------------------------------------------------------+----------------------------------------------------+ +| **IF77** | [Legacy Software](https://its.ntia.gov/software/if-77-electromagnetic-wave-propagation-model-gierhart-johnson/) | The IF-77 Electromagnetic Wave Propagation Model | ++-----------+---------------------------------------+-------------------------------------------------------------------------+----------------------------------------------------+ +| **ITM** | [Repo](https://github.com/NTIA/ITM) | Docs | Irregular Terrain Model | ++-----------+---------------------------------------+-------------------------------------------------------------------------+----------------------------------------------------+ +| **LFMF** | [Repo](https://github.com/NTIA/LFMF) | [Docs](models/LFMF/) | Low Frequency / Medium Frequency Propagation Model | ++-----------+---------------------------------------+-------------------------------------------------------------------------+----------------------------------------------------+ +| **MPM** | [Legacy Software](https://its.ntia.gov/software/millimeter-wave-propagation-model-mpm/) | Millimeter-wave Propagation Model | ++-----------+---------------------------------------+-------------------------------------------------------------------------+----------------------------------------------------+ +: U.S. propagation models available in the ITS Propagation Library {tbl-colwidths="[15,20,10,55]"} ### ITU-R Recommendations @@ -43,10 +53,10 @@ The P.528 model has a public code repository, but documentation is not yet avail in the meantime. ::: -+-----------:+:-------------------------------------:+:------------------------------:+:------------------------------------------------------------+ -| **P.528** | [Repo](https://github.com/NTIA/P528) | Docs | A propagation prediction method for aeronautical mobile and | -| | | | radionavigation services using the VHF, UHF, and SHF bands | -+------------+---------------------------------------+--------------------------------+-------------------------------------------------------------+ -| **P.2108** | [Repo](https://github.com/NTIA/p2108) | [Docs](models/P2108/index.qmd) | Prediction of clutter loss | -+------------+---------------------------------------+--------------------------------+-------------------------------------------------------------+ ++-----------:+:-------------------------------------:+:---------------------:+:------------------------------------------------------------+ +| **P.528** | [Repo](https://github.com/NTIA/P528) | Docs | A propagation prediction method for aeronautical mobile and | +| | | | radionavigation services using the VHF, UHF, and SHF bands | ++------------+---------------------------------------+-----------------------+-------------------------------------------------------------+ +| **P.2108** | [Repo](https://github.com/NTIA/p2108) | [Docs](models/P2108/) | Prediction of clutter loss | ++------------+---------------------------------------+-----------------------+-------------------------------------------------------------+ : ITU-R Recommendations implemented in the ITS Propagation Library {tbl-colwidths="[15,10,10,65]"} From a814718c05e170609b78058103783add09bb3801 Mon Sep 17 00:00:00 2001 From: Anthony Romaniello <66272872+aromanielloNTIA@users.noreply.github.com> Date: Mon, 2 Dec 2024 21:25:22 -0500 Subject: [PATCH 09/21] Update .gitignore --- .gitignore | 1 + 1 file changed, 1 insertion(+) diff --git a/.gitignore b/.gitignore index 997d493..6e30b19 100644 --- a/.gitignore +++ b/.gitignore @@ -7,3 +7,4 @@ models/P528 **/index_files/ **/*_files /env/ +.vscode From 4c0198e7fc78d06b4688d5885a4a87d2ded188dc Mon Sep 17 00:00:00 2001 From: Anthony Romaniello <66272872+aromanielloNTIA@users.noreply.github.com> Date: Mon, 2 Dec 2024 21:25:40 -0500 Subject: [PATCH 10/21] Fix typo --- models/P2108/index.qmd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/models/P2108/index.qmd b/models/P2108/index.qmd index 4357c40..36ed840 100644 --- a/models/P2108/index.qmd +++ b/models/P2108/index.qmd @@ -52,7 +52,7 @@ This table also provides the integer values mapped to each clutter type in the e The terrestrial statistical model is described in @p2108-1 [Section 3.2]. The model can be applied for urban and suburban environments provided terminal heights are well below the clutter height. The correction produced by this model can be applied at one terminal, or, if the path length is at least 1 km, at both terminals. -This model calculates an additional loss, $L_{ctt}$, which can be added to the transmission loss or basic transmission loss. As this is a statistical model, the term $L_{ctt}$ is the clutter loss not exceeded for $p$ percent of locations for a terrestial path of length $d$. If the transmission loss or basic transmission loss has been calculated using a model that inherently accounts for clutter over the entire path then this model should not be applied. +This model calculates an additional loss, $L_{ctt}$, which can be added to the transmission loss or basic transmission loss. As this is a statistical model, the term $L_{ctt}$ is the clutter loss not exceeded for $p$ percent of locations for a terrestrial path of length $d$. If the transmission loss or basic transmission loss has been calculated using a model that inherently accounts for clutter over the entire path then this model should not be applied. | Variable | Type | Units | Limits | Description | |----------|--------|-------|----------------------|---------------| From 6c0e48d7e0d01fb87a1e987c817338f3384239ee Mon Sep 17 00:00:00 2001 From: Anthony Romaniello <66272872+aromanielloNTIA@users.noreply.github.com> Date: Tue, 3 Dec 2024 14:06:46 -0500 Subject: [PATCH 11/21] Add P2108 MATLAB documentation And lots of reusable documentation components --- images/matlab/add-ons-menu.png | Bin 0 -> 14830 bytes images/matlab/add-to-matlab-menu.PNG | Bin 0 -> 6235 bytes images/matlab/install-online.png | Bin 0 -> 6026 bytes images/matlab/manage-add-ons-context-menu.png | Bin 0 -> 45306 bytes images/matlab/manage-add-ons-menu.png | Bin 0 -> 14627 bytes includes/matlab/_documentation.qmd | 3 + includes/matlab/_examples.qmd | 13 ++++ includes/matlab/_getting_started.qmd | 31 ++++++++ models/P2108/matlab.qmd | 72 +++++++++++++++--- 9 files changed, 108 insertions(+), 11 deletions(-) create mode 100644 images/matlab/add-ons-menu.png create mode 100644 images/matlab/add-to-matlab-menu.PNG create mode 100644 images/matlab/install-online.png create mode 100644 images/matlab/manage-add-ons-context-menu.png create mode 100644 images/matlab/manage-add-ons-menu.png create mode 100644 includes/matlab/_documentation.qmd create mode 100644 includes/matlab/_examples.qmd create mode 100644 includes/matlab/_getting_started.qmd diff --git a/images/matlab/add-ons-menu.png b/images/matlab/add-ons-menu.png new file mode 100644 index 0000000000000000000000000000000000000000..09f2867b5e41813401e3ee30031da84fb07fde7c GIT binary patch literal 14830 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 literal 0 HcmV?d00001 diff --git a/images/matlab/add-to-matlab-menu.PNG b/images/matlab/add-to-matlab-menu.PNG new file mode 100644 index 0000000000000000000000000000000000000000..73b487f26ba3a132e98bd057fe42910c78eb2bab GIT binary patch literal 6235 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 literal 0 HcmV?d00001 diff --git a/images/matlab/install-online.png b/images/matlab/install-online.png new file mode 100644 index 0000000000000000000000000000000000000000..3a7a52ee2980914e655df9c8b45a9038eb18ac5c GIT binary patch literal 6026 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 literal 0 HcmV?d00001 diff --git a/images/matlab/manage-add-ons-context-menu.png b/images/matlab/manage-add-ons-context-menu.png new file mode 100644 index 0000000000000000000000000000000000000000..0ffd33bd4089f85f1afc219d9b0b54a39ef19185 GIT binary patch literal 45306 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¥-w6lwYgKtnZ;q*;oGCkv!eCEvz$rZ1qao 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∋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 literal 0 HcmV?d00001 diff --git a/images/matlab/manage-add-ons-menu.png b/images/matlab/manage-add-ons-menu.png new file mode 100644 index 0000000000000000000000000000000000000000..c5499a1315be0ccdd3a5a1a583f7cb139a926be4 GIT binary patch literal 14627 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

kt4!)2akk?3slqWRC4h!rnhGE%_=tgjHzTsn zt$)pLmWEM0E?h!a1- zA{#rcNJ33c#cJ?z{|tO9{%MR$7FYDKN5h%I$(gL|JtST~c#z{_laWYeAn!TK-^O&VHM3KSSiQ8S>MlQdoE zPqGui;6MEI4JGGUJ9TOJYQ`${^F|CPQWZMw=IXf3auinm(rH#d;V`*(?n!G2MRX kb@$!m|HIgUuQ7A5ni%U|%uN2f$%rN^rS!F0!Z_&v0Q|DpMgRZ+ literal 0 HcmV?d00001 diff --git a/includes/matlab/_documentation.qmd b/includes/matlab/_documentation.qmd new file mode 100644 index 0000000..7104aef --- /dev/null +++ b/includes/matlab/_documentation.qmd @@ -0,0 +1,3 @@ +## Documentation + +All functions and/or objects provided by this MATLAB Toolbox contain built-in help documentation. This means that you can find details about inputs, outputs, and usage syntax right from the MATLAB Command Window. For example: diff --git a/includes/matlab/_examples.qmd b/includes/matlab/_examples.qmd new file mode 100644 index 0000000..caff953 --- /dev/null +++ b/includes/matlab/_examples.qmd @@ -0,0 +1,13 @@ +## Examples + +The code examples provided here are also included in the toolbox itself, as MATLAB Live Scripts. To access these, view the toolbox "Getting Started" guide as follows. + +1. Once installed, view the toolbox in the **Add-Ons > Manage Add-Ons** menu as shown in @fig-matlab-manage-add-ons-menu-2. + + ![](/images/matlab/manage-add-ons-menu.png){#fig-matlab-manage-add-ons-menu-2 fig-alt="A screenshot showing the MATLAB 'Manage Add-Ons' menu option" width=300 fig-align="left"} + +1. Find the installed toolbox in the list, and click the **⋮** icon and select **View Getting Started Guide** as shown in @fig-matlab-manage-add-ons-context-menu. + + ![](/images/matlab/manage-add-ons-context-menu.png){#fig-matlab-manage-add-ons-context-menu fig-alt="A screenshot showing the context menu for an installed toolbox in the MATLAB 'Manage Add-Ons' menu" width=300 fig-align="left"} + +1. Under the **Examples** heading, links are provided for Live Script example programs which demonstrate usage of the toolbox in an interactive way. The same code examples are additionally provided below. \ No newline at end of file diff --git a/includes/matlab/_getting_started.qmd b/includes/matlab/_getting_started.qmd new file mode 100644 index 0000000..978625d --- /dev/null +++ b/includes/matlab/_getting_started.qmd @@ -0,0 +1,31 @@ +There are two easy ways to install the toolbox: [from a browser](#installing-from-a-browser) or [from within MATLAB](#installing-from-within-matlab). + +### Installation from a Browser + +1. Open this package's page on the File Exchange using the link provided [above](#getting-started). + +1. In the upper-right, click **Download > Toolbox** as shown in @fig-matlab-install-online. A file with a `.mltbx` extension will download. + + ![](/images/matlab/install-online.png){#fig-matlab-install-online fig-alt="Screenshot showing the 'Download Toolbox' option on the MathWorks File Exchange website" width=250 fig-align="left"} + +1. Optionally, move the downloaded file into your project directory. + +1. Within MATLAB, navigate to the `.mltbx` file and double-click it. + +### Installation from Within MATLAB + +1. Open MATLAB and select **Add-Ons > Get Add-Ons** in the toolbar, as shown in @fig-matlab-add-ons-menu. The Add-On Explorer window will open. + + ![](/images/matlab/add-ons-menu.png){#fig-matlab-add-ons-menu fig-alt="A screenshot showing the MATLAB 'Get Add-Ons' menu option" width=300 fig-align="left"} + +1. Search for this package by its name. + +1. In the upper-right, click **Add > Add to MATLAB** as shown in @fig-matlab-add-to-matlab-menu. + + ![](/images/matlab/add-to-matlab-menu.png){#fig-matlab-add-to-matlab-menu fig-alt="A screenshot showing the 'Add to MATLAB' option for a toolbox within the Add-On Explorer" width=200 fig-align="left"} + +### Uninstallation + +Regardless of how you installed the toolbox, you can uninstall it at any time from the **Add-Ons > Manage Add-Ons** menu. This is available in the MATLAB toolbar as shown in @fig-matlab-manage-add-ons-menu. + +![](/images/matlab/manage-add-ons-menu.png){#fig-matlab-manage-add-ons-menu fig-alt="A screenshot showing the MATLAB 'Manage Add-Ons' menu option" width=300 fig-align="left"} \ No newline at end of file diff --git a/models/P2108/matlab.qmd b/models/P2108/matlab.qmd index f11e9ad..b40cbe4 100644 --- a/models/P2108/matlab.qmd +++ b/models/P2108/matlab.qmd @@ -2,26 +2,76 @@ title: "Recommendation ITU-R P.2108 – MATLAB" --- -{{< include /includes/_under_construction.qmd >}} +This page details the installation and usage of the MATLAB® Toolbox version of the PropLib implementation of Recommendation ITU-R P.2108. + +{{< include /includes/_link_to_model_home.qmd >}} ## Getting Started -{{< include /includes/_package_install_not_ready.qmd >}} +This MATLAB® Toolbox is distributed on [MathWorks® File Exchange](#TODO). + +{{< include /includes/matlab/_getting_started.qmd >}} + +{{< include /includes/matlab/_documentation.qmd >}} + +```matlab +help ITS.ITU.PSeries.P2108.AeronauticalStatisticalModel + +% Prints detailed usage information! +``` + +{{< include /includes/matlab/_examples.qmd >}} + +### Height Gain Terminal Correction Model + +This example shows multiple equivalent ways to specify the clutter type input. + +```matlab +import ITS.ITU.PSeries.P2108.* + +% Define inputs +f__ghz = 1; % Frequency, in GHz +h__meter = 1.5; % Antenna height, in meters +w_s__meter = 27; % Street width, in meters +R__meter = 20; % Representative clutter height, in meters +clutter_type = 6; % Clutter type enum value +clutter_type = ClutterType.DENSE_URBAN; +clutter_type = "DENSE_URBAN"; + +% Call the model +A_h__db = HeightGainTerminalCorrectionModel(f__ghz, h__meter, w_s__meter, R__meter, clutter_type); + +% A_h__db is approximately 25.5 dB +``` + +### Terrestrial Statistical Model -## Documentation +```matlab +import ITS.ITU.PSeries.P2108.* -{{< include /includes/_under_construction.qmd >}} +% Define inputs +f__ghz = 3; % Frequency, in GHz +d__km = 0.5; % Path distance, in km +p = 50; % Percentage of locations, in % -# Examples +% Call the model +L_ctt__db = TerrestrialStatisticalModel(f__ghz, d__km, p); -## Height Gain Terminal Correction Model +% L_ctt__db is approximately 26.6 dB +``` -{{< include /includes/_under_construction.qmd >}} +### Aeronautical Statistical Model -## Terrestrial Statistical Model +```matlab +import ITS.ITU.PSeries.P2108.* -{{< include /includes/_under_construction.qmd >}} +% Define inputs +f__ghz = 15; % Frequency, in GHz +theta__deg = 10; % Elevation angle, in degrees +p = 50; % Percentage of locations, in % -## Aeronautical Statistical Model +% Call the model +L_ces__db = AeronauticalStatisticalModel(f__ghz, theta__deg, p); -{{< include /includes/_under_construction.qmd >}} \ No newline at end of file +% L_ces__db is approximately 14.3 dB +``` \ No newline at end of file From 7ae46c9fcef255c52fedbed95603f766e2a2ec24 Mon Sep 17 00:00:00 2001 From: Anthony Romaniello <66272872+aromanielloNTIA@users.noreply.github.com> Date: Tue, 3 Dec 2024 14:07:18 -0500 Subject: [PATCH 12/21] Refactor language-specific includes and update P2108 pages --- includes/_pypi_distribution.qmd | 5 ----- .../_documentation.qmd} | 0 .../_documentation.qmd} | 0 includes/python/_getting_started.qmd | 12 ++++++++++++ includes/python/_uninstallation.qmd | 4 ++++ models/P2108/cpp.qmd | 4 ++-- models/P2108/dotnet.qmd | 4 +++- models/P2108/python.qmd | 18 ++++++++++++++---- 8 files changed, 35 insertions(+), 12 deletions(-) delete mode 100644 includes/_pypi_distribution.qmd rename includes/{_cpp_documentation_block.qmd => cpp/_documentation.qmd} (100%) rename includes/{_py_documentation_block.qmd => python/_documentation.qmd} (100%) create mode 100644 includes/python/_getting_started.qmd create mode 100644 includes/python/_uninstallation.qmd diff --git a/includes/_pypi_distribution.qmd b/includes/_pypi_distribution.qmd deleted file mode 100644 index f7bc48c..0000000 --- a/includes/_pypi_distribution.qmd +++ /dev/null @@ -1,5 +0,0 @@ -This Python package is distributed through the -[Python Package Index (PyPI)](https://pypi.org/). All ITS PropLib Python -packages required a [currently-supported](https://devguide.python.org/versions/) -version of Python. Run the following command to install the package, and any required dependencies, into your Python environment: - diff --git a/includes/_cpp_documentation_block.qmd b/includes/cpp/_documentation.qmd similarity index 100% rename from includes/_cpp_documentation_block.qmd rename to includes/cpp/_documentation.qmd diff --git a/includes/_py_documentation_block.qmd b/includes/python/_documentation.qmd similarity index 100% rename from includes/_py_documentation_block.qmd rename to includes/python/_documentation.qmd diff --git a/includes/python/_getting_started.qmd b/includes/python/_getting_started.qmd new file mode 100644 index 0000000..3a095cf --- /dev/null +++ b/includes/python/_getting_started.qmd @@ -0,0 +1,12 @@ +## Getting Started + +All ITS PropLib Python packages require a +[currently-supported](https://devguide.python.org/versions/) +version of Python. You may choose to use a tool such as +[pyenv](https://github.com/pyenv/pyenv) or +[conda](https://docs.conda.io/projects/conda/en/latest/user-guide/install/index.html) +to manage multiple Python versions on your machine. Additionally, +you may choose to set up a virtual environment for your project, +using conda or a tool such as [`venv`](https://docs.python.org/3/library/venv.html). +Installation instructions assume that you have a supported version of Python installed, +and that you're working from the desired Python environment. \ No newline at end of file diff --git a/includes/python/_uninstallation.qmd b/includes/python/_uninstallation.qmd new file mode 100644 index 0000000..e632bb8 --- /dev/null +++ b/includes/python/_uninstallation.qmd @@ -0,0 +1,4 @@ +### Uninstallation + +Uninstalling this Python package is also simple. Run the following +command in your Python environment. diff --git a/models/P2108/cpp.qmd b/models/P2108/cpp.qmd index 21d397d..f88ea7a 100644 --- a/models/P2108/cpp.qmd +++ b/models/P2108/cpp.qmd @@ -1,7 +1,7 @@ --- title: "Recommendation ITU-R P.2108 – C++" date: 2024-07-09 -date-modified: 2024-11-21 +date-modified: 2024-12-03 --- {{< include /includes/_under_construction.qmd >}} @@ -28,7 +28,7 @@ using namespace ITS::ITU::PSeries:P2108; // Optional: makes later code more con This library has no external C++ dependencies. -{{< include /includes/_cpp_documentation_block.qmd >}} +{{< include /includes/cpp/_documentation.qmd >}} [Docs](https://ntia.github.io/p2108){.btn .btn-secondary .btn role="button"} diff --git a/models/P2108/dotnet.qmd b/models/P2108/dotnet.qmd index 77d19d0..a7b1d66 100644 --- a/models/P2108/dotnet.qmd +++ b/models/P2108/dotnet.qmd @@ -2,7 +2,9 @@ title: "Recommendation ITU-R P.2108 – .NET" --- -{{< include /includes/_under_construction.qmd >}} +This page details the installation and usage of the .NET version of Recommendation ITU-R P.2108. + +{{< include /includes/_link_to_model_home.qmd >}} ## Getting Started diff --git a/models/P2108/python.qmd b/models/P2108/python.qmd index b9a8353..191f749 100644 --- a/models/P2108/python.qmd +++ b/models/P2108/python.qmd @@ -8,22 +8,32 @@ This page details the installation and usage of the Python version of the PropLi {{< include /includes/_link_to_model_home.qmd >}} -## Installation +{{< include /includes/python/_getting_started.qmd >}} -{{< include /includes/_pypi_distribution.qmd >}} +### Installation + +This Python package is distributed through the +[Python Package Index (PyPI)](https://pypi.org/project/proplib-p2108). +Run the following command to install the package, and any required dependencies, into your Python environment. ```default pip install proplib-p2108 ``` -The following code snippet shows how to import the package and check the installed version: +The following code snippet shows how to import the package and check the installed version. ```python from ITS.ITU.PSeries import P2108 print(P2108.__version__) ``` -{{< include /includes/_py_documentation_block.qmd >}} +{{< include /includes/python/_uninstallation.qmd >}} + +```default +pip uninstall proplib-p2108 +``` + +{{< include /includes/python/_documentation.qmd >}} ```python help(P2108.TerrestrialStatisticalModel) From 677619734a39f362cfb3cab46a8c9e7b13af8cd1 Mon Sep 17 00:00:00 2001 From: Anthony Romaniello <66272872+aromanielloNTIA@users.noreply.github.com> Date: Tue, 17 Dec 2024 19:29:48 -0500 Subject: [PATCH 13/21] Update NTIA logos --- _quarto.yml | 4 ++-- images/ntia-logo-300px.png | Bin 9085 -> 0 bytes images/ntia-logo-dark-bg-1200x630.png | Bin 0 -> 58383 bytes images/ntia-logo-dark-bg-1946px.png | Bin 0 -> 122030 bytes 4 files changed, 2 insertions(+), 2 deletions(-) delete mode 100644 images/ntia-logo-300px.png create mode 100644 images/ntia-logo-dark-bg-1200x630.png create mode 100644 images/ntia-logo-dark-bg-1946px.png diff --git a/_quarto.yml b/_quarto.yml index 041574b..049e2d0 100644 --- a/_quarto.yml +++ b/_quarto.yml @@ -9,7 +9,7 @@ website: description: | The NTIA/ITS Propagation Library: a versatile and robust set of tools for propagation modeling. Learn more on our wiki. - image: images/ntia-logo-300px.png + image: images/ntia-logo-dark-bg-1946px.png image-alt: National Telecommunications and Information Administration Logo image-width: 300 image-height: 300 @@ -19,7 +19,7 @@ website: description: | The NTIA/ITS Propagation Library: a versatile and robust set of tools for propagation modeling. Learn more on our wiki. - image: images/ntia-logo-300px.png + image: images/ntia-logo-dark-bg-1200x630.png image-alt: National Telecommunications and Information Administration Logo image-width: 300 image-height: 300 diff --git a/images/ntia-logo-300px.png b/images/ntia-logo-300px.png deleted file mode 100644 index 4e228594ba78ce7ee60900d6bdb1c6b5dafa38c1..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 9085 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

-Xf{i16< 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 literal 0 HcmV?d00001 From f2ed7bbc82af2d3ffca74c2f050e107527847a6d Mon Sep 17 00:00:00 2001 From: Anthony Romaniello <66272872+aromanielloNTIA@users.noreply.github.com> Date: Wed, 18 Dec 2024 09:53:19 -0500 Subject: [PATCH 14/21] Add command-line driver page --- includes/_getting_started.qmd | 1 + includes/driver/_general_usage.qmd | 9 ++ includes/driver/_intro.qmd | 4 + models/P2108/driver.qmd | 158 +++++++++++++++++++++++++++++ 4 files changed, 172 insertions(+) create mode 100644 includes/driver/_general_usage.qmd create mode 100644 includes/driver/_intro.qmd create mode 100644 models/P2108/driver.qmd diff --git a/includes/_getting_started.qmd b/includes/_getting_started.qmd index 243ee91..6ec57e1 100644 --- a/includes/_getting_started.qmd +++ b/includes/_getting_started.qmd @@ -2,6 +2,7 @@ This page documents the inputs, outputs, and primary functions of this software in a language-agnostic way. Language-specific documentation is additionally provided for this library. The pages linked below include installation instructions as well as usage examples for each supported language. +[Command-Line Driver](driver.qmd){.btn .btn-secondary role="button"} [C++](cpp.qmd){.btn .btn-secondary role="button"} [.NET](dotnet.qmd){.btn .btn-secondary role="button"} [MATLAB](matlab.qmd){.btn .btn-secondary role="button"} diff --git a/includes/driver/_general_usage.qmd b/includes/driver/_general_usage.qmd new file mode 100644 index 0000000..77da4ce --- /dev/null +++ b/includes/driver/_general_usage.qmd @@ -0,0 +1,9 @@ +# General Usage + +## Input Files + +Inputs to the command-line driver are specified in an ASCII text file using the common `key,value` format. Each line holds a single `key,value` combination, with the `key` representing the model input variable name and the `value` representing its value. Refer to the [examples](#examples) below to see the specific keys required for this model's inputs. Note that key names are not case-sensitive. + +## Output Files + +After parsing the inputs and running the software, the command-line driver will generate an output report file containing the results. This file contains a record of the input parameters along with the model outputs and human-readable supporting details. Refer to the [examples](#examples) below to see the expected format of output files generated by this model. \ No newline at end of file diff --git a/includes/driver/_intro.qmd b/includes/driver/_intro.qmd new file mode 100644 index 0000000..11be660 --- /dev/null +++ b/includes/driver/_intro.qmd @@ -0,0 +1,4 @@ +Each model in the Propagation Library is distributed with an accompanying command-line driver program. +This program allows the user to run the model from the command line on Windows, macOS, or Linux. +The model inputs and outputs are handled using simple text files. No programming experience is required to +use the command-line driver. \ No newline at end of file diff --git a/models/P2108/driver.qmd b/models/P2108/driver.qmd new file mode 100644 index 0000000..35a9388 --- /dev/null +++ b/models/P2108/driver.qmd @@ -0,0 +1,158 @@ +--- +title: "Recommendation ITU-R P.2108 – Command-Line Driver" +date: 2024-12-17 +date-modified: 2024-12-17 +--- + +This page details the usage of the cross-platform command-line driver version of Recommendation ITU-R P.2108. + +{{< include /includes/driver/_intro.qmd >}} + +{{< include /includes/_link_to_model_home.qmd >}} + +{{< include /includes/driver/_general_usage.qmd >}} + +# Command-Line Arguments + +Executing the command-line driver requires specifying input arguments, defined in @tbl-p2108-driver-input-args below. + + +| Flag | Type | Required | Description | +|----------|--------|----------|--------------------------------------------------------------| +| `-i` | string | true | File specifying model input parameters in `key,value` format | +| `-model` | string | true | Which model to run, one of `HGTCM`, `TSM`, or `ASM` | +| `-o` | string | true | Filename where output results should be written | +: Arguments for the Recommendation ITU-R P.2108 command-line driver {#tbl-p2108-driver-input-args} + +Additional arguments are available to print help text and version information without running any model. +When using these options, none of the arguments from @tbl-p2108-driver-input-args are required. +The additional arguments are defined in @tbl-p2108-driver-additional-args + +| Flag | Description | +|------|--------------------------------------------------------| +| `-h` | Display help text | +| `-v` | Display version information for the library and driver | +: Additional arguments for the Recommendation ITU-R P.2108 command-line driver {#tbl-p2108-driver-additional-args} + +# Examples + +## Height Gain Terminal Correction Model + +The Height Gain Terminal Correction Model can be run by providing the `-model HGTCM` flag on the command line. +For example: + +```cmd +# Windows +P2108Driver.exe -i input.txt -model HGTCM -o output.txt + +# Linux & macOS +./P2108Driver -i input.txt -model HGTCM -o output.txt +``` + +A corresponding pair of input and output files for the Height Gain Terminal Correction Model are provided below. + +```{.default filename="Input File Contents"} +f__ghz,1.5 +h__meter,2 +w_s__meter,27 +R__meter,15 +clutter_type,4 +``` + +```{.default filename="Output File Contents"} +Model P2108 +Model Variant Height Gain Terminal Correction Model +Library Version v1.0 +Driver Version v1.0.0 +Date Generated Thu Oct 31 17:31:08 2024 +Input Arguments -i .\i_hgtcm.txt -model HGTCM -o .\o_hgtcm.txt + +Inputs +f__ghz 1.5 (gigahertz) +h__meter 2 (meters) +w_s__meter 27 (meters) +r__meter 15 (meters) +clutter_type 4 [Urban clutter type] + +Results +Return Code 0 [P2108 Status: Successful execution] +Clutter loss 24.5 (dB) +``` + +## Terrestrial Statistical Model + +The Terrestrial Statistical Model can be run by providing the `-model TSM` flag on the command line. +For example: + +```cmd +# Windows +P2108Driver.exe -i input.txt -model TSM -o output.txt + +# Linux & macOS +./P2108Driver -i input.txt -model TSM -o output.txt +``` + +A corresponding pair of input and output files for the Terrestrial Statistical Model are provided below. + +```{.default filename="Input File Contents"} +f__ghz,26.6 +d__km,15.8 +p,45 +``` + +```{.default filename="Output File Contents"} +Model P2108 +Model Variant Terrestrial Statistical Model +Library Version v1.0 +Driver Version v1.0.0 +Date Generated Thu Oct 31 17:30:55 2024 +Input Arguments -i .\i_tsm.txt -model TSM -o .\o_tsm.txt + +Inputs +f__ghz 26.6 (gigahertz) +d__km 15.8 (kilometers) +p 45 (%) + +Results +Return Code 0 [P2108 Status: Successful execution] +Clutter loss 32.5 (dB) +``` + +## Aeronautical Statistical Model + +The Aeronautical Statistical Model can be run by providing the `-model ASM` flag on the command line. +For example: + +```cmd +# Windows +P2108Driver.exe -i input.txt -model ASM -o output.txt + +# Linux & macOS +./P2108Driver -i input.txt -model ASM -o output.txt +``` + +A corresponding pair of input and output files for the Aeronautical Statistical Model are provided below. + +```{.default filename="Input File Contents"} +f__ghz,10 +theta__deg,10.5 +p,45 +``` + +```{.default filename="Output File Contents"} +Model P2108 +Model Variant Aeronautical Statistical Model +Library Version v1.0 +Driver Version v1.0.0 +Date Generated Thu Oct 31 17:30:41 2024 +Input Arguments -i .\i_asm.txt -model ASM -o .\o_asm.txt + +Inputs +f__ghz 10 (gigahertz) +theta__deg 10.5 (degrees) +p 45 (%) + +Results +Return Code 0 [P2108 Status: Successful execution] +Clutter loss 12.4 (dB) +``` \ No newline at end of file From 33d9aa4fc6cf472cfd069c9a7dd17611e2f9d8c8 Mon Sep 17 00:00:00 2001 From: Anthony Romaniello <66272872+aromanielloNTIA@users.noreply.github.com> Date: Wed, 18 Dec 2024 09:53:37 -0500 Subject: [PATCH 15/21] P2108 C++ updates --- models/P2108/cpp.qmd | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/models/P2108/cpp.qmd b/models/P2108/cpp.qmd index f88ea7a..93229e4 100644 --- a/models/P2108/cpp.qmd +++ b/models/P2108/cpp.qmd @@ -4,8 +4,6 @@ date: 2024-07-09 date-modified: 2024-12-03 --- -{{< include /includes/_under_construction.qmd >}} - This page details the installation and usage of the C++ version of the PropLib implementation of Recommendation ITU-R P.2108. {{< include /includes/_link_to_model_home.qmd >}} @@ -14,9 +12,9 @@ This page details the installation and usage of the C++ version of the PropLib i {{< include /includes/_package_install_not_ready.qmd >}} -To use the C++ library in your code, you'll need to download the dynamic library (`.dll` on Windows, `.dylib` on macOS, or `.so` on Linux) and the header file. These are distributed for each platform as part of the [GitHub Releases](https://github.com/NTIA/p2108/releases/) starting with v1.0. Prior to v1.0, support was only provided for Windows platforms. +To use the C++ library in your code, you'll need to download the shared library (`.dll` on Windows, `.dylib` on macOS, or `.so` on Linux) and the header file. These are distributed for each platform as part of the [GitHub Releases](https://github.com/NTIA/p2108/releases/) starting with v1.0. Prior to v1.0, support was only provided for Windows platforms. -To use the dynamic library in your project, you'll need to link against it. The details for this process differ depending on your compiler and/or IDE, but generally you will need to somehow provide the path to the files you downloaded from the GitHub release. +To use the shared library in your project, you'll need to link against it. The details for this process differ depending on your compiler and/or IDE, but generally you will need to somehow provide the path to the files you downloaded from the GitHub release. Once you've linked the dynamic library to your project, all you need to do is include the appropriate header file and, optionally, use its namespace: From 658ac912c9dcd0e69e46e1f459bc1c7fb5fe9240 Mon Sep 17 00:00:00 2001 From: Anthony Romaniello <66272872+aromanielloNTIA@users.noreply.github.com> Date: Fri, 10 Jan 2025 16:40:07 -0500 Subject: [PATCH 16/21] Update driver intro section --- .../driver/{_intro.qmd => _intro_and_installation.qmd} | 7 ++++++- models/P2108/driver.qmd | 4 +--- 2 files changed, 7 insertions(+), 4 deletions(-) rename includes/driver/{_intro.qmd => _intro_and_installation.qmd} (75%) diff --git a/includes/driver/_intro.qmd b/includes/driver/_intro_and_installation.qmd similarity index 75% rename from includes/driver/_intro.qmd rename to includes/driver/_intro_and_installation.qmd index 11be660..dcd584e 100644 --- a/includes/driver/_intro.qmd +++ b/includes/driver/_intro_and_installation.qmd @@ -1,4 +1,9 @@ Each model in the Propagation Library is distributed with an accompanying command-line driver program. This program allows the user to run the model from the command line on Windows, macOS, or Linux. The model inputs and outputs are handled using simple text files. No programming experience is required to -use the command-line driver. \ No newline at end of file +use the command-line driver. + +{{< include /includes/_link_to_model_home.qmd >}} + +# Installation + diff --git a/models/P2108/driver.qmd b/models/P2108/driver.qmd index 35a9388..149672c 100644 --- a/models/P2108/driver.qmd +++ b/models/P2108/driver.qmd @@ -6,9 +6,7 @@ date-modified: 2024-12-17 This page details the usage of the cross-platform command-line driver version of Recommendation ITU-R P.2108. -{{< include /includes/driver/_intro.qmd >}} - -{{< include /includes/_link_to_model_home.qmd >}} +{{< include /includes/driver/_intro_and_installation.qmd >}} {{< include /includes/driver/_general_usage.qmd >}} From 55f2fb9a2b2282b2d77fe7e76337638196c4d740 Mon Sep 17 00:00:00 2001 From: Anthony Romaniello <66272872+aromanielloNTIA@users.noreply.github.com> Date: Fri, 10 Jan 2025 16:48:55 -0500 Subject: [PATCH 17/21] Add LFMF driver documentation page --- models/LFMF/driver.qmd | 170 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 170 insertions(+) create mode 100644 models/LFMF/driver.qmd diff --git a/models/LFMF/driver.qmd b/models/LFMF/driver.qmd new file mode 100644 index 0000000..b4c1783 --- /dev/null +++ b/models/LFMF/driver.qmd @@ -0,0 +1,170 @@ +--- +title: "Low Frequency / Medium Frequency Propagation Model – Command-Line Driver" +date: 2025-01-10 +date-modified: 2025-01-10 +--- + +This page details the usage of the cross-platform command-line driver version of the Low Frequency / Medium Frequency (LF/MF) Propagation Model. + +{{< include /includes/driver/_intro_and_installation.qmd >}} + +{{< include /includes/driver/_general_usage.qmd >}} + +# Command-Line Arguments + +Executing the command-line driver requires specifying input arguments, defined in @tbl-lfmf-driver-input-args below. + + +| Flag | Type | Required | Description | +|----------|--------|----------|--------------------------------------------------------------| +| `-i` | string | true | File specifying model input parameters in `key,value` format | +| `-o` | string | true | Filename where output results should be written | +: Arguments for the Recommendation ITU-R P.2108 command-line driver {#tbl-lfmf-driver-input-args} + +Additional arguments are available to print help text and version information without running any model. +When using these options, none of the arguments from @tbl-lfmf-driver-input-args are required. +The additional arguments are defined in @tbl-lfmf-driver-additional-args + +| Flag | Description | +|------|--------------------------------------------------------| +| `-h` | Display help text | +| `-v` | Display version information for the library and driver | +: Additional arguments for the LF/MF command-line driver {#tbl-lfmf-driver-additional-args} + +# Examples + +The LF/MF Propagation Model can be run by simply providing the input and output files on the command line. +For example: + +```cmd +# Windows (64-bit) +LFMFDriver-1.1.0-Windows-x64.exe -i input.txt -o output.txt + +# macOS +./LFMFDriver-1.1.0-Darwin-universal -i input.txt -o output.txt + +# Linux +./LFMFDriver-1.1.0-Linux-x86_64 -i input.txt -o output.txt +``` + +Three example sets of input/output file pairs are provided below. + +## Example 1 + +```{.default filename="Input File Contents"} +h_tx__meter,0 +h_rx__meter,0 +f__mhz,0.01 +P_tx__watt,1000 +N_s,301 +d__km,1000 +epsilon,15 +sigma,0.005 +pol,0 +``` + +```{.default filename="Output File Contents"} +Model LFMF +Library Version v1.1 +Driver Version v1.1.0 +Date Generated Mon Nov 18 13:56:29 2024 +Input Arguments -i i_lfmf_01.txt -o o_lfmf_01.txt + +Inputs: +h_tx__meter 0 [meter] +h_rx__meter 0 [meter] +f__mhz 0.01 [MHz] +p_tx__watt 1000 [Watts] +n_s 301 [N-Units] +d__km 1000 [km] +epsilon 15 +sigma 0.005 +pol 0 [0 = Horizontal, 1 = Vertical] + +Results: +Return Code 0 [LFMF v1.0 Status: Successful execution] +Basic transmission loss 184.49 [dB] +Electric field strength -82.50 [dB(uV/m)] +Received power -114.93 [dB] +Solution method 1 [0 = Flat earth with curve correction, 1 = Residue series] +``` + +## Example 2 + +```{.default filename="Input File Contents"} +h_tx__meter,5.5 +h_rx__meter,1.5 +f__mhz,10 +P_tx__watt,500 +N_s,315 +d__km,15 +epsilon,15 +sigma,0.005 +pol,0 +``` + +```{.default filename="Output File Contents"} +Model LFMF +Library Version v1.1 +Driver Version v1.1.0 +Date Generated Mon Nov 18 13:56:51 2024 +Input Arguments -i i_lfmf_02.txt -o o_lfmf_02.txt + +Inputs: +h_tx__meter 5.5 [meter] +h_rx__meter 1.5 [meter] +f__mhz 10 [MHz] +p_tx__watt 500 [Watts] +n_s 315 [N-Units] +d__km 15 [km] +epsilon 15 +sigma 0.005 +pol 0 [0 = Horizontal, 1 = Vertical] + +Results: +Return Code 0 [LFMF v1.1 Status: Successful execution] +Basic transmission loss 151.33 [dB] +Electric field strength 7.65 [dB(uV/m)] +Received power -84.78 [dB] +Solution method 0 [0 = Flat earth with curve correction, 1 = Residue series] +``` + +## Example 3 + +```{.default filename="Input File Contents"} +h_tx__meter,1 +h_rx__meter,1 +f__mhz,0.45 +P_tx__watt,1000 +N_s,315 +d__km,3000 +epsilon,15 +sigma,0.005 +pol,1 +``` + +```{.default filename="Output File Contents"} +Model LFMF +Library Version v1.1 +Driver Version v1.1.0 +Date Generated Mon Nov 18 13:56:57 2024 +Input Arguments -i i_lfmf_03.txt -o o_lfmf_03.txt + +Inputs: +h_tx__meter 1 [meter] +h_rx__meter 1 [meter] +f__mhz 0.45 [MHz] +p_tx__watt 1000 [Watts] +n_s 315 [N-Units] +d__km 3000 [km] +epsilon 15 +sigma 0.005 +pol 1 [0 = Horizontal, 1 = Vertical] + +Results: +Return Code 0 [LFMF v1.1 Status: Successful execution] +Basic transmission loss 264.33 [dB] +Electric field strength -129.28 [dB(uV/m)] +Received power -194.77 [dB] +Solution method 1 [0 = Flat earth with curve correction, 1 = Residue series] +``` From 50b50f57adf6fb47fd52fbb21e0b2a118a97e3fc Mon Sep 17 00:00:00 2001 From: Anthony Romaniello <66272872+aromanielloNTIA@users.noreply.github.com> Date: Fri, 10 Jan 2025 16:51:49 -0500 Subject: [PATCH 18/21] Update driver executable file names --- models/P2108/driver.qmd | 33 +++++++++++++++++++++------------ 1 file changed, 21 insertions(+), 12 deletions(-) diff --git a/models/P2108/driver.qmd b/models/P2108/driver.qmd index 149672c..15d6103 100644 --- a/models/P2108/driver.qmd +++ b/models/P2108/driver.qmd @@ -40,11 +40,14 @@ The Height Gain Terminal Correction Model can be run by providing the `-model HG For example: ```cmd -# Windows -P2108Driver.exe -i input.txt -model HGTCM -o output.txt +# Windows (64-bit) +P2108Driver-1.0.0-Windows-x64.exe -i input.txt -model HGTCM -o output.txt -# Linux & macOS -./P2108Driver -i input.txt -model HGTCM -o output.txt +# macOS +./P2108Driver-1.0.0-Darwin-universal -i input.txt -model HGTCM -o output.txt + +# Linux +./P2108Driver-1.0.0-Linux-x86_64 -i input.txt -model HGTCM -o output.txt ``` A corresponding pair of input and output files for the Height Gain Terminal Correction Model are provided below. @@ -83,11 +86,14 @@ The Terrestrial Statistical Model can be run by providing the `-model TSM` flag For example: ```cmd -# Windows -P2108Driver.exe -i input.txt -model TSM -o output.txt +# Windows (64-bit) +P2108Driver-1.0.0-Windows-x64.exe -i input.txt -model TSM -o output.txt + +# macOS +./P2108Driver-1.0.0-Darwin-universal -i input.txt -model TSM -o output.txt -# Linux & macOS -./P2108Driver -i input.txt -model TSM -o output.txt +# Linux +./P2108Driver-1.0.0-Linux-x86_64 -i input.txt -model TSM -o output.txt ``` A corresponding pair of input and output files for the Terrestrial Statistical Model are provided below. @@ -122,11 +128,14 @@ The Aeronautical Statistical Model can be run by providing the `-model ASM` flag For example: ```cmd -# Windows -P2108Driver.exe -i input.txt -model ASM -o output.txt +# Windows (64-bit) +P2108Driver-1.0.0-Windows-x64.exe -i input.txt -model ASM -o output.txt + +# macOS +./P2108Driver-1.0.0-Darwin-universal -i input.txt -model ASM -o output.txt -# Linux & macOS -./P2108Driver -i input.txt -model ASM -o output.txt +# Linux +./P2108Driver-1.0.0-Linux-x86_64 -i input.txt -model ASM -o output.txt ``` A corresponding pair of input and output files for the Aeronautical Statistical Model are provided below. From f64f6e46305de5f325bcd404ffba6bd1071b3e60 Mon Sep 17 00:00:00 2001 From: Anthony Romaniello <66272872+aromanielloNTIA@users.noreply.github.com> Date: Fri, 24 Jan 2025 16:01:31 -0500 Subject: [PATCH 19/21] Update P2108 and LFMF pages --- models/LFMF/cpp.qmd | 10 +++--- models/LFMF/driver.qmd | 8 ++--- models/LFMF/index.qmd | 24 ++++++++++---- models/LFMF/matlab.qmd | 62 +++++++++++++++++++++++++++++++++++ models/LFMF/python.qmd | 72 +++++++++++++++++++++++++++++++++++++++++ models/P2108/dotnet.qmd | 31 ------------------ models/P2108/driver.qmd | 32 +++++++++--------- models/P2108/matlab.qmd | 12 +++++-- models/P2108/python.qmd | 8 ++++- references.bib | 28 +++++++++++++--- 10 files changed, 218 insertions(+), 69 deletions(-) create mode 100644 models/LFMF/matlab.qmd create mode 100644 models/LFMF/python.qmd delete mode 100644 models/P2108/dotnet.qmd diff --git a/models/LFMF/cpp.qmd b/models/LFMF/cpp.qmd index 8c8954d..a473b84 100644 --- a/models/LFMF/cpp.qmd +++ b/models/LFMF/cpp.qmd @@ -1,10 +1,10 @@ --- title: "Low Frequency / Medium Frequency Propagation Model – C++" date: 2024-12-02 -date-modified: 2024-12-02 +date-modified: 2025-01-24 --- -This page details the installation and usage of the C++ version of the Low Frequency / Medium Frequency (LF/MF) Propagation Model, developed by NTIA/ITS. +This page details the installation and usage of the C++ version of the PropLib implementation of the Low Frequency / Medium Frequency (LF/MF) propagation model. {{< include /includes/_link_to_model_home.qmd >}} @@ -12,7 +12,7 @@ This page details the installation and usage of the C++ version of the Low Frequ {{< include /includes/_package_install_not_ready.qmd >}} -To use the C++ library in your code, you'll need to download the shared library (`.dll` on Windows, `.dylib` on macOS, or `.so` on Linux) and the header file. These are distributed for each supported platform as part of the [GitHub Releases](https://github.com/NTIA/LFMF/releases/) starting with v2.0. Prior to v2.0, support was only provided for Windows platforms. +To use the C++ library in your code, you'll need to download the shared library (`.dll` on Windows, `.dylib` on macOS, or `.so` on Linux) and the header file. These are distributed for each supported platform as part of the [GitHub Releases](https://github.com/NTIA/LFMF/releases/) starting with v1.1. Prior to v1.1, support was only provided for Windows platforms. To use the shared library in your project, you'll need to link against it. The details for this process differ depending on your compiler and/or IDE, but generally you will need to somehow provide the path to the files you downloaded from the GitHub release. @@ -26,7 +26,7 @@ using namespace ITS::Propagation::LFMF; // Optional: makes later code more conc This library has no external C++ dependencies. -{{< include /includes/_cpp_documentation_block.qmd >}} +{{< include /includes/cpp/_documentation.qmd >}} [Docs](https://ntia.github.io/lfmf){.btn .btn-secondary .btn role="button"} @@ -57,7 +57,7 @@ int main() { LFMF::ReturnCode rtn; // Return code // Call the model - rtn = LFMF::LFMF(h_tx__meter, h_rx__meter, f__mhz, P_tx__watt, N_s, d__km, epsilon, sigma, pol, &result); + rtn = LFMF::LFMF_CPP(h_tx__meter, h_rx__meter, f__mhz, P_tx__watt, N_s, d__km, epsilon, sigma, pol, &result); // rtn is 0 (SUCCESS) // result.A_btl__db is 184.49 dB diff --git a/models/LFMF/driver.qmd b/models/LFMF/driver.qmd index b4c1783..02798b2 100644 --- a/models/LFMF/driver.qmd +++ b/models/LFMF/driver.qmd @@ -1,10 +1,10 @@ --- -title: "Low Frequency / Medium Frequency Propagation Model – Command-Line Driver" +title: "Low Frequency / Medium Frequency Propagation Model – Command-Line Driver" date: 2025-01-10 date-modified: 2025-01-10 --- -This page details the usage of the cross-platform command-line driver version of the Low Frequency / Medium Frequency (LF/MF) Propagation Model. +This page details the usage of the cross-platform command-line driver version of the Low Frequency / Medium Frequency (LF/MF) propagation model. {{< include /includes/driver/_intro_and_installation.qmd >}} @@ -19,7 +19,7 @@ Executing the command-line driver requires specifying input arguments, defined i |----------|--------|----------|--------------------------------------------------------------| | `-i` | string | true | File specifying model input parameters in `key,value` format | | `-o` | string | true | Filename where output results should be written | -: Arguments for the Recommendation ITU-R P.2108 command-line driver {#tbl-lfmf-driver-input-args} +: Arguments for the LF/MF command-line driver {#tbl-lfmf-driver-input-args} Additional arguments are available to print help text and version information without running any model. When using these options, none of the arguments from @tbl-lfmf-driver-input-args are required. @@ -33,7 +33,7 @@ The additional arguments are defined in @tbl-lfmf-driver-additional-args # Examples -The LF/MF Propagation Model can be run by simply providing the input and output files on the command line. +The LF/MF model can be run by simply providing the input and output files on the command line. For example: ```cmd diff --git a/models/LFMF/index.qmd b/models/LFMF/index.qmd index 14c7691..2bcf526 100644 --- a/models/LFMF/index.qmd +++ b/models/LFMF/index.qmd @@ -1,16 +1,29 @@ --- title: "Low Frequency / Medium Frequency Propagation Model" date: 2024-12-02 -date-modified: 2024-12-02 +date-modified: 2025-01-25 --- -The Low Frequency / Medium Frequency (LF/MF) Propagation Model predicts basic transmission loss in the frequency range 0.01 - 30 MHz for propagation paths over a smooth Earth and antenna heights less than 50 meters. [@ntia-tr-99-368] +The Low Frequency / Medium Frequency (LF/MF) propagation model predicts basic transmission loss in the frequency range 0.01 - 30 MHz for propagation paths over a smooth Earth and antenna heights less than 50 meters. [@ntia-tr-99-368] {{< include /includes/_getting_started.qmd >}} -## Model Usage +## Model Background -TODO Background information about how and when to use this model. +This model fundamentally predicts basic transmission loss using @eq-lfmf-btl. + +$$ +\begin{align} +\text{BTL (dB)} =&\ 10\log(P_{tx} \cdot G_{tx}) + 10\log(\eta_0) + 20\log(f) \\ +&-20\log(E_{gw}) - 20\log(c) +\end{align} +$$ {#eq-lfmf-btl} + +In @eq-lfmf-btl, $P_{tx}$ and $f$ are model inputs, where $P_{tx}$ is in watts and $f$ has been converted to hertz. The constants $\eta_0$ and $c$ are the impedance of free space and the speed of light in vacuum, respectively. $G_{tx}$ is the linear conversion of the transmitter antenna gain, which is set to 4.77 dBi. This factor is included to remove the impacts of an equivalent scaling factor which is used when calculating the ground wave. Finally, $E_{gw}$ is the internally-computed ground wave field strength, in volts per meter. + +This smooth earth model implements two different methods to compute the ground wave, depending on the path distance and frequency. A cutoff distance for the use of the flat earth approximation is determined using the method described in the ITU-R Ground Wave Propagation handbook [@itu-r-sg3-ground-wave-handbook, pp. 7]. Up to this distance, a flat-Earth approximation with curvature correction is used [@ntia-tr-99-368, pp. 13; @wait-radiation-from-vertical-antenna]. Beyond this distance, the ground wave strength is calculated by evaluating the full-wave theory integral using the residue series. + +The model additionally outputs the predicted electric field strength of the ground wave, the received power, and the method used to calculate the ground wave. ## Functions @@ -18,7 +31,6 @@ TODO Background information about how and when to use this model. This model's functionality is exposed through a single function. The inputs for this function are shown below in @tbl-lfmf-inputs. The model outputs are provided in @tbl-lfmf-outputs. -TODO refine this table and add more detail | Variable | Type | Units | Limits | Description | |---------------|--------|--------|-------------------------|------------------------------| @@ -41,7 +53,7 @@ The `pol` input must be one of the two valid supported polarization types, as de | 1 | Vertical | : Allowed polarization values for the LF/MF model {#tbl-lfmf-polarizations} -TODO add more information +The LF/MF model produces an output which contains four values. These results indicate the predicted basic transmission loss, the ground wave electric field strength, the received power and the solution method used to calculate the ground wave. | Variable | Type | Units | Description | |-------------|---------|-------------------|-------------------------| diff --git a/models/LFMF/matlab.qmd b/models/LFMF/matlab.qmd new file mode 100644 index 0000000..5b89b1a --- /dev/null +++ b/models/LFMF/matlab.qmd @@ -0,0 +1,62 @@ +--- +title: "Low Frequency / Medium Frequency Propagation Model – MATLAB" +date: 2025-01-24 +date-modified: 2025-01-25 +--- + +This page details the installation and usage of the MATLAB® version of the PropLib implementation of the Low Frequency / Medium Frequency (LF/MF) propagation model. + +{{< include /includes/_under_construction.qmd >}} + +{{< include /includes/_link_to_model_home.qmd >}} + +