Installation¶

The easy way¶

The currently default way to install FixBikeNet is using pip:

pip install fixbikenet

If this does not work, follow the instructions below.

Advanced installations¶

The main step is to set up a virtual environment fbnenv in which to install the package, and then to use or run the environment. Use either of the methods below.

With conda/pip¶

Installation with conda (or the faster mamba).

The conda-forge installation is not yet working. Therefore, you need to clone the repository and create the environment via the environment.yml file:

conda env create --file environment.yml
conda activate fbnenv
pip install fixbikenet

With Pixi¶

Installation with Pixi.

First, clone this repository and create the environment via the environment.yml file:

pixi init --import environment.yml

At this point you can run fixbikenet in the environment, for example as such:

pixi run python examples/mwe.py

The first time you run code with Pixi, it might take a minute longer, as Pixi resolves the environment’s dependencies only at this point.

Run fixbikenet in Jupyter lab¶

After having set up the environment above, if you wish to run fixbikenet via JupyterLab, follow the corresponding instructions below.

With conda¶

Using conda (or the faster mamba), run:

conda activate fbnenv
ipython kernel install --user --name=fbnenv
conda deactivate
jupyter lab

Once Jupyter lab opens, switch the kernel (Kernel > Change Kernel > fbnenv)

With pip¶

Using pip, run:

pip install --user ipykernel
python -m ipykernel install --user --name=fbnenv
jupyter lab

Once Jupyter lab opens, switch the kernel (Kernel > Change Kernel > fbnenv)

With Pixi¶

Running fixbikenet in Jupter lab with Pixi is straightforward:

pixi run jupyter lab

An instance of Jupyter lab is automatically going to open in your browser after the environment is built.

Development installation¶

If you want to develop the project, clone this repository and create the environment via the environment-dev.yml file:

pixi init --import environment-dev.yml

The development environment is called fbnenvdev. Make sure to also read our contribution guidelines.