JChartLib ver 1.0. Silvio Schneider, June 7, Introduction 3. 2 Chart and Dataset 4. 3 Adding data to a chart 4

Size: px

Start display at page:

Download "JChartLib ver 1.0. Silvio Schneider, June 7, Introduction 3. 2 Chart and Dataset 4. 3 Adding data to a chart 4"

Ashlynn Higgins
6 years ago
Views:

1 JChartLib ver 1.0 Silvio Schneider, June 7, 2012 Contents 1 Introduction 3 2 Chart and Dataset 4 3 Adding data to a chart 4 4 Linechart Linechart Example Linechart with dates Linechart with negativ values Linechart with float values Linechart with dots and showing min and max values Linechart with custom X-Axis texts Areachart 10 6 Barchart 11 7 Piechart 13 8 Ringchart 15 9 Saving chart to an image file Contact Copyright 18 Index 19 1

3 1 Introduction Hi, I would like to welcome you to the JChartLib manual. In this document you can find an explanation how to use JChartLib. JChartLib is a Java library that enables you to produce charts in a mater of a few minutes. This guide explains the various chart types and has code examples for how to produce them. JChartlib is under a commercial licence. A trial is avialable for free, for longer use a licence must be purchaced. Since JChartlib ver 1.0 new feactures and chart types are included. 3

4 2 Chart and Dataset Every chart contains a dataset. The dataset itself contains dateseries. The dataseries are then containing the data values. In a Linechart a dataserie would contain the data for a single line. In a Barchart the dataserie would contain a serie of bars. Besides the dataset the chart also contains the title and the X-, Y-axis names. In order to display a chart or generate an image file a renderer is used. The renderer draws a chart using the information from chart and dataset. 3 Adding data to a chart Chart data is stored in a JChartLibDataSet. JChartLibDataSet d a t a s e t = new JChartLibDataSet ( ) ; There are several options to add Data to a chart. Dataseries can be added with a int array int [ ] v a l u e s1 = new int [ 3 ] ; values1 [ 0 ] = 1 ; values1 [ 1 ] = 3 ; values1 [ 2 ] = 4 ; or by generating a Dataserie object JChartLibSerie v a l u e s 2 = new JChartLibSerie ( Banana ) ; values2. addvalue ( 5 ) ; values2. addvalue ( 4 ) ; values2. addvalue ( 2 ) ; The dataseries can then be added individually to the dataset d a t a s e t. adddataserie ( Apple, values1 ) ; // adds the Apples d a t a s e t. adddataserie ( v alues2 ) ; // adds the Bananas With this code also the name of the dataserie is getting set. The order for adding the data has an impact in the chart. The first added chart will be drawn first. In a linechart it would be the lowest line. The chartrenderer automatically chooses a color for a dataserie as well. Therefor the order of adding the dataseries also has an impact of the color of the charts. In JChartLib there is no limitation in the amount of data that can be added to a chart. However the Java virtual machine needs RAM, if you add data to the chart. In case you get an out-of-memory exception increase the maximum RAM the JVM can allocate with the -Xmx option. Example java -Xmx756M allows the JVM to allocate a maximum of 756MB of RAM. You can test the maximum value for -Xmx by using the command java -Xmx2G -version. If you chosen size is possible the version will be printed out. To allocate more than 2 Gigabyte of RAM a 64bit Java virtual machine is needed. 4

4 Linechart 4.1 Linechart Example Example for a Linechart Figure 1: Linechart The thickness of the lines are automatically adjusted depending on the number of values.

5 4 Linechart 4.1 Linechart Example Example for a Linechart Figure 1: Linechart The thickness of the lines are automatically adjusted depending on the number of values. A few data values make thin lines, may values make thiner lines. This makes the charts better to read. To generate a Linechart the Class JChartLibPanel must be used. JChartLibPanel is extending the Java JPanel class and can be used the same way. Source Code Example: //Data JChartLibSerie v a l u e s = new JChartLibSerie ( Name f o r D a t a s e r i e ) ; v a l u e s. addvalue ( 1 ) ; v a l u e s. addvalue ( 5 ) ; v a l u e s. addvalue ( 3 ) ; JChartLibDataSet d a t a s e t = new JChartLibDataSet ( ) ; d a t a s e t. adddataserie ( v a l u e s ) ; // Chart JChartLibLinechart chart = new JChartLibLinechart ( The Chart T i t l e, // c h a r t t i t l e X Axis, // x a x i s t e x t Y Axis, // y a x i s t e x t d a t a s e t // data ) ; // JPanel JChartLibPanel chartpanel = new JChartLibPanel ( chart ) ; 5

4.2 Linechart with dates Linechart with dates timeline as X Axis. JChartlib provides an easy way to draw linecharts with dates. You can simple add a value with a date by using JChartLibSerie.

6 4.2 Linechart with dates Linechart with dates timeline as X Axis. JChartlib provides an easy way to draw linecharts with dates. You can simple add a value with a date by using JChartLibSerie.addValue(Date, Number); Here is a code example. Date now = new Date ( ) ; JChartLibSerie v a l u e s = new JChartLibSerie ( Some F r u i t s ) ; v a l u e s. addvalue (now, 5 ) ; JChartlib displays the Day and Time of the first value. On the next value only Hour, Minute and Second is displayed, if the next value is on the same day. As soon as the day changes the day is getting displayed again. The Picture linechart with dates gives an illustration of this algorithm. Figure 2: Linechart with dates as a timeline 6

Figure 3: Linechart with negativ values 4.

7 4.3 Linechart with negativ values JChartLib can also produce Linechart with values less than 0 (ex. 1,-2,5) and floating point values (ex. 1.2, 3.4, 5.7). Figure 3: Linechart with negativ values 4.4 Linechart with float values Chart with floating point data, for example 1.2, is supported by JChartLib. Figure 4: Linechart with float values 7

4.5 Linechart with dots and showing min max values With JChartLib it is possible to show dots on each value. It is also possible to display the min and the maxvalues.

Figure 5: Linechart with activated dots and showing min and max values To active dots and displaying min max value the follow methods can be used // Get t h e Chart Renderer

8 4.5 Linechart with dots and showing min max values With JChartLib it is possible to show dots on each value. It is also possible to display the min and the maxvalues. Both are optional and must be activated. Figure 5: Linechart with activated dots and showing min and max values To active dots and displaying min max value the follow methods can be used // Get t h e Chart Renderer JChartLibLinechartRenderer r e n d e r e r = ( JChartLibLinechartRenderer ) chart. getrender ( ) ; chart. setrender ( r e n d e r e r ) ; // a c t i v a t e d o t s and show min max v a l u e s r e n d e r e r. setdrawdots ( true ) ; r e n d e r e r. setshowminmax ( true ) ; 4.6 Linechart with custom X-Axis texts With JChartLib it is possible to show a custom text on the x-axis. Figure 6: Linechart with custom text on X-Axis // a c t i v a t e ProRenderer JChartLibRenderer r e n d e r e r = new JChartLibLinechartRendererPro ( chart ) ; chart. setrender ( r e n d e r e r ) ; // a c t i v a t e d o t s and show min v a l u e s 8

9 r e n d e r e r. addxaxistext ( Spring ) ; r e n d e r e r. addxaxistext ( Summer ) ; r e n d e r e r. addxaxistext ( F a l l ) ; r e n d e r e r. addxaxistext ( Winter ) ; 9

5 Areachart Areachart is included in JChartLib since version 1.0 Example for a Areachart Figure 7: Areachart Similar to the linechart are the areacharts.

10 5 Areachart Areachart is included in JChartLib since version 1.0 Example for a Areachart Figure 7: Areachart Similar to the linechart are the areacharts. Areacharts can be used exactly the same way as linecharts. The areas are always drawn with some transparency to show the areas underneath. Same as in the linechart it is possible to show some dots on values or to display the min and the maximum value of a serie. See chapter Linechart for more information. To generate a Arecart the Class JChartLibPanel must be used. JChartLibPanel is extending the Java JPanel class and can be used the same way. Source Code Example: //Data JChartLibSerie v a l u e s = new JChartLibSerie ( Name f o r D a t a s e r i e ) ; v a l u e s. addvalue ( 1 ) ; v a l u e s. addvalue ( 5 ) ; v a l u e s. addvalue ( 3 ) ; JChartLibDataSet d a t a s e t = new JChartLibDataSet ( ) ; d a t a s e t. adddataserie ( v a l u e s ) ; // Chart JChartLibAreachart chart = new JChartLibAreachart ( The Chart T i t l e, // c h a r t t i t l e X Axis, // x a x i s t e x t Y Axis, // y a x i s t e x t d a t a s e t // data ) ; // JPanel JChartLibPanel chartpanel = new JChartLibPanel ( chart ) ; 10

6 Barchart Example for a Barchart Figure 8: Barchart The thickness of the bares depends on the number of series. Use the class JChartLibBarchart to generate a barchart.

11 6 Barchart Example for a Barchart Figure 8: Barchart The thickness of the bares depends on the number of series. Use the class JChartLibBarchart to generate a barchart. Source Code Example: //Data JChartLibSerie v a l u e s = new JChartLibSerie ( Name f o r D a t a s e r i e ) ; v a l u e s. addvalue ( 1 ) ; v a l u e s. addvalue ( 5 ) ; v a l u e s. addvalue ( 3 ) ; JChartLibDataSet d a t a s e t = new JChartLibDataSet ( ) ; d a t a s e t. adddataserie ( v a l u e s ) ; // Chart JChartLibBarchart c h a r t = new JChartLibBarchart ( The Chart T i t l e, // c h a r t t i t l e X Axis, // x a x i s t e x t Y Axis, // y a x i s t e x t d a t a s e t // data ) ; // JPanel JChartLibPanel chartpanel = new JChartLibPanel ( chart ) ; 11

12 Since JChartlib version 1.0 JChartLib can also produce Barchart with values less than 0 (ex. 1,-2,5) and floating point values (ex. 1.2, 3.4, 5.7). Charts with with negative values, for example -3, is supported by JChartLib. Chart with floating point data, for example 1.2, is supported by JChartLib. Figure 9: Barchart with negativ and floating point values 12

13 7 Piechart Example for a Piechart Figure 10: Piechart To generate a piechart use the Class JChartLibPiechart. Source Code Example: //Data JChartLibSerie v a l u e s = new JChartLibSerie ( Name f o r D a t a s e r i e ) ; v a l u e s. addvalue ( 1 ) ; v a l u e s. addvalue ( 5 ) ; v a l u e s. addvalue ( 3 ) ; JChartLibDataSet d a t a s e t = new JChartLibDataSet ( ) ; d a t a s e t. adddataserie ( v a l u e s ) ; // Chart JChartLibPiechart chart = new JChartLibPiechart ( The Chart T i t l e, // c h a r t t i t l e, // x a x i s t e x t, l e a v e t h i s empty f o r no t e x t, // y a x i s t e x t, l e a v e t h i s empty f o r no t e x t d a t a s e t // data ) ; // JPanel JChartLibPanel chartpanel = new JChartLibPanel ( chart ) ; 13

Since JChartLib ver 1.0 JChartLib can also produce a Piechart with a piece taken out. JChartLibPiechartRenderer r e n d e r e r = ( JChartLibPiechartRenderer ) chart.

14 Since JChartLib ver 1.0 JChartLib can also produce a Piechart with a piece taken out. JChartLibPiechartRenderer r e n d e r e r = ( JChartLibPiechartRenderer ) chart. getrender ( ) ; chart. setrender ( r e n d e r e r ) ; r e n d e r e r. takeout ( 1 ) ; // t a k e s out the f i r s t p i e c e o f the c h a r t Figure 11: Piechart with piece taken out 14

15 8 Ringchart Since JChartLib ver 1.0 Example for a Ringchart Figure 12: Ringchart To generate a ringchart use the Class JChartLibRingchart. Source Code Example: //Data JChartLibSerie v a l u e s = new JChartLibSerie ( Name f o r D a t a s e r i e ) ; v a l u e s. addvalue ( 1 ) ; v a l u e s. addvalue ( 5 ) ; v a l u e s. addvalue ( 3 ) ; JChartLibDataSet d a t a s e t = new JChartLibDataSet ( ) ; d a t a s e t. adddataserie ( v a l u e s ) ; // Chart JChartLibRingchart chart = new JChartLibRingchart ( The Chart T i t l e, // c h a r t t i t l e, // x a x i s t e x t, l e a v e t h i s empty f o r no t e x t, // y a x i s t e x t, l e a v e t h i s empty f o r no t e x t d a t a s e t // data ) ; // JPanel JChartLibPanel chartpanel = new JChartLibPanel ( chart ) ; 15

16 9 Saving chart to an image file A JChartlib chart can be saved as jpg or png. This is the codeblock for saving a chart to an image. An IOException must be catched in case the storage device is full or write protected. // s a v i n g the c h a r t as j p g and png in the current working d i r e c t o r y try { chart. saveasjpeg ( chart. jpg, 640, ) ; // you can a l s o save i t to a d i r e c t o r y chart. saveaspng( chart. png, 640, ) ; } catch ( IOException ex ) { //Add your a p p l i c a t i o n s p e c i f i c e x c e p t i o n code here System. out. p r i n t l n ( unable to save chart to f i l e ) ; } Here is a full program example, that generates a linechart and save the chart to an image file / JChartLib Demo App f o r s a v i n g a c h a r t to a f i l S i l v i o Schneider / import com. b i t a g e n t u r. chart. JChartLibBaseChart ; import com. b i t a g e n t u r. data. JChartLibDataSet ; import com. b i t a g e n t u r. data. JChartLibSerie ; import java. i o. IOException ; import java. u t i l. l o g g i n g. Level ; import java. u t i l. l o g g i n g. Logger ; / A simple demonstration a p p l i c a t i o n showing how to c r e a t e a l i n e c h a r t. / public c l a s s JChartLibApp SaveAsJpg { / Creates a new A p p l i c a t i o n Frame / public JChartLibApp SaveAsJpg ( ) { //Some data f o r the c h a r t JChartLibSerie v a l u e s = new JChartLibSerie ( Some Data ) ; v a l u e s. addvalue ( 1 ) ; v a l u e s. addvalue ( 4 ) ; v a l u e s. addvalue ( 2 ) ; // Adding the s e r i e to t he d a t a s e t JChartLibDataSet d a t a s e t = new JChartLibDataSet ( ) ; d a t a s e t. adddataserie ( v a l u e s ) ; // the c h a r t i t s e l f f i n a l JChartLibLinechart chart = new JChartLibLinechart ( T i t l e, // c h a r t t i t l e X Axis, // x a x i s t e x t Y Axis, // y a x i s t e x t d a t a s e t // data ) ; // s a v i n g the c h a r t as j p g and png in the current working d i r e c t o r y try { chart. saveasjpeg ( chart. jpg, 640, ) ; chart. saveaspng( chart. png, 640, ) ; } catch ( IOException ex ) { System. out. p r i n t l n ( unable to save chart to f i l e ) ; 16

17 } } Logger. getlogger ( JChartLibApp SaveAsJpg. class. getname ( ) ). l o g ( Level.SEVERE, n } / DEMO A p p l i c a t i o n f o r args t he command l i n e arguments / public static void main ( f i n a l S t r i n g [ ] args ) { System. out. p r i n t l n ( JChartLibApp s t a r t e d ) ; f i n a l JChartLibApp SaveAsJpg app = new JChartLibApp SaveAsJpg ( ) ; } 17

18 10 Contact Feel free to contact us for feedback or feature requests. We also offer support and integration service. Contact us per 11 Copyright This manual is copyright 2012 by Bitagentur - Suvi.org - Silvio Schneider 18

19 Index Areachart, 10 Barchart, 11 cakechart, 14 color, 4 Dataset, 4 dates, 6 dots, 8 floating point, 7, 12 JPEG, 16 JPG, 16 JVM, 4 Linechart, 5 maxvalue, 8 minvalue, 8 negative values, 12 Piechart, 13 PNG, 16 RAM, 4 Ringchart, 15 timeline, 6 X-Axis, 8 19

ArcGIS 9 ArcGIS StreetMap Tutorial

ArcGIS 9 ArcGIS StreetMap Tutorial Copyright 2001 2008 ESRI All Rights Reserved. Printed in the United States of America. The information contained in this document is the exclusive property of ESRI. This