Faith Okamoto

👋🏽 My CV is available. 👋🏽

• Reproduce your work

  (Ideally somewhere else)

  By Faith Okamoto

  Posted on January 25, 2025

  Here’s another post about something that’s relevant to my last week. (I will get around to another code critique before the month ends, I promise, to my nonexistent readers.) [Read More]

  Tags:

  • process
  • last-pass

• Useful error messages

  How did I mess up?

  By Faith Okamoto

  Posted on January 10, 2025

  Since I made two recent pull requests about graceful errors, I figured I’d talk about why this is so important. In general, you should try to anticipate common issues the end-user might run into. Those errors should cause useful, descriptive error/warning messages. [Read More]

  Tags:

  • errors

• In praise of writing documentation

  Yes, I actually enjoy this

  By Faith Okamoto

  Posted on January 4, 2025

  I’m ill and having difficulty concentrating. Somehow writing documentation came to mind. There’s no way I could write new code in my current state, but I’d be just fine with documentation. [Read More]

  Tags:

  • documentation
  • docstrings

• Do a final cleanup

  December 2024

  By Faith Okamoto

  Posted on December 23, 2024

  I’ve blathered on for ten posts about my code habits. Now I’ll look at other scientists’ code. This blog post is the first of a series. Once a month, I’ll critique the code released by a recent paper. Hopefully concrete examples will make clear principles I’ve discussed. [Read More]

  Tags:

  • published-code-critique
  • last-pass

• Explain your science

  Including your assumptions

  By Faith Okamoto

  Posted on December 7, 2024

  Science code, at least theoretically, represents something tangible. Modeling the spread of a virus in simulated populations. Parsing gads of sensor output for peaks of relevant data. Graphing statistics on tests taken across a country. Because we deal with stuff that has concrete meaning, concrete and defensible constraints crop up... [Read More]

  Tags:

  • comments
  • science-meaning
  • screed

• Newer Posts
• Older Posts