Skip to content

Adds docstring for contrasts and some refactors#389

Merged
StephenNneji merged 9 commits into
RascalSoftware:masterfrom
StephenNneji:yet_another_docstring_branch
Apr 11, 2025
Merged

Adds docstring for contrasts and some refactors#389
StephenNneji merged 9 commits into
RascalSoftware:masterfrom
StephenNneji:yet_another_docstring_branch

Conversation

@StephenNneji
Copy link
Copy Markdown
Collaborator

No description provided.

Copy link
Copy Markdown
Collaborator

@DrPaulSharp DrPaulSharp left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good so far. Few things to address, in particular the docstrings for add/set contrast in numerous places.

Comment thread API/projectClass/baseContrasts.m Outdated
Comment thread API/projectClass/baseContrasts.m Outdated
Comment thread API/projectClass/baseContrasts.m Outdated
Comment thread API/projectClass/baseContrasts.m Outdated
Comment thread API/projectClass/baseContrasts.m Outdated
Comment thread API/projectClass/domainsClass.m Outdated
Comment thread API/projectClass/domainsClass.m
%
% project.addContrast('contrast 1', 'bulkIn', 'Silicon');
obj.contrasts.addContrast(obj.getAllAllowedNames(), varargin{:});
function obj = addContrast(obj, options)
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's all written down somewhere . . .

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Don't understand what is written down somewhere? addContrast has always been in projectClass

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry, I'd gone a bit mad by this point. I just mean that I've written the comments elsewhere, i.e., the same points as the other addContrast docstrings.

% Allow setting of all parameters in terms of name value pairs.
% First input must be contrast number or name, subsequent
% inputs are name / value pairs for the parts involved
function obj = setContrast(obj, row, options)
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

deja vu all over again . . .

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Again, see previous setContrast docstring comments.

Comment thread API/projectClass/projectClass.m Outdated
Comment thread API/projectClass/baseContrasts.m Outdated
@StephenNneji StephenNneji force-pushed the yet_another_docstring_branch branch from a3e960a to 9276962 Compare April 10, 2025 08:59
@StephenNneji StephenNneji merged commit 88c62f3 into RascalSoftware:master Apr 11, 2025
5 checks passed
@StephenNneji StephenNneji deleted the yet_another_docstring_branch branch September 3, 2025 13:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants