    file: jsoc-manual.txt = RR manual for JSOC im_patch cutout service
    init: Dec  8 2013  Rob Rutten  Sac Peak
    last: Jun 17 2021  Rob Rutten  Deil
    note: sometime 2016 this manual became obsolete, see my sdo manual

    NB: this manual is no longer used or needed <by me>
    ---------------------------------------------------
      This manual describes how to get SDO data for "cutouts" (= small
      fields of view matching other telescopes, e.g. the SST) using the
      im_patch service on the JSOC exportdata website.  Since spring 2016
      this isn't needed by me anymore since my sdo_orderjsoc.pro does the
      ordering from an IDL session, and my sdo_getjsoc.pro does the
      dowloading from IDL too.

      I therefore cut the below parts out of my sdo-manual.txt in case I
      still need these notes in future.

    Step 1: define your desired SDO cutout sequences
    ------------------------------------------------
      find area of interest: from GBO data or daily movies or JHelioviewer

      define (X,Y) of cutout center precisely for the start time of the desired
      SDO data set (solar rotation moves your target up to 10 arcsec/hr)
        sdo_featurelocator,datetime,wav,imagedir=imagedir  # find feature (X,Y)
          e.g.: sdo_featurelocator,'2014-01-01 00:00','1600'
          zoom in precisely to the recognized feature and click for coordinates

      define JSOC series identifiers by copy-paste + editing of:
        aia.lev1_uv_24s[2013.07.29_14:00/120m][1600,1700] # start, length, wavs
        aia.lev1_euv_12s[2013.07.29_14:00/120m][304,171,193]   # or more AIA
        hmi.M_45s[2013.07.29_14:00_TAI/120m]              # magnetograms
        hmi.Ic_45s[2013.07.29_14:00_TAI/120m]             # continuum
        hmi.V_45s[2013.07.29_14:00_TAI/120m]              # Dopplergrams

      [NB -in case of problems defining the desired sequence specifier:
      http://jsoc.stanford.edu/ajax/lookdata.html           click on RecordSetSelect
           paste/build series identifier into window, NO return
           click check count
           click tab on top "Export Data"
           click export button
           yes, leave this page
           click export
           redo the exportdata page]

    Step 2: get "im_patch" cutout sequences from JSOC (both AIA and HMI, fast)
    --------------------------------------------------------------------------
      request the first series:
      http://jsoc.stanford.edu/ajax/exportdata.html       paste first series identifier into upper RecordSet window
        hit return or click Check count
        Method > url-tar
        click Enable Processing active
        click im_patch active
            keep Tracking enabled, Register and Crop not enabled
            maintain the default reference time = start time of requested series
              (NB: setting a different reference time ??may?? spoil HMI coutouts)
            set LocUnits for (X,Y) = arcsec from center (not px, 0.5/0.6)
            specify X and Y of patch center
            set box size scale: arcsec (not px)
            set box width    (for xga movies: minimum 55 or 110 or 220 or 440)
            set box height   (for xga movies: minimum 43 or  85 or 170 or 340)
        Check params in im-patch box: must have "OK to submit" behind it
        ?? Compression > Rice
        Protocol: FITS
        notify: email address
        click Check Params for Export
        click Submit Export Request when green
        ignore size estimate            # still is way too large
        wait for grey Request Export Status (or wait for email)
        note Record Set string + JSOC request number (raise page) in emdatasdojot

      request the other series (repeat for each):
        paste next series identifier into upper RecordSet window
        in im_patch box click Update Reference Times
        click again on "Check Params for Export"  # even when green
        wait until Submit Export Request is green
        click green Submit Export Request
        wait until this goes grey after red
        again note request identifier

      wait for the processing to be done or the confirmation email

    Step 3: download requested data sets when ready, untar, check field of view
    ------------------------------------------------------------------------------
      click Request Export Status
        when data complete: right-mouse download link
      or in "export complete" email:
        right-click > open link
        right-click > "Save as"

      post-download shell command startup:
        mkdir datadir
        cd ~/Downloads
        tar xf *tar
        rm -f *tar
        cd datadir
        mkdir level1
        cd level1
        mvfromdownloads *.fits
        cd ..

    RR to RR: get & process JSOC tars off-line in remote server using screen
    ------------------------------------------------------------------------
      in Tosh: start shadow dir
        mkdir ~/data/SDO/"date-topic"
        cd ~/data/SDO/"date-topic"
        mkdir -p  tar level1 level2 cubes mpegs
        emrecordidl (or in dir higher; comes in ~/rr/wrk/SDO/...)
      in server: get tar files and process them all all the way
        <start terminal in remote server>
        screen
        mkdir ~/data/SDO/date-topic
        cd ~/data/SDO/date-topic
        getjsoctar http://jsoc.stanford.edu/SUM57/D526543567/S00000
        getjsoctar http://jsoc.stanford.edu/....
        getjsoctar http://jsoc.stanford.edu/....
        IDL
        sdo_allimages2fitscubes,'171',/sdoprep,/dellev1,maildone='r.j.rutten@uu.nl
           # no dellev2 for safety
        CNTRL-a d
        logout (??)
        login
        screen -r
        exit IDL
        exit from screen and logout
      better get only the mpegs (40x smaller than intcubes, reasonable quality)