Quick start with smilPython

Table of Contents

• Generalities
• Your first program
• Some rules

Generalities

Most Smil features are available under Python, thanks to Swig as a module names smilPython.

Your first program

Type the following lines in your prefered text editor (copy and paste works fine) and name it, e.g., first-smil.py.

# import smilPython module
import smilPython as sp
 
# define which structuring element to use
se = sp.SquSE()
 
# get your first image
# try replacing the URL by some image stored in your computer.
imIn = sp.Image("https://smil.cmm.minesparis.psl.eu/images/lena.png")
imIn.show("Lena original")
 
# declare two images for results
imA = sp.Image(imIn)
imA.show("erode")
 
imB = sp.Image(imIn)
imB.show("dilate")
 
# erosion and dilation
r = sp.erode(imIn,  imA, se())
r = sp.dilate(imIn, imB, se())
 
input("Hit enter to continue")
 
# now let's do some filtering with a SE of size 2
r = sp.open(imIn, imA, se(2))
imA.setName("open")
r = sp.close(imIn, imB, se(2))
imB.setName("close")
 
input("Hit enter to continue")

Run it and try to modify it.

Note

• near all Smil functions return a value which means :
  • 1 - if the function executed with no error
  • 0 or any other value - an error occured. Usually there will be some message to explain the error.
• it's a good practice to verify the returned value and stop processing on errors and handle it.

Some rules

• TBD