This repository contains code and data for testing the compliance of Spectrum Access System (SAS) software. The SAS is defined by the FCC in proceeding 12-354 as the system authorizing priority access and general access to the 3550-3700MHz Citizens Broadband Radio Service.
This repository contains procedures, documentation, and tests for such software, and for the devices authorized by it.
To contribute, please first read the CONTRIBUTING file in the repository for instructions.
The scripts in the SAS repository depend on local environment setup to run. Here are packages and software needed to correctly operate the scripts.
- Python 2.7 (https://www.python.org/download/releases/2.7/)
This is the Python runtime which interprets the scripts in the
src/ directory. It may already be running on many platforms, and
if it is not already installed, is widely available. Type the command
python --version to check the Python version installed on your
platform.
This is the Python package management system. If you have Python installed on
your system, it may already be available as well. The latest distributions of
Python come with pip pre-bundled so you may not need to retrieve
it separately. To check it's availability on your system run the command
pip --version.
- libgeos (http://trac.osgeo.org/geos/)
This binary library is needed to support Python shapely libraries.
It will likely need to be installed separately on your system. Platform-specific
instructions can be found at the above URL.
This binary library provides the mechanism to support Python XML libraries.
It will likely need to be installed separately, and you may need to configure
platform-specific C++ building capabilities to complete the installation. It
can typically be installed with pip.
- libgdal (https://pypi.python.org/pypi/GDAL/ and http://trac.osgeo.org/gdal/wiki/DownloadingGdalBinaries)
This binary library provides geospatial data library methods used to manipulate geographic datasets. It will likely need to be installed separately for your platform, and you may need to configure platform-specific C++ build capabilities to complete the installation. Source-based installation is an option. Once the libgdal package is installed, you will need to download and install the Python bindings for the library.
This library provides a variety of numerics methods and Python bindings to use them. It will likely need to be installed separately for your platform, and may be installed as part of the SciPy packages.
- shapely (https://pypi.python.org/pypi/Shapely)
This Python library can be installed with pip. It provides
libraries for processing geometrical objects and shapes in Python.
- pyJWT (https://pypi.python.org/pypi/PyJWT)
- cryptography (https://pypi.python.org/pypi/cryptography)
- pykml (https://pythonhosted.org/pykml/installation.html)
This Python library can be installed with pip. It provides
libraries for handling KML geospatial files in Python.
This Python library can be installed with pip. It provides
libraries for handling SHP geospatial files in Python.
This Python library can be installed with pip. It provides a
high-level interface for retrieving FTP files with Python.
- jsonschema (https://github.com/Julian/jsonschema)
This Python library can be installed with pip. It provides
JSON schema validation support.
- pyopenssl (https://github.com/pyca/pyopenssl)
This Python library can be installed with pip. It provides
support for the OpenSSL library for Python.
This Python library can be installed with pip. It provides
support for creating testing mocks.
- functools32 (https://pypi.python.org/pypi/functools32)
This Python library can be installed with pip. It provides
support for advanced functools such as OrderedDict and lru_cache memoization.
- psutil (https://github.com/giampaolo/psutil)
This Python library can be installed with pip. It provides
information on running processes and system (RAM,..).
- portpicker (https://pypi.org/project/portpicker)
This Python library can be installed with pip. It allows to
find unused network ports on a host.
For all these Python packages, a good way to test their installation is to
run the Python interpreter and then issue an import xyz command,
where xyz is the name of the package. Error-free import means
that the package is installed successfully.
- Security certificates, as described in
src/harness/testcases/testdata/certs/README.md
Some of the required data is provided in folder data/. Scripts used to retrieve or generate these data are in src/data/.
USGS NED Terrain and NLCD Land cover data are not provided as part of the data/ folder, but kept instead in a separate Git repository found at: https://github.com/Wireless-Innovation-Forum/SAS-Data
See the corresponding README.md for more details.