Committing date/time object and test_calendar

Also added a makefile to compile them with a lot of additional properties from ICAR
added io_routines and string routines from ICAR
Added yml stubs for readthedocs and travisCI work as well.

.travis.yml

@@ -0,0 +1,17 @@
+sudo: false
+language: fortran
+compiler:
+  - gfortran
+os:
+  - linux
+addons:
+  apt:
+    source:
+      - ubuntu-toolchain-r-test
+    packages:
+      - gfortran
+      - libnetcdf-dev
+script:
+  - sed -i "s|NCDF_PATH = /usr/local|NCDF_PATH = /usr|" makefile
+  - make test -j4
+  - make -j4

docs/index.md

@@ -0,0 +1,14 @@
+#Simple Circulation Based Downscaling code
+
+This code is designed to provide a simple statistical downscaling method relying on 
+regressions and statistical transformations from various inputs (e.g. precipitation, 
+humidity, wind, PCA, etc.) to various outputs (e.g. precipitation, temperature, etc.)
+
+##Requirements
+T.B.D
+
+##Developing
+T.B.D
+
+##Reference
+T.B.D.

mkdocs.yml

@@ -0,0 +1,4 @@
+site_name: circudown
+pages:
+- Home: index.md
+theme: readthedocs

src/build/.gitignore

@@ -0,0 +1,28 @@
+# Compiled Object files
+*.slo
+*.lo
+*.o
+*.obj
+
+# Precompiled Headers
+*.gch
+*.pch
+
+# Compiled Dynamic libraries
+*.so
+*.dylib
+*.dll
+
+# Fortran module files
+*.mod
+
+# Compiled Static libraries
+*.lai
+*.la
+*.a
+*.lib
+
+# Executables
+*.exe
+*.out
+*.app

src/makefile

@@ -0,0 +1,251 @@
+#
+# Basic makefile to compile the circulation downscaling code.  
+# 
+# To compile this code on your machine, edit the NCDF_PATH variable and the fortran compiler
+#
+
+FC=gfortran
+RM=/bin/rm
+CP=/bin/cp
+NCDF_PATH = /usr/local
+# LIBNETCDF = -L$(NCDF_PATH)/lib -lnetcdff -lnetcdf
+# INCNETCDF = -I$(NCDF_PATH)/include
+BUILD=build/
+
+###################################################################
+###################################################################
+#
+#	Try to identify the computer we are running on and set up library paths
+#
+###################################################################
+###################################################################
+NODENAME := $(shell uname -n)
+
+ifeq ($(NODENAME), Patthar.local)
+	NODENAME=Nomad.local
+endif
+ifeq ($(NODENAME), pakaldi.local)
+	NODENAME=Nomad.local
+endif
+ifeq ($(patsubst vpn%.ucar.edu,vpn.ucar.edu,$(NODENAME)), vpn.ucar.edu)
+	NODENAME=Nomad.local
+endif
+
+ifeq ($(NODENAME), Nomad.local)
+	FC=gfortran
+	NCDF_PATH=/usr/local
+endif
+
+ifeq ($(NODENAME), hydro-c1)
+	FC=ifort
+	# FC=gfortran
+	ifeq ($(FC), ifort)
+		NCDF_PATH = /opt/netcdf4-intel
+	endif
+	ifeq ($(FC), gfortran)
+		NCDF_PATH = /opt/netcdf4-gcc
+	endif
+endif
+
+###################################################################
+###################################################################
+#
+#	Compiler specific compilation flags
+#
+###################################################################
+###################################################################
+ifeq ($(FC), gfortran)
+	COMP=-fopenmp -lgomp -O3 -ffree-line-length-none -ftree-vectorize -fimplicit-none -funroll-loops -march=native  -fno-protect-parens # -ffast-math #-flto #
+	LINK=-fopenmp -lgomp
+	PREPROC=-cpp
+	MODOUTPUT=-J $(BUILD)
+endif
+# Intel fortran
+ifeq ($(FC), ifort)
+	COMP= -u -openmp -liomp5 -O3 -no-prec-div -xHost -ftz -fpe0
+	LINK= -openmp -liomp5
+	PREPROC=-fpp
+	MODOUTPUT=-module $(BUILD)
+endif
+# PGI fortran
+ifeq ($(FC), pgf90)
+	COMP=-O2 -mp -Mdclchk #-fast -O3 -mp -c -Mdclchk
+	LINK=-mp
+	PREPROC=-Mpreprocess
+	MODOUTPUT=-module $(BUILD)
+endif
+
+# Cray fortran
+ifeq ($(FC), ftn)
+	COMP= -h omp vector2 -O2 -eI
+	LINK= -fopenmp
+	PREPROC= -eZ
+	MODOUTPUT= -J $(BUILD) -em
+endif
+
+###################################################################
+###################################################################
+#
+# Various compiling options.  Set the MODE variable with "make MODE=debugslow" etc.
+#
+###################################################################
+###################################################################
+ifeq ($(MODE), debugslow)
+	ifeq ($(FC), ifort)
+		COMP= -debug -debug-parameters all -traceback -ftrapuv -g -fpe0 -u -check all -check noarg_temp_created -CB
+		LINK=
+	endif
+	ifeq ($(FC), gfortran)
+		COMP= -g -fbounds-check -fbacktrace -finit-real=nan -ffree-line-length-none
+		LINK=
+	endif
+	ifeq ($(FC), pgf90)
+		COMP= -g -Mbounds -Mlist -Minfo  -Mdclchk
+		LINK=
+	endif
+	ifeq ($(FC), ftn)
+		COMP=-h noomp -g -m 0 -R abcsp
+		LINK=-h noomp
+		PREPROC=-eZ
+		MODOUTPUT=-e m -J $(BUILD)
+	endif
+endif
+ifeq ($(MODE), debug)
+	ifeq ($(FC), ifort)
+		COMP= -debug -O1 -u -check all -check noarg_temp_created -traceback -fpe0 -fast-transcendentals -xhost
+		LINK=
+	endif
+	ifeq ($(FC), gfortran)
+		COMP= -O1 -g -fbounds-check -fbacktrace -finit-real=nan -ffree-line-length-none
+		LINK=
+	endif
+	ifeq ($(FC), pgf90)
+		COMP= -gopt -O1 -Mbounds -Mlist -Minfo  -Mdclchk
+		LINK=
+	endif
+	ifeq ($(FC), ftn)
+		COMP=-O1 -h noomp -g
+		LINK=-h noomp
+		PREPROC=-eZ
+		MODOUTPUT=-e m -J $(BUILD)
+	endif
+endif
+ifeq ($(MODE), debugompslow)
+	ifeq ($(FC), ifort)
+		# COMP= -openmp -liomp5 -debug -debug-parameters all -traceback -ftrapuv -g -fpe0 -c -u -check all -check noarg_temp_created -CB
+		COMP= -openmp -liomp5 -debug -u	-fpe0 -traceback -check all -check noarg_temp_created -fp-stack-check
+		LINK= -openmp -liomp5
+	endif
+	ifeq ($(FC), gfortran)
+		COMP= -fopenmp -lgomp -g -fbounds-check -fbacktrace -finit-real=nan -ffree-line-length-none
+		LINK= -fopenmp -lgomp
+	endif
+	ifeq ($(FC), pgf90)
+		COMP= -g -Mbounds -Mlist -Minfo -mp -Mdclchk
+		LINK= -mp
+	endif
+	ifeq ($(FC), ftn)
+		COMP= -g -m 0 -R abcsp
+		LINK=
+		PREPROC=-eZ
+		MODOUTPUT=-e m -J $(BUILD)
+	endif
+endif
+ifeq ($(MODE), debugomp)
+	ifeq ($(FC), ifort)
+		COMP= -openmp -liomp5 -debug -O3 -u -traceback -fpe0 -ftz -fast-transcendentals  -xHost #-check all -check noarg_temp_created -fpe0 -fast-transcendentals -xhost
+		LINK= -openmp -liomp5
+	endif
+	ifeq ($(FC), gfortran)
+		COMP= -fopenmp -lgomp -O1 -g -fbounds-check -fbacktrace -finit-real=nan -ffree-line-length-none
+		LINK= -fopenmp -lgomp
+	endif
+	ifeq ($(FC), pgf90)
+		COMP= -g -O1 -Mbounds -Mlist -Minfo -mp -Mdclchk
+		LINK= -mp
+	endif
+	ifeq ($(FC), ftn)
+		COMP=-O1 -g
+		LINK=
+		PREPROC=-eZ
+		MODOUTPUT=-e m -J $(BUILD)
+	endif
+endif
+
+PROF=
+ifeq ($(MODE), profile)
+	ifeq ($(FC), ifort)
+		PROF=-pg -debug inline-debug-info -shared-intel
+		COMP= -u -openmp -liomp5 -O3 -no-prec-div -xHost -ftz #because -fast includes -static # not available in ifort <13 -align array64byte
+	endif
+	ifeq ($(FC), gfortran)
+		PROF=-g
+	endif
+endif
+ifeq ($(MODE), fast) # WARNING -ipo (included in -fast) takes forever for very little gain, and this may be unstable
+	ifeq ($(FC), ifort)
+		COMP= -u -openmp -liomp5 -fast -ftz #-fast-transcendentals # not available in ifort <13: -align array64byte
+	endif
+endif
+
+###################################################################
+###################################################################
+#
+# Should not need to edit anything below this line
+#
+###################################################################
+###################################################################
+# copy required libraries into a directory accessible on compute nodes and set LD_RUN_PATH e.g.
+# export LD_RUN_PATH=$LD_RUN_PATH:/path/to/netcdf/libraries/lib:/path/to/fftw/libraries/lib
+
+# flags forall
+FCFLAGS = $(COMP) -I$(NCDF_PATH)/include -I$(BUILD)
+# libraries needed for linking
+LDFLAGS = -L$(NCDF_PATH)/lib -lnetcdf -lnetcdff
+
+OBJS =  \
+	$(BUILD)time.o            # \
+	# $(BUILD)data_structures.o \
+	# $(BUILD)string.o          \
+	# $(BUILD)numerics.o        \
+	# $(BUILD)io_routines.o     \
+	# $(BUILD)normalize.o       \
+	# $(BUILD)read_config.o     \
+	# $(BUILD)observations.o    \
+	# $(BUILD)coefficients.o    \
+	# $(BUILD)main.o
+
+
+CAL_TEST_OBJS =    			\
+    $(BUILD)time.o 			\
+	$(BUILD)test_calendar.o
+
+# "make" builds all
+all: test_calendar
+
+test: test_calendar
+
+test_calendar : $(CAL_TEST_OBJS)
+	$(FC) $(FCFLAGS) -o $@ $^ $(LDFLAGS)
+
+install: downscale
+	cp downscale ~/bin/
+
+downscale: $(OBJS)
+	$(FC) $(FCFLAGS) -o $@ $^ $(LDFLAGS)
+
+clean:
+	$(RM) $(BUILD)* 2>/dev/null ||:
+
+allclean:clean
+	$(RM) downscale test_calendar 2>/dev/null ||:
+
+# specify specific builds and dependencies. 
+$(BUILD)time.o: utilities/time.f90
+	$(FC) $(FCFLAGS) -c $< $(MODOUTPUT) -o $@
+
+$(BUILD)test_calendar.o: tests/test_calendar.f90 $(BUILD)time.o
+	$(FC) $(FCFLAGS) -c $< $(MODOUTPUT) -o $@
+
+$(BUILD)%.o: %.f90
+	$(FC) $(FCFLAGS) -c $< $(MODOUTPUT) -o $@