Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/queryverse/statfiles.jl

FileIO.jl integration for Stata, SPSS, and SAS files
https://github.com/queryverse/statfiles.jl

julia queryverse

Last synced: 3 days ago
JSON representation

FileIO.jl integration for Stata, SPSS, and SAS files

Host: GitHub
URL: https://github.com/queryverse/statfiles.jl
Owner: queryverse
License: other
Created: 2017-06-08T21:10:17.000Z (over 7 years ago)
Default Branch: master
Last Pushed: 2020-08-22T04:47:43.000Z (about 4 years ago)
Last Synced: 2024-09-30T15:18:07.505Z (3 days ago)
Topics: julia, queryverse
Language: Julia
Size: 225 KB
Stars: 24
Watchers: 4
Forks: 9
Open Issues: 9
Metadata Files:
- Readme: README.md
- License: LICENSE.md

Awesome Lists containing this project

README

        # StatFiles

[![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)

[![Build Status](https://travis-ci.org/queryverse/StatFiles.jl.svg?branch=master)](https://travis-ci.org/queryverse/StatFiles.jl)

[![Build status](https://ci.appveyor.com/api/projects/status/lx7qmion1a8dggls/branch/master?svg=true)](https://ci.appveyor.com/project/queryverse/statfiles-jl/branch/master)

[![codecov.io](http://codecov.io/github/queryverse/StatFiles.jl/coverage.svg?branch=master)](http://codecov.io/github/queryverse/StatFiles.jl?branch=master)

## Overview

This package provides load support for Stata, SPSS, and SAS files

under the [FileIO.jl](https://github.com/JuliaIO/FileIO.jl) package.

## Installation

Use ``Pkg.add("StatFiles")`` in Julia to install StatFiles and its dependencies.

## Usage

### Load a Stata, SPSS, or SAS file

To read a Stata, SPSS, or SAS file into a ``DataFrame``, use the following julia code:

````julia

using StatFiles, DataFrames

df = DataFrame(load("data.dta"))

````

The 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 Stata, SPSS, or SAS file into data structures that are not a ``DataFrame``:

````julia

using StatFiles, DataTables, IndexedTables, TimeSeries, Temporal, Gadfly

# Load into a DataTable

dt = DataTable(load("data.dta"))

# Load into an IndexedTable

it = IndexedTable(load("data.dta"))

# Load into a TimeArray

ta = TimeArray(load("data.dta"))

# Load into a TS

ts = TS(load("data.dta"))

# Plot directly with Gadfly

plot(load("data.dta"), x=:a, y=:b, Geom.line)

````

### Using the pipe syntax

``load`` also support the pipe syntax. For example, to load a Stata, SPSS, or SAS file into a ``DataFrame``, one can use the following code:

````julia

using StatFiles, DataFrames

df = load("data.dta") |> DataFrame

````

The 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 Stata, SPSS, or SAS file, pipe it into a query, then pipe it to the ``save`` function to store the results in a new file.