CDF Patch for IDL 6.2 and later, including IDL 7.*, 8.* and 9.*

The latest patch is based on the CDF Version 3.9.1. For non-Windows systems, make sure the downloaded dynamic library (the .so file) to have executable permission on your machine. Please contact nasa-cdf-support@nasa.onmicrosoft.com if you need a different CDF version.

Windows:

• Script installation (need to run as the administrator) to place the patch into an existing IDL package in the c:\program files directory.
  • Download Gnu's wget tool if you don't have it: wget.exe.
  • Download the script: install_idl_win.bat from a terminal window.
  • Run the script from an administrator terminal window. Make sure wget.exe is accessible from PATH variable. Verify the test run shows the correct CDF library version and the last updated leap second date.

    install_idl_win.bat

  • The original IDL installed files: idl_cdf.dlm and idl_cdf.dll are renamed to idl_cdf.dlm-orig and idl_cdf.dll-orig, respectively.
  • If you have set up the environment variable CDF_LEAPSECONDSTABLE to access the external leap second table, unset it so the static one in the library is to be used. Do it from a terminal window, outside of the IDL,
    set CDF_LEAPSECONDSTABLE (to check for if it is set)
    set CDF_LEAPSECONDSTABLE= (to unset it)
  
  
• Manual installation to place the patch into a user's directory
  • Download the following files:
  • Select the one of the following files. The library has the latest leap second table embedded. Contact us if you want to over-ride the table rather than install the latest patch.
  • 64-bit: (idl_cdf.dll)
  • 32-bit: (idl_cdf.dll)
  • Download DLM
    • idl_cdf.dlm
  • Optionally, download the leap second table. Do this ONLY if you intend to use the previous IDL patch software.
  • Download script showcdfversion.pro.
  
  
  • Set the IDL_DLM_PATH and IDL_PATH environment variable to point to the directory where you placed the patch. For example, if you placed the patch in c:\idl_cdf391_patch, then the command should be

    set IDL_DLM_PATH="c:\idl_cdf391_patch;<IDL_DEFAULT>"
    set IDL_PATH="c:\idl_cdf391_patch;<IDL_DEFAULT>"

    Note: The above command must be entered exactly as shown, including angle brackets and double quotes, prior to invoking IDL. If the patch is checked out fine, you can use the downloaded files: idl_cdf.dlm and idl_cdf.dll to replace the ones in the operational directory at
    <your IDL directory>\bin\bin.x86_64 for 64-bit mode, or

    <your IDL directory>\bin\bin.x86 for 32-bit mode
    Backup up the original files.

  • If you have downloaded the leap second table, then set the environment variable CDF_LEAPSECONDSTABLE to the table.
    set CDF_LEAPSECONDSTABLE='<your IDL directory>\CDFLeapSeconds.txt'
    
    This table will be used, instead of the hard-coded one embedded in the released library. Not setting the environment variable will result in the use of the table from the library. The step is necessary when the leap second table is different from the one in the library. Need to set the environment variable before running CDF modules under IDL.
  • Invoke IDL and use it as usual. Run showcdfversion to show the IDL-CDF and CDF versions.

• Note: Mac Gatekeeper might block the access to idl_cdf.so (or any other files) from CDF as it is downloaded from the Internet for security purpose. If this is the case, you need to manually set it to be accessible. Open the Apple menu, click System Settings, and from Privacy & Security to choose Open Anyway to allow this file to open. Refer Safely open apps on your Mac.
  
• Script installation (may need to have the root account access) to place the patch into an existing IDL package in the /Applications or other.
  • Download the script: install_idl_mac.sh from a terminal window.
  • Make the script's permission to executable:

    chmod +x install_idl_mac.sh

  • Run the script. It must be run from an id that has the root permission if the installation goes into /Applications folder. Verify the test run shows the correct CDF library version and the last updated leap second date.

    ./install_idl_mac.sh

  • The original IDL installed files: idl_cdf.dlm and idl_cdf.so are renamed to idl_cdf.dlm-orig and idl_cdf.so-orig, respectively.
  • If you have set up the environment variable CDF_LEAPSECONDSTABLE to access the external leap second table, unset it so the static one in the library is to be used. Do it from a terminal window, outside of the IDL,
    printenv CDF_LEAPSECONDSTABLE (to check for if it is set)
    unsetenv CDF_LEAPSECONDSTABLE (to unset it)
  
  
• Manual installation to place the patch into a user's directory
  • Download the following files
    • CDF shared library - Only the 64-bit (Darwin x86_64 or arm64) version (see the message that IDL presents when first starting) is available. The libraries are built from a Mac OS 13 Ventura. Please let us know if you encounter problems running the patch on any earlier OS. The library has the latest leap second table embedded. Contact us if you want to over-ride the table rather than install the latest patch.
    • CDF library:
      • x86_64: idl_cdf.so
      • arm64: idl_cdf.so
    • Download DLM
      • idl_cdf.dlm
    • Optionally, download the leap second table. Do this ONLY if you intend to use the previous IDL patch.
    • Download script showcdfversion.pro.
  • Make sure idl_cdf.so and idl_cdf.dlm did not get ".txt" added to the end. Rename it if so.
  • In Terminal.app, remove Apple's quarantine bit with: sudo xattr -d com.apple.quarantine ~/Downloads/idl_cdf.* if the downloaded files go into ~/Downloads folder.
  • Back up the original idl_cdf.so and idl_cdf.dlm and replace them with the newly downloaded files in the IDL installation at
    <your IDL directory>/bin/bin.darwin.x86_64 with IDL running in x86 code, or
    <your IDL directory>/bin/bin.darwin.arm64 with IDL running in arm64 code
    with the new idl_cdf.so and idl_cdf.dlm downloaded in step 1.
  • If you have downloaded the leap second table, then set the environment variable CDF_LEAPSECONDSTABLE to the table:
    setenv CDF_LEAPSECONDSTABLE "<your downloaded directory>/CDFLeapSeconds.txt" (for csh/tcsh shell)
    export CDF_LEAPSECONDSTABLE="<your downloaded directory>/CDFLeapSeconds.txt" (for sh/bash/korn shell)

    This table will be used, instead of the hard-coded one embedded in the released library. Not setting the environment variable will result in the use of the table from the library. The step is necessary when the leap second table is different from the one in the library. Need to set the environment variable before running CDF modules under IDL.
  • Invoke IDL and use it as usual. Run showcdfversion to show the i IDL-CDF and CDF library versions. For instance,
    cd /Applications/harris/idl/bin/bin.darwin.x86_64
    or cd /Applications/nv5/idl/bin/bin.darwin.arm64
    # Or wherever the latest IDL is.
    # Move old files 2 levels up for safekeeping; give your administrative password.
    sudo mv idl_cdf.* ../..
    # Copy new files from Downloads directory.
    sudo cp ~/Downloads/idl_cdf.* .
    # Make sure there's idl_cdf.so and idl_cdf.dlm, and not a ".txt" on end; if so, rename them.
    ls -l idl_cdf.*
    # Remove Apple's quarantine bit.
    sudo xattr -d com.apple.quarantine idl_cdf.*
    # run IDL to check:
    IDL> .run showcdfversion.pro
    

• Script installation (need to have the root account access) to place the patch into an existing IDL package in the /usr/local system directory.
  • Download the script: install_idl_unix.sh from a terminal window.
  • Make the script's permission to executable:

    chmod +x install_idl_unix.sh

  • Run the script from an id that has the root permission. Verify the test run shows the correct CDF library version and the last updated leap second date.

    ./install_idl_unix.sh

  • The original IDL installed files: idl_cdf.dlm and idl_cdf.so are renamed to idl_cdf.dlm-orig and idl_cdf.so-orig, respectively.
  • If you have set up the environment variable CDF_LEAPSECONDSTABLE to access the external leap second table, unset it so the static one in the library is to be used. Do it from a terminal window, outside of the IDL,
    printenv CDF_LEAPSECONDSTABLE (to check for if it is set)
    unsetenv CDF_LEAPSECONDSTABLE (to unset it)
  
  
• Manual installation to place the patch into a user's directory
  • Download the following files
    • One of the following shared libraries. The banner information from idl when it is run will tell it is in either 32-bit (Linux x86 m32) or 64-bit (Linux x86_64 m64) mode.
    • 64-bit: (idl_cdf.so)
    • 32-bit: (idl_cdf.so)
    The library has the latest leap second table embedded.
    • Download DLM
      • idl_cdf.dlm
    • Optionally, download the leap second table. Do this ONLY if you intend to use the previous IDL patch software.
    • Download script showcdfversion.pro.
  • Set the IDL_DLM_PATH environment variable to point to the directory where you placed the patch. For example, if you placed the patch in /home/harold, then the command should be:
    setenv IDL_DLM_PATH "/home/harold:<IDL_DEFAULT>" (for csh/tcsh shell)
    export IDL_DLM_PATH="/home/harold:<IDL_DEFAULT>" (for sh/bash/korn shell)

    Note: The above command must be entered exactly as shown, including angle brackets and double quotes, prior to invoking IDL.

    If the patch is checked out fine, you can use the downloaded files to replace the ones in the operational directory (may need the root access) at
    <your IDL directory>/bin/bin.linux.x86_64 for 64-bit mode, or

    <your IDL directory>/bin/bin.linux.x86 32-bit mode
    

  • If you have downloaded the leap second table, then set the environment variable CDF_LEAPSECONDSTABLE to the table.
    setenv CDF_LEAPSECONDSTABLE "<your IDL directory>/CDFLeapSeconds.txt" (for csh/tcsh shell)
    export CDF_LEAPSECONDSTABLE="<your IDL directory>/CDFLeapSeconds.txt" (for sh/bash/korn shell)

    This table will be used, instead of the hard-coded one embedded in the released library. Not setting the environment variable will result in the use of the table from the library. The step is necessary when the leap second table is different from the one in the library. Need to set the environment variable before running CDF modules under IDL.
  • Invoke IDL and use it as usual. Run showcdfversion to show the IDL-CDF and CDF library versions.