[Kst] branches/work/kst/newdocs/doc/kst
Duncan Hanson
duncan.hanson at gmail.com
Mon Apr 2 07:30:41 CEST 2007
SVN commit 649113 by dhanson:
all datasources use KIO- although indirect does claim non .cur files for itself sometimes...
D Screenshot-kst-data-indirectexample.png
M +5 -18 data-chapter.docbook
--- branches/work/kst/newdocs/doc/kst/data-chapter.docbook #649112:649113
@@ -1485,6 +1485,10 @@
If you have a data format which you would like &kst; to read, it's easy to <link linkend="supportingadditionalfileformats">create</link> your own.
</para>
+<para>
+All of the data sources read from files using KIO, which is usually able to load data through common file compression formats (eg. BZIP2, GZIP, ZIP, TAR) and most popular networking protocols (eg. HTTP, FTP, SFTP, SMB). For more information on which formats are supported on your system type <userinput><command>kinfocenter</command></userinput> at the command line and inspect the protocols tab. If &kst; detects that you have typed a URL into the filename of a vector or matrix, for example, a '<guibutton>Connect</guibutton>' button will appear. Clicking the <guibutton>Connect</guibutton> button instructs &kst; to load the indicated data, and channel it to a suitable data source.
+</para>
+
<anchor id="data-sources-concepts"></anchor>
<para>
The following concepts are important in understanding how &kst; works with
@@ -1763,25 +1767,8 @@
<sect2 id="data-sources-indirect">
<title>Indirect</title>
<para>
-This is a 'helper' data source, which allows you to access data through an intermediate layer, such as file compression or an internet protocol.
+This is a 'helper' data source, which allows you to access data through a file pointer. If you put the URL or path of a data file on the first line of a text file with the extension '.cur', then the Indirect data source is used to load the referenced file. The use of this is that the contents of the '.cur' file can then be externally modified to change the data file which is loaded by &kst;.
</para>
-
-<para>
-A common use of the Indirect data source is to create dynamic file pointers. If you put the path or URL of a data file on the first line of a text file, and give it the extension '.cur', then the Indirect data source is used to load the referenced file. The contents of the '.cur' file can then be externally modified to change the data files loaded by &kst;.
-</para>
-
-<para>
-The Indirect data source also supports all of the data types read KIO, which is usually configured to understand the most common file compression formats (eg. BZIP2, GZIP, ZIP, TAR) and most popular networking protocols (eg. HTTP, FTP, SFTP, SMB). For more information on which formats are supported on your system type <userinput><command>kinfocenter</command></userinput> at the command line and inspect the protocols tab. A sample use of the Indirect data source comes when you have data data stored at a location given by a URL rather than on your computer. If &kst; detects that you have typed a URL into the filename of a vector or matrix, a '<guibutton>Connect</guibutton>' button will appear, provided by the Indirect data source. Clicking the <guibutton>Connect</guibutton> button instructs the Indirect datasource to load the indicated data, and channel it to a suitable data source. An example of the Indirect data source downloading a .fits file from a remote server is shown i
n the screenshot below.
-</para>
-
-<screenshot>
-<screeninfo>Indirect example</screeninfo>
-<mediaobject>
-<imageobject>
-<imagedata fileref="Screenshot-kst-data-indirectexample.png" format="PNG" />
-</imageobject>
-</mediaobject>
-</screenshot>
</sect2>
<sect2 id="data-sources-cdf">
More information about the Kst
mailing list