# 13 Library of scenario elements
# 13.1 Library overview
SEAMCAT library is a useful tool for creating and storing various elements that are part of a wireless system so that they can be re used at a later point of time. The SEAMCAT library contains the following elements:
- Systems and System Plugins (SP)
- Spectrum Emission Masks (SEM)
- Receiver Blocking Masks (RBM)
- Receivers
- Transmitters
- CDMA Link Level Data
- Antenna Gain Plugins (AGP)
- Coverage Radius Plugins (CRP)
- Propagation Model Plugins (PMP)
- Event Processing Plugins (EPP)
Note that technical library management functions are available regardless of whether a simulation workspace has been loaded or not. The library can be saved in a separate file too so that you can also share them.
[](https://wiki.cept.org/uploads/images/gallery/2026-06/ju1AsuOpUzAdGY2U-image.png)
**Figure 274: Overview of the SEAMCAT library elements**
# 13.2 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:
[](https://wiki.cept.org/uploads/images/gallery/2026-06/VsszPWqkhtQv8V6Q-image.png)
It is possible to save customised libraries on locally by “exporting” them. The libraries are saved with the extension ***“.sli”***. Any library item can be selected (Figure 277), and the path to the folder where these items will be saved can also be specified (Figure 278).
**Figure 278: Select where the library should be saved.**
Library items can be shared and uploaded into SEAMCAT by using the *“import”* button.
Once a library element is **imported** ([](https://wiki.cept.org/uploads/images/gallery/2026-06/MSG4PdLZbhu5s0Or-image.png)) into a given scenario, there remains no link between the original library element and its copy in the workspace. That is, if at some later stage a library element is modified or suppressed it will not produce any change in replicas of that library element previously pasted into existing workspaces. Upon clicking on the *import* button, you will have to chose from a drop down list the element that you want as shown below:
A library can be created from a workspace and **exported** ([](https://wiki.cept.org/uploads/images/gallery/2026-06/4yryM7mbT0M8Hb2a-image.png))to a local library folder. SEAMCAT will automatically place the new element in the right category of the library.
# 13.3 Edit and share library element
When opening a library item from the workspace menu, the following interface will appear (as an example, the antenna interface is shown in the figure below).
All the library elements follow the **same** command feature [](https://wiki.cept.org/uploads/images/gallery/2026-06/sWWkuFl4T7a3Bfik-image.png). They are available for you to allow:
- **Creating** a new antenna, click on [](https://wiki.cept.org/uploads/images/gallery/2026-06/kzjMvc13OCV2ld7J-image.png)
- **Deleting** an existing antenna, select it in the list and click on [](https://wiki.cept.org/uploads/images/gallery/2026-06/xN8mcTIf2BvXb3SI-image.png)
- **Duplicating** an existing antenna, select it in the list and click on [](https://wiki.cept.org/uploads/images/gallery/2026-06/Aco8SDY268YF986T-image.png). 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.
- **Reloading** the pre-defined libraries (it will delete any entries that you may have made), click [](https://wiki.cept.org/uploads/images/gallery/2026-06/dZBvhRkagEsRpzqV-image.png) ;
- Getting on-line **help by** clicking on [](https://wiki.cept.org/uploads/images/gallery/2026-06/CgBP9dxExalhdd5l-image.png)
When adding a new elements, enter the name (unique identifier), description of the elements as well as their technical parameters.
**Note:** Tooltips are available on the buttons to remember their meaning [](https://wiki.cept.org/uploads/images/gallery/2026-06/XZOBfgqCuGtIjELr-image.png)
Once a broad library of various elements are populated, it might be useful to exchange it with other team members working on studies involving similar wireless 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 with a unique file extension ***.sli*** (for Seamcat Library). Such library export file may then be distributed within a group of users and may be uploaded by any user via the command **Import Library** on the **File** menu.
In case of collision of an imported and an existing library element that have the same name (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), a choice will be given to either to overwrite the existing elements or to import new library items after renaming them.
# 13.4 Library elements
# 13.4.1 System elements
To create or modify a library element containing parameters of a particular system, i.e. generic, cellular network like CDMA or OFDMA, select the system library lements command from the **Library pull-down menu** or directly **CTRL+SHIFT+S**.
A list of existing pre-defined systems will be selectable as shown in Figure 282 for a generic system and Figure 283 for cellular systems (e.g. CDMA UL network).
When adding a new system, enter the name (unique identifier) and a description.
**Note:** It is also possible to create a system from the workspace and export it to a local library.
# 13.4.2 Spectrum emission mask elements
To create or modify a library element containing parameters of a particular spectrum mask, select the **Spectrum emission masks** command from the **Library pull-down menu** or directly with **CTRL+SHIFT+S**.
A list of existing pre-defined spectrum emission mask will be selectable as shown in the figure below. This is an example of a LTE UE (Table 6.6.3.1-2 of 3GPP TS 36.101) where the limit for the spurious emission domain (outside ± 12.5 MHz) applies to frequencies above 1000 MHz:
When adding a new spectrum emission mask, enter the name (unique identifier) and description of its technical parameters.
**Note 1:** It is possible to quickly scroll up and down and see the differences in the masks.
**Note 2:** It is possible to create a mask from the workspace and export it to your library environment
# 13.4.3 Receiver blocking mask elements
To create or modify a library element containing parameters of a particular blocking mask, select the **Receiver blocking masks** command from the **Library pull-down menu** or directly with **CTRL+SHIFT+B**.
A list of existing pre-defined receiver blocking mask will be selectable as shown in the figure below:
When adding a new receiver blocking mask, you need to enter the name (unique identifier) and description of its technical parameters .
**Note 1:** It is possible to quickly scroll up and down and see the differences in the blocking masks.
**Note 2:** It is possible to create a blocking mask from the workspace and export it to your library environment.
[](https://wiki.cept.org/uploads/images/gallery/2026-06/A5Vu7khfPJoLZRAO-image.png)
# 13.4.4 Receiver elements
To create or modify a library receiver element, select the **Receivers** command from the **Library pull-down menu** or directly with **CTRL+SHIFT+R**.
This activates the Receiver Library window which displays a list of existing receiver elements in the library. Please note that it is the same interface as in the workspace, so that it is easy to fill. If no receiver has been previously created , the list will contain only the DEFAULT receiver elements:
The parameters of receiver are grouped in 5 different panels:
- **Receiver identification**: to define receiver name (unique identifier), description;
- **Antenna pointing**: It contains all information relative to the antenna other than the radiation pattern (Please read here more about antenna azimuth/elevation settings);
- **Antenna patterns identification**: to define a specific antenna to be associated with that particular receiver. Note that is possible to select one of the existing antenna library elements or define completely new antenna parameters to be associated only with the given receiver;
- **Reception characteristics**: to define the basic receiver features, such as bandwidth, sensitivity, blocking (selectivity) function, etc.;
- **Interference criterion**: to define the required minimum C/I and/or other interference criterion, as appropriate.
**Note 1:** It is possible to scroll up and down and see the differences in the receivers.
**Note 2:** It is possible to create a receiver from the workspace and export it to your library environment
# 13.4.5 Transmitter elements
To create or modify a library transmitter element, select the **Transmitters** command from the **Library pull-down menu**or directly with **CTRL+SHIFT+T**.
This activates the Transmitter Library window which displays a list of existing transmitter elements in the library. Please note that it is the same interface as in the workspace so that it is easy to fill. If you no transmitter has been previously created the list will contain only the DEFAULT transmitter elements:
The parameters of transmitter are grouped in 4 different panels:
- **Transmitter identification**: to define name (unique identifier), description;
- **Antenna pointing**: It contains all information relative to the antenna other than the radiation pattern;
- **Antenna patterns identification**: to define a specific antenna to be associated with that particular receiver. Note that you can select one of the existing antenna library elements or define completely new antenna parameters to be associated only with the given receiver;
- **Emission characteristics**: to define the basic transmission features, such as power, spectrum emission mask function, etc..
**Note 1:** It is possible to quickly scroll up and down and see the differences in the transmitters.
**Note 2:** It is possible to create a transmitter from the workspace and export it to your library environment
**Figure 291: Example on how to import/export to/from the workspace/library for the transmitter elements**
# 13.4.6 CDMA Link level data
To create or modify CDMA Link level data set, select the **CDMA Link level data** command from the **Library pull-down menu** or directly **CTRL+SHIFT+L**. This activates the CDMA Link level data window which displays a list of existing CDMA Link level data:
Regarding the library sets of CDMA Link level data, the default sets distributed within SEAMCAT library are understood to be sufficient to cover typical CDMA systems expected to be deployed in Europe and their respective frequency bands. Any additional link level data may be defined to cover other types of CDMA systems. However, it is recommended that only users with advanced knowledge of CDMA systems develop the new CDMA Link level data for SEAMCAT simulations as several considerations should be kept in mind before creating new Link level data:
- - The SEAMCAT CDMA Link level data have different formats for uplink and downlink sections of CDMA link. In particular, the Link level data for **uplink** provides **Eb / No requirements**, whereas **downlink** data define the **Ec / Ior requirements**;
- Check carefully that the newly created CDMA link level data is appropriate for the SEAMCAT's CDMA simulation methodology for the respective section of the link (uplink/downlink).
**Figure 298: Example of the propagation model plugin library**
More detailed information on specific propagation models is available in ANNEX 17:
# 13.5.4 Event Processing Plugin
To create or modify a library element containing parameters of a particular event processing plugin, select the **event processing plugin** command from the **Library pull-down menu** or directly with **CTRL+SHIFT+E**. A list of available built-in event processing plugin is available in Figure 240.