home

  4SM cookbook: teach yourself 4SM

Is there a market for optical modeling? 
Workstation
GMT download  4SM download: free tutorials
Further your training for a price
Then what?

  Is there a market for optical modeling?

  1. You can get started on your own using my website: the 4SM executable code is there. All you need is a Linux workstation and Openev, some targeted reading, and ... suitable commitment and time.
  2. There is even one option in 4SM for using NOAA's method (with no need, in 4SM, for atmospheric correction or field data), once the calibration has been achieved properly, if this is what you really want to test. 
  3. Then you can work on any of your own images: calibration, deglinting-smoothing, sea truth, profiling, etc, and even final modeling of a small-enough subset of your image. 
  4. From there, then you can then process your own images yourself to final output on the whole image: it is just a question for me to allow it through the license key system, imagewise: you e-mail me the Required_LicenseKey and I e-mail you back a CommandLine_Licensekey that you will include inside the 4SM commandline script in order to enable the processing your full image. 
  5. Whether I get paid for that Command Line_License key remains to be seen, as what I want most at present is that 4SM be actually used and keeps improving: I would prefer that an agreement to cover this aspect be arranged through HDI as they see fit.

Teach yourself 4SM in just one week -well, sort of!  

Download free tutorial zipfiles, 
complete with a 4SM executable code, the image, and detailed step by step tutorial


4SM Workstation  and work environment




Prepare your work environment

Make a local copy of this website on your computer
and update it regularly

download and unzip  4sm.zip (0.4 MB)
Wget is a network utility to retrieve files from the Web using http(s) and ftp, the two most widely used Internet protocols. It works non-interactively, so it will work in the background, after having logged off. The program supports recursive retrieval of web-authoring pages as well as ftp sites -- you can use wget to make mirrors of archives and home pages or to travel the Web like a WWW robot.
Wget works particularly well with slow or unstable connections by continuing to retrieve a document until the document is fully downloaded. Re-getting files from where it left off works on servers (both http and ftp) that support it. Both http and ftp retrievals can be time stamped, so wget can see if the remote file has changed since the last retrieval and automatically  retrieve the new version if it has.
  • use Synaptic to install wget
  • See manual for using wget: wget.html
  • cd /home/YourUserName
  • run        "4SM.2.06 -Wget"
    • this shall display the procedure which is applied automatically by running the following, 
    • in case you need/want to modify it.
  • or run         "4SM.2.06 -Mirror" 
    • 4SM shall request your permission to update/download the website
    • Once the mirror copy is stored on your computer,running this command only update this mirror copy
    • this runs "rm wget.log; wget -r -c -nH  -N  -P  /home/YourUserName/RSPwebsite/   -l 10  http://pws.prserv.net/RSP.4SM/"
  • this downloads/updates my 20 MB website from http://pws.prserv.net/RSP.4SM/  into /home/YouyUserName/RSPwebsite/RSP.4SM/
    • "FINISHED --2009-01-18 11:59:38--  Downloaded: 829 files, 19M in 11m 6s (29.4 KB/s)"
  • The -N option ensures that only newer files are downloaded
  • Hopefully, /home/YourUserName/RSPwebsite/RSP.4SM/ now is a faithful mirror image of 4SM website
  • and 4SM shall use /home/YourUserName/RSPwebsite/RSP.4SM/ by default for HELP services, so you can conveniently work offline
  • Or you can relocate /Full/Path/Of/RSP.4SM anywhere on your machine or network
  • and place a -URL/file:///Full/Path/Of/RSP.4SM in your commandline
Beware though that this website is constantly improved,
so you should also get a complete update regularly.

Experience the  learning curve Sorry: I'm constantly improving, so you might experience frustration with the code.
So don't hesitate to interact with me: I'll do my best to satisfy you.

First, you'll need to familiarize with atmospheric and underwater optics.
Then, please start with the tarawa tutorial, then arcachon, then tmnov, then negril.
Then you can venture into working on your own 4 bands images, like TM, ETM, Ikonos, QuickBird, ....
Then only, you'll be ready for the big experience with hyperspectral data.
Downloads
  • make a new directory called "tarawa", and change to that directory
  • download and unzip 4sm.calls.zip(0.9 MB) and   4sm.zip (0.4 MB)
  • you get
    • 4smcalls directory
      • executables for GMT graphics, under GNU GPL license of University of Hawaii
      • executable shp2text for converting from shapefile to textfile, under GNU GPL license
    • 4smleg directory with the pseudo-color tables for OPENEV projects
    • 4SM.2.06 executable code
Executables
  • Make sure they are all executables
    • " chmod -R a+rwx 4SM.2.06  4smcalls/*  "
Welcome
  • enter "4SM.2.06" at the prompt of your terminal
  • this connects to 
    • your local mirror copy the 4SM website (see above) 
    • or to the original website on the Internet
  • then checks the following (see system calls)
    • gedit..............................check that 4SM's default texteditor is OK; tab width is set at 8 in my gedit's preference
    • kghostview...................check that 4SM's default PostScript viewer is OK
    • firefox...........................check that 4SM's default browser is OK
    • openev..........................check that OPENEV image viewer is OK
    • whoami and cpuid......finds out your username and whether you are a superuser
  • and welcomes you with access to 4SM HELP services 

Tarawa XS tutorial  (0.4 MB)
  • Please start with this detailed introductory SPOT study case.
  • It demonstrates that the simplified radiative transfer equation in its operational form Ls=Lsw+(LsB-Lsw)/exp(2K*Z) does behave in a linear manner across the visible spectrum. 
  • A nice 3-band case with a lot of skyglint , beautiful modeling using the NIR band .  
  • Fairly clear waters in Equatorial Pacific.
  • Then go for a 4-bands Landsat TM image
  • The clear coral reef waters of Bahamas with negative bottom contrast
  • With excellent sea-truth comparison.



Further your training (for a price if/when I get organized for that)
big and real life images, complete with 4SM executable code, command line, and ancillary files

TM   ETM   IKONOS   CASI
My working directories for several of these study cases is included in my CDROM:
  • for 16U images (Ikonos and CASI) the raw data channels are void, for sake of copyright
    • if you hold the image, then you can import the 16U data and run a full processing
  • for TM and ETM images, the raw data is included

   Then what?

  All functionalities are enabled in 4SM executable,    
but modeling is limited to a small sub-window or result channels are chequered     unless
your image is square and small enough
or its licensekey is included in 4SM

This means that you can run your calibration,
and sea truth evaluation using the RegressZZ module,
ahead of any actual modeling of your image.

Then if/when satisfied with your Calibration and Command Line,
you shall have to purchase some kind of license for full modeling of your image.
  home up