Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/adamtaranto/python-novice-dataframes

Working with tabular data in Python
https://github.com/adamtaranto/python-novice-dataframes

Last synced: 3 days ago
JSON representation

Working with tabular data in Python

Awesome Lists containing this project

README

        






# Working locally

## On Mac or Linux machine

1. Install a conda based package manager. We recommend **Miniforge3** if you are setting up for the first time.
- [miniforge3](https://conda-forge.org/miniforge/)
- [micromamba](https://mamba.readthedocs.io/en/latest/installation/micromamba-installation.html)
2. [Install VS Code](https://code.visualstudio.com/download)
3. [Install 'code' command in PATH](https://code.visualstudio.com/docs/setup/mac#_launching-from-the-command-line)

Clone this repo and navigate into the dir:

```bash
git clone https://github.com/Adamtaranto/python-novice-dataframes.git
cd python-novice-dataframes
```

Set up a python environment with the packages we will be using:

### Micromamba

Setup new micromamba environment.

```bash
# Create env and install packages from yml
micromamba env create --name pandas-workshop --file environment.yml

# Activate the environment
micromamba activate pandas-workshop
```

### Or using Conda

```bash
# Create env and install packages from yml
conda env create --name pandas-workshop --file environment.yml

# Activate the environment
conda activate pandas-workshop
```

### Or using pip

```bash
pip install matplotlib numpy pandas scipy seaborn jupyterlab
```

Now you can launch Jupyter Lab.

```bash
jupyter lab
```

## Setup for Windows

1. [Install GitBash](https://wehi-education.github.io/git-novice/#installing-git)
2. [Install VS Code](https://code.visualstudio.com/download)
If you are using VS Code on a windows machine you will also need to [set your default shell as "GitBash"](https://code.visualstudio.com/docs/sourcecontrol/intro-to-git#_git-bash-on-windows).
3. Install [miniforge3](https://conda-forge.org/miniforge/)
4. Open a GitBash shell and run this command to enable Conda: `~/miniforge3/Scripts/conda.exe init bash`
5. From a new GitBash shell use `conda` to install packages:
`conda install -c conda-forge jupyterlab pandas numpy matplotlib seaborn scipy`

Clone this repo and navigate into the dir:

```bash
git clone https://github.com/Adamtaranto/python-novice-dataframes.git
cd python-novice-dataframes
```

Launch Jupyter Lab.

```bash
jupyter lab
```

# Working in Gitpod

Click the Gitpod button at the top of this README to launch a gitpod workspace with all the required software pre-installed.

If you have a paid Gitpod account you can increase the timout limit on your workspace.
Otherwise you will need to restart the workspace periodically.

```bash
# Increase gitpod timeout setting
gp timeout set 6h
```

Manually start Jupyter session

```bash
# Launch jupyter-lab
jupyter lab --NotebookApp.allow_origin='*' --NotebookApp.allow_remote_access=True --NotebookApp.token='' --NotebookApp.password='' --no-browser --port=8888
```

**Note:** See other [gitpod settings](https://www.gitpod.io/docs/references/gitpod-cli#set) here.