{"id":18733476,"url":"https://github.com/queryverse/featherfiles.jl","last_synced_at":"2025-04-12T18:31:40.218Z","repository":{"id":61797903,"uuid":"93790641","full_name":"queryverse/FeatherFiles.jl","owner":"queryverse","description":"FileIO.jl integration for Feather files","archived":false,"fork":false,"pushed_at":"2020-08-22T06:49:12.000Z","size":219,"stargazers_count":8,"open_issues_count":3,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-26T12:51:13.187Z","etag":null,"topics":["julia","queryverse"],"latest_commit_sha":null,"homepage":"","language":"Julia","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/queryverse.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-06-08T20:49:08.000Z","updated_at":"2022-12-13T14:53:54.000Z","dependencies_parsed_at":"2022-10-21T11:15:23.920Z","dependency_job_id":null,"html_url":"https://github.com/queryverse/FeatherFiles.jl","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/queryverse%2FFeatherFiles.jl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/queryverse%2FFeatherFiles.jl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/queryverse%2FFeatherFiles.jl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/queryverse%2FFeatherFiles.jl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/queryverse","download_url":"https://codeload.github.com/queryverse/FeatherFiles.jl/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248613503,"owners_count":21133524,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["julia","queryverse"],"created_at":"2024-11-07T15:09:55.016Z","updated_at":"2025-04-12T18:31:39.911Z","avatar_url":"https://github.com/queryverse.png","language":"Julia","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FeatherFiles\n\n[![Project Status: Active - The project has reached a stable, usable state and is being actively developed.](http://www.repostatus.org/badges/latest/active.svg)](http://www.repostatus.org/#active)\n[![Build Status](https://travis-ci.org/queryverse/FeatherFiles.jl.svg?branch=master)](https://travis-ci.org/queryverse/FeatherFiles.jl)\n[![Build status](https://ci.appveyor.com/api/projects/status/8dbkg1vnew2pihtr/branch/master?svg=true)](https://ci.appveyor.com/project/queryverse/featherfiles-jl/branch/master)\n[![codecov.io](http://codecov.io/github/queryverse/FeatherFiles.jl/coverage.svg?branch=master)](http://codecov.io/github/queryverse/FeatherFiles.jl?branch=master)\n\n## Overview\n\nThis package provides load and save support for [Feather files](https://github.com/wesm/feather) under the [FileIO.jl](https://github.com/JuliaIO/FileIO.jl) package.\n\n## Installation\n\nUse Pkg.add(\"FeatherFiles\") in Julia to install FeatherFiles and its dependencies.\n\n## Usage\n\n### Load a feather file\n\nTo read a feather file into a ``DataFrame``, use the following julia code:\n\n````julia\nusing FeatherFiles, DataFrames\n\ndf = DataFrame(load(\"data.feather\"))\n````\n\nThe call to ``load`` returns a ``struct`` that is an [IterableTable.jl](https://github.com/queryverse/IterableTables.jl), so it can be passed to any function that can handle iterable tables, i.e. all the sinks in [IterableTable.jl](https://github.com/queryverse/IterableTables.jl). Here are some examples of materializing a feather file into data structures that are not a ``DataFrame``:\n\n````julia\nusing FeatherFiles, DataTables, IndexedTables, TimeSeries, Temporal, Gadfly\n\n# Load into a DataTable\ndt = DataTable(load(\"data.feather\"))\n\n# Load into an IndexedTable\nit = IndexedTable(load(\"data.feather\"))\n\n# Load into a TimeArray\nta = TimeArray(load(\"data.feather\"))\n\n# Load into a TS\nts = TS(load(\"data.feather\"))\n\n# Plot directly with Gadfly\nplot(load(\"data.feather\"), x=:a, y=:b, Geom.line)\n````\n\n### Save a feather file\n\nThe following code saves any iterable table as a feather file:\n````julia\nusing FeatherFiles\n\nsave(\"output.feather\", it)\n````\nThis will work as long as ``it`` is any of the types supported as sources in [IterableTables.jl](https://github.com/queryverse/IterableTables.jl).\n\n### Using the pipe syntax\n\nBoth ``load`` and ``save`` also support the pipe syntax. For example, to load a feather file into a ``DataFrame``, one can use the following code:\n\n````julia\nusing FeatherFiles, DataFrame\n\ndf = load(\"data.feather\") |\u003e DataFrame\n````\n\nTo save an iterable table, one can use the following form:\n\n````julia\nusing FeatherFiles, DataFrame\n\ndf = # Aquire a DataFrame somehow\n\ndf |\u003e save(\"output.feather\")\n````\n\nThe pipe syntax is especially useful when combining it with [Query.jl](https://github.com/queryverse/Query.jl) queries, for example one can easily load a feather file, pipe it into a query, then pipe it to the ``save`` function to store the results in a new file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqueryverse%2Ffeatherfiles.jl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fqueryverse%2Ffeatherfiles.jl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqueryverse%2Ffeatherfiles.jl/lists"}