HallPy_Teach

Description

This package uses PyVISA to control and read instruments (power supplies, multimeters etc.) to run experiments in the Physics Honours Laboratory, initially for Hall Effect, although control of Curie Weiss law is also envisaged. This automates the data acquisition and allows easy recording of many data points in patterns or intervals defined by the user, and produces data files containing the results in numpy arrays, suitable for plotting and data analysis.

Get Started

Install the package

pip install HallPy_Teach

Import it in a Jupyter notebook or anyother notebook like python environment

import HallPy_Teach as hp

Doing an experiment There are two methods to doing experiments. Method 1 requires less hassel and allows you to setup your instruments to run the experiments via a GUI. The GUI will guide you through connecting and trouble shooting the required experiment and subsiquently the intsruments required for the selected experiemnt. Method 2 is a more manual approach, this is the less prefered option but we've stated the second method here anyway because it is the method one would follow if they design their own experiment file. The guide to setting up your own experiments can be found on the HallPy_Teach Website

Method 1

Step 1: Experiemnt & Instrument Setup

When the following code block is run you will be guided through choosing the experiment and setting up the instruments for said experiment.

import HallPy_Teach as Teach
experiment = Teach.Setup()

Step 2: Experiment Parameters & Data Collection

You cannot run Step 2 without compelting step 1
When the following code block is run you will start seeing the data being collected. Only run this codeblock once your you've setup your experiment aparatus and you're ready to collect the data. If the experiment requires parameters to be set, such as voltage sweep ranges and data collection intervals you will see a guide to setting the required parameter(s). Once the data collection has started you should see the data being visualised as it comes in. Once all the data is collected you should see a prompt saying so.

data = experiment.doExperiment(experiment.expInsts)

Method 2

Read Method 1 before reading Method 2 As stated before Method 2 is added so users can run their own designed experiments. As you can see in the example below we are importing yourExperimentFile.py from which we will get the custom experiment.

import yourExperimentFile.py as yourExp
import HallPy_Teach as Teach
allInstruments = Teach.initInstruments()
yourExpInstruments = yourExp.setup(allInstruments)
data = yourExp.doExperiment(yourExpInstruments)

As stated before Method 2 exists so that you can run your own experiemnts which means that supporting good error handeling and guides for how to solve said errors is down to the author of the custom experiment. Just for the sake of reference, you can find a code block below which runs the HallEffect experiment, a experiment provided by the library, with Method 2 instead of Method 1.

Guide to push updates to the package

Make your changes on a different branch
Create a New Pull Request which merging your branch to main.
- On the pull request you will be able to see if the workflow is able to build the package
If the workflow is successfull on the Pull Request page, feel free to merge to main and then create a release on the Release Page
- Make sure you add a NEW tag by clicking on the choose tag button and adding a new tag. Make sure its higher than the last release which is
- If you chose an older tag, the package will build but the rest of the workflow will fail when github tries to upload the package to Pypi.

maclariz/HallPy_Teach