wiki:Manual/Library

You are here: Manual / Library

TracNav


Library

1. Overview

SEAMCAT library is a useful tool for creating and storing various typical elements of interference scenario and later easily re-using them when creating complex scenarios. The SEAMCAT library allows creating such data templates for the following scenario elements:

  • Antennas: Useful in particular for storing antenna profiles with complex radiation patterns.
  • Spectrum emission masks: Useful to store existing spectrum emission masks from standards or from ECC Report or CEPT report.
  • Receiver blocking masks: Useful to store existing spectrum receiver blocking masks from standards or from ECC Report or CEPT report.
  • Receivers: Useful to store detailed description of typical receivers, with complex receiver characteristics, etc..
  • Transmitters: Useful to store detailed description of typical transmitters, with complex emission plots, etc..
  • CDMA Link level data - contains a set of pre-defined tables and allows user to create its own tables of CDMA link level data, i.e. the data describing required signal-to-noise criteria for CDMA link as a function of some environmental parameters (e.g. the so called 'link geometry', speed of mobile terminals, handover state).
  • Networks (CDMA/OFDMA): Useful to store detailed description of typical cellular network.
  • Propagation model plugins: Useful to store your own or shared propagation models;
  • Post-processing plugins - which may be used for performing additional, user-defined computations with data produced in each SEAMCAT snapshot.

2. How to import / export a library element in/from a workspace ?

Modification of existing (default) library elements as well as creation of new elements can be managed through the relevant options of Library menu. Once stored, the library elements may be then easily inserted into scenario by selecting a particular library element in the Definition field for relevant transceiver in either victim or interfering links, as illustrated in the following picture:


Once a library element is imported () into a given scenario, there remains no relational link between the original library element and its copy pasted into the workspace scenario. That is, if at some later stage you want to modify or suppress the library element, this by itself will not produce any change in replicas of that library element previously pasted into existing workspaces. Upon clicking the import button, you will have to chose from a drop down list the element that you want as shown below:

You can create a library from the workspace and export () it to your library environment. SEAMCAT will automatically place the new element in the right library category.

3. How to edit a library element ?

When you open a library from the workspace menu you will have the following interface (below is the antenna interface)


Example of the antenna interface

All the library elements follow the same command feature . They are available for you to:

  • Create a new antenna, click on
  • Delete an existing antenna, select it in the list and click on
  • Duplicate an existing antenna, select it in the list and click on . Reference of the new antenna is derived from the reference of the selected one by incrementing the integer suffix of that reference, if any, or adding character '1' to the end of the original name.
  • Reload the pre-defined libraries (it will delete any entries that you may have made), click ;
  • Get on-line help click

When adding a new elements, you need to enter the name (unique identifier), description of the elements as well as its technical parameters.

Note: Tooltip are available on the button to remember their meaning .

4. How to share my libraries with others ?

Once you have created a broad library of various elements, it might be especially useful to exchange this data, e.g. share with other members of the team working on studies of similar radiocommunications systems.

To share the created library, an export file may be created by using command Export Library in menu section File. When selecting this menu option, you will be offered a choice of defining the file name and the entire current library and a library copy will be unloaded to that file.

The SEAMCAT library exchange files are saved using XML format and with unique file extension .sli (for Seamcat Library). Such library export file may then be distributed within the group of users and may be uploaded by any users via command Import Library on the File menu.

In case of collision of imported and existing library element names (e.g, there will always be a collision between the DEFAULT library elements saved in an exchange file and those existing in target SEAMCAT copy), you will be given a choice of either overwriting the existing elements, or importing colliding elements with different names.

Note on importing old SEAMCAT-2 libraries: SEAMCAT-2 was saving libraries in files with extension .txt. These old libraries could be imported into SEAMCAT-3 as well, by using the command Legacy Import, then sub-command Import Legacy Library in the File menu.

Attachments