Esphinx.addnodesdocument)}( rawsourcechildren](docutils.nodessubstitution_definition)}(h.. |rel| replace:: 10.71h]h Text10.71}parenth sba attributes}(ids]classes]names]reladupnames]backrefs]utagnameh source lineKhh _documenthubh )}(h.. |date| replace:: |today| h]h2024 136}(hh)h(hh%Nh'Nubah}(h]h]h]dateah ]h"]uh$h h%h&h'Khhh(hubh target)}(h.. _qsg_prereq:h]h}(h]h]h]h ]h"]refid qsg-prerequh$h8h'Khhh(hh%E/chandler/home/floyd/public_html/gg/docs/source/quickstart/prereq.rstubh section)}(hhh](h title)}(h Prerequisitesh]h Prerequisites}(hhNh(hh%Nh'Nubah}(h]h]h]h ]h"]uh$hLhhIh(hh%hFh'Kubh paragraph)}(hGAMIT/GLOBK requires a few other programs to be installed before compiling the source code and running the software to its full capacity. These prerequisites are also listed on our website at http://geoweb.mit.edu/gg/pre.php.h](hGAMIT/GLOBK requires a few other programs to be installed before compiling the source code and running the software to its full capacity. These prerequisites are also listed on our website at }(hh^h(hh%Nh'Nubh reference)}(h http://geoweb.mit.edu/gg/pre.phph]h http://geoweb.mit.edu/gg/pre.php}(hhhh(hh%Nh'Nubah}(h]h]h]h ]h"]refurihjuh$hfhh^ubh.}(hh^h(hh%Nh'Nubeh}(h]h]h]h ]h"]uh$h\h%hFh'KhhIh(hubh])}(hIn addition to a basic Unix- or Linux-based operating system, there are four fundamental requirements for installing GAMIT/GLOBK on any system:h]hIn addition to a basic Unix- or Linux-based operating system, there are four fundamental requirements for installing GAMIT/GLOBK on any system:}(hhh(hh%Nh'Nubah}(h]h]h]h ]h"]uh$h\h%hFh'K hhIh(hubh bullet_list)}(hhh](h list_item)}(ha Fortran compiler;h]h])}(hhh]ha Fortran compiler;}(hhh(hh%Nh'Nubah}(h]h]h]h ]h"]uh$h\h%hFh'K hhubah}(h]h]h]h ]h"]uh$hhhh(hh%hFh'Nubh)}(h a C compiler;h]h])}(hhh]h a C compiler;}(hhh(hh%Nh'Nubah}(h]h]h]h ]h"]uh$h\h%hFh'K hhubah}(h]h]h]h ]h"]uh$hhhh(hh%hFh'Nubh)}(hX11 libraries and headers, specifically: * an X11 library (libX11.a, libX11.so, libX11.dylib, libX11.la or libX11.dll.a); and * an X11 header file (Xlib.h). h](h])}(h(X11 libraries and headers, specifically:h]h(X11 libraries and headers, specifically:}(hhh(hh%Nh'Nubah}(h]h]h]h ]h"]uh$h\h%hFh'K hhubh)}(hhh](h)}(hRan X11 library (libX11.a, libX11.so, libX11.dylib, libX11.la or libX11.dll.a); andh]h])}(hhh]hRan X11 library (libX11.a, libX11.so, libX11.dylib, libX11.la or libX11.dll.a); and}(hhh(hh%Nh'Nubah}(h]h]h]h ]h"]uh$h\h%hFh'Khhubah}(h]h]h]h ]h"]uh$hhhubh)}(han X11 header file (Xlib.h). h]h])}(han X11 header file (Xlib.h).h]han X11 header file (Xlib.h).}(hhh(hh%Nh'Nubah}(h]h]h]h ]h"]uh$h\h%hFh'Khhubah}(h]h]h]h ]h"]uh$hhhubeh}(h]h]h]h ]h"]bullet*uh$hh%hFh'Khhubeh}(h]h]h]h ]h"]uh$hhhh(hh%Nh'Nubeh}(h]h]h]h ]h"]jjuh$hh%hFh'K hhIh(hubh])}(h^Many operating systems will have some or all of these installed by default but others may not.h]h^Many operating systems will have some or all of these installed by default but others may not.}(hjh(hh%Nh'Nubah}(h]h]h]h ]h"]uh$h\h%hFh'KhhIh(hubh])}(hXBelow are details about what to expect from our experience with various operating systems. Once you have completed the steps described for your system, below, download the source code provided on our server, via FTP or secure HTTP, and install GAMIT/GLOBK. Further information is available in the :doc:`download` section and on the main `GAMIT/GLOBK web page `_.h](hX)Below are details about what to expect from our experience with various operating systems. Once you have completed the steps described for your system, below, download the source code provided on our server, via FTP or secure HTTP, and install GAMIT/GLOBK. Further information is available in the }(hj*h(hh%Nh'Nubh pending_xref)}(h:doc:`download`h]h inline)}(hj6h]hdownload}(hj:h(hh%Nh'Nubah}(h]h](xrefstdstd-doceh]h ]h"]uh$j8hj4ubah}(h]h]h]h ]h"]refdocquickstart/prereq refdomainjEreftypedoc refexplicitrefwarn reftargetdownloaduh$j2h%hFh'Khj*ubh section and on the main }(hj*h(hh%Nh'Nubhg)}(h3`GAMIT/GLOBK web page `_h]hGAMIT/GLOBK web page}(hj]h(hh%Nh'Nubah}(h]h]h]h ]h"]nameGAMIT/GLOBK web pagerefurihttp://geoweb.mit.edu/gg/uh$hfhj*ubh9)}(h h]h}(h]gamit-globk-web-pageah]h]gamit/globk web pageah ]h"]refurijnuh$h8 referencedKhj*ubh.}(hj*h(hh%Nh'Nubeh}(h]h]h]h ]h"]uh$h\h%hFh'KhhIh(hubh9)}(h.. _qsg_linux:h]h}(h]h]h]h ]h"]hD qsg-linuxuh$h8h'KhhIh(hh%hFubh9)}(h.. _qsg_debian:h]h}(h]h]h]h ]h"]hD qsg-debianuh$h8h'KhhIh(hh%hFexpect_referenced_by_name} qsg_linuxjsexpect_referenced_by_id}jjsubhH)}(hhh](hM)}(hDebian-Based Linuxh]hDebian-Based Linux}(hjh(hh%Nh'Nubah}(h]h]h]h ]h"]uh$hLhjh(hh%hFh'Kubh])}(hX*Debian-based Linux distributions include the common `Ubuntu `_ operating system. Install the prerequisite programs, including any dependencies and others that we have found to be missing in the core distribution but must be installed, i.e. (requires administrative privileges):h](h4Debian-based Linux distributions include the common }(hjh(hh%Nh'Nubhg)}(h`Ubuntu `_h]hUbuntu}(hjh(hh%Nh'Nubah}(h]h]h]h ]h"]nameUbuntujmhttps://ubuntu.com/uh$hfhjubh9)}(h h]h}(h]ubuntuah]h]h ]ubuntuah"]refurijuh$h8j|Khjubh operating system. Install the prerequisite programs, including any dependencies and others that we have found to be missing in the core distribution but must be installed, i.e. (requires administrative privileges):}(hjh(hh%Nh'Nubeh}(h]h]h]h ]h"]uh$h\h%hFh'K hjh(hubh literal_block)}(h<$ sudo apt install gfortran make libx11-dev csh tcsh bc curlh]h<$ sudo apt install gfortran make libx11-dev csh tcsh bc curl}hjsbah}(h]h]h]h ]h"] xml:spacepreserveforcelanguageconsolehighlight_args}uh$jh%hFh'K#hjh(hubh9)}(h .. _qsg_rpm:h]h}(h]h]h]h ]h"]hDqsg-rpmuh$h8h'K,hjh(hh%hFubeh}(h](debian-based-linuxjjeh]h](debian-based linux qsg_debianjeh ]h"]uh$hGhhIh(hh%hFh'Kj}(j jjjuj}(jjjjuubhH)}(hhh](hM)}(hRPM-Based Linuxh]hRPM-Based Linux}(hjh(hh%Nh'Nubah}(h]h]h]h ]h"]uh$hLhjh(hh%hFh'K+ubh])}(hXqRPM-based Linux distributions include `Fedora `_, `CentOS `_ and `openSUSE `_ operating systems. Install the prerequisite programs, including any dependencies and others that we have found to be missing in the core distribution but must be installed, i.e. (requires administrative privileges):h](h&RPM-based Linux distributions include }(hj!h(hh%Nh'Nubhg)}(h"`Fedora `_h]hFedora}(hj)h(hh%Nh'Nubah}(h]h]h]h ]h"]nameFedorajmhttps://getfedora.org/uh$hfhj!ubh9)}(h h]h}(h]fedoraah]h]fedoraah ]h"]refurij9uh$h8j|Khj!ubh, }(hj!h(hh%Nh'Nubhg)}(h#`CentOS `_h]hCentOS}(hjKh(hh%Nh'Nubah}(h]h]h]h ]h"]nameCentOSjmhttps://www.centos.org/uh$hfhj!ubh9)}(h h]h}(h]centosah]h]centosah ]h"]refurij[uh$h8j|Khj!ubh and }(hj!h(hh%Nh'Nubhg)}(h'`openSUSE `_h]hopenSUSE}(hjmh(hh%Nh'Nubah}(h]h]h]h ]h"]nameopenSUSEjmhttps://www.opensuse.org/uh$hfhj!ubh9)}(h h]h}(h]opensuseah]h]h ]opensuseah"]refurij}uh$h8j|Khj!ubh operating systems. Install the prerequisite programs, including any dependencies and others that we have found to be missing in the core distribution but must be installed, i.e. (requires administrative privileges):}(hj!h(hh%Nh'Nubeh}(h]h]h]h ]h"]uh$h\h%hFh'K-hjh(hubj)}(hD$ sudo zypper install gcc-fortran libX11-devel csh tcsh ftp hostnameh]hD$ sudo zypper install gcc-fortran libX11-devel csh tcsh ftp hostname}hjsbah}(h]h]h]h ]h"]jjjjconsolej}uh$jh%hFh'K0hjh(hubh9)}(h.. _qsg_macos:h]h}(h]h]h]h ]h"]hD qsg-macosuh$h8h'K9hjh(hh%hFubeh}(h](rpm-based-linuxjeh]h](rpm-based linuxqsg_rpmeh ]h"]uh$hGhhIh(hh%hFh'K+j}jjsj}jjsubhH)}(hhh](hM)}(hmacOSh]hmacOS}(hjh(hh%Nh'Nubah}(h]h]h]h ]h"]uh$hLhjh(hh%hFh'K8ubh])}(hmacOS (previously Mac OS X) requires the installation of Command Line Tools for Xcode, a Fortran compiler and XQuartz. The simplest way to install Command Line Tools for Xcode is to open a Terminal window and run:h]hmacOS (previously Mac OS X) requires the installation of Command Line Tools for Xcode, a Fortran compiler and XQuartz. The simplest way to install Command Line Tools for Xcode is to open a Terminal window and run:}(hjh(hh%Nh'Nubah}(h]h]h]h ]h"]uh$h\h%hFh'K:hjh(hubj)}(h$ xcode-select --installh]h$ xcode-select --install}hjsbah}(h]h]h]h ]h"]jjjjconsolej}uh$jh%hFh'K=hjh(hubh])}(hXThis will download and install core command line programs, including a C compiler, and any dependencies. A Fortran compiler is not included but you may install gfortran from a standard installer (:file:`.dmg`) file available from the `GCC Wiki web page `_. Install the X Windows libraries and headers with `XQuartz `_, which is available for download as a standard installer (:file:`.dmg`) file.h](hThis will download and install core command line programs, including a C compiler, and any dependencies. A Fortran compiler is not included but you may install gfortran from a standard installer (}(hjh(hh%Nh'Nubh literal)}(h :file:`.dmg`h]h.dmg}(hjh(hh%Nh'Nubah}(h]h]fileah]h ]h"]rolefileuh$jhjubh) file available from the }(hjh(hh%Nh'Nubhg)}(hF`GCC Wiki web page `_h]hGCC Wiki web page}(hj h(hh%Nh'Nubah}(h]h]h]h ]h"]nameGCC Wiki web pagejm/https://gcc.gnu.org/wiki/GFortranBinaries#MacOSuh$hfhjubh9)}(h2 h]h}(h]gcc-wiki-web-pageah]h]gcc wiki web pageah ]h"]refurijuh$h8j|Khjubh3. Install the X Windows libraries and headers with }(hjh(hh%Nh'Nubhg)}(h%`XQuartz `_h]hXQuartz}(hj+h(hh%Nh'Nubah}(h]h]h]h ]h"]nameXQuartzjmhttps://www.xquartz.org/uh$hfhjubh9)}(h h]h}(h]xquartzah]h]xquartzah ]h"]refurij;uh$h8j|Khjubh;, which is available for download as a standard installer (}(hjh(hh%Nh'Nubj)}(h :file:`.dmg`h]h.dmg}(hjMh(hh%Nh'Nubah}(h]h]fileah]h ]h"]rolefileuh$jhjubh) file.}(hjh(hh%Nh'Nubeh}(h]h]h]h ]h"]uh$h\h%hFh'KAhjh(hubh9)}(h.. _qsg_windows:h]h}(h]h]h]h ]h"]hD qsg-windowsuh$h8h'KJhjh(hh%hFubeh}(h](macosjeh]h](macos qsg_macoseh ]h"]uh$hGhhIh(hh%hFh'K8j}jyjsj}jjsubhH)}(hhh](hM)}(hWindowsh]hWindows}(hjh(hh%Nh'Nubah}(h]h]h]h ]h"]uh$hLhj~h(hh%hFh'KIubh])}(hXRecent releases of Windows 10 and above may install and run the `Windows Subsystem for Linux `_. See the `Microsoft Docs installation guide `_ for details. Once complete, install required packages following the instructions for Linux distributions, above, e.g. for :ref:`qsg_debian` if you install and use the `Ubuntu `_ or `Debian `_ package, or for :ref:`qsg_rpm` if you install and use the `openSUSE `_ package.h](h@Recent releases of Windows 10 and above may install and run the }(hjh(hh%Nh'Nubhg)}(hS`Windows Subsystem for Linux `_h]hWindows Subsystem for Linux}(hjh(hh%Nh'Nubah}(h]h]h]h ]h"]nameWindows Subsystem for Linuxjm2https://docs.microsoft.com/en-us/windows/wsl/aboutuh$hfhjubh9)}(h5 h]h}(h]windows-subsystem-for-linuxah]h]windows subsystem for linuxah ]h"]refurijuh$h8j|Khjubh . See the }(hjh(hh%Nh'Nubhg)}(ha`Microsoft Docs installation guide `_h]h!Microsoft Docs installation guide}(hjh(hh%Nh'Nubah}(h]h]h]h ]h"]name!Microsoft Docs installation guidejm:https://docs.microsoft.com/en-us/windows/wsl/install-win10uh$hfhjubh9)}(h= h]h}(h]!microsoft-docs-installation-guideah]h]!microsoft docs installation guideah ]h"]refurijuh$h8j|Khjubh{ for details. Once complete, install required packages following the instructions for Linux distributions, above, e.g. for }(hjh(hh%Nh'Nubj3)}(h:ref:`qsg_debian`h]j9)}(hjh]h qsg_debian}(hjh(hh%Nh'Nubah}(h]h](jDstdstd-refeh]h ]h"]uh$j8hjubah}(h]h]h]h ]h"]refdocjQ refdomainjreftyperef refexplicitrefwarnjW qsg_debianuh$j2h%hFh'KKhjubh if you install and use the }(hjh(hh%Nh'Nubhg)}(h:`Ubuntu `_h]hUbuntu}(hjh(hh%Nh'Nubah}(h]h]h]h ]h"]nameUbuntujm.https://apps.microsoft.com/detail/9pdxgncfsczvuh$hfhjubh9)}(h1 h]h}(h]id1ah]h]h ]jah"]refurijuh$h8j|Khjubh or }(hjh(hh%Nh'Nubhg)}(h:`Debian `_h]hDebian}(hj h(hh%Nh'Nubah}(h]h]h]h ]h"]nameDebianjm.https://apps.microsoft.com/detail/9msvkqc78pk6uh$hfhjubh9)}(h1 h]h}(h]debianah]h]debianah ]h"]refurij0uh$h8j|Khjubh package, or for }(hjh(hh%Nh'Nubj3)}(h:ref:`qsg_rpm`h]j9)}(hjDh]hqsg_rpm}(hjFh(hh%Nh'Nubah}(h]h](jDstdstd-refeh]h ]h"]uh$j8hjBubah}(h]h]h]h ]h"]refdocjQ refdomainjPreftyperef refexplicitrefwarnjWqsg_rpmuh$j2h%hFh'KKhjubh if you install and use the }hjsbhg)}(h<`openSUSE `_h]hopenSUSE}(hjfh(hh%Nh'Nubah}(h]h]h]h ]h"]nameopenSUSEjm.https://apps.microsoft.com/detail/9mssk2zxxn11uh$hfhjubh9)}(h1 h]h}(h]id2ah]h]h ]jah"]refurijvuh$h8j|Khjubh package.}(hjh(hh%Nh'Nubeh}(h]h]h]h ]h"]uh$h\h%hFh'KKhj~h(hubh])}(hXOtherwise we recommend installing a virtual machine (e.g. `VirtualBox `_ or `VMWare Workstation Player `_), which requires the installation of a regular Linux distribution (e.g. `Ubuntu `_ to run via the virtual machine. GAMIT/GLOBK may then be installed and run on this virtual machine operating system, again following the instructions for the relevant Linux distribution, above.h](h:Otherwise we recommend installing a virtual machine (e.g. }(hjh(hh%Nh'Nubhg)}(h+`VirtualBox `_h]h VirtualBox}(hjh(hh%Nh'Nubah}(h]h]h]h ]h"]name VirtualBoxjmhttps://www.virtualbox.org/uh$hfhjubh9)}(h h]h}(h] virtualboxah]h] virtualboxah ]h"]refurijuh$h8j|Khjubh or }(hjh(hh%Nh'Nubhg)}(hG`VMWare Workstation Player `_h]hVMWare Workstation Player}(hjh(hh%Nh'Nubah}(h]h]h]h ]h"]nameVMWare Workstation Playerjm(https://www.vmware.com/go/downloadplayeruh$hfhjubh9)}(h+ h]h}(h]vmware-workstation-playerah]h]vmware workstation playerah ]h"]refurijuh$h8j|KhjubhI), which requires the installation of a regular Linux distribution (e.g. }(hjh(hh%Nh'Nubhg)}(h2`Ubuntu `_h]hUbuntu}(hjh(hh%Nh'Nubah}(h]h]h]h ]h"]nameUbuntujm&http://www.ubuntu.com/download/desktopuh$hfhjubh9)}(h) h]h}(h]id3ah]h]h ]ubuntuah"]refurijuh$h8j|Khjubh to run via the virtual machine. GAMIT/GLOBK may then be installed and run on this virtual machine operating system, again following the instructions for the relevant Linux distribution, above.}(hjh(hh%Nh'Nubeh}(h]h]h]h ]h"]uh$h\h%hFh'KOhj~h(hubh])}(hXdPreviously we had preferred to use `Cygwin `_, which is a Linux emulator for Windows, for installing and running GAMIT/GLOBK. To install Cygwin, download and run :download:`setup-x86.exe ` (for 32-bit computers) or :download:`setup-x86_64.exe ` (64-bit) to begin installation. Generally, the defaults shown throughout the installation process are adequate and need not be changed. There are, however, specific packages which are required in addition to the default Cygwin packages that are installed. These are at least:h](h#Previously we had preferred to use }(hjh(hh%Nh'Nubhg)}(h`Cygwin `_h]hCygwin}(hj h(hh%Nh'Nubah}(h]h]h]h ]h"]nameCygwinjmhttps://cygwin.com/uh$hfhjubh9)}(h h]h}(h]cygwinah]h]cygwinah ]h"]refurijuh$h8j|Khjubhu, which is a Linux emulator for Windows, for installing and running GAMIT/GLOBK. To install Cygwin, download and run }(hjh(hh%Nh'Nubhdownload_reference)}(h<:download:`setup-x86.exe `h]j)}(hj/h]h setup-x86.exe}(hj1h(hh%Nh'Nubah}(h]h](jDdownloadeh]h ]h"]uh$jhj-ubah}(h]h]h]h ]h"]refdocjQ refdomainhreftypej; refexplicitrefwarnjW https://cygwin.com/setup-x86.exejmjJuh$j+h%hFh'KRhjubh (for 32-bit computers) or }(hjh(hh%Nh'Nubj,)}(hB:download:`setup-x86_64.exe `h]j)}(hjQh]hsetup-x86_64.exe}(hjSh(hh%Nh'Nubah}(h]h](jDdownloadeh]h ]h"]uh$jhjOubah}(h]h]h]h ]h"]refdocjQ refdomainhreftypej] refexplicitrefwarnjW#https://cygwin.com/setup-x86_64.exejmjluh$j+h%hFh'KRhjubhX (64-bit) to begin installation. Generally, the defaults shown throughout the installation process are adequate and need not be changed. There are, however, specific packages which are required in addition to the default Cygwin packages that are installed. These are at least:}(hjh(hh%Nh'Nubeh}(h]h]h]h ]h"]uh$h\h%hFh'KRhj~h(hubh)}(hhh](h)}(hDevel/gcc-fortran (allowing the required dependencies to be installed will ensure the GCC core packages are also installed, including a C compiler)h]h])}(hj|h]hDevel/gcc-fortran (allowing the required dependencies to be installed will ensure the GCC core packages are also installed, including a C compiler)}(hj~h(hh%Nh'Nubah}(h]h]h]h ]h"]uh$h\h%hFh'KXhjzubah}(h]h]h]h ]h"]uh$hhjwh(hh%hFh'Nubh)}(h Devel/makeh]h])}(hjh]h Devel/make}(hjh(hh%Nh'Nubah}(h]h]h]h ]h"]uh$h\h%hFh'KYhjubah}(h]h]h]h ]h"]uh$hhjwh(hh%hFh'Nubh)}(hMath/bch]h])}(hjh]hMath/bc}(hjh(hh%Nh'Nubah}(h]h]h]h ]h"]uh$h\h%hFh'KZhjubah}(h]h]h]h ]h"]uh$hhjwh(hh%hFh'Nubh)}(h Shells/tcshh]h])}(hjh]h Shells/tcsh}(hjh(hh%Nh'Nubah}(h]h]h]h ]h"]uh$h\h%hFh'K[hjubah}(h]h]h]h ]h"]uh$hhjwh(hh%hFh'Nubh)}(hX11/libX11-devel h]h])}(hX11/libX11-develh]hX11/libX11-devel}(hjh(hh%Nh'Nubah}(h]h]h]h ]h"]uh$h\h%hFh'K\hjubah}(h]h]h]h ]h"]uh$hhjwh(hh%hFh'Nubeh}(h]h]h]h ]h"]jjuh$hh%hFh'KXhj~h(hubh])}(hX;(One may search for the appropriate packages from the `Cygwin package search `_. Search for "libX11.*" and "Xlib.h" for the X11 libraries and header file, respectively, to find the appropriate package.) We also highly recommend installing the :file:`X11/xinit` package and its dependencies. This will provide an X Windows environment from which one can open and use, for example, Emacs for creating or editing text files. This is important given the different end-of-line characters between Windows and other systems (Unix, Linux and macOS).h](h6(One may search for the appropriate packages from the }(hjh(hh%Nh'Nubhg)}(h7`Cygwin package search `_h]hCygwin package search}(hjh(hh%Nh'Nubah}(h]h]h]h ]h"]nameCygwin package searchjmhttps://cygwin.com/packages/uh$hfhjubh9)}(h h]h}(h]cygwin-package-searchah]h]cygwin package searchah ]h"]refurij uh$h8j|Khjubh. Search for “libX11.*” and “Xlib.h” for the X11 libraries and header file, respectively, to find the appropriate package.) We also highly recommend installing the }(hjh(hh%Nh'Nubj)}(h:file:`X11/xinit`h]h X11/xinit}(hjh(hh%Nh'Nubah}(h]h]fileah]h ]h"]rolefileuh$jhjubhX package and its dependencies. This will provide an X Windows environment from which one can open and use, for example, Emacs for creating or editing text files. This is important given the different end-of-line characters between Windows and other systems (Unix, Linux and macOS).}(hjh(hh%Nh'Nubeh}(h]h]h]h ]h"]uh$h\h%hFh'K^hj~h(hubh9)}(h.. _qsg_dc_access:h]h}(h]h]h]h ]h"]hD qsg-dc-accessuh$h8h'Kihj~h(hh%hFubeh}(h](windowsjreh]h](windows qsg_windowseh ]h"]uh$hGhhIh(hh%hFh'KIj}jJjhsj}jrjhsubhH)}(hhh](hM)}(hOAccess to the CDDIS, EarthScope (Formerly UNAVCO) and SOPAC Global Data Centersh]hOAccess to the CDDIS, EarthScope (Formerly UNAVCO) and SOPAC Global Data Centers}(hjRh(hh%Nh'Nubah}(h]h]h]h ]h"]uh$hLhjOh(hh%hFh'Khubh])}(hX3Access to the CDDIS global data server via anonymous FTP was discontinued after 31 October 2020. CDDIS now needs to be accessed via authenticated secure HTTP or anonymous secure FTP. Several of our scripts which download data for use during GNSS data processing have been updated to accommodate this change.h]hX3Access to the CDDIS global data server via anonymous FTP was discontinued after 31 October 2020. CDDIS now needs to be accessed via authenticated secure HTTP or anonymous secure FTP. Several of our scripts which download data for use during GNSS data processing have been updated to accommodate this change.}(hj`h(hh%Nh'Nubah}(h]h]h]h ]h"]uh$h\h%hFh'KjhjOh(hubh])}(hX$We recommend you register to use authenticated secure HTTP by creating a NASA Earthdata account at https://urs.earthdata.nasa.gov/. Then you must include this information in a :file:`.netrc` file (note the dot at the beginning of the file name) in your home directory with the following line:h](hcWe recommend you register to use authenticated secure HTTP by creating a NASA Earthdata account at }(hjnh(hh%Nh'Nubhg)}(hhttps://urs.earthdata.nasa.gov/h]hhttps://urs.earthdata.nasa.gov/}(hjvh(hh%Nh'Nubah}(h]h]h]h ]h"]refurijxuh$hfhjnubh.. Then you must include this information in a }(hjnh(hh%Nh'Nubj)}(h:file:`.netrc`h]h.netrc}(hjh(hh%Nh'Nubah}(h]h]fileah]h ]h"]rolefileuh$jhjnubhf file (note the dot at the beginning of the file name) in your home directory with the following line:}(hjnh(hh%Nh'Nubeh}(h]h]h]h ]h"]uh$h\h%hFh'KnhjOh(hubj)}(hCmachine urs.earthdata.nasa.gov login password h]hCmachine urs.earthdata.nasa.gov login password }hjsbah}(h]h]h]h ]h"]jjjjtextj}uh$jh%hFh'KqhjOh(hubh])}(hXwhere :content:`` is replaced by your Earthdata username and :content:`` is replaced by your Earthdata password. (Do not use quotation marks or brackets around your :content:`` or :content:`` in this line in :file:`.netrc`.) If you do not wish to create an Earthdata account, you may still access the CDDIS archive via anonymous secure FTP but this requires your system to have :command:`curl` version ≥ 7.11.0 or :command:`wget` version ≥ 1.18.h](hwhere }(hjh(hh%Nh'Nubj)}(h:content:``h]h }(hjh(hh%Nh'Nubah}(h]h](code highlightcontenttexteh]h ]h"]languagejuh$jhjubh, is replaced by your Earthdata username and }(hjh(hh%Nh'Nubj)}(h:content:``h]h }(hjh(hh%Nh'Nubah}(h]h](jjjjeh]h ]h"]languagejuh$jhjubh] is replaced by your Earthdata password. (Do not use quotation marks or brackets around your }(hjh(hh%Nh'Nubj)}(h:content:``h]h }(hjh(hh%Nh'Nubah}(h]h](jjjjeh]h ]h"]languagejuh$jhjubh or }(hjh(hh%Nh'Nubj)}(h:content:``h]h }(hjh(hh%Nh'Nubah}(h]h](jjjjeh]h ]h"]languagejuh$jhjubh in this line in }(hjh(hh%Nh'Nubj)}(h:file:`.netrc`h]h.netrc}(hj h(hh%Nh'Nubah}(h]h]fileah]h ]h"]rolefileuh$jhjubh.) If you do not wish to create an Earthdata account, you may still access the CDDIS archive via anonymous secure FTP but this requires your system to have }(hjh(hh%Nh'Nubhliteral_strong)}(h:command:`curl`h]hcurl}(hj#h(hh%Nh'Nubah}(h]h]commandah]h ]h"]uh$j!hjubh version ≥ 7.11.0 or }(hjh(hh%Nh'Nubj")}(h:command:`wget`h]hwget}(hj6h(hh%Nh'Nubah}(h]h]j.ah]h ]h"]uh$j!hjubh version ≥ 1.18.}(hjh(hh%Nh'Nubeh}(h]h]h]h ]h"]uh$h\h%hFh'KuhjOh(hubh])}(hWe also recommend adding a similar line in a :file:`.netrc` file in your home directory to provide the CDDIS secure FTP server and the SOPAC server with the information they request:h](h-We also recommend adding a similar line in a }(hjNh(hh%Nh'Nubj)}(h:file:`.netrc`h]h.netrc}(hjVh(hh%Nh'Nubah}(h]h]fileah]h ]h"]rolefileuh$jhjNubh{ file in your home directory to provide the CDDIS secure FTP server and the SOPAC server with the information they request:}(hjNh(hh%Nh'Nubeh}(h]h]h]h ]h"]uh$h\h%hFh'KyhjOh(hubj)}(h{machine gdc.cddis.eosdis.nasa.gov login anonymous password machine garner.ucsd.edu login anonymous password h]h{machine gdc.cddis.eosdis.nasa.gov login anonymous password machine garner.ucsd.edu login anonymous password }hjqsbah}(h]h]h]h ]h"]jjjjtextj}uh$jh%hFh'K{hjOh(hubh])}(hrwhere :content:`` is replaced by your email address (again, without quotation marks or brackets around it).h](hwhere }(hjh(hh%Nh'Nubj)}(h:content:``h]h}(hjh(hh%Nh'Nubah}(h]h](jjjjeh]h ]h"]languagejuh$jhjubhZ is replaced by your email address (again, without quotation marks or brackets around it).}(hjh(hh%Nh'Nubeh}(h]h]h]h ]h"]uh$h\h%hFh'KhjOh(hubh])}(hXWe recommend installing the `EarthScope Command Line Interface (CLI) `_ to download data and products from EarthScope (formerly UNAVCO). You must have Python version 3.7 or above available on your operating system. We suggest installing the EarthScope CLI in a virtual environment in a hidden directory, e.g. :file:`.earthscope-cli`, in your home directory and adding :file:`$HOME/.earthscope-cli/bin` to your :envvar:`PATH` environment variable or linking the :program:`es` program to a directory you already have in your :envvar:`PATH`, e.g. :file:`~/gg/com/`, so GAMIT/GLOBK may run it, e.g.h](hWe recommend installing the }(hjh(hh%Nh'Nubhg)}(h``EarthScope Command Line Interface (CLI) `_h]h'EarthScope Command Line Interface (CLI)}(hjh(hh%Nh'Nubah}(h]h]h]h ]h"]name'EarthScope Command Line Interface (CLI)jm3https://gitlab.com/earthscope/public/earthscope-cliuh$hfhjubh9)}(h6 h]h}(h]%earthscope-command-line-interface-cliah]h]'earthscope command line interface (cli)ah ]h"]refurijuh$h8j|Khjubh to download data and products from EarthScope (formerly UNAVCO). You must have Python version 3.7 or above available on your operating system. We suggest installing the EarthScope CLI in a virtual environment in a hidden directory, e.g. }(hjh(hh%Nh'Nubj)}(h:file:`.earthscope-cli`h]h.earthscope-cli}(hjh(hh%Nh'Nubah}(h]h]fileah]h ]h"]rolefileuh$jhjubh$, in your home directory and adding }(hjh(hh%Nh'Nubj)}(h!:file:`$HOME/.earthscope-cli/bin`h]h$HOME/.earthscope-cli/bin}(hjh(hh%Nh'Nubah}(h]h]fileah]h ]h"]rolefileuh$jhjubh to your }(hjh(hh%Nh'Nubhindex)}(hhh]h}(h]h]h]h ]h"]entries]((singlePATHindex-0hNt(jenvironment variable; PATHjhNteuh$jhjubh9)}(hhh]h}(h]jah]h]h ]h"]uh$h8hjubj3)}(h:envvar:`PATH`h]j)}(hjh]hPATH}(hjh(hh%Nh'Nubah}(h]h](jDstd std-envvareh]h ]h"]uh$jhjubah}(h]h]h]h ]h"]refdocjQ refdomainj reftypeenvvar refexplicitrefwarnjWjuh$j2h%hFh'Khjubh% environment variable or linking the }(hjh(hh%Nh'Nubj")}(h :program:`es`h]hes}(hj5h(hh%Nh'Nubah}(h]h]programah]h ]h"]uh$j!hjubh1 program to a directory you already have in your }(hjh(hh%Nh'Nubj)}(hhh]h}(h]h]h]h ]h"]j]((jPATHindex-1hNt(jenvironment variable; PATHjShNteuh$jhjubh9)}(hhh]h}(h]jSah]h]h ]h"]uh$h8hjubj3)}(h:envvar:`PATH`h]j)}(hjbh]hPATH}(hjdh(hh%Nh'Nubah}(h]h](jDstd std-envvareh]h ]h"]uh$jhj`ubah}(h]h]h]h ]h"]refdocjQ refdomainjnreftypeenvvar refexplicitrefwarnjWjRuh$j2h%hFh'Khjubh, e.g. }(hjh(hh%Nh'Nubj)}(h:file:`~/gg/com/`h]h ~/gg/com/}(hjh(hh%Nh'Nubah}(h]h]fileah]h ]h"]rolefileuh$jhjubh!, so GAMIT/GLOBK may run it, e.g.}(hjh(hh%Nh'Nubeh}(h]h]h]h ]h"]uh$h\h%hFh'KhjOh(hubj)}(h$ cd ~ $ mkdir .earthscope-cli $ python3 -m venv .earthscope-cli $ . .earthscope-cli/bin/activate $ pip install earthscope-cli $ ln -s ~/.earthscope-cli/bin/es ~/gg/com/esh]h$ cd ~ $ mkdir .earthscope-cli $ python3 -m venv .earthscope-cli $ . .earthscope-cli/bin/activate $ pip install earthscope-cli $ ln -s ~/.earthscope-cli/bin/es ~/gg/com/es}hjsbah}(h]h]h]h ]h"]jjjjconsolej}uh$jh%hFh'KhjOh(hubh])}(hXSee https://cddis.nasa.gov/Data_and_Derived_Products/CDDIS_Archive_Access.html (CDDIS), https://www.unavco.org/data/gps-gnss/file-server/file-server-access-examples.html (EarthScope, formerly UNAVCO) and http://garner.ucsd.edu/ (SOPAC) for more information.h](hSee }(hjh(hh%Nh'Nubhg)}(hJhttps://cddis.nasa.gov/Data_and_Derived_Products/CDDIS_Archive_Access.htmlh]hJhttps://cddis.nasa.gov/Data_and_Derived_Products/CDDIS_Archive_Access.html}(hjh(hh%Nh'Nubah}(h]h]h]h ]h"]refurijuh$hfhjubh (CDDIS), }(hjh(hh%Nh'Nubhg)}(hQhttps://www.unavco.org/data/gps-gnss/file-server/file-server-access-examples.htmlh]hQhttps://www.unavco.org/data/gps-gnss/file-server/file-server-access-examples.html}(hjh(hh%Nh'Nubah}(h]h]h]h ]h"]refurijuh$hfhjubh# (EarthScope, formerly UNAVCO) and }(hjh(hh%Nh'Nubhg)}(hhttp://garner.ucsd.edu/h]hhttp://garner.ucsd.edu/}(hjh(hh%Nh'Nubah}(h]h]h]h ]h"]refurijuh$hfhjubh (SOPAC) for more information.}(hjh(hh%Nh'Nubeh}(h]h]h]h ]h"]uh$h\h%hFh'KhjOh(hubeh}(h](Laccess-to-the-cddis-earthscope-formerly-unavco-and-sopac-global-data-centersjCeh]h](Oaccess to the cddis, earthscope (formerly unavco) and sopac global data centers qsg_dc_accesseh ]h"]uh$hGhhIh(hh%hFh'Khj}jj9sj}jCj9subeh}(h]( prerequisiteshEeh]h]( prerequisites qsg_prereqeh ]h"]uh$hGhhh(hh%hFh'Kj}j h:sj}hEh:subeh}(h]h]h]h ]h"]sourcehFtranslation_progress}(totalK translatedKuuh$hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(outputNhLN generatorN datestampN source_linkN source_urlN toc_backlinksentryfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerj3 error_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcehF _destinationN _config_files]file_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}(hh h5h)usubstitution_names}(relhdateh5urefnames}refids}(hE]h:aj]jaj]jaj]jaj]jajr]jhajC]j9aunameids}(j hEj j jxjujjj jj jubuntuNjjjjjCj@jejbopensuseNjyjjxjuj#j jEjBjJjrjIjFjjjjj:j7jjjjj#j jjjjCjjjju nametypes}(j j jxjj j j jjjCjej jyjxj#jEjJjIjjj:jjj#jjjjuh}(hEhIj hIjujojjjjjjjjjjjjj@j:jbj\jj~jjjujj jjBj<jrj~jFj~jjjjjjj7j1j}jwjjjjjjj jjj jCjOjjOjjjj jSjWu footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}jA KsRparse_messages](h system_message)}(hhh]h])}(h)Duplicate explicit target name: "ubuntu".h]h-Duplicate explicit target name: “ubuntu”.}(hj h(hh%Nh'Nubah}(h]h]h]h ]h"]uh$h\hj ubah}(h]h]h]h ]h"]jalevelKtypeWARNINGsourcehFlineKuh$j hj~h(hh%hFh'KMubj )}(hhh]h])}(h+Duplicate explicit target name: "opensuse".h]h/Duplicate explicit target name: “opensuse”.}(hj h(hh%Nh'Nubah}(h]h]h]h ]h"]uh$h\hj ubah}(h]h]h]h ]h"]j}alevelKtypej sourcehFlineKuh$j hj~h(hh%hFh'KMubj )}(hhh]h])}(h)Duplicate explicit target name: "ubuntu".h]h-Duplicate explicit target name: “ubuntu”.}(hj h(hh%Nh'Nubah}(h]h]h]h ]h"]uh$h\hj ubah}(h]h]h]h ]h"]jalevelKtypej sourcehFlineKuh$j hj~h(hh%hFh'KPubetransform_messages](j )}(hhh]h])}(hhh]h0Hyperlink target "qsg-prereq" is not referenced.}hj sbah}(h]h]h]h ]h"]uh$h\hj ubah}(h]h]h]h ]h"]levelKtypeINFOsourcehFlineKuh$j ubj )}(hhh]h])}(hhh]h/Hyperlink target "qsg-linux" is not referenced.}hj sbah}(h]h]h]h ]h"]uh$h\hj ubah}(h]h]h]h ]h"]levelKtypej sourcehFlineKuh$j ubj )}(hhh]h])}(hhh]h0Hyperlink target "qsg-debian" is not referenced.}hj- sbah}(h]h]h]h ]h"]uh$h\hj* ubah}(h]h]h]h ]h"]levelKtypej sourcehFlineKuh$j ubj )}(hhh]h])}(hhh]h-Hyperlink target "qsg-rpm" is not referenced.}hjG sbah}(h]h]h]h ]h"]uh$h\hjD ubah}(h]h]h]h ]h"]levelKtypej sourcehFlineK,uh$j ubj )}(hhh]h])}(hhh]h/Hyperlink target "qsg-macos" is not referenced.}hja sbah}(h]h]h]h ]h"]uh$h\hj^ ubah}(h]h]h]h ]h"]levelKtypej sourcehFlineK9uh$j ubj )}(hhh]h])}(hhh]h1Hyperlink target "qsg-windows" is not referenced.}hj{ sbah}(h]h]h]h ]h"]uh$h\hjx ubah}(h]h]h]h ]h"]levelKtypej sourcehFlineKJuh$j ubj )}(hhh]h])}(hhh]h3Hyperlink target "qsg-dc-access" is not referenced.}hj sbah}(h]h]h]h ]h"]uh$h\hj ubah}(h]h]h]h ]h"]levelKtypej sourcehFlineKiuh$j ubj )}(hhh]h])}(hhh]h-Hyperlink target "index-0" is not referenced.}hj sbah}(h]h]h]h ]h"]uh$h\hj ubah}(h]h]h]h ]h"]levelKtypej sourcehFlineKuh$j ubj )}(hhh]h])}(hhh]h-Hyperlink target "index-1" is not referenced.}hj sbah}(h]h]h]h ]h"]uh$h\hj ubah}(h]h]h]h ]h"]levelKtypej sourcehFlineKuh$j ube transformerN include_log] decorationNh(hub.