datasetutilities.html

jfreechart1。0。2的api。

<FONT color="green">409</FONT>                throw new IllegalArgumentException("Null 'columnKeys' argument.");<a name="line.409"></a>
<FONT color="green">410</FONT>            }<a name="line.410"></a>
<FONT color="green">411</FONT>            if (ArrayUtilities.hasDuplicateItems(rowKeys)) {<a name="line.411"></a>
<FONT color="green">412</FONT>                throw new IllegalArgumentException("Duplicate items in 'rowKeys'.");<a name="line.412"></a>
<FONT color="green">413</FONT>            }<a name="line.413"></a>
<FONT color="green">414</FONT>            if (ArrayUtilities.hasDuplicateItems(columnKeys)) {<a name="line.414"></a>
<FONT color="green">415</FONT>                throw new IllegalArgumentException(<a name="line.415"></a>
<FONT color="green">416</FONT>                    "Duplicate items in 'columnKeys'."<a name="line.416"></a>
<FONT color="green">417</FONT>                );<a name="line.417"></a>
<FONT color="green">418</FONT>            }<a name="line.418"></a>
<FONT color="green">419</FONT>            if (rowKeys.length != data.length) {<a name="line.419"></a>
<FONT color="green">420</FONT>                throw new IllegalArgumentException(<a name="line.420"></a>
<FONT color="green">421</FONT>                    "The number of row keys does not match the number of rows in "<a name="line.421"></a>
<FONT color="green">422</FONT>                    + "the data array."<a name="line.422"></a>
<FONT color="green">423</FONT>                );<a name="line.423"></a>
<FONT color="green">424</FONT>            }<a name="line.424"></a>
<FONT color="green">425</FONT>            int columnCount = 0;<a name="line.425"></a>
<FONT color="green">426</FONT>            for (int r = 0; r &lt; data.length; r++) {<a name="line.426"></a>
<FONT color="green">427</FONT>                columnCount = Math.max(columnCount, data[r].length);<a name="line.427"></a>
<FONT color="green">428</FONT>            }<a name="line.428"></a>
<FONT color="green">429</FONT>            if (columnKeys.length != columnCount) {<a name="line.429"></a>
<FONT color="green">430</FONT>                throw new IllegalArgumentException(<a name="line.430"></a>
<FONT color="green">431</FONT>                    "The number of column keys does not match the number of "<a name="line.431"></a>
<FONT color="green">432</FONT>                    + "columns in the data array."<a name="line.432"></a>
<FONT color="green">433</FONT>                );<a name="line.433"></a>
<FONT color="green">434</FONT>            }<a name="line.434"></a>
<FONT color="green">435</FONT>            <a name="line.435"></a>
<FONT color="green">436</FONT>            // now do the work...<a name="line.436"></a>
<FONT color="green">437</FONT>            DefaultCategoryDataset result = new DefaultCategoryDataset();<a name="line.437"></a>
<FONT color="green">438</FONT>            for (int r = 0; r &lt; data.length; r++) {<a name="line.438"></a>
<FONT color="green">439</FONT>                Comparable rowKey = rowKeys[r];<a name="line.439"></a>
<FONT color="green">440</FONT>                for (int c = 0; c &lt; data[r].length; c++) {<a name="line.440"></a>
<FONT color="green">441</FONT>                    Comparable columnKey = columnKeys[c];<a name="line.441"></a>
<FONT color="green">442</FONT>                    result.addValue(new Double(data[r][c]), rowKey, columnKey);<a name="line.442"></a>
<FONT color="green">443</FONT>                }<a name="line.443"></a>
<FONT color="green">444</FONT>            }<a name="line.444"></a>
<FONT color="green">445</FONT>            return result;<a name="line.445"></a>
<FONT color="green">446</FONT>    <a name="line.446"></a>
<FONT color="green">447</FONT>        }<a name="line.447"></a>
<FONT color="green">448</FONT>    <a name="line.448"></a>
<FONT color="green">449</FONT>        /**<a name="line.449"></a>
<FONT color="green">450</FONT>         * Creates a {@link CategoryDataset} by copying the data from the supplied <a name="line.450"></a>
<FONT color="green">451</FONT>         * {@link KeyedValues} instance.<a name="line.451"></a>
<FONT color="green">452</FONT>         *<a name="line.452"></a>
<FONT color="green">453</FONT>         * @param rowKey  the row key (&lt;code&gt;null&lt;/code&gt; not permitted).<a name="line.453"></a>
<FONT color="green">454</FONT>         * @param rowData  the row data (&lt;code&gt;null&lt;/code&gt; not permitted).<a name="line.454"></a>
<FONT color="green">455</FONT>         *<a name="line.455"></a>
<FONT color="green">456</FONT>         * @return A dataset.<a name="line.456"></a>
<FONT color="green">457</FONT>         */<a name="line.457"></a>
<FONT color="green">458</FONT>        public static CategoryDataset createCategoryDataset(Comparable rowKey, <a name="line.458"></a>
<FONT color="green">459</FONT>                                                            KeyedValues rowData) {<a name="line.459"></a>
<FONT color="green">460</FONT>    <a name="line.460"></a>
<FONT color="green">461</FONT>            if (rowKey == null) {<a name="line.461"></a>
<FONT color="green">462</FONT>                throw new IllegalArgumentException("Null 'rowKey' argument.");<a name="line.462"></a>
<FONT color="green">463</FONT>            }<a name="line.463"></a>
<FONT color="green">464</FONT>            if (rowData == null) {<a name="line.464"></a>
<FONT color="green">465</FONT>                throw new IllegalArgumentException("Null 'rowData' argument.");<a name="line.465"></a>
<FONT color="green">466</FONT>            }<a name="line.466"></a>
<FONT color="green">467</FONT>            DefaultCategoryDataset result = new DefaultCategoryDataset();<a name="line.467"></a>
<FONT color="green">468</FONT>            for (int i = 0; i &lt; rowData.getItemCount(); i++) {<a name="line.468"></a>
<FONT color="green">469</FONT>                result.addValue(rowData.getValue(i), rowKey, rowData.getKey(i));<a name="line.469"></a>
<FONT color="green">470</FONT>            }<a name="line.470"></a>
<FONT color="green">471</FONT>            return result;<a name="line.471"></a>
<FONT color="green">472</FONT>    <a name="line.472"></a>
<FONT color="green">473</FONT>        }<a name="line.473"></a>
<FONT color="green">474</FONT>    <a name="line.474"></a>
<FONT color="green">475</FONT>        /**<a name="line.475"></a>
<FONT color="green">476</FONT>         * Creates an {@link XYDataset} by sampling the specified function over a <a name="line.476"></a>
<FONT color="green">477</FONT>         * fixed range.<a name="line.477"></a>
<FONT color="green">478</FONT>         *<a name="line.478"></a>
<FONT color="green">479</FONT>         * @param f  the function (&lt;code&gt;null&lt;/code&gt; not permitted).<a name="line.479"></a>
<FONT color="green">480</FONT>         * @param start  the start value for the range.<a name="line.480"></a>
<FONT color="green">481</FONT>         * @param end  the end value for the range.<a name="line.481"></a>
<FONT color="green">482</FONT>         * @param samples  the number of sample points (must be &gt; 1).<a name="line.482"></a>
<FONT color="green">483</FONT>         * @param seriesKey  the key to give the resulting series <a name="line.483"></a>
<FONT color="green">484</FONT>         *                   (&lt;code&gt;null&lt;/code&gt; not permitted).<a name="line.484"></a>
<FONT color="green">485</FONT>         *<a name="line.485"></a>
<FONT color="green">486</FONT>         * @return A dataset.<a name="line.486"></a>
<FONT color="green">487</FONT>         */<a name="line.487"></a>
<FONT color="green">488</FONT>        public static XYDataset sampleFunction2D(Function2D f, <a name="line.488"></a>
<FONT color="green">489</FONT>                                                 double start, <a name="line.489"></a>
<FONT color="green">490</FONT>                                                 double end, <a name="line.490"></a>
<FONT color="green">491</FONT>                                                 int samples,<a name="line.491"></a>
<FONT color="green">492</FONT>                                                 Comparable seriesKey) {<a name="line.492"></a>
<FONT color="green">493</FONT>    <a name="line.493"></a>
<FONT color="green">494</FONT>            if (f == null) {<a name="line.494"></a>
<FONT color="green">495</FONT>                throw new IllegalArgumentException("Null 'f' argument.");   <a name="line.495"></a>
<FONT color="green">496</FONT>            }<a name="line.496"></a>
<FONT color="green">497</FONT>            if (seriesKey == null) {<a name="line.497"></a>
<FONT color="green">498</FONT>                throw new IllegalArgumentException("Null 'seriesKey' argument.");<a name="line.498"></a>
<FONT color="green">499</FONT>            }<a name="line.499"></a>
<FONT color="green">500</FONT>            if (start &gt;= end) {<a name="line.500"></a>
<FONT color="green">501</FONT>                throw new IllegalArgumentException("Requires 'start' &lt; 'end'.");<a name="line.501"></a>
<FONT color="green">502</FONT>            }<a name="line.502"></a>
<FONT color="green">503</FONT>            if (samples &lt; 2) {<a name="line.503"></a>
<FONT color="green">504</FONT>                throw new IllegalArgumentException("Requires 'samples' &gt; 1");<a name="line.504"></a>
<FONT color="green">505</FONT>            }<a name="line.505"></a>
<FONT color="green">506</FONT>    <a name="line.506"></a>
<FONT color="green">507</FONT>            XYSeries series = new XYSeries(seriesKey);<a name="line.507"></a>
<FONT color="green">508</FONT>            double step = (end - start) / samples;<a name="line.508"></a>
<FONT color="green">509</FONT>            for (int i = 0; i &lt;= samples; i++) {<a name="line.509"></a>
<FONT color="green">510</FONT>                double x = start + (step * i);<a name="line.510"></a>
<FONT color="green">511</FONT>                series.add(x, f.getValue(x));<a name="line.511"></a>
<FONT color="green">512</FONT>            }<a name="line.512"></a>
<FONT color="green">513</FONT>            XYSeriesCollection collection = new XYSeriesCollection(series);<a name="line.513"></a>
<FONT color="green">514</FONT>            return collection;<a name="line.514"></a>
<FONT color="green">515</FONT>    <a name="line.515"></a>
<FONT color="green">516</FONT>        }<a name="line.516"></a>
<FONT color="green">517</FONT>    <a name="line.517"></a>
<FONT color="green">518</FONT>        /**<a name="line.518"></a>
<FONT color="green">519</FONT>         * Returns &lt;code&gt;true&lt;/code&gt; if the dataset is empty (or &lt;code&gt;null&lt;/code&gt;),<a name="line.519"></a>
<FONT color="green">520</FONT>         * and &lt;code&gt;false&lt;/code&gt; otherwise.<a name="line.520"></a>
<FONT color="green">521</FONT>         *<a name="line.521"></a>
<FONT color="green">522</FONT>         * @param dataset  the dataset (&lt;code&gt;null&lt;/code&gt; permitted).<a name="line.522"></a>
<FONT color="green">523</FONT>         *<a name="line.523"></a>
<FONT color="green">524</FONT>         * @return A boolean.<a name="line.524"></a>
<FONT color="green">525</FONT>         */<a name="line.525"></a>
<FONT color="green">526</FONT>        public static boolean isEmptyOrNull(PieDataset dataset) {<a name="line.526"></a>
<FONT color="green">527</FONT>    <a name="line.527"></a>
<FONT color="green">528</FONT>            if (dataset == null) {<a name="line.528"></a>
<FONT color="green">529</FONT>                return true;<a name="line.529"></a>
<FONT color="green">530</FONT>            }<a name="line.530"></a>
<FONT color="green">531</FONT>    <a name="line.531"></a>
<FONT color="green">532</FONT>            int itemCount = dataset.getItemCount();<a name="line.532"></a>
<FONT color="green">533</FONT>            if (itemCount == 0) {<a name="line.533"></a>
<FONT color="green">534</FONT>                return true;<a name="line.534"></a>
<FONT color="green">535</FONT>            }<a name="line.535"></a>
<FONT color="green">536</FONT>    <a name="line.536"></a>
<FONT color="green">537</FONT>            for (int item = 0; item &lt; itemCount; item++) {<a name="line.537"></a>
<FONT color="green">538</FONT>                Number y = dataset.getValue(item);<a name="line.538"></a>
<FONT color="green">539</FONT>                if (y != null) {<a name="line.539"></a>
<FONT color="green">540</FONT>                    double yy = y.doubleValue();<a name="line.540"></a>
<FONT color="green">541</FONT>                    if (yy &gt; 0.0) {<a name="line.541"></a>
<FONT color="green">542</FONT>                        return false;<a name="line.542"></a>
<FONT color="green">543</FONT>                    }<a name="line.543"></a>
<FONT color="green">544</FONT>                }<a name="line.544"></a>
<FONT color="green">545</FONT>            }<a name="line.545"></a>