# fiona > Fiona reads and writes spatial data files - **URL**: https://www.freshcrate.ai/projects/fiona - **Author**: Sean Gillies - **Category**: Databases - **Latest version**: `1.10.1` (2026-04-21) - **License**: BSD 3-Clause - **Source**: https://github.com/Toblerity/Fiona - **Homepage**: https://pypi.org/project/fiona/ - **Language**: Python - **GitHub**: 1,236 stars, 217 forks - **Registry**: pypi (`fiona`) - **Tags**: `data`, `feature`, `gis`, `pypi`, `vector` ## Description ===== Fiona ===== .. image:: https://github.com/Toblerity/Fiona/actions/workflows/tests.yml/badge.svg :target: https://github.com/Toblerity/Fiona/actions/workflows/tests.yml .. image:: https://github.com/Toblerity/Fiona/actions/workflows/test_gdal_latest.yml/badge.svg :target: https://github.com/Toblerity/Fiona/actions/workflows/test_gdal_latest.yml .. image:: https://img.shields.io/pypi/v/fiona :target: https://pypi.org/project/fiona/ .. image:: https://api.securityscorecards.dev/projects/github.com/Toblerity/Fiona/badge :target: https://securityscorecards.dev/viewer/?uri=github.com/Toblerity/Fiona Fiona streams simple feature data to and from GIS formats like GeoPackage and Shapefile. Fiona can read and write real-world data using multi-layered GIS formats, zipped and in-memory virtual file systems, from files on your hard drive or in cloud storage. This project includes Python modules and a command line interface (CLI). Fiona depends on `GDAL `__ but is different from GDAL's own `bindings `__. Fiona is designed to be highly productive and to make it easy to write code which is easy to read. Installation ============ Fiona has several `extension modules `__ which link against libgdal. This complicates installation. Binary distributions (wheels) containing libgdal and its own dependencies are available from the Python Package Index and can be installed using pip. .. code-block:: console pip install fiona These wheels are mainly intended to make installation easy for simple applications, not so much for production. They are not tested for compatibility with all other binary wheels, conda packages, or QGIS, and omit many of GDAL's optional format drivers. If you need, for example, GML support you will need to build and install Fiona from a source distribution. It is possible to install Fiona from source using pip (version >= 22.3) and the `--no-binary` option. A specific GDAL installation can be selected by setting the GDAL_CONFIG environment variable. .. code-block:: console pip install -U pip pip install --no-binary fiona fiona Many users find Anaconda and conda-forge a good way to install Fiona and get access to more optional format drivers (like GML). Fiona 1.10 requires Python 3.8 or higher and GDAL 3.4 or higher. Python Usage ============ Features are read from and written to file-like ``Collection`` objects returned from the ``fiona.open()`` function. Features are data classes modeled on the GeoJSON format. They don't have any spatial methods of their own, so if you want to transform them you will need Shapely or something like it. Here is an example of using Fiona to read some features from one data file, change their geometry attributes using Shapely, and write them to a new data file. .. code-block:: python import fiona from fiona import Feature, Geometry from shapely.geometry import mapping, shape # Open a file for reading. We'll call this the source. with fiona.open( "zip+https://github.com/Toblerity/Fiona/files/11151652/coutwildrnp.zip" ) as src: # The file we'll write to must be initialized with a coordinate # system, a format driver name, and a record schema. We can get # initial values from the open source's profile property and then # modify them as we need. profile = src.profile profile["schema"]["geometry"] = "Point" profile["driver"] = "GPKG" # Open an output file, using the same format driver and coordinate # reference system as the source. The profile mapping fills in the # keyword parameters of fiona.open. with fiona.open("centroids.gpkg", "w", **profile) as dst: # Process only the feature records intersecting a box. for feat in src.filter(bbox=(-107.0, 37.0, -105.0, 39.0)): # Get the feature's centroid. centroid_shp = shape(feat.geometry).centroid new_geom = Geometry.from_dict(centroid_shp) # Write the feature out. dst.write( Feature(geometry=new_geom, properties=f.properties) ) # The destination's contents are flushed to disk and the file is # closed when its with block ends. This effectively # executes ``dst.flush(); dst.close()``. CLI Usage ========= Fiona's command line interface, named "fio", is documented at `docs/cli.rst `__. The CLI has a number of different commands. Its ``fio cat`` command streams GeoJSON features from any dataset. .. code-block:: console $ fio cat --compact tests/data/coutwildrnp.shp | jq -c '.' {"geometry":{"coordinates":[[[-111.73527526855469,41.995094299316406],...]]}} ... Documentation ============= For more details about this project, pleas ## Recent releases | Version | Date | Urgency | Changes | | --- | --- | --- | --- | | `1.10.1` | 2026-04-21 | Low | Imported from PyPI (1.10.1) | | `1.10.0` | 2024-09-04 | Low | This is 1.10.0. At last! The project has added 25 new contributors since 1.9.0, for a total of 73. Fiona 1.10 will continue to support classic GIS programming work with a record-style data model. Rows, that is, not columns. The changes since 1.9.6 are fully described in the changelog, split across pre-releases. Here is a high-level summary. ### Deprecations - Python-style filter expressions for CLI commands are being replaced by Lisp-like expressions. - Some constants in the `fiona. | | `1.10.0rc1` | 2024-08-22 | Low | This is the first release candidate for 1.10.0. ### Changes - Mutable item access to Feature, Geometry, and Properties instances has been restored (reported in #1430). This usage should be avoided as instances of these classes will be immutable in a future version. - The setup.cfg duplicates project configuration in pyproject.toml and has been removed. ### Packaging - PyPI wheels include GDAL 3.9.2. Please see the CHANGES file for a more detailed enumeration of changes since vers | | `1.10b3` | 2024-07-30 | Low | ### Bug fixes - The sketchy, semi-private Python opener interfaces of version 1.10b2 have been replaced by ABCs that are exported from fiona.abc (#1415). How to implement the interfaces and provide a custom opener is documented in `test_pyopener.py` and will be included in the documentation for version 1.10.0. - The truncate GDAL VSI plugin callback has been implemented (#1413). Please see the CHANGES file for a more detailed enumeration of changes since version 1.9.6. Unless showstopper | | `1.10b2` | 2024-07-11 | Low | This is the second beta release for Fiona 1.10. There are no new features, only bug fixes: ### Bug fixes - The Pyopener registry and VSI plugin have been rewritten to avoid filename conflicts and to be compatible with multithreading. Now, a new plugin handler is registered for each instance of using an opener (#1408). Before GDAL 3.9.0 plugin handlers cannot not be removed and so it may be observed that the size of the Pyopener registry grows during the execution of a program. - A CSLCons | | `1.10b1` | 2024-04-16 | Low | This is the first beta release for Fiona 1.10. There are no new features, only one bug fix: - Fiona can again set fields with values that are instances of classes derived from date, time, and datetime (#1377). This was broken by changes in 1.10a2. Please see the CHANGES file for a more detailed enumeration of changes since version 1.9.6. Unless showstopper bugs are found in this release, expect a release candidate in two weeks. | | `1.10a2` | 2024-04-05 | Low | This is the second 1.10 pre-release. The changes since 1.10a1 are enumerated below. ### Deprecations - The FIELD_TYPES, FIELD_TYPES_MAP, and FIELD_TYPES_MAP_REV attributes of fiona.schema are no longer used by the project and will be removed in version 2.0 (#1366). - The Python style of rio-filter expressions introduced in version 1.0 are deprecated. Only the parenthesized list type of expression will be supported by version 2.0. ### New features - All supported Fiona field types ar | | `1.9.6` | 2024-03-08 | Low | This is very likely the last 1.9.x release and fixes several bugs that can't wait until 1.10.0. ### Bug fixes - Ensure that geometry types in a schema are translated to a linear type, as geometry instances are (#1313). - Fix broken stable API documentation on Read The Docs. - Remove install requirement of setuptools, a regression introduced in 1.9.5. | | `1.10a1` | 2024-03-03 | Low | This is the first 1.10 pre-release. ### Python version Fiona 1.10 will require Python version 3.8 or higher. ### Deprecations The fiona.path module will be removed in version 2.0 and a deprecation warning is issued when the module is imported (#1334). Additionally, members of that module are no longer exported from the top level module. ### New features Python openers can now support discovery of auxiliary "sidecar" files like .aux.xml, .msk, and .tfw files for GeoTIFFs (#1331) | | `1.9.5` | 2023-10-12 | Low | ### Bug fixes - Expand keys in schema mismatch exception, resolving #1278. - Preserve the null properties and geometry of a Feature when serializing (#1276). ### Packaging * The distribution name is now officially "fiona", not "Fiona". The import name remains `fiona`. * Builds now require Cython >= 3.0.2 (#1276). * PyPI wheels include GDAL 3.6.4, PROJ 9.0.1, and GEOS 3.11.2. * PyPI wheels include curl 8.4.0, addressing CVE-2023-38545 and CVE-38546. * PyPI wheels are now available f | ## Citation - HTML: https://www.freshcrate.ai/projects/fiona - Markdown: https://www.freshcrate.ai/projects/fiona.md - Dependencies JSON: https://www.freshcrate.ai/api/projects/fiona/deps _Generated by freshcrate.ai. Indexes pypi releases for AI-agent ecosystem packages._