!!!{{{EIS_XSTUDY}}}
[{TableOfContents}]
!!About
The {{{eis_xstudy}}} routine is actually a component of the EIS Planning Tool, and is used in both the construction of a timeline ({{{eis_mk_plan}}}) — to load something from the OSDB (official studies database) — and in {{{eis_mk_study}}}, used to select a study for modification in your own personal database before submission to the OSDB.

To look at the OSDB, ensure that you have already run the command

{{{print,fix_zdbase(/eis)}}}

to instruct the planning tool to read from the OSDB.
%%information To look at your personal database instead (where you keep studies that you're designing) just replace {{{/eis}}} with {{{/user}}} in the above line.



!!Walk-through

!The {{{eis_xstudy}}} interface

Below is an example of the widget that appears in SolarSoft when you type {{{eis_xstudy}}}:
[{Image src='EIS_XSTUDY.png'}]

!Study list
The top panel contains a list of all the studies in the database.
I've cheated a little bit, in the sense that I've already scrolled down the list in the upper panel and chosen Study ID #267, the catchily-named {{{JS_CH_140x256p}}}

At the top of this widget there are two black triangular arrows. These can be used to reduce (down arrow) or increase (up arrow) the number of lines shown in the study list. (This can be especially useful if your screen is a lot smaller than the default widget size.) This looks like so:

[{Image src='EIS_XSTUDY_shrunk.png'}]

There's also a button at the top of the widget marked ''View/Edit Study Description''. I'll come back to that in a while.

!Information bar
In the status bar immediately beneath the study list is a sort of information bar: here you can see important information such as the amount of data that the study is expected to generate in kbits (this is approximate, since compression factors vary a little from dataset to dataset), the duration in hours minutes and seconds (fixed, but with a little margin added), and the consequent rate of telemetry from EIS to the Hinode Data Recorder (DR).

The volume here is probably one of the most important factors, since it determines how many times (if any!) a study can be run during an OP Period — see [SbandObservingInfo] for what this means in practice.