gcrnet 1.0.3

A Python library for sparse-input neural networks using group concave regularization

GCRNet: Sparse-Input Neural Networks with Group Concave Regularization

Project Page|Paper

GCRNet is a Python library that implements a novel framework for sparse-input neural networks using group concave regularization. Leveraging the power of concave penalties, specifically MCP and SCAD, GCRNet provides a comprehensive approach for simultaneous feature selection and non-linear function estimation. The proposed framework considers all outgoing connections from a single input neuron as a group and applies an appropriate concave penalty to the $l_2$ norm of weights within each group. By selectively shrinking the weights of certain groups to exact zeros, GCRNet constructs a neural network that utilizes only a small subset of variables, enhancing both the accuracy and interpretability of the feature selection process. GCRNet offers versatile functionality, supporting regression or classification tasks with continuous, binary, or time-to-event outcomes.

Installation

Installation with pip

To install with pip, run the following command:

pip install --user gcrnet

Installation from GitHub

You can also clone the repository and install manually:

git clone 
cd gcrnet/python
python setup.py install --user

Usage

Once you install the library, you can import GCRNet to create a model instance:

from gcrnet import GCRNet
lam=np.exp(np.linspace(np.log(0.01),np.log(0.5), 50))
gmcp_net = GCRNet(task_type='regression',device=torch.device("cpu"), input_dim=train_data['X'].shape[1], output_dim=1, hidden_dims=[10,5], activation="relu",
    optimizer="Adam",learning_rate=0.001, batch_size=train_data['X'].shape[0], 
    alpha=0.01, lam=lam, penalty="MCP",drop_input=True)

# fit model and tune parameters
param_grid={"alpha":[0.03]}
gmcp_net= gmcp_net.fit_and_validate(X=train_data['X'], y=train_data['y'], 
                              param_grid=param_grid, init_num_epochs=2000, num_epochs=200, verbose=True, print_interval=200)

For more details, please see our Colab notebooks:

• Regression example
• Classification example
• Cox example

Acknowledgements and References

Some of our codebase and its structure are inspired by https://github.com/runopti/stg.

If you find our library useful in your research, please consider citing us:

@misc{luo2023sparseinput, title={Sparse-Input Neural Network using Group Concave Regularization}, author={Bin Luo and Susan Halabi}, year={2023}, eprint={2307.00344}, archivePrefix={arXiv}, primaryClass={stat.ML} }