aimodelshare 0.3.7__py3-none-any.whl

aimodelshare/documentation/source/advanced_features.rst

@@ -0,0 +1,137 @@
+.. _advanced_features: 
+
+Advanced Features
+#################
+
+The AI Model Share library can help deploy interactive web dashboards for making predictions with your models in minutes. 
+
+However, sometimes there is a need for higher levels of customization than the base features include. 
+
+This page describes additional pathways to allow for the greatest programming flexibility, while also leveraging the power of the AI Model Share library. 
+
+.. _custom_deployments:
+
+Custom Deployments
+******************
+
+The base ``ModelPlayground.deploy`` method deploys a pre-written lambda handler optimized for efficiency with specific types of prediction domains. 
+
+For projects requiring more flexibility in the lambda handler, the AI ModelShare library allows for "Custom Deployments". Custom Deployments allow users to leverage the AI ModelShare infrastructure through AWS, while also creating opportunities for additional customization. 
+
+**Tutorial**
+
+`Guide to Custom Deployments <https://www.modelshare.org/notebooks/notebook:365>`_
+
+.. _PySpark:
+
+Using PySpark
+*************
+
+AI Model Share supports PySpark. Note that the current prediction API runtime can only accept Pandas Dataframes, which may require additional steps for PySpark preprocessors. 
+
+
+**Tutorial**
+
+`Quick Start Tutorial with PySpark <https://www.modelshare.org/notebooks/notebook:366>`_
+	
+
+.. _webapps:
+
+Connecting Custom Web Apps
+**************************
+
+AI Model Share allows users to leverage the AI Model Share deployment infrastructure to power their own custom web apps. Web apps can be displayed through the AI Model Share website and be highlighted as part of a developer’s portfolio.
+
+**Users can connect their web apps in 3 easy steps:** 
+
+#. Deploy a Model Playground (See tutorials :ref:`HERE<example_notebooks>`).
+
+#. In the code for your web app, set the path for your Model Playground's prediction API (built for you by AI Model Share in the “deploy” step) as the endpoint for the API request. 
+
+	.. note::
+
+    		Owners can find their Model Playground's API URL on the “Predict” tab of their Model Playground.
+
+		AI Model Share API URLs follow this format: *"https://example.execute-api.us-east-1.amazonaws.com"* (Remove "/prod/m" from the end of the url string.) 
+
+		.. image:: images/predict_tab.png
+	
+
+#. Authorization tokens are generated for users when they log in to the AI Model Share website. Unpack the token parameter within your Streamlit code, then format the headers in your API call to expect a token as a query parameter.  
+
+	.. code-block::
+
+		auth_token = st.experimental_get_query_params()['token'][0]
+
+		headers = {
+	            "Content-Type": "application/json", 
+	            "authorizationToken": auth_token,
+	        }
+
+
+**Done!** Design your web-app to customize the AI Model Share infrastructure to your own needs. See examples below: 
+
+**Examples**
+
+* `Text Classification: Webapp <https://share.streamlit.io/thestreett/streamlit-text-classification/main>`_
+* `Text Classification: Github <https://github.com/AIModelShare/aimodelshare_tutorials/tree/main/streamlit-text-classification>`_
+* `Tabular Classification: Webapp <https://share.streamlit.io/thestreett/streamlit-tabular-classification/main>`_
+* `Tabular Classification: Github <https://github.com/AIModelShare/aimodelshare_tutorials/tree/main/streamlit-tabular-classification>`_
+* `Image Classification: Webapp <https://share.streamlit.io/thestreett/streamlit-image-classification/main>`_
+* `Image Classification: Github <https://github.com/AIModelShare/aimodelshare_tutorials/tree/main/streamlit-image-classification>`_
+
+
+.. _reproducibility:
+
+Model Reproducibility
+*********************
+
+AI Model Share encourages users to share, replicate, and build on each other’s work by offering full model reproducibility functionality. 
+Users can leverage Competitions & Experiments as a way to exchange trained & untrained models. 
+
+To **share** a reproducible model, take the following steps: 
+
+1. Export the model's reproducibility environment into a json file with the ``export_reproducibility_env`` function. This function captures all of the necessary information to exactly reproduce a machine learning model. 
+
+	Example: :: 
+
+		from aimodelshare import export_reproducibility_env
+
+		mode = "gpu" # or "cpu", depending on model type
+		seed = 2021
+
+		export_reproducibility_env(
+ 		 seed=seed,
+		  directory="", #use "" for current directory
+		  mode=mode,
+		)
+
+.. note::
+
+    	The captured reproducibility environment only applies for one training iteration (data prep, preprocessing, fit model, submit model), so it is recommended to only train one model per training iteration. 
+
+2. Build your model with your preferred ML library. 
+
+3. Submit model with the ``reproducibility_env_filepath`` argument set. 
+
+	Example: :: 
+
+		#Submit Reproducible Model: 
+		reproducibility_env_filepath="reproducibility.json"
+
+		# generate predicted y values (for keras models)
+		y_pred = model.predict(X_test).argmax(axis=1)
+		prediction_labels = [y_test.columns[i] for i in y_pred]
+
+		# Submit Model to Competition Leaderboard
+		mycompetition.submit_model(model_filepath = "model.onnx",
+                           preprocessor_filepath="preprocessor.zip",
+                           prediction_submission=prediction_labels,
+                           reproducibility_env_filepath=reproducibility_env_filepath)
+
+
+To **instantiate** a previously submitted reproducible model, use the ``Competition.instantiate_model`` method. 
+
+	Example: ::
+	
+		reproducible_model = mycompetition.instantiate_model(version=1, reproduce=True) 

aimodelshare/documentation/source/competition.rst

@@ -0,0 +1,218 @@
+Competition Class
+=================
+
+After deploying a Model Playground, users can create a model competition. Creating a competition allows you to:
+
+    1. Verify the Model Playground performance metrics on aimodelshare.org
+    2. Submit models to a leaderboard
+    3. Grant access to other users to submit models to the leaderboard
+    4. Easily compare model performance and structure
+
+
+.. _submit_model:
+
+submit_model
+------------
+
+Submits model/preprocessor to machine learning competition using live prediction API url generated by AI Modelshare library. The submitted model gets evaluated and compared with all existing models and a leaderboard can be generated. 
+
+.. py:function:: Competition.submit_model(model_filepath, preprocessor_filepath, prediction_submission, sample_data=None, reproducibility_env_filepath=None, custom_metadata=None)
+
+   :param model_filepath: Value - Absolute path to model file [REQUIRED] to be set by the user. .onnx is the only accepted model file extension. "example_model.onnx" filename for file in directory. "/User/xyz/model/example_model.onnx" absolute path to model file from local directory.
+   :type model_filepath: string -ends with '.onnx'
+   :param preprocessor_filepath: value - absolute path to preprocessor file. [REQUIRED] to be set by the user. "./preprocessor.zip". Searches for an exported zip preprocessor file in the current directory. File is generated from preprocessor module using export_preprocessor function from the AI Modelshare library.
+   :type preprocessor_filepath: string
+   :param prediction_submission: Values - predictions for test data. [REQUIRED] for evaluation metrics of the submitted model.
+   :type prediction_submission: One-hot encoded prediction data for classification. List of values for regression. 
+   :param sample_data: 
+   :type sample_data: 
+   :param reproducibility_env_filepath: [OPTIONAL] to be set by the user- absolute path to environment environment json file. Example:  "./reproducibility.json". File is generated using export_reproducibility_env function from the AI Modelshare library
+   :type reproducibility_env_filepath: string
+   :param custom_metadata: Dictionary of custom metadata metrics (keys) and values for the model to be submitted. 
+   :type custom_metadata: Dictionary
+
+   :return: Model version if the model is submitted sucessfully.
+
+Example: :: 
+
+	#-- Generate predicted values (sklearn)
+	prediction_labels = model.predict(preprocessor(X_test))
+	
+	#-- Generate predicted values (keras)
+	prediction_column_index=model.predict(preprocessor(X_test)).argmax(axis=1)
+	# Extract correct prediction labels 
+	prediction_labels = [y_train.columns[i] for i in prediction_column_index]
+
+	# Submit Model to Competition Leaderboard
+	mycompetition.submit_model(model_filepath = "model.onnx",
+                                 preprocessor_filepath="preprocessor.zip",
+                                 prediction_submission=prediction_labels)
+
+.. _instantiate_model:
+
+instantiate_model
+-----------------
+
+Import a model previously submitted to the competition leaderboard to use in your session.
+
+.. py:function:: Competition.instantiate_model(version=None, trained=False, reproduce=False)
+
+   :param version: Model version number from competition leaderboard.
+   :type version: integer
+   :param trained: If True, a trained model is instantiated, if False, the untrained model is instantiated
+   :type trained: bool, default=False
+   :param reproduce: Set to True to instantiate a model with reproducibility environment setup
+   :type reproduce: bool, default=False
+
+   :return: Model chosen from leaderboard
+
+Example: :: 
+
+	# Instantiate Model 1 from the leaderboard, pre-trained
+	mymodel = mycompetition.instantiate_model(version=1, trained=True, reproduce=False)
+
+.. note::
+    If ``reproduce = True``, an untrained model will be instantiated, regardless of the ``trained`` parameter value.
+
+.. _inspect_model:
+
+inspect_model
+-------------
+
+Examine structure of model submitted to a competition leaderboard.
+
+.. py:function:: Competition.inspect_model(version=None, naming_convention=None)
+
+   :param version: Model version number from competition leaderboard.
+   :type version: integer
+   :param naming_convention: Either "keras" or "pytorch" depending on which kinds of layer names should be displayed
+   :type naming_convention: string - either "keras" or "pytorch"
+
+   :return: inspect_pd : dictionary of model summary & metadata
+
+
+.. _compare_models:
+
+compare_models
+--------------
+
+Compare the structure of two or more models submitted to a competition leaderboard. Use in conjunction with stylize_compare to visualize data. 
+
+.. py:function:: Competition.compare_models(version_list="None",  verbose=1, naming_convention=None)
+
+   :param version_list: list of model version numbers to compare (previously submitted to competition leaderboard).
+   :type version_list: list of integers
+   :param verbose: Controls the verbosity: the higher, the more detail 
+   :type verbose: integer
+   :param naming_convention: Either "keras" or "pytorch" depending on which kinds of layer names should be displayed
+   :type naming_convention: string - either "keras" or "pytorch"
+
+   :return: data : dictionary of model comparison information.
+
+Example :: 
+
+	# Compare two or more models
+	data=mycompetition.compare_models([7,8], verbose=1)
+	mycompetition.stylize_compare(data)
+
+.. _stylize_compare: 
+
+stylize_compare
+---------------
+
+Stylizes data received from compare_models to highlight similarities & differences.
+
+.. py:function:: Competition.stylize_compare(compare_dict, naming_convention=None)
+
+   :param compare_dict: Model data from compare_models()
+   :type compare_dict: dictionary
+   :param naming_convention: Either "keras" or "pytorch" depending on which kinds of layer names should be displayed
+   :type naming_convention: string - either "keras" or "pytorch"
+
+   :return: Formatted table of model comparisons. 
+
+Example :: 
+
+	# Compare two or more models
+	data=mycompetition.compare_models([7,8], verbose=1)
+	mycompetition.stylize_compare(data)
+
+.. _inspect_y_test: 
+
+inspect_y_test
+--------------
+
+Examines structure of y-test data to hep users understand how to submit models to the competition leaderboard.
+
+.. py:function:: Competition.inspect_y_test()
+
+   :param none:
+   
+   :return: Dictionary of a competition's y-test metadata.
+
+Example: :: 
+
+	mycompetition.inspect_y_test()
+
+.. _get_leaderboard:
+
+get_leaderboard
+---------------
+
+Get current competition leaderboard to rank all submitted models. Use in conjunction with stylize_leaderboard to visualize data. 
+
+.. py:function:: Competition.get_leaderboard(verbose=3, columns=None)
+
+   :param verbose: (Optional) controls the verbosity: the higher, the more detail.
+   :type verbose: integer
+   :param columns: (Optional) List of specific column names to include in the leaderboard, all else will be excluded. Performance metrics will always be displayed.
+   :type columns: list of strings
+
+   :return: Dictionary of leaderboard data.
+
+Example: :: 
+
+	data = mycompetition.get_leaderboard()
+	mycompetition.stylize_leaderboard(data)
+
+.. _stylize_leaderboard: 
+
+stylize_leaderboard
+-------------------
+
+Stylizes data received from get_leaderbord.
+
+.. py:function:: Competition.stylize_leaderboard(leaderboard, naming_convention="keras"
+
+   :param leaderboard: Data dictionary object returned from get_leaderboard
+   :type leaderboard: dictionary
+
+   :return: Formatted competition leaderboard
+
+Example: :: 
+
+	data = mycompetition.get_leaderboard()
+	mycompetition.stylize_leaderboard(data)
+
+.. _update_access_list:
+
+update_access_list
+------------------
+
+Updates list of authenticated participants who can submit new models to a competition.
+
+.. py:function:: Competition.update_access_list(email_list=[],update_type="Replace_list")
+
+   :param email_list: [REQUIRED] list of comma separated emails for users who are allowed to submit models to competition.
+   :type email_list: list of strings
+   :param update_type:[REQUIRED] options: ``string``: 'Add', 'Remove','Replace_list','Get. Add appends user emails to original list, Remove deletes users from list, 'Replace_list' overwrites the original list with the new list provided, and Get returns the current list.    
+   :type update_type: string
+
+
+   :return: "Success" upon successful request
+
+Example :: 
+
+	# Add, remove, or completely update authorized participants for competition later
+	emaillist=["newemailaddress@gmail.com"]
+	mycompetition.update_access_list(email_list=emaillist,update_type="Add")

aimodelshare/documentation/source/conf.py

@@ -0,0 +1,58 @@
+# Configuration file for the Sphinx documentation builder.
+#
+# This file only contains a selection of the most common options. For a full
+# list see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+# -- Path setup --------------------------------------------------------------
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+#
+#import os
+#import sys
+#sys.path.insert(0, os.path.abspath('../Documents/Columbia/AI Model Share/Github/aimodelshare/'))
+
+
+# -- Project information -----------------------------------------------------
+
+project = 'AIModelShare'
+copyright = '2022, AIModelShare'
+author = 'AIModelShare'
+
+# The full version, including alpha/beta/rc tags
+release = '0.1'
+
+
+# -- General configuration ---------------------------------------------------
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+#    'sphinx.ext.autodoc'
+    "nbsphinx",
+   # "sphinxcontrib.fulltoc",
+]
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+# This pattern also affects html_static_path and html_extra_path.
+exclude_patterns = []
+
+
+# -- Options for HTML output -------------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+#
+html_theme = 'karma_sphinx_theme'
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ['_static']

aimodelshare/documentation/source/create_credentials.rst

@@ -0,0 +1,86 @@
+.. _create_credentials: 
+
+Setting up AI Model Share Credentials
+#####################################
+
+In order to deploy a Model Playground, AI Model Share needs access to create & manage cloud-based resources on your behalf through Amazon Web Services (AWS). This guide shows you how to create an AWS account, access the proper credentials, and create a credentials file to use with the aimodelshare python library. 
+
+Step 1: Create an AI Model Share Account
+**************************************** 
+
+*If you already have an AI Model Share account, proceed to the next step.* 
+
+Create an AI Model Share account by going `HERE <https://www.modelshare.org/login>`_ and following the prompts.
+
+*Are you just using your credentials to submit models to a pre-existing playground competition or experiment? You're done!* 
+Get started with any of the :ref:`Model Submission notebooks <example_notebooks>`.  
+
+
+Step 2: Create an AWS account
+*****************************
+ 
+*If you already have an AWS account, proceed to the next step.* 
+ 
+Create an AWS account by going `HERE <https://portal.aws.amazon.com/billing/signup#/start/email>`_ and following the prompts.
+
+
+Step 3: Create an IAM User & AWS Access Keys
+********************************************
+
+In order for aimodelshare to access your AWS resources, you will need to create IAM credentials for your AWS account. 
+
+	* `Log in <https://signin.aws.amazon.com/signin>`_ to your AWS account. 
+	* From the AWS Management Console, Navigate to “Security, Identity, & Compliance” 	and then “IAM”. 
+
+		.. image:: images/creds1.png
+   			:width: 300
+
+	* In the side menu, navigate to “Access management”, click on “Users”, then click 	on “Add User” on the right side of the screen. 
+
+		.. image:: images/creds2.png
+   			:width: 600
+
+	* Create a name that you’ll remember, like “aimodelshareadmin”, then enable 	“programmatic access” by checking the box. 
+
+		.. image:: images/creds3.png
+   			:width: 600
+
+	* On the next screen, click “Attach existing policies directly”, then 	“AdministratorAccess”. 
+
+		.. image:: images/creds4.png
+   			:width: 600
+
+	* Click Next: Review, then “Create User”. 	
+	* Copy the Access key ID and Secret access key  and save them somewhere safe. 		These are the credentials you will use to link your AI Model Share account to the 	resources in your AWS account. 
+
+Step 4: Create your credentials file 
+************************************
+
+Combine your AI Model Share & AWS credentials into a single ‘credentials.txt' file with the `configure_credentials` function. You only have to make the file once, then you can use it whenever you use the aimodelshare library. 
+
+Credentials files must follow this format: 
+	
+	.. image:: images/creds_file_example.png
+   			:width: 600
+
+You can create this txt file manually or you can automatically create this file by inputting your credentials in response to simple prompts from the configure_credentials() function.  The following code will prompt you to provide your credentials one at a time and pre-format a txt file for you to use in the future: 
+
+.. code-block::
+
+	#install aimodelshare library
+	! pip install aimodelshare
+
+	# Generate credentials file
+	import aimodelshare as ai 
+	from aimodelshare.aws import configure_credentials 
+	configure_credentials()
+
+
+.. warning::
+
+	Remember to keep your credentials secure! Handle your credentials file with the same level of security you handle your passwords. Do not share your file with anyone, send via email, or upload to Github.
+
+Step 5: Get started! 
+********************
+
+Now that you have your credentials file, you are ready to work through the :ref:`AI Model Share Tutorial <aimodelshare_tutorial>`  or one of the :ref:`example_notebooks`. 

aimodelshare/documentation/source/example_notebooks.rst

@@ -0,0 +1,132 @@
+.. _example_notebooks: 
+
+Example Notebooks
+#################
+
+After completing the AI Model Share Tutorial, you can deploy Model Playgrounds and submit models for a variety of live data classification & regression competitions. 
+
+Choose a dataset that you would like to work with, and find everything you need included below. Notebooks can be downloaded or opened directly in Google Colab.  
+
+(*Looking for PySpark?* Go :ref:`here. <tabular_class>`) 
+
+.. _tabular_class:
+
+Tabular Classification:
+***********************
+
+Titanic Dataset
+================
+	"The sinking of the Titanic is one of the most infamous shipwrecks in history. On April 15, 1912, during her maiden voyage, the widely considered “unsinkable” RMS Titanic sank after colliding with an iceberg. Unfortunately, there weren’t enough lifeboats for everyone onboard, resulting in the death of 1502 out of 2224 passengers and crew. While there was some element of luck involved in surviving, it seems some groups of people were more likely to survive than others." Use data about the passengers on board to determine whether they were likely to survive the shipwreck or not. 
+
+	*Dataset and description adapted from: Kaggle GettingStarted Prediction Competition. (2012, September). Titanic - Machine Learning from Disaster, Version 1. Retrieved September 7, 2021 from https://www.kaggle.com/c/titanic/data.* 
+
+	* `Quick Start Tutorial (Start here to Deploy) <https://www.modelshare.org/notebooks/notebook:304>`_
+	* `Quick Start Tutorial with PySpark <https://www.modelshare.org/notebooks/notebook:366>`_
+	* `Model Submission Guide: sklearn <https://www.modelshare.org/notebooks/notebook:305>`_
+	* `Model Submission Guide: Deep Learning <https://www.modelshare.org/notebooks/notebook:306>`_
+	* `Model Submission Guide: Predictions Only (no model metadata extracted) <https://www.modelshare.org/notebooks/notebook:319>`_
+
+.. _tabular_reg:
+
+Tabular Regression:
+*******************
+
+Used Car Sales Price Dataset
+============================
+
+	Cars notoriously lose value as soon as they are purchased. However, the resell value of any particular car depends on many factors, including make, model, miles driven, transmission type, the number of owners, and more. Use this dataset to predict the resell value of used cars based on their features.
+
+	*Dataset adapted from: Birla, Nehal, Nishant Verma, and Nikhil Kushwaha. (June, 2018). Vehicle dataset, Version 3. Retrieved September 14, 2021 from https://www.kaggle.com/nehalbirla/vehicle-dataset-from-cardekho.*
+
+	* `Quick Start Tutorial (Start here to Deploy) <https://www.modelshare.org/notebooks/notebook:285>`_
+	* `Model Submission Guide: sklearn <https://www.modelshare.org/notebooks/notebook:286>`_
+	* `Model Submission Guide: Deep Learning <https://www.modelshare.org/notebooks/notebook:287>`_
+
+.. _text_class:
+
+Text Classification:
+********************
+
+Covid Misinformation Identification
+===================================
+
+	"The significance of social media has increased manifold in the past few decades as it helps people from even the most remote corners of the world stay connected. With the COVID-19 pandemic raging, social media has become more relevant and widely used than ever before, and along with this, there has been a resurgence in the circulation of fake news and tweets that demand immediate attention." Use this dataset to read COVID-19 related tweets and determine if the information they present is "real" or "fake". 
+
+	*Description and dataset adapted from: Sourya Dipta Das, Ayan Basak, and Saikat Dutta. "A Heuristic-driven Ensemble Framework for COVID-19 Fake News Detection”. arXiv preprint arXiv:2101.03545. 2021. Retrieved from https://github.com/diptamath/covid_fake_news/tree/main/data.*
+
+	* `Quick Start Tutorial (Start here to Deploy) <https://www.modelshare.org/notebooks/notebook:290>`_
+	* `Model Submission Guide: sklearn <https://www.modelshare.org/notebooks/notebook:291>`_
+	* `Model Submission Guide: Deep Learning <https://www.modelshare.org/notebooks/notebook:292>`_
+
+
+Clickbait Identification
+========================
+
+	"In the online world, many media outlets have to generate revenue from the clicks made by their readers, and due to the presence of numerous such outlets, they have to compete with each other for reader attention. To attract the readers to click on an article and visit the media site, they often come up with catchy headlines accompanying the article links, which lure the readers to click on the link. Such headlines are known as Clickbaits. While these baits may trick the readers into clicking, in the long-run, clickbaits usually don’t live up to the expectation of the readers and leave them disappointed." Use this dataset to read headlines from multiple media outlets and identify whether they represent clickbait or substantive news.
+
+	*Dataset and description adapted From: Abhijnan Chakraborty, Bhargavi Paranjape, Sourya Kakarla, and Niloy Ganguly. "Stop Clickbait: Detecting and Preventing Clickbaits in Online News Media”. In Proceedings of the 2016 IEEE/ACM International Conference on Advances in Social Networks Analysis and Mining (ASONAM), San Fransisco, US, August 2016.*
+
+	* `Quick Start Tutorial (Start here to Deploy) <https://www.modelshare.org/notebooks/notebook:288>`_
+	* `Model Submission Guide <https://www.modelshare.org/notebooks/notebook:289>`_
+	
+
+IMDB Movie Review Identification
+================================
+
+	IMDb, also knows as the Internet Movie Database, is an online database of movies, TV shows, celebrities, and awards. Registered users can write reviews and rate content that they've seen. Use this dataset to classify 50,000 'highly polarized' movie reviews as positive or negative. 
+
+	*Andrew L. Maas, Raymond E. Daly, Peter T. Pham, Dan Huang, Andrew Y. Ng, and Christopher Potts. (2011). Learning Word Vectors for Sentiment Analysis. The 49th Annual Meeting of the Association for Computational Linguistics (ACL 2011).*
+
+	* `Quick Start Tutorial (Start here to Deploy) <https://www.modelshare.org/notebooks/notebook:300>`_
+	* `Model Submission Guide <https://www.modelshare.org/notebooks/notebook:301>`_
+
+
+.. _image_class:
+
+Image Classification:
+*********************
+
+Dog Breed Classification
+========================
+
+	This dataset contains pictures from 6 different dog breeds, adapted from the original dataset with 120 different dog breeds from around the world. Use this dataset to look at images of dogs and determine which breed they belong to. 
+
+	*Dataset adapted from: Aditya Khosla, Nityananda Jayadevaprakash, Bangpeng Yao and Li Fei-Fei. Novel dataset for Fine-Grained Image Categorization. First Workshop on Fine-Grained Visual Categorization (FGVC), IEEE Conference on Computer Vision and Pattern Recognition (CVPR), 2011. Retrieved from http://vision.stanford.edu/aditya86/ImageNetDogs/*
+
+	* `Quick Start Tutorial (Start here to Deploy) <https://www.modelshare.org/notebooks/notebook:293>`_
+	* `Model Submission Guide <https://www.modelshare.org/notebooks/notebook:294>`_
+
+Fashion MNIST Classification
+============================
+
+	An updated version of the iconic handwritten digits MNIST dataset. Fashion-MNIST is a dataset of Zalando's article images—consisting of a training set of 60,000 examples and a test set of 10,000 examples. Each example is a 28x28 grayscale image, associated with a label from one of 10 classes. 
+
+	*Fashion-MNIST: a Novel Image Dataset for Benchmarking Machine Learning Algorithms. Han Xiao, Kashif Rasul, Roland Vollgraf. arXiv:1708.07747*
+
+	* `Quick Start Tutorial (Start here to Deploy) <https://www.modelshare.org/notebooks/notebook:295>`_
+	* `Model Submission Guide <https://www.modelshare.org/notebooks/notebook:296>`_
+
+Flower Classification
+=====================
+
+	A dataset containing pictures of 5 different classes of flowers. 
+
+	*The Tensorflow Team. (2019, January). Flowers. http://download.tensorflow.org/example_images/flower_photos.tgz*
+
+	* `Quick Start Tutorial (Start here to Deploy) <https://www.modelshare.org/notebooks/notebook:297>`_
+	* `Model Submission Guide <https://www.modelshare.org/notebooks/notebook:299>`_
+
+.. _video_class:
+
+Video Classification:
+*********************
+
+Sports Clips Classification
+===========================
+
+	Video clips of people doing pull-ups, kayaking, and horseback riding. Use this dataset to watch video clips and determine which of three activities are taking place. 
+
+	*Dataset adapted from: Soomro, K., Zamir, A. R., & Sha, M. (2012). UCF101: A Dataset of 101 Human Actions Classes From Videos in The Wild. Center for Research in Computer Vision, University of Central Florida. https://arxiv.org/pdf/1212.0402v1.pdf*
+
+	* `Quick Start Tutorial (Start here to Deploy) <https://www.modelshare.org/notebooks/notebook:302>`_
+	* `Model Submission Guide <https://www.modelshare.org/notebooks/notebook:303>`_