OBSOLETE WINDOWS INSTRUCTIONS FORWARD is now available as a Solar Soft package "forward" - see new installation instructions.


You should only have to go through all these steps once -- after that, you only have to do step 4 with each new version of FORWARD, step 14 if you upgrade SSW, and steps 10-13 if the fortran codes in $FORWARD/FORCOMP change (rare) .

---------------------

1)  make sure you have Perl installed (www.mssl.ucl.ac.uk/surf/sswdoc/solarsoft/simple_windows/Install_Perl.html)

 

2)  make sure you have SolarSoft IDL (SSWIDL) installed (www.lmsal.com/solarsoft/ssw_install_howto.html)

 

3)  make sure you have all the necessary packages

                 IDL > ssw_upgrade,/spawn,/binaries,/chianti,/eis,/xrt,/eit,/trace,/secchi,/aia,/mdi,/pfss,/nrl,/cds,/swap,/lasco,/loud,/passive_ftp

4)  get latest version of FORWARD [http://www.hao.ucar.edu/FORWARD/TARS], delete (or make sure not in your path) old versions, and expand new tars (for FORWARD, FORWARD_DOCS, and FORWARD_DB). (N.B.: this step must be redone if any of the tar files have a date stamp later than the last one your downloaded)

5)   create a working directory FORWARD_WORKING_DIR

 

6)  make sure you have the packages pointed to in your SSWIDL startup (probably in ssw/site/setup/sswidl.bat)

IDL > set SSW_INSTR=binaries chianti eis xrt eit trace secchi aia mdi pfss nrl cds swap lasco

 

7)  make sure you have $FORWARD, $FORWARD_DB, $FORWARD_DOCS, and $FORWARD_WORKING_DIR and IDL_PATH are all set in  ssw\site\setup\setup.ssw_paths

 

                   setenv FORWARD c:\ssw_idl\ssw\FORWARD\

                                (editing to make the correct path pointing to the FORWARD* directories)

                   setenv FORWARD_DOCS c:\ssw_idl\ssw\FORWARD_DOCS\

                   setenv FORWARD_DB c:\ssw_idl\ssw\FORWARD_DB\

                   setenv FORWARD_WORKING_DIR [wherever you want to put it] FORWARD_WORKING_DIR\

                   setenv IDL_PATH +${IDL_DIR}/lib:\+$FORWARD/:\+$FORWARD_DB/:\+$FORWARD_DOCS/:\+$FORWARD_WORKING_DIR/

 

IF YOU DO NOT HAVE A SETUP.SSW_PATHS - you can download them http://hesperia.gsfc.nasa.gov/ssw/site/setup/setup.ssw_paths and then add the lines above.

 

8)  make sure FORWARD, FORWARD_DB, FORWARD_DOCS, and FORWARD_WORKING_DIR are all included in IDLDE preferences Window: ÒPreferences/IDL/PathsÓ.

 

9)  make sure you have Fortran compiler installed. GFORTRAN is recommended (https://gcc.gnu.org/wiki/GFortranBinaries ). If using g77, from a DOS cmd window run Òg77setupÓ in directory C:\G77

 

10)  if using g77, then edit the makefile in FORWARD/FORCOMP by changing all the "gfortran" into "g77" (there should be two places, after FC and after LINK). (NB: to change disk from the prompt line in the DOS cmd window, type: C:\ > D:) (N.B.: this step must be redone if forcomp.f or any other *.f codes change in $FORWARD/FORCOMP directory)

 

11) go to directory $FORWARD/FORCOMP and in a DOC cmd window compile the "forcomp" FORTRAN routine with the following command: "make forcomp". (it also might work to just type: ÒmakeÓ). (N.B.: this step must be redone if forcomp.f or any other *.f codes change in $FORWARD/FORCOMP directory)

 

12) copy the executable forcomp.exe to your FORWARD_WORKING_DIR (N.B.: this step must be redone if forcomp.f or any other *.f codes change in $FORWARD/FORCOMP directory).

 

13) If you do not have the ability to ÒzipÓ and ÒunzipÓ from the command line in your windows installment, follow instructions to install the "zip" and "unzip" command under Windows able to run from DOS command line. The instructions can be found in the webpage: http://www.hao.ucar.edu/FORWARD/FOR_SSW/docs/INSTRUCTIONS/unzip.html

 

14) check in directory Ò\ssw\vobs\ontology\binaries\Win32_x86_64 Ò if there are the files Òcfitsio.dllÓ and  Òcfitsio.libÓ. If not, copy them there from directory: Ò\ssw\vobs\ontology\binaries\Win32_x86 Ò. (N.B.: this step must be redone if you upgrade ssw).

 

15) run the tests below outside of FORWARD (just in a SSWIDL session)

 

16)  run FORWARD in a SSWIDL session by typing

 

                  IDL> for_widget,

;*******

TESTS (can be run in SSWIDL session, even when FORWARD not started):

If any of these fail, be sure you have all the packages set up as described in $FORWARD/FOR_SSW/docs/INSTRUCTIONS/installupdate.html

 

IDL> aia_lct,wave=193

(this should set AIA color table, you should not get an error.)

 

IDL> test=get_stereo_lonlat('2010-01-01','A') (this should return spacecraft position)

 

IDL> use_network

(this should not give an error - if it does, try ssw_upgrade,/spawn,/loud,/passive_ftp

 

IDL> test=vso_search('2012-01-01T00:00:00','2012-01-01T00:10:00',instr='aia')

(this should not give an error but acts to query the VSO for data and return information)

 

IDL> filelocatenew=vso_get(test[0],filenames=filenames,/rice)

(this should download a file with the name of the file now in filenames)

IDL> read_sdo,filenames,header,image

IDL> help,header,image

--you should get something like:

 

HEADER

STRUCT

= ->     Array[1]

IMAGE

INT

= Array[4096, 4096]