Skip to content

Commit 0001c36

Browse files
committed
add a README for Firefly
1 parent 1bb0128 commit 0001c36

File tree

1 file changed

+33
-0
lines changed

1 file changed

+33
-0
lines changed

README_firefly.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
# Using the LSST DM Stack from Python - Firefly edition
2+
3+
The Jupyter Notebook in this repository is a self-guided tutorial that walks the reader through writing a simple processing script using LSST Data Management Python libraries. This tutorial was originally set up for the LSST2017 Project
4+
and Community Workshop.
5+
6+
The `tutorial-firefly.ipynb` notebook is a modified form of the notebook that gives Firefly equivalents to the
7+
matplotlib displays used in the original version. This notebook is based on the "answers" version of the tutorial,
8+
in which the solutions to the exercises have been included.
9+
10+
As of mid-December 2017, the necessary Firefly packages are included in `lsst_distrib`. It is possible to
11+
run the notebook in a Docker container, following the
12+
[developer instructions for Docker](https://pipelines.lsst.io/install/docker.html#docker-tags).
13+
14+
Here are Docker commands used to test this notebook:
15+
16+
```
17+
docker run -itd -p 9745:9745 -v `pwd`:/home/vagrant/mnt --name lsst2 lsstsqre/centos:7-stack-lsst_distrib-d_2017_12_14
18+
19+
docker exec -it lsst2 /bin/bash
20+
```
21+
22+
Then in the shell inside the container:
23+
```
24+
source loadLSST.bash
25+
26+
conda install jupyter notebook ipython
27+
28+
cd /home/vagrant/mnt/lsst2017
29+
30+
jupyter notebook --ip 0.0.0.0 --port 9745
31+
```
32+
33+
Then on the host machine, open a browser to [http://localhost:9745](http://localhost:9745).

0 commit comments

Comments
 (0)