Skip to main content

Build Status Coverage Status Install with conda

nanonispy

A small library written in python 3 to parse Nanonis binary and ascii files.

Nanonispy was made in needing to do a lot of analysis for scanning tunneling microscopy (STM) data, and thought this would be good practice in creating a proper python library. That being said it is in no way foolproof and if anybody else actually uses this please let me know if you run into issues.

Nanonispy can read Nanonis grid, scan, and point spectroscopy files. This means it will read the file header and parse that into a somewhat useful dictionary for later use, as well as read in the binary/ascii data in a relatively general way to accomadate data with multiple channels stored, or custom spectroscopy experiments.

Requirements

Currently written and tested with

  • python 3.9

  • python 3.8

  • python 3.7

  • python 3.6

Depends on

  • numpy

Install

For the most up-to-date version, install from github as pip and conda packages are not updated as frequently.

pip

pip install nanonispy

conda

conda install --channel https://conda.anaconda.org/underchemist nanonispy

github

Simply clone this repo and run

python setup.py install

Basic usage

Once installed, you should be able to import it to any python script or ipython session.

import nanonispy as nap

Then given a file,

grid = nap.read.Grid('/path/to/datafile.3ds')

You can look at the attributes and methods to determine the information available.

Running tests

Similar to the install, except run

python setup.py test

. If you have the nose module installed, it’s as simple as

nosetests

.

You can also see coverage of the tests as well as ignore the test discovery of numpy core packages (don’t quite understand why it does this) with

nosetests --with-coverage --cover-branches --cover-package=nanonispy

.

Metadata

Release files for nanonispy2 1.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nanonispy2 1.2.0
File Size Uploaded
nanonispy2-1.2.0.tar.gz 15.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for nanonispy2 1.2.0
File Interpreter ABI Platform
nanonispy2-1.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 26.4 kB

Release files / nanonispy2-1.2.0.tar.gz

Download URL nanonispy2-1.2.0.tar.gz
Size 15.8 kB
Tags Source
SHA-256 checksum
How to use checksums
65ad304de2bac8691c567795275e386f16d2f269d20c8e8d44fad06f82411d9c
BLAKE2b-256 checksum
How to use checksums
6a414388fef72035a2a1c9f67bdbb76a833c13d265548d7138d861bb32f86e15
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.0.0 CPython/3.12.2

Release files / nanonispy2-1.2.0-py3-none-any.whl

Download URL nanonispy2-1.2.0-py3-none-any.whl
Size 10.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9b19435cc0b80b787f452e5d235a881a1d3777fa3c648ef8b62e8ff43a40471c
BLAKE2b-256 checksum
How to use checksums
8f68e86c8adfd1399a120ae8af48264a346cdc562778e958beb92ec15233408d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.0.0 CPython/3.12.2

Release history Release notifications | RSS feed

This release

1.2.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page