This repository contains Jupyter notebooks showcasing how to use the LUSID SDK. You can find a list of the notebooks at examples/README.
| branch | status |
|---|---|
master |
  |
develop |
 view builds |
We welcome contributions from our community. See our contributing guide for information on how to contribute to the Sample Notebooks repository.
Authentication is handled automatically; see https://support.lusid.com/knowledgebase/article/KA-01829/en-us
You can run the Notebooks locally but you will need to set up authentication using a secrets file:
- Clone this repository
git clone git@github.com:finbourne/sample-notebooks.git
cd sample-notebooks
-
Create a
secrets.jsonfile in the examples folder with your LUSID credentials. See how to assemble these. -
Build the Docker image
docker build -t finbourne/lusid-sample-notebooks .
Mac users may need to specify the platform. On a Mac M1 it is:
docker build --platform linux/arm64 -t finbourne/lusid-sample-notebooks .
- Run the Docker image / Run from command line
Windows
docker run --rm -it --name fbn-jupyter -v %cd%:/home/jovyan -e FBN_SECRETS_PATH=/home/jovyan/examples/secrets.json -p 8888:8888 finbourne/lusid-sample-notebooksmacOS/linux
docker run --rm -it --name fbn-jupyter \
-v $(pwd):/home/jovyan \
-e FBN_SECRETS_PATH=/home/jovyan/examples/secrets.json \
-p 8888:8888 \
finbourne/lusid-sample-notebooksYou will see something similar to the following output:
[I 09:14:44.031 NotebookApp] Writing notebook server cookie secret to /home/jovyan/.local/share/jupyter/runtime/notebook_cookie_secret
[I 09:14:45.228 NotebookApp] JupyterLab extension loaded from /opt/conda/lib/python3.7/site-packages/jupyterlab
[I 09:14:45.228 NotebookApp] JupyterLab application directory is /opt/conda/share/jupyter/lab
[I 09:14:45.231 NotebookApp] Serving notebooks from local directory: /home/jovyan
[I 09:14:45.231 NotebookApp] The Jupyter Notebook is running at:
[I 09:14:45.231 NotebookApp] http://e910e1f74c45:8888/?token=<token>
[I 09:14:45.231 NotebookApp] or http://127.0.0.1:8888/?token=<token>
[I 09:14:45.231 NotebookApp] Use Control-C to stop this server and shut down all kernels (twice to skip confirmation).
[C 09:14:45.245 NotebookApp]
To access the notebook, open this file in a browser:
file:///home/jovyan/.local/share/jupyter/runtime/nbserver-6-open.html
Or copy and paste one of these URLs:
http://e910e1f74c45:8888/?token=<token>
or http://127.0.0.1:8888/?token=<token>
If you chose to run directly from the command line instead of docker you will need to install the dependencies specified in requirements.txt and then run 'jupyter notebook'
-
Click on the link shown in the console to open up JupyterHub in a browser.
-
Open the
examplesfolder and open index.ipynb to see a catalogue of available notebooks.
There are few notebooks that interact with Luminesce and need some extra config.
For these notebooks you will need to run the following code in the intended notebook:
import os
from IPython.core.magic import (register_line_cell_magic)
from lusidjam import RefreshingToken
import lumipy as lm
secrets_path = os.getenv("FBN_SECRETS_PATH")
@register_line_cell_magic
def luminesce(line, cell=None):
query = cell if cell is not None else line
lm_client = lm.get_client(token=RefreshingToken(), api_secrets_filename=secrets_path)
df = lm_client.query_and_fetch(query)
return df
# In an interactive session, we need to delete to avoid
# name conflicts for automagic to work on line magics.
del luminesce