Metadata-Version: 1.1
Name: kalibrate
Version: 2.1.0
Summary: A python wrapper for kalibrate-rtl
Home-page: https://github.com/ashmastaflash/kal-wrapper
Author: Ash Wilson
Author-email: ash.d.wilson@gmail.com
License: BSD
Description: =========
        kalibrate
        =========
        
        Python wrapper for Kalibrate.
        -----------------------------
        
        .. image:: https://travis-ci.org/ashmastaflash/kal-wrapper.svg?branch=master
            :target: https://travis-ci.org/ashmastaflash/kal-wrapper
        
        .. image:: https://api.codeclimate.com/v1/badges/8a598e64e8ed55a21645/maintainability
           :target: https://codeclimate.com/github/ashmastaflash/kal-wrapper/maintainability
           :alt: Maintainability
        
        .. image:: https://api.codeclimate.com/v1/badges/8a598e64e8ed55a21645/test_coverage
           :target: https://codeclimate.com/github/ashmastaflash/kal-wrapper/test_coverage
           :alt: Test Coverage
        
        
        Returns scan data in structured format.
        
        
        Example usage:
        
        ::
        
          import kalibrate
          scanner = kalibrate.Kal("/usr/local/bin/kal")
          # Scan a band
          band_results = scanner.scan_band("GSM850", gain=45)
          # Scan a channel
          channel_results = scanner.scan_channel("232", gain=45)
        
        
        And what you get for scanning a band:
        
        ::
        
          [{'band': 'GSM-850',
          'base_freq': 869200000.0,
          'channel': '128',
          'channel_detect_threshold': '259970.196875',
          'device': '0: Generic RTL2832U OEM',
          'final_freq': '869175933',
          'gain': '45.0',
          'mod_freq': 24067.0,
          'modifier': '-',
          'power': '299318.41',
          'sample_rate': '270833.002142'},
          {'band': 'GSM-850',
          'base_freq': 890000000.0,
          'channel': '232',
          'channel_detect_threshold': '259970.196875',
          'device': '0: Generic RTL2832U OEM',
          'final_freq': '890022169',
          'gain': '45.0',
          'mod_freq': 22169.0,
          'modifier': '+',
          'power': '780303.16',
          'sample_rate': '270833.002142'}]
        
        
        Channel scan results:
        
        ::
        
          {'device': '0: Generic RTL2832U OEM',
          'channel': '232',
          'band': 'GSM-850',
          'gain': '45.0',
          'sample_rate': '270833.002142',
          'frequency': '890MHz',
          'average_absolute_error': '-33.445',
          'measurements':
          ['29921.37',
          '29952.37',
          '29900.71'],
          'raw_scan_result': 'ORIGINAL FULL SCAN BODY GOES HERE'}
        
        
        Note: Kalibrate's output for this feature starts numbering with offset 1. This
        abstraction starts at 0, because that's how Python numbers things. So you'll
        find your measurement for the first offset labeled "offset 1:" in the original
        output, and in channel_scan["measurements"][0] in the output of the channel
        scan. This format is new in version 2 of this library, and is a breaking change
        from the way v1 presented this information.
        
        v2.1.0
        ------
        
        Changes
        ~~~~~~~
        - Adding build, coverage, and quality badges to README.rst. [Ash Wilson]
        - Python 3.6, 3.7 compatibility. [Ash Wilson]
        
        Other
        ~~~~~
        - Create pyup.io config file. [pyup-bot]
        
        
        v2.0 (2018-10-17)
        -----------------
        
        Changes
        ~~~~~~~
        - Better-structured format for channel scans. [Ash Wilson]
        - Adding CodeClimate config. [Ash Wilson]
        
          Removing Python2.6 because this ain't the antique roadshow.
        
          Closes #3
        - Add "avg_absolute_error" to scan_channel() output. [Ash Wilson]
        
        
        v1.1.1 (2017-01-06)
        -------------------
        - Update travis. [ashmastaflash]
        
        
        
Keywords: kalibrate kal rtl-sdr sdr
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Security
Classifier: License :: OSI Approved :: BSD License
