search

aschaap / cas741

Course project
Apache License 2.0
0 stars 0 forks source link

SRS: Variabilities Preamble (Very minor) #20

Closed GenevaS closed 6 years ago

GenevaS commented 6 years ago

As it is written, the listing of subsections does not follow how they actually appear (i.e. you state that the instance models are followed by assumptions, etc., but assumptions come first in the document.).

In your case, aren't your Instance Models the same as your Calculations? You use both in this preamble and treat them as separate sections.

aschaap commented 6 years ago

Yes, they are. initially I had a separate instance models section, but I changed this due to Dr. Smith's answer to #5.

GenevaS commented 6 years ago

I have a follow-up question. What do you mean when you write "After instance models, output is covered."? What does "output" refer to here?

aschaap commented 6 years ago

Since Output is under Variabilities, I assumed it covered potential variabilities in output. I've tried to clarify that.

GenevaS commented 6 years ago

I am honestly not sure what "Output" means here either. I thought it was similar to the "Properties of a Correct Solution" from the SRS template. I think we should ask...

aschaap commented 6 years ago

Alright - @smiths, could you clarify what "Output" under Variabilities in a commonality analysis is expected to contain?

smiths commented 6 years ago

@aschapp, your interpretation (as written above) is correct. The "Output" heading is for variabilities in the output. This is discussed in the Smith2006 reference.

@GenevaS, a section with "properties of a correct solution" would be a nice addition to the CA, where appropriate, but it isn't part of the starting template. I'll think about adding it in the future though. (The challenge is that the properties must be correct for all family members, or the properties should be tied to variabilities.)

GenevaS commented 6 years ago

Thank you for clarifying. So if I am reading your Output section correctly, your family will always produce a function of the same form no matter which member is used?

aschaap commented 6 years ago

Yes, different members should produce the same kind of solution, all that should vary there is accuracy.

GenevaS commented 6 years ago

Perhaps mention that? "The accuracy of the generated function depends on the family member that produced it." <- Something like this? (And I think this also means that you should remove N/A since there is content here now.)

aschaap commented 6 years ago

The N/A denoted a lack of variability, but I guess it was confusing. I've removed it and tried to be more specific about the output.

GenevaS commented 6 years ago

Much clearer (to me anyways).