NESS Python library

This library presents some Python classes for building score and instrument files for the NESS physical models.

Below are a some tutorials that give you an idea of how to use these tools for engaging with the Ness models.

Tutorials

Net1 Tutorials

1. Raw score and instrument files 1
2. Multiple Strings
3. Adding Connections
4. Troubleshooting
5. Using the Python nesstools with Net1 part 1
6. Using the Python nesstools with Net1 part 2

NESS Guitar score tutorials:

1. Score basics: pluck a couple of a strings
2. Plucking with more control
3. Putting fingers on frets with playFret()
4. Putting fingers in positions with playPosition()
5. Playing harmonics with playHarmonic()
6. A more advanced look at harmonics
7. Creating scores from tab and tab files
8. Creating scores from MIDI files
9. Creating structures with iteration #1
10. Creating structures with iteration #2
11. (coming soon) NESS Recipe #1: a simple plucking piece
12. (coming soon) NESS Recipe #2: a fretless just intonation tuning piece

NESS Guitar instrument tutorials:

1. Instrument basics: defaultGuitar
2. Instrument basics: more tempaltes
3. Tuning / Microtones
4. Customising string parameters #1
5. Customising string parameters #2
6. Customising fretboard parameters
7. Adding Preparations

How to run these files

• Clone or download this repository
• Open a terminal and cd to the folder.
• type python gtr_score_1_basic_plucks.py (or whichever file you wish to run)
• This should create both a score file and an instrument file in the "ness_files_to_process" folder
• Process these files with the NESS Code framework
• This is again a command line process, where -s and -i flags need to be set for the input score and instrument files,
  • e.g. ./ness-framework -s /path/to/scorefile.m -i /path/to/instrumentfile.m

Example implementation

from nesstools import guitar

stringCount = 6
my_guitar = guitar.StringInstrument(stringCount)
my_guitar.defaultGuitar()
my_guitar.write("basic_guitar.m")

my_score = guitar.GuitarScore(10, stringCount)       
my_score.pluck( 1, 0.5 )
my_score.playFret( 1, 1.0, 5 )
my_score.playFret( 1, 1.5, 7 )
my_score.pluck( 1, 2 )
my_score.write("basic_score.m")

Currently includes classes for the brass, guitar and soundboard models