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.

• pip (https://pip.pypa.io/en/stable/installing/)

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.

• lxml (http://lxml.de/installation.html)

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.

• numpy (http://www.scipy.org/scipylib/download.html)

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.

• pyshp (https://github.com/GeospatialPython/pyshp)

This Python library can be installed with pip. It provides libraries for handling SHP geospatial files in Python.

• ftputil (http://ftputil.sschwarzer.net/trac/wiki/Documentation)

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.

• mock (https://pypi.python.org/pypi/mock)

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.