:orphan:

===================================================
System Environment Testing for WRF/WPS Installation
===================================================

In addition to requirements discussed in `Complete Installation of WRF & WPS <https://www2.mmm.ucar.edu/wrf/site/faq/full_installation.html>`_, the following tests may be used to check that required compilers and libraries are compatible:

|

|

.. important::
   If any of the below tests fail, WRF support is not able to provide guidance. Please contact a systems administrator at your institution for assistance.

|

|

Fortran and C Compatibility
===========================

From a terminal window, download and unpack the test.

|

.. code-block::

        wget https://www2.mmm.ucar.edu/wrf/OnLineTutorial/compile_tutorial/tar_files/Fortran_C_tests.tar

        tar -xf Fortran_C_tests.tar

|

Issue the following commands to run through the seven tests:

1. Fixed Format Fortran Test
----------------------------

.. code-block::
        
        gfortran TEST_1_fortran_only_fixed.f

        ./a.out

|

If successful, the following message should print to the screen:

**SUCCESS test 1 fortran only fixed format**

|

|

2. Free Format Fortran Test
---------------------------

.. code-block::

        gfortran TEST_2_fortran_only_free.f90

        ./a.out

|

If successful, the following message should print to the screen:

**Assume Fortran 2003: has FLUSH, ALLOCATABLE, derived type, and ISO C Binding** |br|
**SUCCESS test 2 fortran only free format**

|

|

3. C Test
---------

.. code-block::

        gcc TEST_3_c_only.c

        ./a.out

|

If successful, the following message should print to the screen:

**SUCCESS test 3 c only** 

|

|

4. Fortran Calling a C Function 
-------------------------------
*WRF's gcc and gfortran use different defaults, so both are forced to use 64 bit [-m64] when they are combined.*

.. code-block::

        gcc -c -m64 TEST_4_fortran+c_c.c

        gfortran -c -m64 TEST_4_fortran+c_f.f90

        gfortran -m64 TEST_4_fortran+c_f.o TEST_4_fortran+c_c.o

        ./a.out

|

If successful, the following message should print to the screen:

**C function called by Fortran** |br|
**Values are xx = 2.00 and ii = 1** |br|
**SUCCESS test 4 fortran calling c**

|

|

5. csh
------

.. code-block::

        ./TEST_csh.csh 

|

If successful, the following message should print to the screen:

**SUCCESS csh test** 

|

|

6. perl
-------

.. code-block::

        ./TEST_perl.pl 

|

If successful, the following message should print to the screen:

**SUCCESS perl test** 

|

|

7. sh
-----

.. code-block::

        ./TEST_sh.sh

|

If successful, the following message should print to the screen:

**SUCCESS sh test**

|

|

|

`Return to Complete Installation of WRF & WPS <https://www2.mmm.ucar.edu/wrf/site/faq/full_installation.html>`_

|

|

|

|

|