26
MATH36032 Problem Solving by Computer Mathematical Writing

MATH36032 Problem Solving by Computer

  • Upload
    others

  • View
    4

  • Download
    0

Embed Size (px)

Citation preview

Page 1: MATH36032 Problem Solving by Computer

MATH36032 Problem Solving by Computer

Mathematical Writing

Page 2: MATH36032 Problem Solving by Computer

PART I: General Academic Writing

Page 3: MATH36032 Problem Solving by Computer

Academic writing: how it is different?

formality

objectivity

Main characteristics (compared to business or personal writing):

• Passive verb forms

• Qualifying words/phrases (suggest,imply...)

• Complex sentence structures

• Specialised vocabulary

• Citation

• Large amount of experimental details, data and figures

Page 4: MATH36032 Problem Solving by Computer

Different stages of the writing process

Assuming that you have more or less finished the coding part,

I Exploring, Planning and Organising

I Drafting: just the draft, no grammar or other details

I Revising, Editing

I Proofreading

The focus should be on the last two stages!

Page 5: MATH36032 Problem Solving by Computer

Different stages of the writing process

Revising and Editing

I Edit at sentence, paragraph, and text level: the choice ofwords, length of sentences

I Focus on content, organisation, grammatical accuracy,puncuation and spelling

I Transition between paragraphs and sections

I View the draft as a reader - be a critic of your work

Page 6: MATH36032 Problem Solving by Computer

Different stages of the writing process

Proofreading

I Read your draft report in printed form?

I Look at it globally (sections, pages, layout) as well as locally(words, symbols, spelling).

I Check word, letter, space and punctuation mark

I Incomplete/incorrect punctuation, incorrect line or paragraphbreaks, unmatched parentheses

I Wrong font, missing words, phrases

Page 7: MATH36032 Problem Solving by Computer

Important tips: Get someone to read your writing

Get some honest feedback on

I Overall structure

I Organisation of ideas

I Grammatical accuracy

I Writing style

I Clarity of the presentation

I Coherence of argument

I Ways of demonstrating data

Page 8: MATH36032 Problem Solving by Computer

PART II: Mathematical Writing

Page 9: MATH36032 Problem Solving by Computer

Dos and Don’ts

I Punctuate all equations.Now consider the quadratic equation

ax2 + bx + c = 0.

(do not forget the period at the end of the equation!)

I Don’t start a sentence with a symbol.The function f is continuous on its domain.

I Separate symbols by punctuation marks or words.... where a, b and c are constants.

Page 10: MATH36032 Problem Solving by Computer

Dos and Don’ts

Add words to explain the logical flow of the manipulation(instead of just using math symbols).

Bad: As n→∞, xn → x∗ = 1− 1/r .Good: As n goes to infinity, xn converges to x∗ = 1− 1/r .

Bad: ∀x > 0, ∃y > 0 such that y > x .Good: For all x > 0, there exists y > 0, such that y > x .

Page 11: MATH36032 Problem Solving by Computer

Dos and Don’ts: notations

Do not use unnecessary notations (especially the notation isnot used again).

Bad: Every differentiable function f is continuous.

Good: Every differentiable function is continuous.

Page 12: MATH36032 Problem Solving by Computer

Dos and Don’ts: notations

Avoid overloading meaning into notation.

Bad: Let x > 0 ∈ Z.

Good: Let x be an integer, with x > 0.

Good: Let x be a positive integer.

Page 13: MATH36032 Problem Solving by Computer

Dos and Don’ts: logical symbols

Try to use words instead of logical symbols like ∀, ∃,∧,∨, · · · ,unless it is about logic.

Bad: We have x2 ≥ 0 ∀ x ∈ R.

Good: We have x2 ≥ 0 for all x ∈ R.

Good: We have x2 ≥ 0 for any real number x .

Page 14: MATH36032 Problem Solving by Computer

Fonts for math functions

Math functions are in Roman

Bad: : sinx , tanx , sincxGood: : sin x , tan x , sincx

$\sin x, \cos x, \mbox{sinc} x$

Page 15: MATH36032 Problem Solving by Computer

Double negative?1

Bad: Red skin is not uncommon in patients treated withhydroxocobalamin.

Good: Red skin is common in patients treated withhydroxocobalamin.

Bad: Nausea and vomiting were not infrequently reported duringphase II trials of that drug.

Good: Nausea and vomiting were frequently reported during phaseII trials of that drug.

Bad: It is not unusual for writers of case reports to speculate tooreadily.

Good: It is usual for writers of case reports to speculate tooreadily.

Eliminating double negatives will enhance the clarity of yourmessage to readers and make your writing more active.

1From: Double Negatives Do Not Make a Positive Editorial Experience by Mark B. Mycyk,J Med Toxicol. 2011 Sep; 7(3): 254.

Page 16: MATH36032 Problem Solving by Computer

Check your spelling

I Use a dictionary and a thesaurus to check meanings, spellingsand synonyms

I Do not assume the spellchecker is always right!

I Printed

I Read aloud

Page 17: MATH36032 Problem Solving by Computer

Check your spelling

I Use a dictionary and a thesaurus to check meanings, spellingsand synonyms

I Do not assume the spellchecker is always right!

I Printed

I Read aloud

Page 18: MATH36032 Problem Solving by Computer

MATLAB commands/functions/output

I Use typewriter font for MATLAB code, names, variablesand outputBad: Before invoking int, we first set up symbolic variable xand f.Good: Before invoking int, we first set up symbolic variablex and f.

I Make MATLAB M-files and output clearly distinct fromsurrounding narrative

I You should not materially change MATLAB output ( but youcan remove blank lines and ”tiny up” output)

MATLAB commands/functions/output can be handled usingverbatim environment, or extra packages like mcode.

Page 19: MATH36032 Problem Solving by Computer

Common mistakes and confusing pairs of words

I singular vs plural: phenomenon, phenomena; criterion, criteria

I loose vs lose

I supersede vs supercede

I its vs it’s

I few, less: few iterations, less computation

I practice, practise

I affect, effect; compare with, compare to

I comprise, compose, constitute

Page 20: MATH36032 Problem Solving by Computer

Citations and References (if any)

I Should be cited (or referred) in the main text, not just listsome references at the very end.

I Make sure the format or style is consistency. (Commoncitation styles: APA, MLA, Chicago, ...)

Recommended style (for book and journal articles):

N. J. Higham, Handbook of writing for the mathematical sciences.Second edition. Society for Industrial and Applied Mathematics (SIAM),Philadelphia, PA, 1998. xvi+302 pp. ISBN: 0-89871-420-6

R. C. Fetecau, Y. Huang and T. Kolokolnikov, Swarm dynamics and

equilibria for a nonlocal aggregation model. Nonlinearity.

24(10):2681—2716, 2011.

Page 21: MATH36032 Problem Solving by Computer

Cite internet sources (if any)

Not as popular as you may think in the academic world.

Recommended style:

Prime number theorem.https://en.wikipedia.org/wiki/Prime_number_theorem

(you may also have to include access date)

Page 22: MATH36032 Problem Solving by Computer

Cite internet sources (if any)

Not as popular as you may think in the academic world.

Recommended style:

Prime number theorem.https://en.wikipedia.org/wiki/Prime_number_theorem

(you may also have to include access date)

Page 23: MATH36032 Problem Solving by Computer

Bibliography using bibtex (if using LaTeX)

Further details can be found in the book by N.Higham [1].

produced by

Further details can be found in the book by

N. Higham~\cite{higham1998handbook}.

An entry in bibtex file that looks like:

@book{higham1998handbook,

title={Handbook of writing for the mathematical sciences},

author={Higham, Nicholas J},

year={1998},

publisher={Siam}

}

Page 24: MATH36032 Problem Solving by Computer

Proofreading Test (1)

I One of the best unknown methods for determining all theeigenvalues and eigenvectors of (2.1) was developed bythe nineteenth century mathematician Jacobi.

I It would be hard to underestimate the importance ofoptimization to scientific computing.

I (from my submitted draft2)... which can not be deriveddirectly from the criteria given in the seminar paper byMcCann [25].

2JA Carrillo, Y Huang, MC Santos, JL Vazquez. Exponential convergencetowards stationary states for the 1D porous medium equation with fractionalpressure. Journal of Differential Equations, 258(3):736–763

Page 25: MATH36032 Problem Solving by Computer

Proofreading Test (2)

I (from last year’s description) We can get some primariesunderstanding using the following code block (changing thevalue of r).

I Acknowledgements. I thank the anonymous referees,particularly Dr. J. R. Ockendon, for numerous suggestions andfor the source of references.

I The ability of physics to explain similar phenomena over scalesof centimeters to 1018 centimeters is why it is such a powerfulscience. (From the book Very Large Scale Computation in the21st Century)

More examples from Prof Nick Higham’s blog post PublicationPeculiarities: Acknowledgements.

Page 26: MATH36032 Problem Solving by Computer

References

I Strunk, William. The elements of style. Penguin, 2007.

I Chicago Manual of Style. University of Chicago Press, 2010.

I Higham, Nicholas J. Handbook of writing for themathematical sciences (Chapter 3, 4, 5 and 13). SIAM,1998.

I Krantz, Steven. A Primer Of Mathematical Writing. AMS,1997.