{@code
ScriptContext.load('http://autoplot.org/data/somedata.dat')
ScriptContext.writeToPdf('/tmp/foo.pdf')
*}
* plot([1,2,3])
* popup=newWindow('popup')
* setWindow(popup)
* plot([3,2,1])
*
* @param app the application
* @see #setWindow(org.autoplot.ApplicationModel)
* @see #newApplication(java.lang.String)
*/
public static synchronized void setApplication( AutoplotUI app ) {
setApplicationModel(app.applicationModel);
setView(app);
appLookup.put( app.applicationModel, app );
}
/**
* reset the script focus to the default application.
*/
public static synchronized void setDefaultApplication() {
setApplication(defaultApp);
}
/**
* Set the application model. This is the simplest Autoplot implementation
* existing, where there are no buttons, etc.
* @param appm
* @see #newWindow(java.lang.String)
* @see #getWindow() which returns the current window.
* @see #setApplication(org.autoplot.AutoplotUI) which creates another application.
*/
public static synchronized void setWindow( ApplicationModel appm ) {
AutoplotUI app= appLookup.get(appm);
if (app==null ) {
view= null;
} else {
view= app;
}
setApplicationModel(appm);
}
/**
* return the focus application.
* @return the focus application.
*/
public static synchronized AutoplotUI getApplication() {
return view;
}
/**
* return the internal handle for the window and dom within.
* @return the internal handle for the application.
*/
public static synchronized ApplicationModel getWindow() {
return model;
}
private static final Map
*ds= ripples(20,20)
*plot( 0, ds )
*sliceWindow= newApplication('slice')
*setApplication(sliceWindow)
*plot( slice0(ds,0) )
* {@code
*plot( 0, 'label', findgen(20), ripples(20), ripples(20), 'digital' )
*from org.autoplot import RenderType
*plot( 0, 'label', findgen(20), ripples(20), ripples(20), RenderType.digital.toString() )
*}{@code
*plot( 0, 'label', findgen(20), ripples(20), ripples(20), 'digital' )
*from org.autoplot import RenderType
*plot( 0, 'label', findgen(20), ripples(20), ripples(20), RenderType.digital.toString() )
*}{@code
def boxLookup( evt ):
showMessageDialog( "start: (%s,%s)
finish: (%s,%s)" %
( evt.getStartX(), evt.getStartY(),
evt.getFinishX(), evt.getFinishY() ) )
addMouseModule( dom.plots[0], 'Box Lookup', boxLookup )
*}
* @param plot the plot which will receive the events.
* @param label a label for the mouse module.
* @param listener the PyFunction to call with new events.
* @return the mouse module.
* @see org.das2.event.MouseModule#setDragRenderer(org.das2.event.DragRenderer) setDragRenderer to see how to set how feedback can be provided.
* @see org.das2.event.BoxSelectionEvent BoxSelectionEvent for the methods of the event.
*
*/
public static MouseModule addMouseModule( Plot plot, String label, final PyFunction listener ) {
DasPlot p= plot.getController().getDasPlot();
BoxSelectorMouseModule mm= new BoxSelectorMouseModule( p, p.getXAxis(), p.getYAxis(), null, new BoxRenderer(p), label );
BoxSelectionListener bsl= (BoxSelectionEvent e) -> {
listener.__call__(Py.java2py(e));
};
mm.addBoxSelectionListener(bsl);
p.getDasMouseInputAdapter().setPrimaryModule(mm);
return mm;
}
/**
* add code that will paint custom graphics on the canvas or on a plot.
* The command will be invoked after all other painting is done, making
* the decoration to be on top. Note plots can only have one decoration,
* and the Canvas can have any number. Calling reset() will remove all
* decorations.
*{@code
def paint(g):
for i in xrange(0,1000,100):
g.drawOval(500-i/2,500-i/2,i,i)
addTopDecoration( dom.canvases[0], paint )
*}{@code
def paint(g):
g.color= Color.BLUE
for i in xrange(0,1000,100):
g.drawOval(500-i/2,500-i/2,i,i)
addBottomDecoration( dom.canvases[0], paint )
*}{@code
*dpr= createDataPointRecorder()
*addTab( 'digitizer', dpr )
*}{@code
*report= createApplicationModel()
*addTab( 'report', report.canvas )
*report.setDataSet(linspace(0,1,101))
*}{@code
* in: file://tmp/data/autoplot.png
* out: /tmp/data/autoplot.png
* in: test016_006.png
* out: test016_006.png
* in: http://autoplot.org/data/
* throws IllegalArgumentException
* in: file://tmp/data/autoplot.xls?sheet=sheet1
* out: /tmp/data/autoplot.xls?sheet=sheet1
* in: /tmp/has spaces.png
* out: /tmp/has spaces.png
* in: C:\Users\Documents and Settings\
* out: C:\Users\Documents and Settings\
*}
* @param filename like "file:/tmp/data/autoplot.png"
* @return "/tmp/data/autoplot.png"
* @throws IllegalArgumentException if the filename reference is not a local reference.
*/
private static String getLocalFilename( String filename ) {
String fp;
String qp=null; // query part
int iq= filename.indexOf('?');
if ( iq>-1 ) {
fp = filename.substring(0,iq);
qp= filename.substring(iq);
} else {
fp= filename;
}
if ( filename.contains("/") || filename.contains("\\") ) {
URISplit split= URISplit.parse(filename);
if ( split.path==null ) {
throw new IllegalArgumentException("something is wrong with the specified filename: "+filename);
}
if ( !"file".equals(split.scheme) ) {
throw new IllegalArgumentException("cannot write to "+filename+ " because it must be local file");
}
if ( fp.startsWith("file:") ) {
filename= split.file.substring(split.scheme.length()+1); //TODO: this is sloppy.
if ( split.params!=null ) {
filename= filename + "?"+ split.params;
}
if ( filename.startsWith("///" ) ) filename= filename.substring(2);
return filename;
} else {
if ( qp!=null ) {
return fp + qp;
} else {
return fp;
}
}
} else {
String pwd= new File("").getAbsolutePath();
return pwd + File.separator + filename;
}
}
/**
* write out the current canvas to a png file.
* TODO: bug 557: this has issues with the size. It's coded to get the size from
* the DOM, but if it is fitted and has a container it must get size from
* the container. Use writeToPng( filename, width, height ) instead for now.
* See writeToPdf(String filename), which appears to have a fix for this that
* would affect how this is resolved.
* Note for relative references, this will use the Java process present working directory (PWD) instead
* of the PWD variable found in scripts
* @param filename The name of a local file
* @throws java.io.IOException
*/
public static void writeToPng(String filename) throws IOException {
setStatus("writing to "+filename);
if ( !( filename.endsWith(".png") || filename.endsWith(".PNG") ) ) {
filename= filename + ".png";
}
filename= getLocalFilename(filename);
waitUntilIdle();
int width= model.getDocumentModel().getCanvases(0).getWidth();
int height= model.getDocumentModel().getCanvases(0).getHeight();
logger.log(Level.FINER, "writeToPng {0} by {1} {2}", new Object[]{width, height, filename});
writeToPng( filename, width, height );
File f= new File(filename);
setStatus("wrote to "+f.getAbsolutePath());
}
private static void maybeMakeParent( String filename ) throws IOException {
filename= getLocalFilename(filename);
File file= new File(filename);
File parentFile= file.getParentFile();
if ( parentFile!=null ) { // relative filenames are okay.
if ( !parentFile.exists() ) {
if ( !parentFile.mkdirs() ) {
throw new IOException( "unable to mkdir: "+file.getParentFile() );
}
}
}
}
/**
* The name of the script which results in the image, optionally with its arguments.
* @see org.das2.util.DasPNGConstants
*/
public static final String PNG_KEY_SCRIPT="AutoplotScriptURI";
/**
* The Autoplot .vap file which results in the image, optionally with "?" and modifiers.
* @see org.das2.util.DasPNGConstants
*/
public static final String PNG_KEY_VAP="AutoplotVap";
/**
* The Autoplot URI which results in the image.
* @see org.das2.util.DasPNGConstants
*/
public static final String PNG_KEY_URI="AutoplotURI";
/**
* write out the current canvas to a png file.
* TODO: bug 557: this has issues with the size. It's coded to get the size from
* the DOM, but if it is fitted and has a container it must get size from
* the container. User writeToPng( filename, width, height ) instead for now.
* See writeToPdf(String filename), which appears to have a fix for this that
* would affect how this is resolved.
* Note for relative references, this will use the Java process present working directory (PWD) instead
* of the PWD variable found in scripts
* @param filename The name of a local file
* @param width the width in pixels of the png
* @param height the height in pixels of the png
* @throws java.io.IOException
*/
public static void writeToPng( String filename, int width, int height ) throws IOException {
filename= getLocalFilename(filename);
BufferedImage image = model.canvas.getImage( width, height );
Logger llogger= Logger.getLogger("autoplot.scriptcontext.writeToPng");
llogger.log(Level.FINE, "writeToPng({0},{1},{2})->{3},{4} image.", new Object[]{filename, width, height, image.getWidth(), image.getHeight()});
Map
* uri= 'http://cdaweb.gsfc.nasa.gov/istp_public/data/polar/hyd_h0/$Y/po_h0_hyd_$Y$m$d_v01.cdf?ELECTRON_DIFFERENTIAL_ENERGY_FLUX'
* xx= getTimeRangesFor( uri, '2000-jan', '$Y-$d-$m' )
* for x in xx:
* print x
*
*
* @param surl an Autoplot uri with an aggregation specifier.
* @param timeRange a string that is parsed to a time range, such as "2001"
* @param format format for the result, such as "%Y-%m-%d"
* @return a list of URLs without the aggregation specifier.
* @throws java.io.IOException if the remote folder cannot be listed.
* @throws java.text.ParseException if the timerange cannot be parsed.
*/
public static String[] getTimeRangesFor(String surl, String timeRange, String format) throws IOException, ParseException {
return org.autoplot.jythonsupport.Util.getTimeRangesFor( surl, timeRange, format );
}
/**
* Given a spec to format timeranges and a range to contain each timerange,
* produce a list of all timeranges covering the range formatted with the
* spec. For example, generateTimeRanges( "%Y-%m-%d", "Jun 2009" ) would result in
* 2009-06-01, 2009-06-02, ..., 2009-06-30.
* @param spec such as "%Y-%m". Note specs like "%Y%m" will not be parsable.
* @param srange range limiting the list, such as "2009"
* @return a string array of formatted time ranges, such as [ "2009-01", "2009-02", ..., "2009-12" ]
* @throws java.text.ParseException of the outer range cannot be parsed.
*/
public static String[] generateTimeRanges( String spec, String srange ) throws ParseException {
return org.autoplot.jythonsupport.Util.generateTimeRanges( spec, srange );
}
/**
* return a list of completions. This is useful in the IDL context
* as well as Jython scripts. This will perform the completion for where the carot is
* at the end of the string. Only completions where maybePlot indicates the URI is now
* valid are returned, so for example http://autoplot.org/data/somedata.cdf?noDep is not
* returned and http://autoplot.org/data/somedata.cdf?Magnitude is.
* Note this is included to continue support as this is described in http://autoplot.org/developer.idlMatlab.
* @param file, for example http://autoplot.org/data/somedata.cdf?
* @return list of completions, containing the entire URI.
* @throws java.lang.Exception any exception thrown by the data source.
*/
public static String[] getCompletions( String file ) throws Exception {
return org.autoplot.jythonsupport.Util.getAllCompletions(file);
}
/**
* sleep for so many milliseconds. This is introduced to avoid the import,
* which makes running scripts securely non-trivial.
* @param millis number of milliseconds to pause execution
*/
public static void sleep( int millis ) {
org.autoplot.jythonsupport.Util.sleep( millis );
}
/**
* Export the data into a format implied by the filename extension.
* See the export data dialog for additional parameters available for formatting.
*
* For example:
*
{@code
* ds= getDataSet('http://autoplot.org/data/somedata.cdf?BGSEc')
* formatDataSet( ds, 'vap+dat:file:/home/jbf/temp/foo.dat?tformat=minutes&format=6.2f')
*}{@code
* ds= getDataSet('http://autoplot.org/data/somedata.cdf?BGSEc')
* formatDataSet( ds, 'vap+dat:file:/home/jbf/temp/foo.dat?tformat=minutes&format=6.2f')
* formatDataSet( ds, 'foo.dat' ) # also okay
*}{@code
* model= getApplicationModel()
* bind( model.getPlotDefaults(), "title", model.getPlotDefaults().getXAxis(), "label" )
*}{@code
* model= getApplicationModel()
* bind( model.getPlotDefaults(), "title", model.getPlotDefaults().getXAxis(), "label" )
*}{@code
* model= getApplicationModel()
* bind( model.getPlotDefaults(), "title", model.getPlotDefaults().getXAxis(), "label" )
*}
*ds= getDataSet('http://autoplot.org/data/somedata.cdf?BGSEc')
*from java.lang import System
*dumpToQStream( ds, System.out, True )
*