home | career | drupal | java | mac | mysql | perl | scala | uml | unix  

Java example source code file (overview.xml)

This example Java source code file (overview.xml) is included in the alvinalexander.com "Java Source Code Warehouse" project. The intent of this project is to help you "Learn Java by Example" TM.

Learn more about this Java project at its project page.

Java - Java tags/keywords

all, apache, commons, conditions, equations, license, math, ordinary, see, the, this, version, when, you

The overview.xml Java example source code

<?xml version="1.0"?>

<!--
   Licensed to the Apache Software Foundation (ASF) under one or more
  contributor license agreements.  See the NOTICE file distributed with
  this work for additional information regarding copyright ownership.
  The ASF licenses this file to You under the Apache License, Version 2.0
  (the "License"); you may not use this file except in compliance with
  the License.  You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.
  -->
  
<?xml-stylesheet type="text/xsl" href="./xdoc.xsl"?>
<document>
  <properties>
    <title>User Guide - Overview
  </properties>
  
<body>

<section name="Overview">

<subsection name="0.1 About The User Guide" href="about">
    <p>
    This guide is intended to help programmers quickly find what they need to develop
    solutions using Commons Math.  It also provides a supplement to the javadoc API documentation,
    providing a little more explanation of the mathematical objects and functions included
    in the package.    
    </p>
</subsection>

<subsection name="0.2 What's in commons-math" href="summary">
    <p>
    Commons Math is made up of a small set of math/stat utilities addressing 
    programming problems like the ones in the list below.  This list is not exhaustive, 
    it's just meant to give a feel for the kinds of things that Commons Math provides.  
    <ul>
        <li>Computing means, variances and other summary statistics for a list of numbers
        <li>Fitting a line to a set of data points using linear regression
        <li>Fitting a curve to a set of data points
        <li>Finding a smooth curve that passes through a collection of points (interpolation)
        <li>Fitting a parametric model to a set of measurements using least-squares methods
        <li>Solving equations involving real-valued functions (i.e. root-finding) 
        <li>Solving systems of linear equations
        <li>Solving Ordinary Differential Equations
        <li>Minimizing multi-dimensional functions
        <li>Generating random numbers with more restrictions (e.g distribution, range) than what
            is possible using the JDK</li>
        <li>Generating random samples and/or datasets that are "like" the data in an input file
        <li>Performing statistical significance tests
        <li>Miscellaneous mathematical functions such as factorials, binomial
            coefficients and "special functions" (e.g. gamma, beta functions)</li>
    </ul>

<p> We are actively seeking ideas for additional components that fit into the <a href="../index.html#summary">Commons Math vision of a set of lightweight, self-contained math/stat components useful for solving common programming problems. Suggestions for new components or enhancements to existing functionality are always welcome! All feedback/suggestions for improvement should be sent to the <a href="http://commons.apache.org/mail-lists.html">commons-dev mailing list with [math] at the beginning of the subject line. </p> </subsection> <subsection name="0.3 How commons-math is organized" href="organization"> <p> Commons Math is divided into sixteen subpackages, based on functionality provided. <ul> <li>org.apache.commons.math3.stat - statistics, statistical tests <li>org.apache.commons.math3.analysis - rootfinding, integration, interpolation, polynomials <li>org.apache.commons.math3.random - random numbers, strings and data generation <li>org.apache.commons.math3.special - special functions (Gamma, Beta) <li>org.apache.commons.math3.linear - matrices, solving linear systems <li>org.apache.commons.math3.util - common math/stat functions extending java.lang.Math <li>org.apache.commons.math3.complex - complex numbers <li>org.apache.commons.math3.distribution - probability distributions <li>org.apache.commons.math3.fraction - rational numbers <li>org.apache.commons.math3.transform - transform methods (Fast Fourier) <li>org.apache.commons.math3.geometry - geometry (Euclidean spaces and Binary Space Partitioning) <li>org.apache.commons.math3.optim - function maximization or minimization <li>org.apache.commons.math3.ode - Ordinary Differential Equations integration <li>org.apache.commons.math3.genetics - Genetic Algorithms <li>org.apache.commons.math3.fitting - Curve Fitting <li>org.apache.commons.math3.ml - Machine Learning </ul> Package javadocs are <a href="../apidocs/index.html">here </p> </subsection> <subsection name="0.4 How interface contracts are specified in commons-math javadoc" href="contracts"> <p> You should always read the javadoc class and method comments carefully when using Commons Math components in your programs. The javadoc provides references to the algorithms that are used, usage notes about limitations, performance, etc. as well as interface contracts. Interface contracts are specified in terms of preconditions (what has to be true in order for the method to return valid results), special values returned (e.g. Double.NaN) or exceptions that may be thrown if the preconditions are not met, and definitions for returned values/objects or state changes.</p> <p> When the actual parameters provided to a method or the internal state of an object make a computation meaningless, a <a href="../apidocs/org/apache/commons/math3/exception/MathIllegalArgumentException.html"> MathIllegalArgumentException</a> or <a href="../apidocs/org/apache/commons/math3/exception/MathIllegalStateException.html"> MathIllegalStateException</a> may be thrown. Exact conditions under which runtime exceptions (and any other exceptions) are thrown are specified in the javadoc method comments. In some cases, to be consistent with the <a href="http://grouper.ieee.org/groups/754/"> IEEE 754 standard</a> for floating point arithmetic and with java.lang.Math, Commons Math methods return <code>Double.NaN values. Conditions under which Double.NaN or other special values are returned are fully specified in the javadoc method comments. </p> <p> As of version 2.2, the policy for dealing with null references is as follows: When an argument is unexpectedly null, a <a href="../apidocs/org/apache/commons/math3/exception/NullArgumentException.html"> NullArgumentException</a> is raised to signal the illegal argument. Note that this class does not inherit from the standard <code>NullPointerException but is a subclass of <code>MathIllegalArgumentException. </p> </subsection> <subsection name="0.5 Dependencies" href="dependencies"> <p> Commons Math requires JDK 1.5+ and has no runtime dependencies. </p> </subsection> <subsection name="0.6 License" href="license"> <p> Commons Math is distributed under the terms of the Apache License, Version 2.0: <a href="http://www.apache.org/licenses/LICENSE-2.0"/>. </p> <p> This product includes software developed by other third parties and distributed under licenses terms compatible with Apache License, Version 2.0. All the licenses of such third parties products are available in the distribution in the LICENSE.txt file. Some products require additional attribution, these attributions can be found in the NOTICE.txt file. These files are available both in the source packages and in the binaries distribution jar files. </p> </subsection> </section> </body> </document>

Other Java examples (source code examples)

Here is a short list of links related to this Java overview.xml source code file:



my book on functional programming

 

new blog posts

 

Copyright 1998-2021 Alvin Alexander, alvinalexander.com
All Rights Reserved.

A percentage of advertising revenue from
pages under the /java/jwarehouse URI on this website is
paid back to open source projects.