Git Product home page Git Product logo

sticsrfiles's Introduction

SticsRFiles

Project Status: Active – The project has reached a stable, usable state and is being actively developed. R build status Codecov test coverage

DOI

The goal of SticsRFiles is to perform manipulations of the STICS model files either on XML files (used by the JavaStics GUI) or on text files used by the model fortran executable.

The basic functionnalites allows to read parameters names and values through XML queries and replace parameters values in files. A starting guide is available on the Get started page.

Advanced functionnalities are dedicated to produce XML parameter files using a mailing process like from XML templates and Excel sheets containing multiple simulations contexts. A JavaStics workspace is generated and directly usable from the JavaStics interface (GUI or command line), or with an R JavaStics interface provided by the SticsOnR package.

If you want to be notified when a new release of this package is made, you can tick the Releases box in the “Watch / Unwatch => Custom” menu at the top right of this page.

Prerequisites and technical tips

Some information about software requirements and operating system constraints are given in the SticsOnR package documentation here.

Installation


Warning: If during the installation process, packages updates are suggested.

  • First, abort the installation.
  • Second, update the installed packages, except the XML package.
  • Finally, install the SticsRFiles package.

Recommended installation: SticsRPacks

The best way to install the packages from SticsRPacks, from which SticsRFiles is part of, is by installing the [SticsRPacks] package. The package can be installed from GitHub using either the devtools package, or the more lightweight remotes package:

devtools::install_github("SticsRPacks/SticsRPacks")
  • With remotes
# install.packages("remotes")
remotes::install_github("SticsRPacks/SticsRPacks")

The package will install the packages for you at the latest release version.

Or, install directly

  • With devtools
devtools::install_github("SticsRPacks/SticsRFiles@*release")
  • With remotes
# install.packages("remotes")
remotes::install_github("SticsRPacks/SticsRFiles@*release")

Normaly, all the package dependencies will be installed for CRAN packages.

Examples

Files manipulations

  • A description of how to use the functions for manipulating XML input files is detailed here

  • A description of how to use the functions for manipulating text input files is available here.

Files generation

  • A description of usefull functions for generating XML input files from usms parameters data stored in Excel files sheets or CSV files is available here.

  • A description of functions for generating text input files from XML one of usms parameters is available here.

Getting help

If you have any question or suggestion or if you want to report a bug, please do it via the GitHub issues.

Thanks for that, this would greatly help us to improve this package.

Citation

If you have used this package for a study that led to a publication or report, please cite us. You can either use the citation tool from Github if you used the last version, or use citation("SticsRFiles") from R otherwise.

Code of conduct

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

The package is under intensive development, so you can fill an issue or request us a feature here at any time.

sticsrfiles's People

Contributors

aminebarkaoui avatar chabrier avatar ginerm avatar plecharpent avatar sbuis avatar thomasrobine avatar vezy avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.