MAP Logo

MAP Background Information

[A logo showing the University of Cambridge Crest]

Advice for Contributors - MAP Donor Code Agreement

Contents

1. Your commitment.
2. Our commitment.
3. Guidelines for code providers.
3.1 Data transfer.
3.2 Documentation.


1. Your commitment.

Yours | Ours | Guidelines | Contact info. | Links | MAP homepage

Before code can be accepted for distribution on the MAP website, the supplier MUST agree that, to the best of his/her knowledge :-

You must enclose a signed copy of the Code Donor Agreement.


2. Our commitment.

| Yours | Ours | Guidelines | Contact info. | Links | MAP homepage


3. Guidelines for code suppliers.

| Yours | Ours | Guidelines | Contact info. | Links | MAP homepage

3.2 Documentation

3.2.1. Source code

Source code should be provided as ASCII text files only, though accompanying hard copy is welcome.

3.2.2. Accompanying documentation.

If possible, the documentation should be provided in the form of an ACSII text file, accompanied by a printout. However, plain TeX and html documents are acceptable by prior arrangement.

Documentation supplied with source code should include :-

  1. Brief statment of purpose of code and description of operating principles.
  2. A list of input and output arguments, including type, eg double precision, integer, etc, and purpose.
  3. References for theoretical basis of code (where appropriate).
  4. Statement of known accuracy limits, or input conditions likely to result in an error.
  5. A list of keywords (for benefit of search engine).
  6. A sample program demonstrating the use of the routine, including sample input data and results.
  7. Notification of use of code in published documents, eg conference papers, refereed journals, etc. (These may be same as [3]).

Links

| Yours | Ours | Guidelines | Contact info. | Links | MAP homepage

National Physical Laboratory
University of Cambridge Home Page
Department of Materials Science and Metallurgy Home Page
MAP Home Page

Return to top of document

Valid HTML 3.2!