From b439e2b7bda158837ad6da8253f8ba1b97d397ec Mon Sep 17 00:00:00 2001 From: Aijana Schumann Date: Thu, 3 Sep 2020 20:39:00 +0200 Subject: update readthedocs update helpserver and readthedocs Issue-ID: CCSDK-2667 Signed-off-by: Aijana Schumann Change-Id: I9c0d306e67ed0042bf19079b46566ecc43b20a19 --- docs/guides/onap-user/general.rst | 45 +++++++------ docs/guides/onap-user/linkCalculator.rst | 107 +++++++++++++++++++++++++++++++ docs/guides/onap-user/networkMap.rst | 87 +++++++++++++++++++++++++ docs/guides/onap-user/pnfInventory.rst | 28 ++++++-- 4 files changed, 238 insertions(+), 29 deletions(-) create mode 100644 docs/guides/onap-user/linkCalculator.rst create mode 100644 docs/guides/onap-user/networkMap.rst (limited to 'docs/guides/onap-user') diff --git a/docs/guides/onap-user/general.rst b/docs/guides/onap-user/general.rst index 85814d507..a63ba4d9f 100644 --- a/docs/guides/onap-user/general.rst +++ b/docs/guides/onap-user/general.rst @@ -34,26 +34,25 @@ Table filters The following filters are supported by all tables based on the data type of the column. -+------------+------------------+------------+ -| Data type | Possible Filter | Example | -+============+==================+============+ -| Text | Any characters | Test, | -| | or numbers, | Tes\ \*, | -| | matches exactly | \*\ t | -| | unless a \* is | | -| | used. The \* | | -| | acts as a | | -| | wildcard and can | | -| | be used for | | -| | contains, ends | | -| | with and begins | | -| | with queries. | | -+------------+------------------+------------+ -| Numeric | < or <= or > or | >5000, 20, | -| | >= or exact | <=82 | -| | number | | -+------------+------------------+------------+ -| Boolean | None (no filter | true, | -| | set), true or | false | -| | false | | -+------------+------------------+------------+ ++------------------+-------------------------------+------------------+ +| Data type | Possible Filter | Example | ++==================+===============================+==================+ +| Text | Any characters or numbers, | Test, | +| | matches exactly unless a \* | T\ *,*\ st, | +| | or a ? are used. Both special | Te?t, ?est | +| | characters act as wildcards, | | +| | which can be used for | | +| | contains, ends with and | | +| | begins with queries. The \* | | +| | matches any number of | | +| | characters whereas the ? | | +| | matches exactly one | | +| | character. Both wildcards can | | +| | be used in the same query. | | ++------------------+-------------------------------+------------------+ +| Numeric | < or <= or > or >= or exact | >5000, 20, <=82 | +| | number | | ++------------------+-------------------------------+------------------+ +| Boolean | None (no filter set), true or | true, false | +| | false | | ++------------------+-------------------------------+------------------+ diff --git a/docs/guides/onap-user/linkCalculator.rst b/docs/guides/onap-user/linkCalculator.rst new file mode 100644 index 000000000..4970b7bf9 --- /dev/null +++ b/docs/guides/onap-user/linkCalculator.rst @@ -0,0 +1,107 @@ +.. contents:: + :depth: 3 +.. + +Link Calculator +=============== + +The ‘Link calculator’ analyzes the microwave propagation measurements of +the wireless links. It can be accessed through the Network Map by +clicking on the ‘link calculation’ button available in microwave links. + +View +---- + +The app includes two view possibilities. If it is accessed via the menu, +the view provides a form table and a blank information table. The form +table offers inputs for latitude and longitude values of the two points +of a link. By entering this geographical information the data in the +information table gets updated. + +The information table contains the calculation inputs and outputs. If +the Link Calculator is accessed through the ‘calculate link’ button, +only this table with pre-filled geographical locations is shown. +Currently, input variables of the link calculation include Polarization, +Frequency, Rain Model, and Rainfall Rate. Outputs of the calculation are +Free Space Loss and Rain Loss. The results will be visible upon clicking +the ‘Calculate’ button at the bottom of the table. + +Average Mean Sea Level +~~~~~~~~~~~~~~~~~~~~~~ + +Denotes the ground elevation of the sites on each end. + +Antenna Height Above Ground +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Is the height at which the antenna is mounted from the ground. + +Distance +~~~~~~~~ + +The distance in the information table is auto-filled when the microwave +link is selected and the calculator is accessed through the ‘calculate +link’ button in the Network Map. If the points are entered manually, the +distance is calculated after clicking the ‘Calculate’ button. + +Polarization +~~~~~~~~~~~~ + +A selection of Vertical and Horizontal polarization is possible. + +Frequency +~~~~~~~~~ + +A selection of known and regulated microwave bands is possible. + +Rainfall Rate +~~~~~~~~~~~~~ + +Rainfall rate can be entered in the field, however if the local +information is not available, the digital map and rainfall values of +ITU-R P.837-7 [1]_ is used. The latitude grid is from -90 North degrees +to +90 North degrees and the longitude grid is from -180 degrees East to ++180 East. For this calculation, the pre-computed R_0.01 map is used. A +selection is possible through the Rain Model drop-down list. When the +ITU model is selected, the rainfall rate will be shown in the rainfall +rate field after clicking the ‘Calculate’ button. + +Calculations +------------ + +Wireless signal attenuation is calculated based on ITU Recommendations +for Propagation. At the moment these calculations include the free space +loss and rain loss. + +Free Space Loss +~~~~~~~~~~~~~~~ + +Calculates the Free Space Path Loss for a point-to-point non-terrestrial +link using the recommended formula in ITU-R P.525-4 [2]_. The output is +shown in dB hence the distance is attributed in the calculation. + +Rain Loss +~~~~~~~~~ + +Calculates the rain induced attenuation on microwave signal. The +calculation is based on the recommended formula in ITU-R P.838-3 [3]_, +taking into account the polarization of the signal, rainfall rate, and +distance. The manual calculation is also possible if ‘Specific Rain’ is +selected as rain model. After selecting the inputs, rain loss will be +calculated by clicking the ‘Calculate’ button. + +-------------- + +.. [1] + Radiocommunication Sector of International Telecommunication Union. + ITU-R P.837-7: Characteristics of precipitation for propagation + modelling 2017. + +.. [2] + Radiocommunication Sector of International Telecommunication Union. + ITU-R P.525-4: Calculation of free-space attenuation 2019. + +.. [3] + Radiocommunication Sector of International Telecommunication Union. + ITU-R P.838-3: Specific attenuation model for rain for use in + prediction methods 2005. diff --git a/docs/guides/onap-user/networkMap.rst b/docs/guides/onap-user/networkMap.rst new file mode 100644 index 000000000..fa08922cd --- /dev/null +++ b/docs/guides/onap-user/networkMap.rst @@ -0,0 +1,87 @@ +.. contents:: + :depth: 3 +.. + +Network Map +=========== + +The ‘Network Map’ visualizes a network by showing the location of a site +and its connections (links) to other sites in a geographical context. + +Views +----- + +The ‘Network Map’ consists of two side-by-side views: The map and the +details-panel. + +Map +~~~ + +The geographical map visualizes sites and links of a network. Sites are +usually displayed as blue circles and links are shown as lines +connecting sites. + +If a link or site is clicked, its information is presented in the +details panel. If more than one site or link is clicked, or if links or +sites are too close together to determine which element should be +selected, a selection popup appears to select one of the elements. + +The map offers statistics information to visualize the number of links +and sites in the currently shown map area. The statistics information +gets updated when the map stops moving. + +Additionally, the map offers a search field. The user can enter the name +of a site or link. If an element was found, the map will center on the +given element and its information is loaded by the details panel. + +If the zoom level is bigger than 11 and the loaded sites have a type of +high-rise building, datacenter, factory, or street-lamp, the blue +circles are swapped against icons, which visualizes the type of site. + +The swapping of icons can be activated or deactivated via a switch on +the left-hand site of the map. The switch only becomes visible, if the +zoom level is bigger than 9. + +The map supports zoom levels between 0 (furthest zoomed out, the entire +world is visible) and 18 (most detailed). + +Whenever the map stops moving, it updates the URL with its current +latitude, longitude, and zoom values. If the ‘Network Map’ application +is opened with those URL parameters present, it will display the given +area. That way, the map can be bookmarked or shared and will always +display the same result. + +Details +~~~~~~~ + +The details panel shows information specific to the selected element. + +Sites offer information about itself, such as name, address and owner, +and a short overview of its links and nodes data. The nodes are physical +network elements, comparable to the elements of the ‘connect’ +application, and offer an interface to other apps via buttons, such as +connect, configure, and fault. Currently, those buttons are disabled. By +clicking on a link, the given link is loaded into details. + +If a link of type ‘microwave’ is selected, the ‘calculate link’ button +is available, which opens the `Link +Calculator <../linkCalculator/README.md>`__ in a new tab or page. + +Just like the map, the details panel updates the URL if data is loaded. +Once again, the ‘Network Map’ application will try to load the element +specified in the URL, if one is present. + +Connection Error +---------------- + +If no tile or network data is available, an error popup is shown. + +Load Network- and Tile-Data +--------------------------- + +On startup of the sdnc-web container, a topology URL for the network +data and a tile URL for the tiles can be specified. + +A ready-to-use topology server offering pre-defined network data is +available here. There is no way to import generic network data as of +now. diff --git a/docs/guides/onap-user/pnfInventory.rst b/docs/guides/onap-user/pnfInventory.rst index 1acee6d80..36937838c 100644 --- a/docs/guides/onap-user/pnfInventory.rst +++ b/docs/guides/onap-user/pnfInventory.rst @@ -8,14 +8,31 @@ Inventory The application offers basic inventory management of devices supporting ONF-TR-512 and ietf-hardware. +Views +----- + +The inventory application offers two different ways to visualize +inventory data. + +Tableview +~~~~~~~~~ + The view displays the inventory data of the network element – for example, serial-numbers and part-numbers according to the containment of -the equipment. +the equipment – as a table. By right-clicking on an entry, the element +can be viewed in the treeview. + +Treeview +~~~~~~~~ + +The treeview visualizes relations between the inventory data of a +network element. To load all relations, a ’*’ can be entered in the +search-field. Inventory Export: ------------------ +^^^^^^^^^^^^^^^^^ -The '︙' button in the upper right corner of the table allows exporting +The ‘︙’ button in the upper right corner of the table allows exporting the inventory data as a CSV file. Only the currently viewed table data is exported. As the default @@ -27,10 +44,9 @@ The behavior of the export can vary based on different browsers: a) Some browsers allow you to save the file with the predefined name export.csv. In case your browser does not offer this function please - use the 'Save as...' option and define the filename with extension - csv. + use the ‘Save as…’ option and define the filename with extension csv. b) Some browsers save the file automatically with the alphanumeric name but without an extension. In such a case navigate to the downloaded file location and rename the file. The extension (csv) must be - appended to the name. The result should look like export\_file.csv. + appended to the name. The result should look like export_file.csv. -- cgit 1.2.3-korg