Douglass.jl is a package for manipulating DataFrames in Julia using a syntax that is very similar to Stata.
Note: Douglass.jl is in alpha, and may contain bugs. Please do try it out and report your experience. When using it in production, please check that the output is correct.
Douglass is not registered. To install, type ]
in the Julia command prompt, followed by
add https://github.com/jmboehm/Douglass.jl.git
using Douglass, RDatasets, DataFrames, DataFramesMeta
df = dataset("datasets", "iris")
# set the active DataFrame
Douglass.set_active_df(:df)
# create a variable `z` that is the sum of `SepalLength` and `SepalWidth`, for each row
d"gen :z = :SepalLength + :SepalWidth"
# replace `z` by the row index for the first 10 observations
d"replace :z = _n if _n <= 10"
# drop a variable
d"drop :z"
# construct the within-group sum for a subset of the observations
d"bysort :Species : egen :z = sum(:SepalLength) if :SepalWidth .> 3.0"
generate
-- Creates a new variable and assigns the output from an expression to it.replace
-- Recplaces the content of a variable, but does not change the type.egenerate
(oregen
for short) -- Creates a new variable. Operates on vectors.ereplace
(orerep
for short) -- Analogous toegen
, replaces values of existing variables.drop
-- Drops the specified observations (if used in conjunction withif
) or variables (withoutif
)rename
-- Rename a variablesort
-- Sort the rows activateDataFrame
by the specified columnsreshape
-- Reshape the activateDataFrame
between wide and long format (reshape_long
,reshape_wide
)merge
-- Merge the activeDataFrame
with another one in the local scope (merge_m1
,merge_1m
,merge_11
)duplicates_drop
-- Delete duplicate rows, also by subset of columns
See the commands documentation page for more details on syntax of these commands.
Press the backtick (`
) to switch between the normal Julia REPL and the Douglass REPL mode:
Douglass supports multiline input on the active dataframe:
d"""
gen :x = 5
gen :y = 6
"""
The @douglass
macro allows subsequent operations to be performed on one particular DataFrame:
using RDatasets
iris = dataset("datasets", "iris")
Douglass.@douglass iris """
gen :x = :SepalWidth + :PetalWidth
gen :y = 42
"""
These benchmarks are made using a synthetic dataset with 1m observations, on my Macbook Pro (Intel(R) Core(TM) i9-9980HK CPU @ 2.40GHz, Julia 1.9.0, Stata/MP 17.0).
- Better documentation of the interface will come when the package is a bit more stable. In the meantime, the Test script is probably the best introduction to the interface for those that know Stata.
- Keep in mind that this is not Stata. Here are some notable differences.
Please file bug reports as issues.
- Implement more commands
- If other people find the package useful, it may be worth making the package extensible, so that other commands can be added in separate packages
If you find the package useful or the idea promising, please consider giving it a star (at the top of the page).
- Tidier.jl is a set of Julia packages that allow data manipulation and plotting using R's tidyverse syntax. If you like tidyverse syntax, this package may be for you.
- StataCall.jl is a package to call Stata from Julia
- julia.ado is a package to call Julia from Stata
Douglass.jl is named in honour of the economic historian Douglass North.