search

swcarpentry / DEPRECATED-bc

DEPRECATED: This repository is now frozen - please see individual lesson repositories.
Other
299 stars 383 forks source link

Translate novice introduction into MATLAB #557

Closed gvwilson closed 10 years ago

gvwilson commented 10 years ago

Our lessons on Python and R use the same basic examples (analyzing inflammation data), and present topics in more or less the same order. While MathWorks has kindly open-licensed some excellent teaching material (see the matlab branch of this repository), life would be simpler if we had MATLAB lessons that were consistent with our Python and R. This should go in a novice/matlab directory in a fresh branch.

The current Python topics are listed below. There's no requirement for the MATLAB lessons to stick exactly to this order, or this division of material, but it seems like a good starting point. If you'd like to tackle one of these topics, please add your name(s) in a comment on this issue.

shwina commented 10 years ago

Hello!

I'd consider myself a competent Matlab/Python programmer and a novice Git user, and I'd be very excited to contribute here. This would be my first time contributing, so you might need to be a little patient with me! - Ashwin Srinath

To begin with, here are my proposed objectives for the section on "Loading and visalizing data":

  1. Explain Matlab arrays -- what they can represent that scalars can't, how to create one, and how to load one from a .txt or .csv.
  2. Explain Matlab functions -- and show that they can generate, modify or extract information from/about arrays.
  3. Read tabular data from a file.
  4. Assign scalars and arrays to variables.
  5. Select individual values and subsections from arrays.
  6. Display simple graphs.

I'm not sure if making the distinction between a "vector" and a "matrix" is a good idea at this point -- the NumPy tutorial did not.

I'll start working on a first draft, and I'm looking forward to comments!

mghamsar commented 10 years ago

I'm also interested in this topic. Would the part on writing functions overlap with your explanation of functions within "Loading and visualizing data"?? I was interested in looking at the writing functions part in Matlab.

shwina commented 10 years ago

Hello!

I'm working on translating the first Python lesson- "Analyzing Patient Data" , to Matlab. You can check it out here https://github.com/ashwinsrnth/bc. If there's anything you'd like me to do differently, please let me know. The second Python lesson is on "Creating Functions". Would you be interested in translating it to Matlab? I don't think that there should be any overlap, since I didn't particularly introduce any new concepts. Also, if like me, this is your first time contributing to swc, I'm more than happy to help!

Thanks, Ashwin

On Fri, Jul 18, 2014 at 11:57 AM, mghamsar notifications@github.com wrote:

I'm also interested in this topic. Would the part on writing functions overlap with your explanation of functions within "Loading and visualizing data"?? I was interested in looking at the writing functions part in Matlab.

— Reply to this email directly or view it on GitHub https://github.com/swcarpentry/bc/issues/557#issuecomment-49447556.

mghamsar commented 10 years ago

It is my first time too. And it's been a while since I've worked with Matlab so I'll need some time to remember everything. I can work on lesson 2 and I'll look at how you've done part one. I guess if things were too vague we can discuss them here! :)

rgaiacs commented 10 years ago

Translating the second lesson of Python into MATLAB will require more work than the first one since "public" functions has to be write in their own file. I would recommend as first work to translate the lessons about loops and conditionals since it should be a little easy and fast to we review and merge the change.

shwina commented 10 years ago

Thank you, I will get on that ASAP so that we can move forward. I'm still unsure about the Git workflow here. Should I have submitted a pull request? For now, I have linked Raniere to my fork for review.

Thanks, Ashwin

On Saturday, July 19, 2014, r-gaia-cs notifications@github.com wrote:

Translating the second lesson of Python into MATLAB will require more work than the first one since "public" functions has to be write in their own file. I would recommend as first work to translate the lessons about loops and conditionals since it should be a little easy and fast to we review and merge the change.

— Reply to this email directly or view it on GitHub https://github.com/swcarpentry/bc/issues/557#issuecomment-49503556.

rgaiacs commented 10 years ago

Should I have submitted a pull request?

@ashwinsrnth Yes, please.

DamienIrving commented 10 years ago

@gvwilson This issue can probably be closed now - discussion of the MATLAB conversion is now happening at #686