{
"cells": [
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Example `stata_kernel` Jupyter notebook\n",
"\n",
"This Jupyter notebook is an example of how you can use Stata in the Jupyter ecosystem using `stata_kernel`.\n",
"\n",
"Full documentation, including how to install, is available at https://kylebarron.dev/stata_kernel/."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Overview\n",
"\n",
"The Jupyter Notebook is a file format that permits interactive coding with text, code, and results in a single document. You can share a notebook file (with extension `.ipynb`), and results will be viewable without running the code, but as long as the recipient also has Jupyter installed, he or she can edit and re-run the code cells.\n",
"\n",
"Jupyter itself is language agnostic, i.e. it permits writing code in any language. This document uses Stata code, but you can also code in Jupyter using Python, [R](https://irkernel.github.io/), [Julia](https://github.com/JuliaLang/IJulia.jl), [Matlab](https://github.com/calysto/matlab_kernel), and [SAS](https://github.com/sassoftware/sas_kernel). "
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Running code\n",
"\n",
"In contrast to [IPyStata](https://github.com/TiesdeKok/ipystata), no special commands are needed. Just write code as you would normally in Stata.\n",
"\n",
"Let's make sure that the connection with Stata is working properly."
]
},
{
"cell_type": "code",
"execution_count": 1,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Hello, world!\n"
]
}
],
"source": [
"display \"Hello, world!\""
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"You can run a cell by pressing Ctrl+Enter or Shift+Enter. If a number appears in the brackets to the left of the input cell, that means that the code was successfully run (sometimes a cell doesn't produce any output).\n",
"\n",
"If you don't see `Hello, world!` as output, check out the [troubleshooting tips](https://kylebarron.dev/stata_kernel/using_stata_kernel/troubleshooting/)."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Let's load the included `auto` dataset."
]
},
{
"cell_type": "code",
"execution_count": 2,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"(1978 Automobile Data)\n"
]
}
],
"source": [
"sysuse auto.dta"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Now the `auto` dataset is in memory."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Basic descriptive statistics"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Nearly all commands that work in Stata work through Jupyter as well. A couple commands that depend on the Graphical User Interface, such as `browse` and `edit`, only work on Windows."
]
},
{
"cell_type": "code",
"execution_count": 3,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"\n",
" | Headroom (in.)\n",
" Car type | 1.5 2.0 2.5 3.0 3.5 4.0 4.5 5.0 | Total\n",
"-----------+----------------------------------------------------------------------------------------+----------\n",
" Domestic | 3 10 4 7 13 10 4 1 | 52 \n",
" Foreign | 1 3 10 6 2 0 0 0 | 22 \n",
"-----------+----------------------------------------------------------------------------------------+----------\n",
" Total | 4 13 14 13 15 10 4 1 | 74 \n"
]
}
],
"source": [
"tabulate foreign headroom"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Graphs"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"No special syntax is needed to generate graphs. Just write commands like you're used to.\n",
"The display order of graphs will always be the same as the order in the code."
]
},
{
"cell_type": "code",
"execution_count": 4,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"\n",
"(highschool and beyond (200 cases))\n"
]
},
{
"data": {
"application/pdf": "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",
"image/svg+xml": [
"\n",
"\n",
"\n",
"