python-weka-wrapper 0.3.18

Python wrapper for the Weka Machine Learning Workbench

WARNING: Python 2.7 reaches its end-of-life in 2020, you should consider using the Python 3 version of this library!

The python-weka-wrapper package makes it easy to run Weka algorithms and filters from within Python. It offers access to Weka API using thin wrappers around JNI calls using the javabridge package.

Forum for project at:

https://groups.google.com/forum/#!forum/python-weka-wrapper

Changelog

0.3.18 (2019-12-02)

• method train_test_split of the weka.dataset.Instances class now creates a copy of itself before applying randomization, to avoid changing the order of data for subsequent calls.

0.3.17 (2019-11-19)

• method create_instances_from_matrices from module weka.core.dataset now works with pure numeric data again

• added sections for creating datasets (manual, lists, matrices) to examples documentation

0.3.16 (2019-11-11)

• added console scripts: pww-associator, pww-attsel, pww-classifier, pww-clusterer, pww-datagenerator, pww-filter

• added serialize, deserialize methods to weka.classifiers.Classifier to simplify loading/saving model

• added serialize, deserialize methods to weka.clusterers.Clusterer to simplify loading/saving model

• added serialize, deserialize methods to weka.filters.Filter to simplify loading/saving filter

• added methods plot_rocs and plot_prcs to weka.plot.classifiers module to plot ROC/PRC curve on same dataset for multiple classifiers

• method plot_classifier_errors of weka.plot.classifiers module now allows plotting predictions of multiple classifiers by providing a dictionary

• method create_instances_from_matrices from module weka.core.dataset now allows string and bytes as well

• method create_instances_from_lists from module weka.core.dataset now allows string and bytes as well

0.3.15 (2019-01-11)

• added wrapper classes for association classes that implement AssociationRuleProducer (package weka.associations): AssociationRules, AssociationRule, item

• added to_source method to weka.classifiers.Classifier and weka.filters.Filter (underlying Java classes must implement the respective Sourcable interface)

0.3.14 (2018-10-28)

• fixed logging setup in weka.core.jvm to avoid global setting global logging setup to DEBUG (thanks to https://github.com/Arnie97)

0.3.13 (2018-09-16)

• upgraded to Weka 3.9.3

• weka.jar now included in PyPi package

• exposed the following methods in weka.classifiers.Evaluation: cumulative_margin_distribution, sf_prior_entropy, sf_scheme_entropy

0.3.12 (2018-02-18)

• upgraded to Weka 3.9.2

• properly initializing package support now, rather than adding package jars to classpath

• added weka.core.ClassHelper Java class for obtaining classes and static fields, as javabridge only uses the system class loader

0.3.11 (2017-08-23)

• added check_for_modified_class_attribute method to FilterClassifier class

• added complete_classname method to weka.core.classes module, which allows completion of partial classnames like .J48 to weka.classifiers.trees.J48 if there is a unique match; JavaObject.new_instance and JavaObject.check_type now make use of this functionality, allowing for instantiations like Classifier(cls=”.J48”)

• jvm.start(system_cp=True) no longer fails with a KeyError: ‘CLASSPATH’ if there is no CLASSPATH environment variable defined

• Libraries mtl.jar, core.jar and arpack_combined_all.jar were added as is to the weka.jar in the 3.9.1 release instead of adding their content to it. Repackaged weka.jar to fix this issue (https://github.com/fracpete/python-weka-wrapper/issues/52)

0.3.10 (2017-01-04)

• types.double_matrix_to_ndarray no longer assumes a square matrix (https://github.com/fracpete/python-weka-wrapper/issues/48)

• len(Instances) now returns the number of rows in the dataset (module weka.core.dataset)

• added method insert_attribute to the Instances class

• added class method create_relational to the Attribute class

• upgraded Weka to 3.9.1

0.3.9 (2016-10-19)

• plot_learning_curve method of module weka.plot.classifiers now accepts a list of test sets; * is index of test set in label template string

• added missing_value() methods to weka.core.dataset module and Instance class

• output variable y for convenience method create_instances_from_lists in module weka.core.dataset is now optional

• added convenience method create_instances_from_matrices to weka.core.dataset module to easily create an Instances object from numpy matrices (x and y)

0.3.8 (2016-05-09)

• now works with javabridge 1.0.14 as well

0.3.7 (2016-05-04)

• upgraded Weka to 3.9.0

0.3.6 (2016-04-02)

• Loader.load_file method now checks whether the dataset file really exists, otherwise a previously loaded file gets loaded again without an error message (seems to be a Weka issue)

• replaced org.pentaho.packageManagement with weka.core.packageManagement as the package management code is now part of Weka rather than a third-party library

• jvm.start() no longer tries to load packages and therefore suppresses error message if $HOME/wekafiles/packages should not yet exist

0.3.5 (2016-01-29)

• added support for weka.core.BatchPredictor to class Classifier in module weka.classifiers

• upgraded Weka to revision 12410 (post 3.7.13) to avoid performance bottleneck when using setOptions method

• fixed class SetupGenerator from module weka.core.classes

• added load_any_file method to the weka.core.converters module

• added save_any_file method to the weka.core.converters module

• if GridSearch instantiation (module weka.classifiers) fails, it now outputs message whether package installed and JVM with package support started

0.3.4 (2016-01-15)

• added convenience method create_instances_from_lists to weka.core.dataset module to easily create an Instances object from numeric lists (x and y)

• added get_object_tags method to Tags class from module weka.core.classes, to allow obtaining weka.core.Tag array from the method of a JavaObject rather than a static field (MultiSearch)

• updated MultiSearch wrapper in module weka.classifiers to work with the multi-search package version 2016.1.15 or later

0.3.3 (2015-09-26)

• updated to Weka 3.7.13

• documentation now covers the API as well

0.3.2 (2015-06-29)

• The packages parameter of the weka.core.jvm.start() function can be used for specifying an alternative Weka home directory now as well

• added train_test_split method to weka.core.Instances class to easily create train/test splits

• evaluate_train_test_split method of weka.classifiers.Evaluation class now uses the train_test_split method

0.3.1 (2015-04-23)

• added get_tags class method to Tags method for easier instantiation of Tag arrays

• added find method to Tags class to locate Tag object that matches the string

• fixed __getitem__ and __setitem__ methods of the Tags class

• added GridSearch meta-classifier with convenience properties to module weka.classifiers

• added SetupGenerator and various parameter classes to weka.core.classes

• added MultiSearch meta-classifier with convenience properties to module weka.classifiers

• added quote/unquote and backquote/unbackquote methods to weka.core.classes module

• added main method to weka.core.classes for operations on options: join, split, code

• added support for option handling to weka.core.classes module

0.3.0 (2015-04-15)

• added method ndarray_to_instances to weka.converters module for converting Numpy 2-dimensional array into Instances object

• added method plot_learning_curve to weka.plot.classifiers module for creating learning curves for multiple classifiers for a specific metric

• added plotting of experiments with plot_experiment methid in weka.plot.experiments module

• Instance.create_instance method now takes list of tuples (index, internal float value) when generating sparse instances

• added weka.core.database module for loading data from a database

• added make_copy class method to Clusterer class

• added make_copy class method to Associator class

• added make_copy class method to Filter class

• added make_copy class method to DataGenerator class

• most classes (like Classifier and Filter) now have a default classname value in the constructor

• added TextDirectoryLoader class to weka.core.converters

• moved all methods from weka.core.utils to weka.core.classes

• fixed Attribute.index_of method for determining label index

• fixed Attribute.add_string_value method (used incorrect JNI parameter)

• create_instance and create_sparse_instance methods of class Instance now ensure that list values are float

• added to_help method to OptionHandler class which outputs a help string generated from the base class’s globalInfo and listOptions methods

• fixed test_model method of Evaluation class when supplying a PredictionOutput object (previously generated No dataset structure provided! exception)

• added batch_finished method to Filter class for incremental filtering

• added line_plot method to weka.plot.dataset module for plotting dataset using internal format (one line plot per instance)

• added is_serializable property to JavaObject class

• added has_class convenience property to Instance class

• added __repr__ method to JavaObject classes (simply calls toString() method)

• added Stemmer class in module weka.core.stemmers

• added Stopwords class in module weka.core.stopwords

• added Tokenizer class in module weka.core.tokenizers

• added StringToWordVector filter class in module weka.filters

• added simple workflow engine (see documentation on Flow)

0.2.2 (2015-01-05)

• added convenience methods no_class (to unset class) and has_class (class set?) to Instances class

• switched to using faster method objects for methods classify_instance/distribution_for_instance in Classifier class

• switched to using faster method objects for methods cluster_instance/distribution_for_instance in Clusterer class

• switched to using faster method objects for methods class_index, is_missing, get/set_value, get/set_string_value, weight in Instance class

• switched to using faster method objects for methods input, output, outputformat in Filter class

• switched to using faster method objects for methods attribute, attribute_by_name, num_attributes, num_instances, class_index, class_attribute, set_instance, get_instance, add_instance in Instances class

0.2.1 (2015-01-05)

• added unit testing framework

• added method refresh_cache() to weka/core/packages.py to allow user to refresh local cache

• method get_classname in weka.core.utils now handles Python objects and class objects as well

• added convenience method get_jclass to weka.core.utils to instantiate a Java class

• added a JavaArray wrapper for arrays, which allows getting/setting elements and iterating

• added property classname to class JavaObject for easy access to classname of underlying object

• added class method parse_matlab for parsing Matlab matrix strings to CostMatrix class

• predictions method of Evaluation class now return None if predictions are discarded

• Associator.get_capabilities() method is now a property: Associator.capabilities

• added wrapper classes for Java enums: weka.core.classes.Enum

• fixed retrieval of sumSq in Stats class (used by AttributeStats)

• fixed cluster_instance method in Clusterer class

• fixed filter and clusterer properties in clusterer classes (SingleClustererEnhancer, FilteredClusterer)

• added crossvalidate_model method to ClusterEvaluation

• added get_prc method to plot/classifiers.py for calculating the area under the precision-recall curve

• Filter.filter method now handles list of Instances objects as well, applying the filter sequentially to all the datasets (allows generation of compatible train/test sets)

0.2.0 (2014-12-22)

NB: This release is not backwards compatible!

• requires JavaBridge 1.0.9 at least

• moved from Java-like get/set (getIndex() and setIndex(int)) to nicer Python properties

• using Python properties (also only read-only ones) wherevere possible

• added weka.core.version for accessing the Weka version currently in use

• added jwrapper and jclasswrapper methods to JavaObject class (the mother of all objects in python-weka-wrapper) to allow generic access to an object’s methods: http://pythonhosted.org//javabridge/highlevel.html#wrapping-java-objects-using-reflection

• added convenience methods class_is_last() and class_is_first() to weka.core.Instances class

• added convenience methods delete_last_attribute() and delete_first_attribute() to weka.core.Instances class

Older releases

https://github.com/fracpete/python-weka-wrapper/blob/7fd0bba3c74277313eb463e338c1a7e117a1ea22/CHANGES.rst