Cleveland State University EEC 414/503, ESC 720 Writing in Electrical and Computer Engineering

1. Cleveland State UniversityEEC 414/503, ESC 720Writing in Electrical and Computer Engineering Lecture 1 – Introduction Dan Simon

2. The Importance of Communication • 96% of employers say that employees must have good communication skills [Markel] • 80% of Fortune 400 companies identify writing skills as their greatest weakness [Markel] • “Without communication there is no engineering.” [Gunn] • A professional engineer spends up to 80% of the time communicating with others [Oatheimer] • “If you cannot communicate, you are less valuable; if you can, you are more valuable.” [Markel]

3. The Importance of Communication How do you objectively identify senior engineering qualities? [Lee] • Instinct and intuition • Foresight and planning • Result oriented • Communication skills • Time management How can we improve our communication skills?

4. Types of Engineering Communication • Memos, emails, letters • Instructions, manuals • Proposals • Reports • Oral presentations • Web sites • Articles • Theses

6. Your First Assignment Write a one-page essay related to one of the following topics, or some other engineering topic • How to develop and tune an effective control algorithm • How to design and test a power electronics circuit • The importance of electronic communications in 21st-century America • Methods for software testing • Potential pitfalls when designing a computer networking protocol Closed book, closed notes Write neatly You have 10 minutes If you finish early, keep your paper with you and wait

7. Your First Assignment Answer these questions on the back of the page • Did you put your name and the date at the top of the essay? • What is a one-sentence description of the focus of the essay? • How many paragraphs are in your essay? • How many sentences are in each paragraph? • How many words are in each sentence? • How many one-syllable words did you use? Two-syllable words? Words of more than two syllables? • How many contractions did you use? Hand in your paper

8. Characteristics of Good Communication(Markel’s book) • Address your particular audience • Use both words and graphics • Write clearly • Write accurately • Write comprehensively • Write accessibly (i.e., be organized) • Write concisely • Write professionally

9. 1. Address your particular audience • What is your audience’s level of knowledge? This is one of the differences between beginning and intermediate writers.Avoid being overly simple or overly complex. • Example: A technical proposal to NASA or the NSF should not include an overview of fuzzy logic • Example: An overview of fuzzy logic to management should not include defuzzification equations

10. 1. Address your particular audience • Address your particular audience. What is your audience’s interest? • Example: An academic research paper should not include a cost/benefit analysis, but it could be included in a thesis • Example: A proposal to management for a new control approach should not include a stability proof

11. Characteristics of Good Communication • Address your particular audience • Use both words and graphics • Write clearly • Write accurately • Write comprehensively • Write accessibly (i.e., be organized) • Write concisely • Write professionally

12. 2. Use both words and graphics • Why use graphics? • A picture is worth a thousand words • Make your writing more interesting and appealing • Communicate difficult concepts • Communicate large amounts of data • Use flowcharts and algorithm listings • Make sure you explain your figures and tables • Use color as appropriate

13. 2. Use both words and graphics The figure looks fine in color, but not in black and white. Do not rely on color unless you are sure that it will always be available.

14. 2. Use both words and graphics The price of soybeans is $1.45 per pound in Zambia and $1.67 in Sweden. The price of rice is $0.65 per pound in Zambia and $0.63 in Sweden. We see that soybeans are more expensive in Sweden, but rice is more expensive in Zambia.

15. 2. Use both words and graphics The price of soybeans is $1.45 per pound in Zambia and $1.67 in Sweden. The price of rice is $0.65 per pound in Zambia and $0.63 in Sweden. We see that soybeans are more expensive in Sweden, but rice is more expensive in Zambia.

16. Characteristics of Good Communication • Address your particular audience • Use both words and graphics • Write clearly • Write accurately • Write comprehensively • Write accessibly (i.e., be organized) • Write concisely • Write professionally

17. 3. Write clearly • What question does your report answer? • What is the focus of your report (thesis)? • Does the entire report support your focus? • Is your report organized well? • Between-section level • Within-section level • The mechanics of writing is a lower level that is related to clear writing

18. 3. Write clearly It is necessary for technical reasons that these warheads be stored upside down, that is, with the top at the bottom and the bottom at the top. In order that there be no doubt as to which is the bottom and which is the top, for storage purposes, it will be seen that the bottom of each warhead has been labeled 'TOP'. British navy instructions [Markel]

19. 3. Write clearly • Unclear: Such preparations shall be made as will completely obscure all Federal buildings and non-Federal buildings occupied by the Federal government during an air raid for any period of time from visibility by reason of internal or external illumination. [Zinsser]

20. 3. Write clearly • Unclear: Such preparations shall be made as will completely obscure all Federal buildings and non-Federal buildings occupied by the Federal government during an air raid for any period of time from visibility by reason of internal or external illumination. [Zinsser] • Clear: In buildings where you have to keep working, put something across the windows.

21. 3. Write clearly • Make sure antecedents are well defined • John built the experimental setup. Elmer and Fred conducted the experiment. They destroyed the lab and should be fired.

22. 3. Write clearly • Make sure antecedents are well defined • John built the experimental setup. Elmer and Fred conducted the experiment. They destroyed the lab and should be fired. • John built the experimental setup. Elmer and Fred conducted the experiment. Elmer and Fred destroyed the lab and should be fired.

23. 3. Write clearly • Make sure antecedents are well defined • Modern technology has provided advanced prosthetic legs for amputees so that they can remain active and so that they can emulate able-bodied gait.

24. 3. Write clearly • Make sure antecedents are well defined • Modern technology has provided advanced prosthetic legs for amputees so that they can remain active and so that they can emulate able-bodied gait. • Modern technology has provided advanced prosthetic legs to restore able-bodied gait and to enable increased activity levels for amputees.

25. Characteristics of Good Communication • Address your particular audience • Use both words and graphics • Write clearly • Write accurately • Write comprehensively • Write accessibly (i.e., be organized) • Write concisely • Write professionally

26. 4. Write accurately • Inaccuracy confuses and annoys readers • Accuracy is an ethical consideration • Inaccuracy casts doubt on your credibility

27. 4. Write accurately • Accuracy includes completeness • Two types of deceit • Commission • OmissionExample: A new controller tracks to within 1% of the set point, while PID tracks to within 10%. But what were the tuning parameters?What are other options, or other perspectives? • Avoid spin; we are not salespersons

28. 4. Write accurately The mechanics of accuracy: • Accuracy includes corectspelllling. • Accuracy, includes correct punctuation. • Accuracy include correct grammar. • accuracy Includes correct Capitalization. • Accuracy includes correct spacing.

29. 4. Write accurately • Technical writing should be objective and unbiased. It should not be sales literature. • Ugly: Our new optimization algorithm far outperforms all other methods and is clearly the best algorithm that has ever been invented. • Bad: Our new optimization algorithm outperforms differential evolution. • Good: Our new algorithm outperforms differential evolution in terms of convergence speed for the benchmarks that we investigated and the tuning parameters that we used.

30. Characteristics of Good Communication • Address your particular audience • Use both words and graphics • Write clearly • Write accurately • Write comprehensively • Write accessibly (i.e., be organized) • Write concisely • Write professionally

31. 5. Write comprehensively • Provide background information (introduction) • Technical background • Define acronyms (within reason) • Experimental background • Provide details • Clearly refer to supporting materials (references) • Allow (even encourage) the reader to reproduce your results

32. 5. Write comprehensively • This paper discusses various experiments with FCs, including tradeoffs related to materials and tolerances.

33. 5. Write comprehensively • This paper discusses various experiments with FCs, including tradeoffs related to materials and tolerances. • Flux capacitors (FCs) are a new … Initial research was reported in … This paper discusses various experiments with FCs, including tradeoffs related to materials and tolerances.

34. 5. Write comprehensively • Genetic algorithm results are shown in Fig. 3.

35. 5. Write comprehensively • Genetic algorithm results are shown in Fig. 3. • The genetic algorithm was run with a mutation rate of 0.01, a crossover rate of 0.9, a population size of 50, an elitism parameter of 4, and roulette wheel selection. Results are shown in Fig. 3. These results can be duplicated with the PIC assembly code at www.micropicga.com.

36. Characteristics of Good Communication • Address your particular audience • Use both words and graphics • Write clearly • Write accurately • Write comprehensively • Write accessibly (i.e., be organized) • Write concisely • Write professionally

37. 6. Write accessibly Make your writing is clear and organized • Abstract: 100200 word summary of results • Introduction, including overview of paper • Sections • Subsections • Paragraphs • Conclusion • Summary • Future work • References – unnumbered section • Appendices

38. Characteristics of Good Communication • Address your particular audience • Use both words and graphics • Write clearly • Write accurately • Write comprehensively • Write accessibly (i.e., be organized) • Write concisely • Write professionally

39. 7. Write concisely • Eliminate and eradicate words and terms which, due to their repetitiveness and redundancy, do not serve a useful or functional purpose, and that do not add to or augment the intended meaning.

40. 7. Write concisely • Eliminate and eradicate words and terms which, due to their repetitiveness and redundancy, do not serve a useful or functional purpose, and that do not add to or augment the intended meaning. • Eliminate unnecessary words.

41. 7. Write concisely • Eliminate and eradicate words and terms which, due to their repetitiveness and redundancy, do not serve a useful or functional purpose, and that do not add to or augment the intended meaning. • Eliminate unnecessary words. • Don’t repeat yourself. • Also, don’t say the same thing more than once.

42. 7. Write concisely Use short words The proposed methodology endeavors to facilitate the utilization of the assembler.

43. 7. Write concisely Use short words The proposed methodologyendeavors to facilitate the utilization of the assembler. The proposed methodmakes it easier to use the assembler.

44. 7. Write concisely Replace phrases with words Our students’ excellence is due to the fact that our professors are hired for the purpose of teaching, with the possible exception of Dr. Einstein.

45. 7. Write concisely Replace phrases with words Our students’ excellence is due to the fact that our professors are hired for the purpose of teaching, with the possible exception of Dr. Einstein. Our students are excellent because our professors are hired for teaching, except for Dr. Einstein.

46. 7. Write concisely Replace phrases with words This paper provides a review of the basic tenets of cancer biology study design, using as examples studies that illustrate the methodological challenges or that demonstrate successful solutions to the difficulties inherent in biological research.

47. 7. Write concisely Replace phrases with words This paper provides a review of the basic tenets of cancer biology study design, using as examples studies that illustrate the methodological challenges or that demonstratesuccessful solutions to the difficulties inherent in biological research. This paper reviewscancer biology study design, using examples that illustrate the challenges and solutions.http://www.youtube.com/watch?v=91jo4kX7Cq0

48. 7. Write concisely Replace verb-noun combinations with active verbs • Obtain estimates of  Estimate • Has seen an expansion of  Has expanded • Provides an emphasis  Emphasizes • Take an assessment of  Assess • Conduct a review of  Review • Offer confirmation  Confirm • Make a decision  Decide • Shows a peak  Peakshttp://www.youtube.com/watch?v=O-NZFSrqHB0

49. Characteristics of Good Communication • Address your particular audience • Use both words and graphics • Write clearly • Write accurately • Write comprehensively • Write accessibly (i.e., be organized) • Write concisely • Write professionally

50. 8. Write professionally • Your writing is a reflection of your ability • Referencing and ethics (Lectures 2 and 3) • Use correct and consistent formatting • Page layout • Section headings • Margins • Font • Capitalization • Reference formatting