folder
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
obj
sqlite-amalgamation
sw_src @ 8533b82
testing.sagebrush.master
tools
.cproject
.gitignore
.gitmodules
.project
.syntastic_c_config
.travis.yml
DLM_change_log.txt
README.md
ST_defines.h
ST_environs.c
ST_functions.h
ST_globals.h
ST_grid.c
ST_indivs.c
ST_main.c
ST_mortality.c
ST_output.c
ST_params.c
ST_resgroups.c
ST_species.c
ST_sql.c
ST_stats.c
ST_steppe.h
ST_structs.h
appveyor.yml
makefile
stepwat_test_job.sh
sxw.c
sxw.h
sxw_environs.c
sxw_funcs.h
sxw_main.c
sxw_module.h
sxw_resource.c
sxw_soilwat.c
sxw_sql.c
sxw_tester.c
sxw_vars.h

README.md

Unix Windows Release License Coverage Downloads
Travis build status Appveyor build status github release license codecov status github downloads

STEPWAT2


Basic instructions for working with the code

  1. Clone (obtain code from online github repository): git clone --single-branch --recursive https://github.com/Burke-Lauenroth-Lab/STEPWAT2.git

  2. Change working directory to STEPWAT2 folder: cd STEPWAT2

  3. Compile the code (make an executable application): make

Other tasks:

  • Clean local repository, e.g., after having run some tests: git clean -d -f

  • Reset files to their online github repository version, i.e., overwrite changes made to local files: git reset --hard

  • Pull down/sync latest commits/version from github repository: git pull

Code development and pull-requests


Basic instruction for running a test project

  • Print a brief explanation of options:
./stepwat --help
> Usage: stepwat [-d startdir] [-f files.in] [-q] [-s] [-e] [-o] [-i] [-g]
>   -d : supply working directory (default=.)
>   -f : supply list of input files (default=files.in)
>   -q : quiet mode, don't print message to check logfile.
>   -s : use SOILWAT model for resource partitioning.
>   -e : echo initialization results to logfile
>   -o : write SOILWAT output to output files. Contains average over all iterations and standard deviation
>   -i : write soilwat output to output files for each iteration
>   -g : use gridded mode
  • Run the gridded version (-g) of STEPWAT2 using SOILWAT2 to drive the water cycle (-s):
cd testing.sagebrush.master/
./stepwat -f files.in -g -s
  • Run the non-gridded version of STEPWAT2 from the Stepwat_Inputs/ folder using SOILWAT2 to drive the water cycle (-s):
cd testing.sagebrush.master/Stepwat_Inputs/
./stepwat -f files.in -s
  • Run non-gridded version of STEPWAT using SOILWAT and output all variables passed between Stepwat and SOILWAT:
cd testing.sagebrush.master/Stepwat_Inputs/
./stepwat -s -f files.in -ssxwdebug.in
  • Run STEPPE (no SOILWAT2)
cd testing.sagebrush.master/Stepwat_Inputs/
./stepwat -f files.in
  • Run STEPPE (get SOILWAT output for all iterations and average)
cd testing.sagebrush.master/Stepwat_Inputs/
./stepwat -f files.in -o -i -s
  • Alternatively, use makefile targets (compile, copy, and execute in one command)
    • Non-gridded version, with SOILWAT2 water cycle, and with iteration and aggregated SOILWAT2-output:
      make bint_testing_nongridded
      
    • Gridded version with SOILWAT2 water cycle
      make bint_testing_gridded
      
    • If you need to clean up first, then run, e.g.,
      make cleanall bint_testing_nongridded
      

If switching to resource_partitioning_overhaul from another branch:

  • run
    git submodule update --init --recursive
    
    To ensure all submodules are updated correctly.

Note: repository renamed from StepWat to STEPWAT2 on Feb 23, 2017

All existing information should automatically be redirected to the new name.

Contributors are encouraged, however, to update local clones to point to the new URL, i.e.,

git remote set-url origin https://github.com/Burke-Lauenroth-Lab/STEPWAT2.git