Metadata-Version: 2.1
Name: pybv
Version: 0.5.0
Summary: A lightweight I/O utility for the BrainVision data format.
Home-page: https://pybv.readthedocs.io
Maintainer: Stefan Appelhoff
Maintainer-email: stefan.appelhoff@mailbox.org
License: BSD (3-clause)
Download-URL: https://github.com/bids-standard/pybv
Project-URL: Documentation, https://pybv.readthedocs.io
Project-URL: Bug Reports, https://github.com/bids-standard/pybv/issues
Project-URL: Source, https://github.com/bids-standard/pybv
Description: .. image:: https://github.com/bids-standard/pybv/workflows/Python%20tests/badge.svg
           :target: https://github.com/bids-standard/pybv/actions?query=workflow%3A%22Python+tests%22
           :alt: GitHub Actions Python tests
        
        .. image:: https://codecov.io/gh/bids-standard/pybv/branch/master/graph/badge.svg
           :target: https://codecov.io/gh/bids-standard/pybv
           :alt: codecov
        
        .. image:: https://badge.fury.io/py/pybv.svg
           :target: https://badge.fury.io/py/pybv
           :alt: pypi version
        
        .. image:: https://img.shields.io/conda/vn/conda-forge/pybv.svg
           :target: https://anaconda.org/conda-forge/pybv
           :alt: conda version
        
        .. image:: https://readthedocs.org/projects/pybv/badge/?version=stable
           :target: https://pybv.readthedocs.io/en/stable/?badge=stable
           :alt: Documentation Status
        
        ====
        pybv
        ====
        
        ``pybv`` is a lightweight exporter to the BrainVision data format.
        
        The BrainVision data format is a recommended data format
        for use in the `Brain Imaging Data Structure <https://bids.neuroimaging.io>`_.
        
        
        The documentation can be found under the following links:
        
        - for the `stable release <https://pybv.rtfd.io/en/stable/>`_
        - for the `latest (development) version <https://pybv.rtfd.io/en/latest/>`_
        
        About the BrainVision data format
        =================================
        
        BrainVision is the name of a file format commonly used for storing
        electrophysiology data. Originally, it was put forward by the
        company `Brain Products <https://www.brainproducts.com>`_, however the
        simplicity of the format has allowed for a diversity of tools reading from and
        writing to the format.
        
        The format consists of three separate files:
        
        1. A text header file (``.vhdr``) containing meta data
        2. A text marker file (``.vmrk``) containing information about events in the
           data
        3. A binary data file (``.eeg``) containing the voltage values of the EEG
        
        Both text files are based on the
        `Microsoft Windows INI format <https://en.wikipedia.org/wiki/INI_file>`_
        consisting of:
        
        - sections marked as ``[square brackets]``
        - comments marked as ``; comment``
        - key-value pairs marked as ``key=value``
        
        A documentation for core BrainVision file format is provided by Brain Products.
        You can `view the specification <https://www.brainproducts.com/productdetails.php?id=21&tab=5>`_
        as hosted by Brain Products.
        
        
        Installation
        ============
        
        ``pybv`` runs on Python version 3.6 or higher.
        
        ``pybv``'s only dependency is ``numpy``. However, we currently recommend that
        you install MNE-Python for reading BrainVision data. See their instructions
        `here <https://mne.tools/stable/install/index.html>`_.
        
        After you have a working installation of MNE-Python (or only ``numpy`` if you
        do not want to read data and only write it), you can install ``pybv`` through
        the following:
        
        - ``pip install --upgrade pybv``
        
        or if you use `conda <https://docs.conda.io/en/latest/miniconda.html>`_:
        
        - ``conda install --channel conda-forge pybv``
        
        Contributing
        ============
        
        The development of ``pybv`` is taking place on
        `GitHub <https://github.com/bids-standard/pybv>`_.
        
        For more information, please see
        `CONTRIBUTING.md <https://github.com/bids-standard/pybv/blob/master/.github/CONTRIBUTING.md>`_
        
        Usage
        =====
        
        Writing BrainVision files
        -------------------------
        
        The primary functionality provided by ``pybv`` is the ``write_brainvision``
        function. This writes a numpy array of data and provided metadata into a
        collection of BrainVision files on disk.
        
        .. code-block:: python
        
            from pybv import write_brainvision
        
            # for further parameters see our API documentation
            write_brainvision(data=data, sfreq=sfreq, ch_names=ch_names,
                              fname_base=fname, folder_out=tmpdir,
                              events=events)
        
        Reading BrainVision files
        -------------------------
        
        Currently, ``pybv`` recommends using `MNE-Python <https://mne.tools>`_
        for reading BrainVision files.
        
        Here is an example of the MNE code required to read in BrainVision data:
        
        .. code-block:: python
        
            import mne
        
            # Import the BrainVision data into an MNE Raw object
            raw = mne.io.read_raw_brainvision('tmp/test.vhdr', preload=True)
        
            # Reconstruct the original events from our Raw object
            events, event_ids = mne.events_from_annotations(raw)
        
        Acknowledgements
        ================
        
        This package was originally adapted from the
        `Philistine package <https://gitlab.com/palday/philistine>`_ by
        `palday <https://palday.bitbucket.io/>`_.
        It copies much of the BrainVision exporting code, but removes the dependence on MNE.
        Several features have been added, such as support for individual units for each channel.
        
Keywords: Brain Products BrainVision vhdr vmrk eeg
Platform: any
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development
Classifier: Topic :: Scientific/Engineering
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX
Classifier: Operating System :: Unix
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Python: ~=3.6
Description-Content-Type: text/x-rst
