add allen-brain user story by @jsiegle

[jhamman]

towards: #344

cc @jsiegle

[vercel]

@jhamman is attempting to deploy a commit to the xarray Team on Vercel.

A member of the Team first needs to authorize it.

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated
xarray-dev	✅ Ready (Inspect)	Visit Preview	💬 Add your feedback	Mar 28, 2023 at 2:54PM (UTC)

[jhamman]

@andersy005 - any ideas why this is failing to build?

[jhamman]

@jsiegle - I (finally) added the figures here and updated the publish date to this Wednesday. Would you mind giving this a final read through? The preview is here: https://xarray-9qf77ibqu-xarray.vercel.app/blog/xarray-for-neurophysiology

@andersy005, @dcherian, or @TomNicholas - can we get one additional proof read on this?

[andersy005]

💬 @jhamman & @jsiegle, thank you for this addition! i left some comments/suggestions (mostly code formatting)

[TomNicholas]

This looks great! I only have two small comments:

1. It would be nice to explain the relationship between the session class and xarray objects earlier. Currently it's a bit confusing how you create this unfamiliar class, call some functions on it, and then somehow end up in xarray-land. Just a quick statement like "session objects hold all the information about our experiment, including X data which is stored in a wrapped xarray.Dataset".

2. There are some figures which it's implied are produced directly from the given code, but I'm pretty sure aren't, because they have extra annotations. (e.g. "flash stimulus on screen" or "onset response".) Maybe add a figure caption explaining this? Or just use the actual raw figure that would be produced by that code.

[jsiegle]

Here are some edits that address @TomNicholas' suggestions: jsiegle@b5f5ee0

[jhamman]

Thanks again for writing this up @jsiegle! It's live here: https://xarray.dev/blog/xarray-for-neurophysiology

[jsiegle]

No problem, it was fun!