Ticket #9608 (closed: fixed)

Opened 6 years ago

Last modified 5 years ago

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

  1. InvertMDDim.cpp
  2. ProjectMD.cpp
  3. SliceMDHisto.cpp
  4. LoadFlexiNexus.cpp
  5. 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:10 Changed 6 years ago by Karl Palmen

  • Status changed from verify to verifying

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

Note: See TracTickets for help on using tickets.