| | 1 | = Infrequently Asked Questions = |
| | 2 | |
| | 3 | == (and known bugs/problems) == |
| | 4 | |
| | 5 | You may also want to take a look at the [wiki:VsoFAQ Frequently Asked Questions] list. |
| | 6 | |
| | 7 | |
| | 8 | == Questions == |
| | 9 | |
| | 10 | |
| | 11 | === How do I file a problem report or suggestion for improvement? === |
| | 12 | |
| | 13 | |
| | 14 | |
| | 15 | We suggest you use |
| | 16 | our general feedback form |
| | 17 | '''[http://virtualsolar.org/feedback/ http://virtualsolar.org/feedback/]''', |
| | 18 | or email your reports/comments/suggestions to: |
| | 19 | ''VSO-AT-spd.aas.org''. You can also fill out our |
| | 20 | '''[http://vso.stanford.edu/vso_feedback.html user survey]''' so we can |
| | 21 | prioritize based on the needs of the user community. |
| | 22 | |
| | 23 | You should also check that you are using the most recent version |
| | 24 | of VSO. The most recent link will always be available from the VSO homepage |
| | 25 | at '''http://virtualsolar.org/'''. |
| | 26 | |
| | 27 | === I have a digital data archive and I would like to make the data available through VSO. What do I have to do? === |
| | 28 | |
| | 29 | Please contact one of the VSO scientists (Rick Bogart, Joe Gurman, Frank Hill, |
| | 30 | Piet Martens) and let us know of your interest. Extension of data service |
| | 31 | providers is the highest priority for VSO. We have an adoptor's kit, and |
| | 32 | assistance available to help tie your archive into VSO. |
| | 33 | |
| | 34 | The majority of the work from the provider is in attempting to describe |
| | 35 | your holdings in terms of the VSO Data Model, so that the VSO has |
| | 36 | accurate information about the type of information that your organization |
| | 37 | providers. |
| | 38 | |
| | 39 | === Are there limits to the number of query results returned? If so, what are they? === |
| | 40 | |
| | 41 | Yes. Each data provider may have limits to prevent their systems |
| | 42 | from returning exceptionally large results. Because of the way in which |
| | 43 | VSO breaks queries down into simpler queries for the individual data |
| | 44 | providers to process, it is difficult to say just how many records an |
| | 45 | individual data provider will return. |
| | 46 | |
| | 47 | === How do I know if the number of query results was truncated by the data server? === |
| | 48 | |
| | 49 | The results page lists two numbers -- the number of records returned, and the |
| | 50 | number of records found. If the two are not equal, it means that one the |
| | 51 | data providers has reached its internal limit, and not returned all of its |
| | 52 | records that matched the query. If the number of records found is not displayed, |
| | 53 | it suggests that the data provider had reached its limit, but did not determine |
| | 54 | how many additional records there were. [This should only occur if the cost in |
| | 55 | performing an exhaustive search would be prohibitive]. |
| | 56 | |
| | 57 | We are trying to find a good balance between obtaining the desired results, |
| | 58 | while preventing there from being an undue burden on individual data archives, |
| | 59 | and the mechanisms for handling this scenario may be changed in the future. |
| | 60 | |
| | 61 | === When I request data, do they have to go through the VSO? How long does it take to get the data? === |
| | 62 | |
| | 63 | No data go through VSO. VSO only handles the process of locating, and ordering |
| | 64 | the data. The actual data delivery is handled by the user and the individual |
| | 65 | data providers, although it is possible that some user interfaces may add |
| | 66 | additional value by automatically following URLs to download information. |
| | 67 | For more information about the transfer of data, see the |
| | 68 | '''[http://vso1.nascom.nasa.gov/API/VSO_API.html#negotiation API documentation on Transfer Negotiation]'''. Additional information is available |
| | 69 | for the '''[http://vso.nascom.nasa.gov/cgi-bin/show_details.pl?keyword=PROVIDER data providers]''', but |
| | 70 | is currently in the process of being updated. |
| | 71 | |
| | 72 | === When I submit a query, at the end of the list of results it says Session ID: followed by a long incomprehensible hexadecimal string. What does it mean? === |
| | 73 | |
| | 74 | You may be using an older version of VSO. Please make sure you are |
| | 75 | connecting to the most recent |
| | 76 | '''[http://vso.nascom.nasa.gov/cgi-bin/search VSO Search Interface]'''. We are experimenting with mechanisms for recording |
| | 77 | search parameters and/or results (at the option of the user), so that |
| | 78 | any particular |
| | 79 | useful query can automatically be regenerated if desired, or referred to |
| | 80 | in publication of results. |
| | 81 | |
| | 82 | |
| | 83 | |
| | 84 | === All queries seem to go through and require the (''some organization'') VSO site. What is virtual about the Virtual Solar Observatory? === |
| | 85 | |
| | 86 | There originally was a single prototype implementation at Stanford. That has |
| | 87 | since been replaced with a system that is distributed across Stanford, NASA, |
| | 88 | and NSO, not including the functionality at each of the individual data |
| | 89 | providers. |
| | 90 | |
| | 91 | What is virtual about VSO is that there is no one master archive or |
| | 92 | database of all of the holdings. There is a point of entry that users |
| | 93 | or applications can interact with, to access data that is spread across multiple |
| | 94 | systems. This concept is commonly refered to as 'Data Virtualization'. Additionally, |
| | 95 | there is virtualization on another scale, as there is no one single server -- |
| | 96 | Although there is a reference system, at |
| | 97 | '''http://virtualsolar.org/''', its |
| | 98 | purpose is to provide a unified starting point to people new to the VSO, |
| | 99 | and is not involved with the actual processing of the VSO, which currently |
| | 100 | has multiplexors at SDAC, Stanford, and NSO. |
| | 101 | |
| | 102 | === The information in the server data registries does not always match what is actually searchable. Are the displayed data registries different from those used by the user interface? === |
| | 103 | |
| | 104 | Please '''[wiki:ContactUs send us details]''' |
| | 105 | about what you have found that doesn't seem to be in agreement, or |
| | 106 | what query you used, that you had expected data to be returned for. |
| | 107 | |
| | 108 | === What do all the funny colors on the results pages mean? === |
| | 109 | |
| | 110 | For ease of navigating among large numbers of return results, every |
| | 111 | fifth entry from each data provider is highlighted in yellow, every |
| | 112 | tenth in green, and every hundredth in blue. No special significance |
| | 113 | attaches to these entries. |
| | 114 | |
| | 115 | |
| | 116 | == Problems == |
| | 117 | |
| | 118 | === When I query data from the (Montana State University|Mauna Loa) archive, I get lists in which apparently identical data sets are reproduced from two to seven times. When I download these data sets, they are indeed identical. === |
| | 119 | |
| | 120 | Observations in the MSU Yohkoh SXT archive are catalogued individually but packaged |
| | 121 | together in orbit files. If several observations in the same file match |
| | 122 | the search criterion they will each return a record, but the records will |
| | 123 | all point to the same distribution file. Downloading any one will of course |
| | 124 | get you all the data in the orbit file. |
| | 125 | |
| | 126 | Observations in the MLSO archive are stored in both JPEG and FITS formats. |
| | 127 | Although the observations occur in the listings twice, they point to |
| | 128 | different data products. It is possible that this may change in the future, |
| | 129 | depending on user feedback. #13 |
| | 130 | |
| | 131 | === I don't see any data from the McMath FTS Spectrometer, though it shows up in the NSO list of instruments. === |
| | 132 | |
| | 133 | The VSO has helped us to shed light on the fact that some metadata |
| | 134 | are not correct. In this particular case, most of the datasets listed |
| | 135 | from the Kitt Peak 512-Channel Magnetograph |
| | 136 | and from the Evans Spectroheliograph have end times earlier than the start |
| | 137 | times. Occasionally there are multiple entries that are apparently identical |
| | 138 | (e.g. KPVT Magnetograph 1993.04.10). |
| | 139 | |
| | 140 | === I don't see any data for the last day of my time range request from the GOLF instrument, even though I know it is there; it shows up if I extend the range of time by even one minute. === |
| | 141 | |
| | 142 | Please make sure you are using the most recent version of VSO. Early versions |
| | 143 | of VSO required the observation to be completely contained within the search |
| | 144 | range. The current implementation performs range matching by searching for |
| | 145 | non-vanishing intersection. |
| | 146 | |
| | 147 | |
| | 148 | === When I query the Stanford Heleioseismology Archive for ground-based data I sometimes see records whose start and end times are both outside my requested time interval. === |
| | 149 | |
| | 150 | Range matches (in this case, time range), is done by finding a non-vanishing |
| | 151 | intersection. If you would prefer a different type of range matching, please |
| | 152 | '''[wiki:ContactUs let us know]''', so we can |
| | 153 | prioritize new functionality. |
| | 154 | |
| | 155 | The Stanford datasets are generally for sets of images spanning a long |
| | 156 | time interval, typically a day for ground-based instruments. Although |
| | 157 | the datasets have registered start and end times corresponding to the |
| | 158 | first and last images of the day, they are in fact searched by an index |
| | 159 | number corresponding to the day number, starting at local midnight. |
| | 160 | In order to assure that no relevant records are missed from sites whose |
| | 161 | observations can span two UT days, the Stanford server returns matches |
| | 162 | for both day numbers. |