Last modified 4 years ago
You are here: Manual / Annex / Messages
TracNav
SEAMCAT Manual Table of contents
- About this Wiki
- About the STG (SEAMCAT Technical Group)
- About the source code
- Frequently Asked Questions
- How to register on TracTool?
- Tutorial videos
- Known Issues
- Disclaimer
Introduction
Main structural elements of SEAMCAT
Data elements
- SEAMCAT Data types
- Function entry dialog window
- Emissions mask dialog window
- Random distribution dialog window
- Antenna pattern dialog window
- Signal display window
- How to generate a truncated distribution?
Simulation workspace
Creating SEAMCAT scenario
- Simulation scenario and its programming
- Victim link dialog window
- Interfering link dialog window
- CDMA system dialog window
- Sharing and importing scenarios
CDMA module
- CDMA Module Overview
- CDMA Simulation Engine (CDMAE)
- CDMA system dialog window
- CDMA Link level data
- CDMA simulation algorithm
- CDMA input parameters
- CDMA output results
OFDMA module
Cognitive Radio System module
Performing a simulation
- Simulation control settings
- Running a simulation (event generation)
- Calculating probability of interference
Simulation results...
- Producing simulation report
- Logging options and Remote server
- Saving results in .csv format
Library of scenario elements
- SEAMCAT Library
- Antenna elements
- Receiver elements
- Transmitter elements
- CDMA Link level data
- Propagation model plugins
- Post processing plugins
- Setting up environment for programming plugins
- Exporting and importing a library
Special functions
Detailed algorithms
- Calculation of wanted signal (dRSS)
- Calculation of unwanted and blocking signals (iRSS)
- Calculation of overloading (iRSS)
- Calculation of intermodulation signal (iRSS)
- Interference calculation (non-CDMA/non-OFDMA)
- CDMA simulation algorithm
- OFDMA simulation algorithm
Elementary calculations
- Relative location of VR and IT (Simulation Radius)
- Relative location of transceivers within a link
- Calculation of azimuths and elevations (within a link)
- Calculation of azimuths and elevations (IT-VR path)
- Calculation of antenna gains
- Calculation of VR blocking attenuation
- Calculation of the coverage radius of a transmitter
- Calculation of IT power control gain
- Calculation of IT (unwanted) emissions
Propagation models
- Guide to propagation models in SEAMCAT
- How to test propagation model?
- ITU-R P.1546 model
- Extended Hata and Hata-SRD models
- Spherical diffraction model
- Free Space Loss model
- User-defined model (Propagation plug-in)
- JTG5-6 propagation plug-in
- SE42 propagation plug-in
- Longley Rice propagation plug-in
- Winner propagation plug-in
- IEEE 802.11 Model C (modified) plug-in
Reference annexes
- Setting antenna height, pointing azimuth and elevation
- Setting path azimuths in links
- Setting blocking attenuation of victim receiver
- Scenario consistency check
- Error and warning messages
Example Scenarios
Release to be tested by STG
Error and warning messages
Two types of error/warning messages could be encountered in SEAMCAT:
- Simulation messages are produced during event generation and calculation, they are also logged to the simulation log file which is located in Log subdirectory of the Seamcat installation directory. When in batch mode they are only logged to the log file;
- Interactive messages are displayed outside the event generation process.
Two levels of messages could be distinguished:
- Error messages that notify the user that the current action (validation, simulation) can not be performed;
- Warning messages inform the user of some oddity or possible inconsistency, which do not prevent the current action/simulation to be performed.
The following error and warning messages can be encountered in SEAMCAT:
| Message | Context | Level | Description |
| ?? is not a floating point value | Interactive | Error | Occurs when validating a data window (random or function) where a field has been left empty. |
| Blocking response range does not match interfering transmitter frequency and victim receiver frequency ranges in link x | Simulation | Error | see Scenario consistency |
| C/I cannot be lower than C/N+I | Simulation | Warning | see Scenario consistency |
| Cannot modify this parameter | Interactive | Error | The batch parameter which cannot be edited : this corresponds to parameters which cannot be edited from the workspace tree view. |
| Cannot perform event generation : no interfering link is available | Simulation | Error | A scenario must contain at least one interfering link so that a simulation can be performed. |
| Cannot remove batch parameter. Check whether it is still not used in a batch | Simulation | Error | A batch parameter cannot be removed from a workspace if it is referred to by at least one batch. |
| Consistency check found errors, simulation aborted | Simulation | Error | Global message issued when the Scenario consistency found errors which prevent simulation to be performed. |
| Correlation threshold must be greater than 0 | Interactive | Error | Correlation threshold must be a positive value. |
| Database constraint violated at line l, Section = s Field = f Value = v, Please modify item in import file and retry import | Simulation | Error | Occurs when importing an item which already exist in SEAMCAT database. |
| Distribution must contain at least two points | Interactive | Error | A user-defined distribution has been defined with less than two points. |
| Distribution encompass negative values for parameter x link y | Simulation | Warning | A distribution spreading in the negative domain is used for a parameter such as antenna height. |
| dRSS and iRSS are correlated, results might be erroneous with this algorithm | Simulation | Warning | Quick and Complete 1 algorithm should not be used when dRSS and iRSS are found to be correlated. |
| Error at line x | Interactive | Error | Gives the line at which the error occrred while importing a library file. |
| Error occurred while reseting results | Interactive | Error | Results cannot be reseted because of an internal database error. |
| File imported with errors Please check log file f | Interactive | Error | Import is unsuccessful, log file detailing errors is located in the same directory as the imported file. |
| Function must contain at least two points (X,Y,Z) | Interactive | Error | A user-defined emission mask has been defined with less that two triplets (X, Y, Z) |
| Function must contain at least two points | Interactive | Error | A user-defined emission mask has been defined with less that two triplets (X, Y, Z) |
| Hata model not applicable above 3 GHz in x in link y | Simulation | Warning | see Scenario consistency |
| Hata model not applicable below 30 MHz in x in link y | Simulation | Warning | see Scenario consistency |
| Horizontal Pattern invalid | Interactive | Error | Occurs when attempting to load an horizontal pattern file where angles are not between 0 and 360. |
| Horizontal pattern must contain at least two points | Interactive | Error | An horizontal pattern has been defined with less than two points. |
| Import failed at line x | Interactive | Error | Occurs when attempting to import a corrupted scenario file. |
| Inapropriate distribution type (Constant) for parameter x in link y | Simulation | Warning | see Scenario consistency |
| Inapropriate distribution type (Uniform angle) for parameter x in link y | Simulation | Warning | see Scenario consistency |
| Inapropriate distribution type (Uniform polar) for parameter x in link y | Simulation | Warning | see Scenario consistency |
| Inconsistency between C/I, C/N+I and I/N thresholds | Simulation | Warning | see Scenario consistency |
| Inconsistency between C/I, C/N+I and N+I/N thresholds | Simulation | Warning | see Scenario consistency |
| Inconsistency between N+I/N and I/N thresholds | Simulation | Warning | see Scenario consistency |
| Inconsistency between number of interfering links and resulting signals | Simulation | Warning | see Scenario consistency |
| Initialization exception | Simulation | Error | Occurs when calculation of coverage and simulation radius fails (typically because zero divide operation) |
| Interference calculation failed | Interactive | Error | ICE internal error. |
| Interference probability calculation stopped. No result will be stored in database | Simulation | Warning | When the interference probability calculation is interrupted, no results are stored in the database. |
| Interference probability set to 1 since dRSS is always less than victim receiver sensitivity | Simulation | Warning | dRSS is always below sensitivity, hence the victim receiver is always jammed. |
| Intermodulation rejection range does not match interfering transmitter frequency and victim receiver frequency ranges in link x | Simulation | Error | see Scenario consistency |
| ITU-R P.1546 model not applicable above 3 GHz in link x | Simulation | Warning | see Scenario consistency |
| ITU-R P.1546 model not applicable below 30 MHz in link x | Simulation | Warning | see Scenario consistency |
| Minimum distance must be less than maximum distance (Noise limited network) | Interactive | Error | Coherence between min and max distance for calculation of coverage radius. |
| Minimum power must be less than Maximum | Interactive | Error | Coherence between min and max thresholds for translation mode. |
| No antenna available in technical library. Cannot initialize receiver | Interactive | Error | Library should contain at least one antenna to be able to create a receiver. |
| No antenna available in technical library. Cannot initialize transmitter | Interactive | Error | Library should contain at least one antenna to be able to create a transmitter. |
| No correlation results | Interactive | Warning | Correlation of signals has not been calculated (calculation has been stopped). |
| No density for constant signal | Interactive | Warning | Constant signals density is a dirac. |
| No Intermodulation signal is available for this scenario | Interactive | Warning | ICE : intermodulation rejection cannot be used as parameter of translation : only one link has been defined in the scenario and hence no intermodulation signals have been generated. |
| No link to delete | Interactive | Error | No more links in current workspace, hence cannot delete. |
| No receiver available in technical library. Cannot initialize interfering link | Interactive | Error | Library should contain at least one receiver to be able to create a link. |
| No receiver available in technical library. Cannot initialize victim link | Interactive | Error | Library should contain at least one receiver to be able to create a link. |
| No transmitter available in technical library. Cannot initialize victim link | Interactive | Error | Library should contain at least one transmitter to be able to create a link. |
| No transmitter available in technical library. Cannot initialize interfering link | Interactive | Error | Library should contain at least one transmitter to be able to create a link. |
| No values defined for this batch | Interactive | Error | User has started a batch which contains no simulation (batch values). |
| No workspace to delete | Interactive | Error | No more workspace in database so cannot delete. |
| Number of active transmitters can't be equal to 0 | Interactive | Error | Number of active transmitters must be strictly positive. |
| Number of exceptions equals number of generated events : no results have been stored | Simulation | Warning | Simulation has generated as many exceptions as events : storing results is useless. Revision of the scenario is required. |
| Number of generated events must be greater than DEE additional number of events | Simulation | Error | Additional number of samples must be small regards to the initial number of samples. |
| Previous version not installed | Interactive | Error | Upgrade function requires previous version of SEAMCAT to be installed. |
| Probability of transmission must be between 0 and 1 | Interactive | Error | Probability is constrained to be between 0 and 1. |
| Range is not multiple of the step in the discrete uniform distribution used for parameter x in link y | Simulation | Warning | see Scenario consistency |
| Significance level for distribution identification must be greater than 0 | Interactive | Error | Significance level for distribution identification must be positive. |
| Significance level for stability estimation must be greater than 0 | Interactive | Error | Significance level for distribution identification must be positive |
| Simulation results exist for this workspace | Interactive | Warning | Occurs when opening a workspace containing results. |
| Spherical diffraction model not applicable below 1 GHz in x in link y | Simulation | Warning | see Scenario consistency |
| Spherical Pattern invalid | Interactive | Error | Occurs when attempting to load an horizontal pattern file where angles are not between 0 and 180. |
| Spherical pattern must contain at least two points | Interactive | Error | An horizontal pattern has been defined with less than two points. |
| Syntax error detected at line x, offset y | Interactive | Error | Indicates at which position of the |
| This file requires a higher version of SEAMCAT | Simulation | Error | Occurs when attempting to import a file generated by a higher version of SEAMCAT. |
| This parameter is not editable in tree view | Simulation | Error | This parameter cannot be editable from the tree-view. |
| Time must be between 0 and 24 hours | Interactive | Error | Time parameter is constrained to be between 0 and 24 hours. |
| Translation mode is not available for one of following reasons: 1. Receiver blocking response mask is not constant, 2. Receiver intermodulation response mask is not constant, 3. Power distribution of interfering transmitter is not constant, 4. Unwanted emission floor mask is used | Interactive | Error | ICE translation mode requires the four assumptions to be true. |
| Unbounded distribution for parameter x in link y | Simulation | Warning | see Scenario consistency |
| Unbounded frequency distribution in link x | Simulation | Warning | see Scenario consistency |
| Unwanted emissions floor range does not match victim receiver frequency +/- receiver bandwidth in link x | Smulation | Error | see Scenario consistency |
| Unwanted emissions range does not match victim receiver frequency +/- receiver bandwidth in link x | Simulation | Error | see Scenario consistency |
| User model syntaxically incorrect | Interactive | Warning | Confirm correctness of the user defined propagation model |
| User-defined distribution doesn't include 0 and/or 1 value(s) for parameter x in link y | Simulation | Error | see Scenario consistency |
| Vertical Pattern invalid | Interactive | Error | Occurs when attempting to load an horizontal pattern file where angles are not between -90 and 90°. |
| Vertical pattern must contain at least two points | Interactive | Error | An horizontal pattern has been defined with less than two points. |
| You can't delete an interfering link because simulation results exist | Interactive | Error | Constraint : to maintain coherence between scenario and results, change of the scenario requires to delete the results. |
| You can't duplicate this link because simulation results exist | Interactive | Error | Constraint : to maintain coherence between scenario and results, change of the scenario requires to delete the results. |
| You must select at least one signal type | Interactive | Error | ICE translation mode requires one signal type to be selected |
