# publish.features()

### Parameters

**`features_dict`***`:dict:`*[`Dictionary`](https://github.com/rasgointelligence/RasgoDocs/blob/main/rasgo-0.1/pyrasgo-0.3/features/broken-reference/README.md) `to publish as Rasgo Features`

`{`\
`"sourceTable": "mandatory DB.SCHEMA.TABLE where features are",`\
`"features": [`\
`{`\
`"columnName": "mandatory_field_name_in_table",`\
`"displayName": "Optional Pretty Name",`\
`"dataType": "mandatory sql type",`\
`"description": "optional display text",`\
`"tags": [`\
`"optional",`\
`"list of strings",`\
`"apply only to this feature"`\
`],`\
`"attributes": [`\
`{ "key": "value"},`\
`{"optional": "apply only to this features" }`\
`]`\
`}`\
`],`\
`"dimensions": [`\
`{`\
`"columnName": "mandatory_field_name_in_table",`\
`"displayName": "Optional Pretty Name",`\
`"dataType": "mandatory sql type",`\
`"granularity": "mandatory noun ..."`\
`}`\
`],`\
`"status": "Production | Sandbox",`\
`"tags": [`\
`"optional",`\
`"list of strings",`\
`"apply to all features"`\
`],`\
`"attributes": [`\
`{"key": "value"},`\
`{"optional": "apply to all features"}`\
`],`\
`"script": "OptionalFile.py",`\
`"gitRepo": "Optional"`\
`}`

### Return Object

[Rasgo FeatureSet](https://github.com/rasgointelligence/RasgoDocs/blob/main/pyrasgo/features/broken-reference/README.md)

### Sample Usage

Create new features from a dict

```python
	features_dict = rasgo.prepare_feature_set_dict(600)
    print('My Dict:', features_dict)
	
	features_dict = {
        'sourceTable': 'pandas_by_DATE_YEAR_2021_02_05_00_42', 
        'features': [
            {
                'columnName': 'NEXT_MONTH', 
                'dataType': 'integer', 
                'displayName': 'PANDAS_NEXT_MONTH_2021_02_05_00_42', 
                'description': 'Feature that contains PANDAS_NEXT_MONTH_2021_02_05_00_42 data',
                'tags': ['test'],
                'attributes': [{'FeatureKey': 'FeatureValue'}]
            },
            {
                'columnName': 'NEXT_MONTH', 
                'dataType': 'integer', 
                'displayName': 'PANDAS_NEXT_MONTH_2021_02_05_00_42', 
                'description': 'Feature that contains PANDAS_NEXT_MONTH_2021_02_05_00_42 data'
            }
            ], 
        'dimensions': [
            {
                'columnName': 'YEAR', 
                'dataType': 'integer', 
                'granularity': 'test'
            }, 
            {
                'columnName': 'DATE', 
                'dataType': 'string', 
                'granularity': 'day'
            }
            ], 
        'tags': ['test', '02/05/2021', 'Pandas'],
        'attributes': [{'Key1': 'Value1'}],
        'status': 'Production'
    }
    features = rasgo.publish.features(features_dict)
    print(features)
```

Publish changes to an existing feature

```python
feature = rasgo.get_feature(1557)
features_dict = feature.to_dict()
print('My Feature:', features_dict)

# Changes feature values by interacting with dict
# Example: Update Name
feautures_dict["features"][0]["displayName"] = "New Feature Name"

feature = rasgo.publish_features(features_dict)
print(feature)
```

Publish changes to all features in a FeatureSet

```python
features_dict = rasgo.prepare_feature_set_dict(600)
print('My FeatureSet:', features_dict)


# Changes feature values by interacting with dict
# Example: Add tags to all features
feautures_dict["tags"] = ["new tag", "apply to all features"]

features = rasgo.publish_features(features_dict)
print(features)
```

{% hint style="info" %}
Columns in your DataSource table that are not referenced in either the "dimensions" or "features" list will be ignored
{% endhint %}

### Best Practices / Tips

{% hint style="warning" %}
TIP: Feature name warning message

If you receive the error: "APIError: Failed to create Feature {\_\_\_}. This name is already in use in your organization. Feature names must be unique." this is a sign that a feature already exists with this name.

Options to remedy are:

* If the existing feature is named correctly and the feature you are trying to upload needs a new name: change the displayName attribute in your dict.
* If the existing feature is simply an earlier run of this feature, instruct the function to overwrite it by passing in the param *if\_exists='edit'*
* If the existing feature is named incorrectly, navigate to the WebApp to change that feature's name, then re-upload
  {% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.rasgoml.com/rasgo-docs/rasgo-0.1/pyrasgo-0.3/features/publish.features.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.