Ticket #9608 (closed: fixed)
Check Documentation and add algorithm usage examples lot 3
Reported by: | Nick Draper | Owned by: | Nick Draper |
---|---|---|---|
Priority: | critical | Milestone: | Release 3.2 |
Component: | Documentation | Keywords: | |
Cc: | Blocked By: | ||
Blocking: | Tester: | Karl Palmen |
Description (last modified by Nick Draper) (diff)
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
- InvertMDDim.cpp
- ProjectMD.cpp
- SliceMDHisto.cpp
- LoadFlexiNexus.cpp
- SplineSmoothing.cpp
Change History
comment:1 Changed 6 years ago by Nick Draper
- Status changed from new to assigned
- Description modified (diff)
- Summary changed from Check Documentation and add algorithm usage examples lot 2 (cloned) to Check Documentation and add algorithm usage examples lot 3
comment:2 Changed 6 years ago by Nick Draper
- Status changed from assigned to inprogress
re #9608 4 and 5 done, next is the MD ones
Changeset: 32a10d99fff531afe6d248cc4a2065b327fc9a78
comment:3 Changed 6 years ago by Nick Draper
re #9608, complete the algorithm usage examples
Changeset: cb221978b5b05d592ce248431ac5ee595f5a0f1b
comment:4 Changed 6 years ago by Nick Draper
- Status changed from inprogress to verify
- Resolution set to fixed
comment:5 Changed 6 years ago by Karl Palmen
- Status changed from verify to verifying
- Tester set to Karl Palmen
comment:6 Changed 6 years ago by Karl Palmen
ProjectMD-v1.rst has print statements that seem to be incorrect:
The word 'he' before 'workspace' needs to be changed to 'the' in two statements. Also the 'Z' in the second of these statements needs changing to 'X'.
comment:7 Changed 6 years ago by Karl Palmen
- Status changed from verifying to reopened
- Resolution fixed deleted
All algorithms documents seem OK, except ProjectMD-v1.rst, which nhas some incorrect print statements in the usage script as explained in previous comment. Ticket reopened to fix this.
comment:8 Changed 6 years ago by Nick Draper
- Status changed from reopened to inprogress
re #9608 for incorrect print statements
Changeset: d05bf47a1e9fcf2e6ec09b84079c857621ccafa6
comment:9 Changed 6 years ago by Nick Draper
- Status changed from inprogress to verify
- Resolution set to fixed
comment:11 Changed 6 years ago by Karl Palmen
- Status changed from verifying to closed
Merge remote-tracking branch 'origin/feature/9608_Usage_examples_nd3'
Full changeset: 4c128d1da4bd3204283c87c4a60fdbbb8b200e77
comment:12 Changed 5 years ago by Stuart Campbell
This ticket has been transferred to github issue 10451