fcsfiles


Namefcsfiles JSON
Version 2024.5.24 PyPI version JSON
download
home_pagehttps://www.cgohlke.com
SummaryRead fluorescence correlation spectroscopy (FCS) data files
upload_time2024-05-25 16:38:19
maintainerNone
docs_urlNone
authorChristoph Gohlke
requires_python>=3.9
licenseBSD
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            Read fluorescence correlation spectroscopy (FCS) data files
===========================================================

Fcsfiles is a Python library to read Carl Zeiss(r) ConfoCor(r) RAW and ASCII
measurement data files.

:Author: `Christoph Gohlke <https://www.cgohlke.com>`_
:License: BSD 3-Clause
:Version: 2024.5.24

Quickstart
----------

Install the fcsfiles package and all dependencies from the
`Python Package Index <https://pypi.org/project/fcsfiles/>`_::

    python -m pip install -U fcsfiles

See `Examples`_ for using the programming interface.

Source code and support are available on
`GitHub <https://github.com/cgohlke/fcsfiles>`_.

Requirements
------------

This revision was tested with the following requirements and dependencies
(other versions may work):

- `CPython <https://www.python.org>`_ 3.9.13, 3.10.11, 3.11.9, 3.12.3
- `NumPy <https://pypi.org/project/numpy>`_ 1.26.4

Revisions
---------

2024.5.24

- Support NumPy 2.
- Fix docstring examples not correctly rendered on GitHub.

2023.8.30

- Fix linting issues.
- Add py.typed marker.
- Convert to Google style docstrings.
- Drop support for Python 3.8 and numpy < 1.22 (NEP29).

2022.9.28

- Update metadata.

2022.2.2

- Add type hints.
- Use float64 or int64 for ConfoCor3Fcs arrays.
- Drop support for Python 3.7 and numpy < 1.19 (NEP29).

2021.6.6

- Remove support for Python 3.6 (NEP 29).

2020.9.18

- Relax ConfoCor3Raw header requirement.
- Support os.PathLike file names.

2020.1.1

- Remove support for Python 2.7 and 3.5.

Notes
-----

"Carl Zeiss" and "ConfoCor" are registered trademarks of Carl Zeiss, Inc.

The use of this implementation may be subject to patent or license
restrictions.

The API is not stable yet and is expected to change between revisions.

This module does *not* read flow cytometry standard FCS files.

Examples
--------

Read the CountRateArray from a ConfoCor3 ASCII file as a numpy array:

>>> fcs = ConfoCor3Fcs('ConfoCor3.fcs')
>>> fcs['FcsData']['FcsEntry'][0]['FcsDataSet']['CountRateArray'].shape
(60000, 2)
>>> print(fcs)  # doctest: +ELLIPSIS, +NORMALIZE_WHITESPACE
Carl Zeiss ConfoCor3 - measurement data file - version 3.0 ANSI
BEGIN FcsData 30000
        Name = Fluorescein
        Comment =
        AverageFlags = Repeat|Position|Average_Fit_Results
        SortOrder = Channel-Repeat-Position-Kinetics
        BEGIN FcsEntry1 10000
...

Read data and metadata from a ConfoCor3 RAW file:

>>> fcs = ConfoCor3Raw('ConfoCor3.raw')
>>> fcs.filename
'f5ee4f36488fca2f89cb6b8626111006_R1_P1_K1_Ch1.raw'
>>> fcs.frequency
20000000
>>> times = fcs.asarray()
>>> times[10858]
1199925494
>>> times, bincounts = fcs.asarray(bins=1000)
>>> times.shape
(1000,)
>>> bincounts[618]
23
>>> fcs.close()

Read data and metadata from a ConfoCor2 RAW file:

>>> fcs = ConfoCor2Raw('ConfoCor2.raw')
>>> fcs.frequency
20000000
>>> ch0, ch1 = fcs.asarray()
>>> ch1[4812432]
999999833
>>> times, ch0, ch1 = fcs.asarray(bins=1000)
>>> times.shape
(1000,)
>>> ch1[428]
10095
>>> fcs.close()

            

Raw data

            {
    "_id": null,
    "home_page": "https://www.cgohlke.com",
    "name": "fcsfiles",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": null,
    "keywords": null,
    "author": "Christoph Gohlke",
    "author_email": "cgohlke@cgohlke.com",
    "download_url": "https://files.pythonhosted.org/packages/52/f1/5489df1b20b36a0c7b7b966c94ed0323297684a75e848a3c1e96af3a601d/fcsfiles-2024.5.24.tar.gz",
    "platform": "any",
    "description": "Read fluorescence correlation spectroscopy (FCS) data files\r\n===========================================================\r\n\r\nFcsfiles is a Python library to read Carl Zeiss(r) ConfoCor(r) RAW and ASCII\r\nmeasurement data files.\r\n\r\n:Author: `Christoph Gohlke <https://www.cgohlke.com>`_\r\n:License: BSD 3-Clause\r\n:Version: 2024.5.24\r\n\r\nQuickstart\r\n----------\r\n\r\nInstall the fcsfiles package and all dependencies from the\r\n`Python Package Index <https://pypi.org/project/fcsfiles/>`_::\r\n\r\n    python -m pip install -U fcsfiles\r\n\r\nSee `Examples`_ for using the programming interface.\r\n\r\nSource code and support are available on\r\n`GitHub <https://github.com/cgohlke/fcsfiles>`_.\r\n\r\nRequirements\r\n------------\r\n\r\nThis revision was tested with the following requirements and dependencies\r\n(other versions may work):\r\n\r\n- `CPython <https://www.python.org>`_ 3.9.13, 3.10.11, 3.11.9, 3.12.3\r\n- `NumPy <https://pypi.org/project/numpy>`_ 1.26.4\r\n\r\nRevisions\r\n---------\r\n\r\n2024.5.24\r\n\r\n- Support NumPy 2.\r\n- Fix docstring examples not correctly rendered on GitHub.\r\n\r\n2023.8.30\r\n\r\n- Fix linting issues.\r\n- Add py.typed marker.\r\n- Convert to Google style docstrings.\r\n- Drop support for Python 3.8 and numpy < 1.22 (NEP29).\r\n\r\n2022.9.28\r\n\r\n- Update metadata.\r\n\r\n2022.2.2\r\n\r\n- Add type hints.\r\n- Use float64 or int64 for ConfoCor3Fcs arrays.\r\n- Drop support for Python 3.7 and numpy < 1.19 (NEP29).\r\n\r\n2021.6.6\r\n\r\n- Remove support for Python 3.6 (NEP 29).\r\n\r\n2020.9.18\r\n\r\n- Relax ConfoCor3Raw header requirement.\r\n- Support os.PathLike file names.\r\n\r\n2020.1.1\r\n\r\n- Remove support for Python 2.7 and 3.5.\r\n\r\nNotes\r\n-----\r\n\r\n\"Carl Zeiss\" and \"ConfoCor\" are registered trademarks of Carl Zeiss, Inc.\r\n\r\nThe use of this implementation may be subject to patent or license\r\nrestrictions.\r\n\r\nThe API is not stable yet and is expected to change between revisions.\r\n\r\nThis module does *not* read flow cytometry standard FCS files.\r\n\r\nExamples\r\n--------\r\n\r\nRead the CountRateArray from a ConfoCor3 ASCII file as a numpy array:\r\n\r\n>>> fcs = ConfoCor3Fcs('ConfoCor3.fcs')\r\n>>> fcs['FcsData']['FcsEntry'][0]['FcsDataSet']['CountRateArray'].shape\r\n(60000, 2)\r\n>>> print(fcs)  # doctest: +ELLIPSIS, +NORMALIZE_WHITESPACE\r\nCarl Zeiss ConfoCor3 - measurement data file - version 3.0 ANSI\r\nBEGIN FcsData 30000\r\n        Name = Fluorescein\r\n        Comment =\r\n        AverageFlags = Repeat|Position|Average_Fit_Results\r\n        SortOrder = Channel-Repeat-Position-Kinetics\r\n        BEGIN FcsEntry1 10000\r\n...\r\n\r\nRead data and metadata from a ConfoCor3 RAW file:\r\n\r\n>>> fcs = ConfoCor3Raw('ConfoCor3.raw')\r\n>>> fcs.filename\r\n'f5ee4f36488fca2f89cb6b8626111006_R1_P1_K1_Ch1.raw'\r\n>>> fcs.frequency\r\n20000000\r\n>>> times = fcs.asarray()\r\n>>> times[10858]\r\n1199925494\r\n>>> times, bincounts = fcs.asarray(bins=1000)\r\n>>> times.shape\r\n(1000,)\r\n>>> bincounts[618]\r\n23\r\n>>> fcs.close()\r\n\r\nRead data and metadata from a ConfoCor2 RAW file:\r\n\r\n>>> fcs = ConfoCor2Raw('ConfoCor2.raw')\r\n>>> fcs.frequency\r\n20000000\r\n>>> ch0, ch1 = fcs.asarray()\r\n>>> ch1[4812432]\r\n999999833\r\n>>> times, ch0, ch1 = fcs.asarray(bins=1000)\r\n>>> times.shape\r\n(1000,)\r\n>>> ch1[428]\r\n10095\r\n>>> fcs.close()\r\n",
    "bugtrack_url": null,
    "license": "BSD",
    "summary": "Read fluorescence correlation spectroscopy (FCS) data files",
    "version": "2024.5.24",
    "project_urls": {
        "Bug Tracker": "https://github.com/cgohlke/fcsfiles/issues",
        "Homepage": "https://www.cgohlke.com",
        "Source Code": "https://github.com/cgohlke/fcsfiles"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "4012faf61a6d0b7ec1fd4d801c36938763f7993e6f32b0ae0955270e161edbac",
                "md5": "4b337176849aad61ba32a565487cfd7a",
                "sha256": "cbe45c30c5a5b08a407b12381739c1a039bec0e0ac7d2ff154874818fd121975"
            },
            "downloads": -1,
            "filename": "fcsfiles-2024.5.24-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "4b337176849aad61ba32a565487cfd7a",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 10562,
            "upload_time": "2024-05-25T16:38:17",
            "upload_time_iso_8601": "2024-05-25T16:38:17.946939Z",
            "url": "https://files.pythonhosted.org/packages/40/12/faf61a6d0b7ec1fd4d801c36938763f7993e6f32b0ae0955270e161edbac/fcsfiles-2024.5.24-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "52f15489df1b20b36a0c7b7b966c94ed0323297684a75e848a3c1e96af3a601d",
                "md5": "e989ec8acb3200de0598339be9f48287",
                "sha256": "0b5df9ee64ecd13e144fe56113364e78a436f38a055154fe4893e9d1f1685f71"
            },
            "downloads": -1,
            "filename": "fcsfiles-2024.5.24.tar.gz",
            "has_sig": false,
            "md5_digest": "e989ec8acb3200de0598339be9f48287",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 9477,
            "upload_time": "2024-05-25T16:38:19",
            "upload_time_iso_8601": "2024-05-25T16:38:19.507188Z",
            "url": "https://files.pythonhosted.org/packages/52/f1/5489df1b20b36a0c7b7b966c94ed0323297684a75e848a3c1e96af3a601d/fcsfiles-2024.5.24.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-05-25 16:38:19",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "cgohlke",
    "github_project": "fcsfiles",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "fcsfiles"
}
        
Elapsed time: 2.98955s