Help:FAQ

Frequently Asked Questions (FAQ's)

Can’t find the answer? Feel free to e-mail your question to CSDMS@colorado.edu. CSDMS staff will try to respond within a week. Please make sure the question you’re asking is unique and CSDMS-related.

Topics

Organization

1. What is CSDMS?
   CSDMS stands for Community Surface Dynamics Modeling System. We are a diverse community of experts promoting the modeling of earth surface processes by developing, supporting, and disseminating integrated software modules that predict the erosion, transport, and deposition of sediment and solutes in landscapes and their sedimentary basins. Read more...
2. Is there another effort like CSDMS?
   Not quite, but there are many modeling efforts underway across the world, and we try to make connections and collaborate with other efforts when appropriate. CSDMS is willing to work together with the international community to build an integrated modeling community.
3. Is CSDMS a Community Clastic Model?
   No, it is a modeling community supporting a modeling architecture (not an "uber"-model). It deals with hydrology, nutrients, sediment (incl. carbonates), ecosystems, glaciers, oceanography, weather, etc. -- earth-surface dynamics. The goal of CSDMS protocols is to allow for models and components to be combined in unique ways to answer diverse questions. CSDMS is interested in stand-alone models, components and compliant contributions.
4. How do I become a member of one of the Groups?
   Simply follow the link and complete the form to join a working group and/or focus research group.
5. I changed jobs. How do I inform CSDMS and the chairs of the various groups?
   Please let us know if your contact information has been changed. Complete this form and we will update your contact information.
6. How often do the Working Groups or Focus Research Groups meet?
   Currently, each group hosts an annual meeting. The rest of their activity is done through remote communication systems.
7. How do I benefit from becoming a member of CSDMS's Working Groups and or Focus Research Groups?
   There are many ways you benefit. Most importantly, you become part of a family of experts who are willing to collaborate. You'll have an advantage in staying current within a community sharing research on the Earth Sciences. You'll also gain better knowledge on available models for education and application, and you'll have opportunities for interaction with a variety of industrial and NGO partners and federal agencies. Read more about this.
8. Are there funding opportunities?
   There are competitive funding opportunities through various traditional sources. Please note, CSDMS does not directly fund proposals, but association with CSDMS and detailing how your proposal can interact with and advance CSDMS can be helpful to your proposal. Benefits include:
   1. support by a state-of-the-art research agenda developed by an integrated community;
   2. support by a community of modelers & software engineers;
   3. access to a sophisticated modeling architecture, data systems, and high performance computing;
   4. CSDMS opportunities with NGO’s, agencies, and industry partners.

Model Contribution

1. Why Open-Source?
   Science is advanced through mutual cooperation. Community modeling involves the collective efforts of individuals that code, debug, test, document, run, and apply models and modeling frameworks. Community modeling relies on open-source code to address the practical need of contributing developers to examine and modify the code. Open-source code provides complete information transfer. This transparency is important because code is the ultimate statement of the scientific hypotheses embodied in a numerical model, and their implementation.
   In the world of software, details are important. A scientific article describing code may provide the theoretical equations, but the solution to these equations can take numerous forms, and each solution has its pyramid of assumptions and limitations. Therefore open-source code allows for full peer review and replication of results — the foundation of modern science.
   Open source code allows for reuse, often in new and clever ways. This certainly reduces redundancy. Open source does not mean that the original developer is not recognized. Developers are recognized with the metadata associated with each model, with GPL2 software license protection, through community exposure, vetting and recognition, and through accelerated citations within peer-reviewed publications.
   In the world of science, software code is often considered “research grade”. That means that it is often relatively untested, may contain bugs, and might not be at the standards required for true “commercial grade” or “operational grade” code. Coding glitches in research grade code are often unknown by the original author. With wider community use, such problems are discovered and either rectified by the original author or by the bug discoverer. Research grade code should be widely available to the community of scientists through an appropriate international repository such as the CSDMS Model Repository.
   Too often code is issued with an open source license but access to the code is restricted to access through the author. Unfortunately this allows the author to decide who they will give the code to. This runs contrary to the transparency needed in science, and we discourage this level of availability.
   See also: Ince, D.C., Hatton, L., and Graham-Cumming, J. (2012) The case for open computer programs. Nature 482, 485-488. doi:10.1038/nature10836
2. Where can I upload my model to make it available to the community?
   First, complete the model questionnaire. CSDMS will create a special website for your model were you, yourself, can upload it, start a discussion page or create a page that explains some of the routines of your model. Have a look at one of the model pages currently hosted by CSDMS at our Models page.
3. Why is CSDMS promoting the development of free open source code?
   Since we’re working in the public domain, the general opinion is that the research should be public and community centered as well. One goal of CSDMS is to change the current culture, encouraging more open collaboration and cooperation as a community. Not long ago the climate community experienced such a cultural shift, which resulted in better funding and vastly improved, integrated modeling. Working together will make the earth-surface dynamics community more effective. There will be less duplication of effort, more ways to connect models, and these models will be open to be built upon.
4. How are coders recognized?
   
   1. Through the CSDMS web site,
   2. with the metadata following the model,
   3. with GPL2 software license protection,
   4. through community exposure, vetting and recognition,
   5. through accelerated citations within CSDMS-supported peer-reviewed publications.
      The CSDMS Integration Facility will insist on best practices to ensure that proper credit is provided by those who use CSDMS products, along with proper protection of, for example, contributions by graduate students. CSDMS has the advantage of following in the footsteps of the CCSM and CIG initiatives.
5. I’m afraid to give my source code away. Can you ease my fears?
   It’s ok to be a little apprehensive. It can be a bit intimidating to publish your code for all to see. Some things to remember: it is a way to advertise your code; your license will ensure that your name will stay with the code; most importantly, your model will be better for it because there will potentially be more people using it. You get credit for your work by making it public. Since you’re the most experienced user, you are probably also the best person to do a simulation. As more people learn about and use your model, there will likely be more opportunities to collaborate with you for proposals.
6. How do I keep track of different versions of my model?
   We encourage model owners to use some form of version control, like Subversion (SVN). If you are unable or just don’t want to host such a server, there are many other options. Perhaps the best solution is for model owners to create a SourceForge or Google Code project. These sites provide Subversion hosting as well as many other useful tools for managing a modeling project. If you don’t want to do this, CSDMS can also store your model in its subversion repository.
7. Whoa there! I don’t want just anyone making changes to my model!
   If you prefer, you can allow only a small group of people to have permission to make changes to your code. If someone makes an unwanted change, you can easily roll back to a previous version.
8. What is my responsibility after submitting my model?
   The owner of the model stays owner of their own model. CSDMS is providing the opportunity to store and make it available to the community. Once the code is available to the community, other people could, depending on your model license, add or change the code and create a new version if desired, but the original owner should always be recognized. By proving code, the owner is more or less responsible to answer possible questions that could arise or to fix bugs if that’s necessary. The nice thing about the CSDMS website is that other people may also answer questions or fix the bugs if they want. That's a major benefit of working with the greater modeling community.
9. How can I make sure that I’m not overloaded with questions?
   By making your model available on the CSDMS web site, other users can also answer questions or fix bugs; remember, this is a WIKI, any registered member can reply to questions on the model pages. Once a question is asked and answered on the model website, you needn’t answer it again and again.
10. But if I give my model to the community, they’ll find bugs!
    Not really a question. Yes, they probably will. This is a good thing. Sometimes you will be able to fix these bugs. Sometimes the community will fix them for you. Sometimes they will go unfixed. Users would rather a bug be identified and not fixed than not be identified in the first place. Don’t worry, users understand that you are busy and can’t get to every bug immediately (if at all).

HPCC: Using beach

1. What? No questions yet?
   Yes, unfortunately, there are no questions yet for this section (except for this one, of course). It turns out that the person who gets these questions has been rerouting them to /dev/null. Ooops!
2. Well when will you get a new person to answer my questions?
   Actually, we already have (that's why your questions are being answered right now, duh). I hope we'll have a few more questions and answers this afternoon.