component_base ==================================================== .. py:module:: evalml.pipelines.components.component_base .. autoapi-nested-parse:: Base class for all components. Module Contents --------------- Classes Summary ~~~~~~~~~~~~~~~ .. autoapisummary:: evalml.pipelines.components.component_base.ComponentBase Contents ~~~~~~~~~~~~~~~~~~~ .. py:class:: ComponentBase(parameters=None, component_obj=None, random_seed=0, **kwargs) Base class for all components. :param parameters: Dictionary of parameters for the component. Defaults to None. :type parameters: dict :param component_obj: Third-party objects useful in component implementation. Defaults to None. :type component_obj: obj :param random_seed: Seed for the random number generator. Defaults to 0. :type random_seed: int **Methods** .. autoapisummary:: :nosignatures: evalml.pipelines.components.component_base.ComponentBase.clone evalml.pipelines.components.component_base.ComponentBase.default_parameters evalml.pipelines.components.component_base.ComponentBase.describe evalml.pipelines.components.component_base.ComponentBase.fit evalml.pipelines.components.component_base.ComponentBase.load evalml.pipelines.components.component_base.ComponentBase.modifies_features evalml.pipelines.components.component_base.ComponentBase.modifies_target evalml.pipelines.components.component_base.ComponentBase.name evalml.pipelines.components.component_base.ComponentBase.needs_fitting evalml.pipelines.components.component_base.ComponentBase.parameters evalml.pipelines.components.component_base.ComponentBase.save evalml.pipelines.components.component_base.ComponentBase.training_only evalml.pipelines.components.component_base.ComponentBase.update_parameters .. py:method:: clone(self) Constructs a new component with the same parameters and random state. :returns: A new instance of this component with identical parameters and random state. .. py:method:: default_parameters(cls) Returns the default parameters for this component. Our convention is that Component.default_parameters == Component().parameters. :returns: Default parameters for this component. :rtype: dict .. py:method:: describe(self, print_name=False, return_dict=False) Describe a component and its parameters. :param print_name: whether to print name of component :type print_name: bool, optional :param return_dict: whether to return description as dictionary in the format {"name": name, "parameters": parameters} :type return_dict: bool, optional :returns: Returns dictionary if return_dict is True, else None. :rtype: None or dict .. py:method:: fit(self, X, y=None) Fits component to data. :param X: The input training data of shape [n_samples, n_features] :type X: pd.DataFrame :param y: The target training data of length [n_samples] :type y: pd.Series, optional :returns: self :raises MethodPropertyNotFoundError: If component does not have a fit method or a component_obj that implements fit. .. py:method:: load(file_path) :staticmethod: Loads component at file path. :param file_path: Location to load file. :type file_path: str :returns: ComponentBase object .. py:method:: modifies_features(cls) :property: Returns whether this component modifies (subsets or transforms) the features variable during transform. For Estimator objects, this attribute determines if the return value from `predict` or `predict_proba` should be used as features or targets. .. py:method:: modifies_target(cls) :property: Returns whether this component modifies (subsets or transforms) the target variable during transform. For Estimator objects, this attribute determines if the return value from `predict` or `predict_proba` should be used as features or targets. .. py:method:: name(cls) :property: Returns string name of this component. .. py:method:: needs_fitting(self) Returns boolean determining if component needs fitting before calling predict, predict_proba, transform, or feature_importances. This can be overridden to False for components that do not need to be fit or whose fit methods do nothing. :returns: True. .. py:method:: parameters(self) :property: Returns the parameters which were used to initialize the component. .. py:method:: save(self, file_path, pickle_protocol=cloudpickle.DEFAULT_PROTOCOL) Saves component at file path. :param file_path: Location to save file. :type file_path: str :param pickle_protocol: The pickle data stream format. :type pickle_protocol: int .. py:method:: training_only(cls) :property: Returns whether or not this component should be evaluated during training-time only, or during both training and prediction time. .. py:method:: update_parameters(self, update_dict, reset_fit=True) Updates the parameter dictionary of the component. :param update_dict: A dict of parameters to update. :type update_dict: dict :param reset_fit: If True, will set `_is_fitted` to False. :type reset_fit: bool, optional