Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Check Code Documentation and add Usage Examples #10568

Closed
1 task done
KarlPalmen opened this issue Jun 23, 2014 · 1 comment
Closed
1 task done

Check Code Documentation and add Usage Examples #10568

KarlPalmen opened this issue Jun 23, 2014 · 1 comment
Assignees
Labels
Documentation Issues and pull requests related to documentation High Priority An issue or pull request that if not addressed is severe enough to postponse a release.
Milestone

Comments

@KarlPalmen
Copy link
Contributor

This ticket is blocked by :

Please check the documentation for these algorithms (check images, formatting etc) and add testable algorithm usage examples. We have tried to allocate algorithms as fairly and sensibly as possible, but there will be some that you do not consider "yours".

There is help on how to document the algorithms in the following links: http://www.mantidproject.org/Algorithm_Documentation http://www.mantidproject.org/Algorithm_Usage_Examples And there are examples implemented for Fit, Load, LoadISISNexus and Rebin.

To create workspaces to use in your usages you should try to create the workspace using CreateSampleWorkspace or CreateWorkspace, and only use a file if you really have no other option and the size is small.

In Visual studio you have two targets to create the documentation and run the doc tests (docs-html and docs-test in a documentation subfolder). You will need to update your Third Party Library.

If you are using Linux/Mac look here: ​https://github.com/mantidproject/mantid/blob/master/Code/Mantid/docs/README.md

Algorithms:

  1. CopyLogs.cpp
  2. CreateTransmissionWorkspace.cpp
  3. FilterEvents.cpp
  4. FindPeaks.cpp
  5. GeneralisedSecondDifference.cpp
  6. GetTimeSeriesLogInformation.cpp
  7. MaskBins.cpp
  8. MaskBinsFromTable.cpp
  9. NormaliseByCurrent.cpp
  10. NormaliseToMonitor.cpp
  11. PerformIndexOperations.cpp
  12. ReadGroupsFromFile.cpp
  13. ReflectometryReductionOne.cpp

Crystal:

  1. ClearUB.cpp
  2. GoniometerAnglesFromPhiRotation.cpp
  3. IndexPeaks.cpp
  4. ShowPeakHKLOffsets.cpp

MD Algorithms:

  1. ThresholdMD.cpp

SINQ:

  1. MDHistoToWorkspace2D.cpp

WorkflowAlogirthms:

  1. StepScan.cpp

These are the algorithms outstanding from http://trac.mantidproject.org/mantid/ticket/9567

@KarlPalmen
Copy link
Contributor Author

This issue was originally trac ticket 9726

@KarlPalmen KarlPalmen added High Priority An issue or pull request that if not addressed is severe enough to postponse a release. Documentation Issues and pull requests related to documentation labels Jun 3, 2015
@KarlPalmen KarlPalmen self-assigned this Jun 3, 2015
@KarlPalmen KarlPalmen added this to the Release 3.4 milestone Jun 3, 2015
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Documentation Issues and pull requests related to documentation High Priority An issue or pull request that if not addressed is severe enough to postponse a release.
Projects
None yet
Development

No branches or pull requests

1 participant