&gnum; is a spreadsheet, a computer program used to manipulate and analyze numeric data. &gnum; can help you keep track of information in lists, organize numeric values in columns and rows, perform and update complex calculations by defining each step of the calculation and modifying particular steps subsequently, create and display or print graphical plots of data using bar plots, line graphs, pie charts or radar charts, implement complex optimization modeling or perform many other tasks involving numbers, dates, times, names or other data.

The features of &gnum; make it versatile and powerful. The screenshot (picture) of &gnum; shown in demonstrates the main program window and some of the features currently available.

# An example of what Gnumeric can do.

An image of &gnum; showing the use of complex formatting and several graphical plots.

An example of &gnum;, shrunk to fit in this document.

&gnum; currently supports a full complement of calculation functions, formatting options, graph types and drawing options.

&gnum; aims to be the best spreadsheet available. It has been developed over many years to become mature and mathematically correct. &gnum; was created and is maintained by the GNOME project. This manual describes version &appversion; of &gnum;.

Releases of &gnum; in the 1.8 series have numbers starting with 1.8 but with extra numbers afterwards, such as 1.8.0 or 1.8.3. These are stable releases which are only changed with minor improvements and fixes for problems (bugs) in the program. These releases can be considered safe for use in a production environment.

Goals of Gnumeric

&gnum; is developed with a specific set of goals in mind.

- Stability

  &gnum; has undergone significant amounts of testing. A diverse group of users evaluates &gnum; in a wide variety of environments. Testing workbooks are used to assess the mathematical correctness of the calculations and to validate the quality of the file importers.

- Accuracy

  Calculating the correct answer is important, and &gnum; has worked hard to surpass the competition. Recent reports indicate that it has done so.

- File compatibility

  Transparent access and manipulation of files from other applications is vital in a modern office. The &gnum; file format is simply compressed XML which can be decompressed using gunzip, the GNU gzip program's decompression utility, into text. &gnum; can open files from several well known proprietary and free spreadsheets including MS Excel, Lotus 1-2-3, Applix, OpenOffice.org, Psion, Sylk, XBase, Oleo, PlanPerfect, Quattro Pro and HTML. &gnum; can save files to several versions of the MS Excel file format and can save tables into LaTeX \longtable, HTML, and roff files. &gnum; also benefits from a highly configurable text importer and exporter which ensures that data can be transferred smoothly, and allows new formats to be added easily as plug-in software routines.

- Minimal cost of transition

  Learning new and unfamiliar interfaces is an expensive and frustrating process. &gnum; attempts to present itself so that a user's familiarity with other applications will still apply and to offer new features in an intuitive manner.

- Extensive feature set

  &gnum; now has enough of the features that users expect in a spreadsheet to provide for the vast majority of user needs. However, new features are constantly being added. People often quote the statistic that most users only need 20% of the features of the software they use. This statistic does not mean that only 20% of the features are needed but, rather, that most users share a common need for 10% of the features and require distinct features for the rest of their work. &gnum; attempts to provide full implementations of the features it offers, leaving features unimplemented until a robust and complete implementation exists.

- Internationalization

  &gnum; has been translated into 46 languages, and is being used by people around the globe with the symbols and date/monetary conventions appropriate for their local setting.

- Scalability

  The core architecture is designed to ensure that &gnum; can comfortably scale to moderately large loads (1 million cells) while remaining usable on older hardware.

- Openness

  &gnum; is free software in the sense of giving its users several freedoms related to the program including the freedoms to use, modify and redistribute the program. These freedoms are explained at the Free Software Foundation web site page on the philosophy of free software. In order to maintain these freedoms for everyone, certain restrictions are required which prevent anyone limiting these freedom for others. &gnum; is therefore released under a particular license agreement; &gnum; is licensed under the terms of the GNU GPL.

  One of the consequences of these freedoms, is that everyone can have access to the source code used to create &gnum;. This code is explicitly maintained and documented to make it easy for anyone to modify in any way they choose. This makes it possible to modify the spreadsheet, write custom routines or extend &gnum; for special needs.

New features introduced in the Gnumeric 1.8 release series:

The 1.8 series of &gnum; includes numerous improvements over the versions in the 1.6 series.

- Improved .gnumeric and export

  &gnum; now uses the faster SAX based parser by default for parsing `.gnumeric` files. The schema was improved and additional features were added.

- Microsoft OfficeOpenXML import and export

  Basic import and export support for the Office Open XML ("OOXML") format was added, focussing on standard spreadsheet content. Charts and embedded objects are not yet supported.

- New value formatting engine

  Improved compatibility and performance.

- Use new Gtk based Printing

  The printing infrastructure was changed to use Gtk based printing instead of the deprecated libgnomeprint libraries.

- Improved in-cell drop downs

  In cell validation lists, and improved finger feel for autofilters.

New features introduced in the Gnumeric 1.6 release series:

The 1.6 series of &gnum; includes numerous improvements over the versions in the 1.4 series.

- Better Charting:

  Several new types of charts have been added, and many features, such as regression lines, have been added.

- Improved Accuracy:

  While &gnum; 1.4 was already the best available source for accuracy in statistical calculations, &gnum; 1.6 is even better. We are continuing our behind-the-scenes cooperation with The R Project to make this happen. We have also added a new plugin supplying consistently named probability density, cumulative density, and reverse cumulative density functions to &gnum;. The new function names mirror their R counterparts.

- The Port to Microsoft Operating Systems

  Our "Windows" port is now mature enough for everyday use. We have improved the theming support of our custom widgets, so Gnumeric now looks and feels slighly more like a native application. The build might still have a few rough edges, but those are being worked on.

- Right-to-Left Support:

  We now support right-to-left orientation of the sheets as well as for text within cells.

New features introduced in the Gnumeric 1.4 release series:

The 1.4 series of &gnum; include numerous improvements over the versions in the 1.2 series.

- The Port to Microsoft Operating Systems

  The port of the core of &gnum; to the GTK+ libraries will enable the application to be run on the series of operating systems sold by Microsoft and colloquially known as "Windows".

- Improved Analytics

  The analytical correctness of &gnum; is a primary concern of the team. The precision and correctness of the analytics are constantly being evaluated and improved. Updated versions of the solver libraries (lp_solve and GLPK) were added.

- Improved Charting

  The graphical system is improving rapidly with new types of graphs, such as radar plots. There is now support for error bars and additional styles. The plots also look significantly sharper on screen, and off thanks to some pixel tuning. The axes now support various mappings (logarithmic, inverse), and there are a wider selection of markers. There is also support for formatting individual points in a plot.

- Rich Text In Cells

  The ability to use Rich Text has been added in this version. This allows a single cell to contain text with mixed formatting including bold, italic and other formats.

- Improved Microsoft Excel Compatibility

  The file format used by the Microsoft Excel spreadsheet is commonly used to exchange spreadsheet documents. The &gnum; team spends a considerable effort reverse engineering that file format to ensure that &gnum; can read and write files in that format. This release now supports all forms of 'array formula' and adds export support for charts, rich text, and images. More compatibility accelerator keys were added to simplify transition, and improve the finger feel. There is better support for hyperlinks.

- Printing

  Using Pango throughout the printing subsystem improves the consistency between on screen and resulting paper.

- Improved Analytics:

  This version of &gnum; includes 470 sheet functions including all of the functions from the North American edition of Microsoft Excel 2000 (TM). This version also includes numerous new functions and statistical routines imported from the R statistical language, from the GNU Scientific Library, and from other sources. The random number generation has been updated to include Beta, Cauchy, Chi-Squared, Exponential power F, Gamma, Geometric, Laplace, Levy alpha-Stable Logarithmic, Logistic, Log-normal, Pareto, Rayleigh Rayleigh tail, T, Type I Gumbel, Type II Gumbel, Weibull Gaussian Tail, Landau, and Uniform integer distributions. The derivative valuation routines have been expanded to include Black-Scholes (and sensitivities), Garman Kohlhagen, Merton Jump Diffusion process, Bjerksund and Stensland (American options), Forward Starts, Simple and Complex Choosers, Exchange Options, options on future spreads, and most favourable state payouts. The solver has been improved with new linear and quadratic programming routines. There were improvements in the T-Test, Z-Test, and F-Test. More accuracy for GEOMDIST, BINOMDIST, BETADIST, BETAINV, FINV, CAUCHY, FDIST, FTEST, HYPGEOMDIST, ERF, FISHER, EFFECT, NOMINAL, MIRR, IRR, XNPV, NPV, PMT, RATE, PV, FV, IPMT, PPMT, ZTEST, EXPM1, LN1P.

- Import/Export

  The xml exporter is now much faster and lighter for `.gnumeric` files, and the GNOME enabled &gnum; supports gnome-vfs and drag-n-drop images and files.

- GTK+ Port

  One of the principal aims of this developers series is to make &gnum; work using only the GTK+ libraries. These libraries, following their 2.4.0 release, have all the functionality needed for the core of &gnum;. This work will remove all dependencies in the core code on GNOME libraries although a version with the more complete features included in GNOME will still exist.

The 1.4.x release is dedicated to the memory of lost colleagues, Chema (Grandma) Celorio who helped make &gnum; as stable as it is, and Mel Seder who kept us smiling. They'll be missed.

For more details on the changes in &gnum;, refer to the file; named NEWS in the source code distribution.

Known Issues in Gnumeric:

The current list of all known and reported problems with &gnum; is maintained in the GNOME bugzilla database. This list can be accessed using this bugzilla query.