Manuscript Revision Checklist - Major

Manuscript

[x] Define Pyllusion scope, reduce discussion of clinical contexts and increase discussion of studies showing that differences in stimulus parameters/features systematically alter illusions leading to a need to reproducible stimuli (hence emphasizing the gap pyllusion is filling)
- E.g. Role/impact of color, lightness contrast, size, line weighting, orientation on different types of illusions
- Zen: the intro is refined to retain just a short summary of visual illusions in clinical studies before moving on to elaborating how theoretical understanding of the fundamental parameters underlying the various illusions is still lacking, and referencing studies showing systematic effects of manipulating parameters (e.g., colour contrast, proximity etc) on the perceived illusions. Also explained the importance of manipulating these parameters for practical applications (e.g., Delboeuf illusion for perceived food portions) and how they tap on neurocognitive processes in schizophrenia/ASD - which currently faces low replication rates due to inconsistent methodologies and hence (the gap the pyllusion is filling) the need for experimental paradigms where results can be consistently interpreted with respect to the parametric properties of the visual illusion.

[ ] Current strengths and limitations of pyllusion
[x] Considerations needed for researchers when using pyllusion (e.g., accurate control of contrast luminance and color will still require a properly calibrated monitor, viewing distance will still influence size, moving into the temporal domain will require consideration of refresh rates) especially to make an entire illusion based experiment (e.g., gathering responses)
- Zen: Elaborated on additional practical considerations such as viewing conditions and presentation timings which have specific effects on each illusion. Second last paragraph

[ ] Consideration of class-based API (see here)
[ ] Clarify need for psychopy_circles psychopy_line and psychopy_rectangle vs using the ShapeStim class in PsychoPy itself
[x] Reconsider choice of ill as abbreviation
[x] Either remove or explain syntax import as as it might be obscure for people not experienced in programming
- Zen: Added sentence in installation section: "In the example script below, the line import pyllusion as ill is used so that it stores the Pyllusion module locally and makes functions accessible as ill (this effectively binds any module to a convenient local name)."
[x] Provide greater clarification on the meanings of numbers assigned to illusion_strength and difference parameters
- Zen: see two paras at "Note the two main parameters,..."