2013/12/17 - DPC
2014/03/12 - DPC updated

The Mimir Software Packages (MSP-BDP, MSP-PPOL, etc.) were developed
using IDL version 6 (IDL64). Many users will instead be using IDL8.

These instructions will help users install and run the MSPs.

As always, if questions or problems arise, email me (clemens@bu.edu).

A. Initializing IDL8 - set up a separate workspace for your MSP code:

	1. Launch IDL8 (using the development editor IDLE)
	2. File > Switch Workspace > Other
	3. Workspace: Select a place to put your MSP code, mine is:
             C:\Users\Dan\IDL8_MSP_Workspace
	4. Copy Settings: select "Workbench Layout" and "Working Sets"
	5. Click "OK" (this may cause IDL8 to close and relaunch)

B. Set IDL preferences to look for files within packages

	1. Window > Preferences
	2. In the "Preferences" window that appears, 
		Double-click "IDL" in the list at left
	3. In the list that expands below "IDL", click "Paths"
	4. In the "Paths" window at right, click "Insert..."
	5. Use the "Select Directory" file chooser window that appears
		to navigate to, and select, the Workspace you set up
		in Step A above
	6. That workspace will show up in the list of paths
	7. Select that workspace, and click the "Move up" button until
		that workspace is the first item on the list
	8. Click in the open square to the left of the workspace
		name to permit searching of subdirectories in the
		workspace
	9. Click "Apply" at bottom right
	10. Click "OK" (the window should close)

C. Create a new project for each MSP package to be installed

	1. File > New Project
	2. Name: MSP_BDP	(for example)
	3. Select "Create the new project in the workspace"
	4. Leave checked the "Update IDL path when project is opend or closed"
	5. Click "Finish"
        >> this new project should show up in the Project Explorer window

D. Read the zip file version of the package distribution into the project

	1. Right-click (select) on the new project ("MSP_BDP" for example)
		to bring up a pull-down menu
	2. On that menu, select "Import"
	3. In the Import window that appears, right-click the triangle
		appearing to the left of "General" to unbundle it
	4. From that unbundling, select "Archive File" then click the
		"Next" button at the bottom of the window
	5. In the Import window, in the "From archive file:" window, 
		click the "Browse" button
	6. In the "Import from Archive File" file chooser window that 
		appears, navigate to where you placed the MSP package
		zip file
	7. Select that zip file 
	8. In the "Import" window, the files in the zip file are unpacked
		and listed in the right hand panel in window
	9. Verify that the correct destination folder is listed in the
		"Into folder:" text zone (should say "MSP_BDP" for example)
	10. Click the "Finish" button at the bottom of the window.
	11. Verify that this worked: In the Project Explorer window,
		click small triangle to the left of the new project 
		name ("MSP_BDP") to see the files imported

E. Be sure to import the "Astrolib_MSP" package and install it or the
	other MSP packages will not be happy

E1. Import and install the new "MSP_Library" package

F. Edit the Project properties, as needed

	1. Right-click on the Package name ("MSP_BDP") to get the pull-down
		menu
	2. Select "Properties" at the bottom of the menu
	3. A "Properties for [package name]" window will open
	4. Select "IDL Project Properties" from the list at left
	5. At right, check "Build project before running result"
	6. In the text window, list the name of the GUI that will
		launch for each package, according to the following
		table:

		Package		Entry in the textbox
		---------------------------------------
		MSP_BDP		MSP_BDP_GUI
		MSP_CCS		MSP_CCS
		MSP_DRM		MSP_DRM_GUI  *** not yet supported for release
		MSP_MOT		MSP_MOT_GUI  *** not yet supported for release
		MSP_PPOL	MSP_PPOL_GUI
		MSP_SXC		... not run as a GUI
		MSP_WCT		MSP_WCT
		---------------------------------------
	7. Select "Project References". In the window at right, place 
		check marks in the boxes next to "Astrolib_MSP"
                and "MSP_Library" to allow this
		package to search those libraries for routines
	7. Click "Apply"
	8. Click "OK"

G. Launch the package

	1. Right-click the package name in the Project Explorer to get
		the pull down menu
	2. Click on "Run [package name]" - this should compile and launch
		the package