A curated list of open technology projects to sustain a stable climate, energy supply, biodiversity and natural resources.

RHESSys

The Regional Hydro-Ecologic Simulation System.
https://github.com/RHESSys/RHESSys

Last synced: over 1 year ago
JSON representation

Acceptance Criteria

Repository metadata

The Regional Hydro-Ecologic Simulation System

README.md

+ TRUNK IS NOW THE DEFAULT BRANCH (REPLACING MASTER).
+ THE MASTER BRANCH WILL REMAIN FOR ARCHIVAL PURPOSES, BUT TRUNK SHOULD NOW BE USED AS THE MAIN BRANCH.
- SEE NEW CHANGES.    
- NEW CODE MAY NOT BE BACKWARD COMPATIBLE WITH YOUR CURRENT FILES.    
- PLEASE REVIEW INFORMATION ABOUT CHANGES ON THE WHAT'S NEW WIKI PAGE   

https://github.com/RHESSys/RHESSys/wiki/What's-New

RHESSys - The Regional Hydro-Ecologic Simulation System

Github is the new home for the RHESSys code repository.

The project homepage is at http://fiesta.bren.ucsb.edu/~rhessys/

The old SVN repository was at http://sourceforge.net/projects/rhessys/

Branches

The "develop" branch should be used for day-to-day development, with
RHESSys releases pushed to the "trunk" (formerly "master") branch periodically (for example
yearly).

Continuous Build and Test

We are using Travis-CI (http://travis-ci.org) to host our continuous integration efforts. Continuous integration helps us run our test suite upon every commit to this repository and let us know if and when we break the build.

The current build status is: Build Status

The above icon should be clickable and point to the latest build at Travis-CI: https://travis-ci.org/RHESSys/RHESSys

The .travis.yml configuration file defines how this project is hooked to Travis-CI. Github has a post-commit hook that is fired upon every commit to this repository. This post-commit hook uses an authentication token to login to Travis-CI and run the configured steps on a virtual machine. A return value of 0 means success and generates a 'green' status indicator (hopefully illustrated in the previous paragraph).

While the code is successfully compiling and running, there are a significant number of compiler warnings at this time:

$ GISBASE=/usr/lib/grass64 make 2>&1 | grep warning | wc -l
1233

Tests

The Create Flowpaths subproject has a growing suite of tests that can be run via make test. Tests are defined as .c files in the cf/test/src directory and will automatically get compiled and run by the make test target.

Code Coverage

The Create Flowpaths subproject also has a code coverage script. This script will use gcov and lcov to generate an HTML coverage report and show where more tests are needed by illustrating which lines of code are not being exercised by the existing tests.

Run the code coverage script:

cd cf/
./generate_coverage.sh

This will generate an HTML report in the newly formed cf/coverage_report/ directory. This new directory can be copied to a webserver or opened directly in your web browser.

Static Analysis

RHESSys can be analyzed by cppcheck in a few seconds with the following command:

cppcheck . --quiet

OR to see the output, and save the errors out to a textfile:

cppcheck . 2> err.txt
cat err.txt

$ wc -l err.txt
16

Static analysis will show things like memory leaks, out-of-bound references, and null pointers. It is generally assumed a good thing to have your code be "static analysis clean".


Owner metadata


Committers metadata

Last synced: over 1 year ago

Total Commits: 1,727
Total Committers: 46
Avg Commits per committer: 37.543
Development Distribution Score (DDS): 0.772

Commits in past year: 119
Committers in past year: 8
Avg Commits per committer in past year: 14.875
Development Distribution Score (DDS) in past year: 0.218

Name Email Commits
naomitague c****e@b****u 393
Brian Miles s****b@g****m 252
Xiaoli Chen h****l@g****m 160
mkenn m****n@u****u 153
William Burke b****4@g****m 120
LouisGraup l****p@g****m 111
Erin Hanan e****n@w****u 100
groulx g****x 84
ryanrbart r****t@e****u 53
aubreyd a****l@g****m 36
jschoate j****o@g****m 34
renjianning r****g@g****m 28
Erin Hanan e****n@E****l 23
ejhanan e****n@e****l 22
sbpcs p****r@b****u 17
Erin Hanan e****n@f****u 16
Terrell Russell t****l@g****m 13
Mingliang Liu m****u@w****u 13
esgarcia g****a@g****u 11
Janet Choate j****e@f****t 9
Janet Choate j****e@a****u 8
jjreyes j****s@e****u 7
Brian Miles b****s@u****u 7
Harry Johnson h****1@r****g 6
Janet Choate j****e@1****u 6
Janet Choate j****e@f****l 6
Janet Choate j****e@f****n 5
aquaph a****h 4
Linyuan Shang l****g@g****m 3
Janet Choate j****e@t****t 3
and 16 more...

Committer domains:


Issue and Pull Request metadata

Last synced: over 1 year ago

Total issues: 117
Total pull requests: 40
Average time to close issues: 2 months
Average time to close pull requests: 4 months
Total issue authors: 27
Total pull request authors: 14
Average comments per issue: 1.78
Average comments per pull request: 1.28
Merged pull request: 23
Bot issues: 0
Bot pull requests: 0

Past year issues: 2
Past year pull requests: 0
Past year average time to close issues: N/A
Past year average time to close pull requests: N/A
Past year issue authors: 2
Past year pull request authors: 0
Past year average comments per issue: 0.0
Past year average comments per pull request: 0
Past year merged pull request: 0
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/RHESSys/RHESSys

Top Issue Authors

  • selimnairb (31)
  • trel (9)
  • rahul1525 (8)
  • laurencelin (8)
  • Benxin1997 (7)
  • hcjiv1 (6)
  • jschoate (5)
  • koadean (5)
  • LuckyanTan (5)
  • CQuin042 (4)
  • yuefeng-98 (3)
  • xialang2012 (3)
  • theobarnhart (3)
  • magonsa (3)
  • tungttnguyen (2)

Top Pull Request Authors

  • selimnairb (16)
  • ejhanan (5)
  • ryanrbart (3)
  • canghan (2)
  • Yun1 (2)
  • mingliangwsu (2)
  • tungttnguyen (2)
  • jjreyes (2)
  • scaife (1)
  • MorganRodgers (1)
  • laurencelin (1)
  • xiaoli-chen (1)
  • mkenn (1)
  • cdbell01 (1)

Top Issue Labels

  • enhancement (17)
  • bug (16)
  • variable timestep (13)
  • question (4)

Top Pull Request Labels

  • enhancement (1)

Dependencies

.github/workflows/build_docker_develop.yml actions
  • docker/build-push-action v2 composite
  • docker/login-action v1 composite
  • docker/setup-buildx-action v1 composite
.github/workflows/build_docker_trunk.yml actions
  • docker/build-push-action v2 composite
  • docker/login-action v1 composite
  • docker/setup-buildx-action v1 composite
Dockerfile docker
  • ubuntu 20.04 build

Score: 8.891236429516063