AWS SDK for C++  1.9.124
AWS SDK for C++
Public Member Functions | List of all members
Aws::SageMaker::Model::Trial Class Reference

#include <Trial.h>

Public Member Functions

 Trial ()
 
 Trial (Aws::Utils::Json::JsonView jsonValue)
 
Trialoperator= (Aws::Utils::Json::JsonView jsonValue)
 
Aws::Utils::Json::JsonValue Jsonize () const
 
const Aws::StringGetTrialName () const
 
bool TrialNameHasBeenSet () const
 
void SetTrialName (const Aws::String &value)
 
void SetTrialName (Aws::String &&value)
 
void SetTrialName (const char *value)
 
TrialWithTrialName (const Aws::String &value)
 
TrialWithTrialName (Aws::String &&value)
 
TrialWithTrialName (const char *value)
 
const Aws::StringGetTrialArn () const
 
bool TrialArnHasBeenSet () const
 
void SetTrialArn (const Aws::String &value)
 
void SetTrialArn (Aws::String &&value)
 
void SetTrialArn (const char *value)
 
TrialWithTrialArn (const Aws::String &value)
 
TrialWithTrialArn (Aws::String &&value)
 
TrialWithTrialArn (const char *value)
 
const Aws::StringGetDisplayName () const
 
bool DisplayNameHasBeenSet () const
 
void SetDisplayName (const Aws::String &value)
 
void SetDisplayName (Aws::String &&value)
 
void SetDisplayName (const char *value)
 
TrialWithDisplayName (const Aws::String &value)
 
TrialWithDisplayName (Aws::String &&value)
 
TrialWithDisplayName (const char *value)
 
const Aws::StringGetExperimentName () const
 
bool ExperimentNameHasBeenSet () const
 
void SetExperimentName (const Aws::String &value)
 
void SetExperimentName (Aws::String &&value)
 
void SetExperimentName (const char *value)
 
TrialWithExperimentName (const Aws::String &value)
 
TrialWithExperimentName (Aws::String &&value)
 
TrialWithExperimentName (const char *value)
 
const TrialSourceGetSource () const
 
bool SourceHasBeenSet () const
 
void SetSource (const TrialSource &value)
 
void SetSource (TrialSource &&value)
 
TrialWithSource (const TrialSource &value)
 
TrialWithSource (TrialSource &&value)
 
const Aws::Utils::DateTimeGetCreationTime () const
 
bool CreationTimeHasBeenSet () const
 
void SetCreationTime (const Aws::Utils::DateTime &value)
 
void SetCreationTime (Aws::Utils::DateTime &&value)
 
TrialWithCreationTime (const Aws::Utils::DateTime &value)
 
TrialWithCreationTime (Aws::Utils::DateTime &&value)
 
const UserContextGetCreatedBy () const
 
bool CreatedByHasBeenSet () const
 
void SetCreatedBy (const UserContext &value)
 
void SetCreatedBy (UserContext &&value)
 
TrialWithCreatedBy (const UserContext &value)
 
TrialWithCreatedBy (UserContext &&value)
 
const Aws::Utils::DateTimeGetLastModifiedTime () const
 
bool LastModifiedTimeHasBeenSet () const
 
void SetLastModifiedTime (const Aws::Utils::DateTime &value)
 
void SetLastModifiedTime (Aws::Utils::DateTime &&value)
 
TrialWithLastModifiedTime (const Aws::Utils::DateTime &value)
 
TrialWithLastModifiedTime (Aws::Utils::DateTime &&value)
 
const UserContextGetLastModifiedBy () const
 
bool LastModifiedByHasBeenSet () const
 
void SetLastModifiedBy (const UserContext &value)
 
void SetLastModifiedBy (UserContext &&value)
 
TrialWithLastModifiedBy (const UserContext &value)
 
TrialWithLastModifiedBy (UserContext &&value)
 
const MetadataPropertiesGetMetadataProperties () const
 
bool MetadataPropertiesHasBeenSet () const
 
void SetMetadataProperties (const MetadataProperties &value)
 
void SetMetadataProperties (MetadataProperties &&value)
 
TrialWithMetadataProperties (const MetadataProperties &value)
 
TrialWithMetadataProperties (MetadataProperties &&value)
 
const Aws::Vector< Tag > & GetTags () const
 
bool TagsHasBeenSet () const
 
void SetTags (const Aws::Vector< Tag > &value)
 
void SetTags (Aws::Vector< Tag > &&value)
 
TrialWithTags (const Aws::Vector< Tag > &value)
 
TrialWithTags (Aws::Vector< Tag > &&value)
 
TrialAddTags (const Tag &value)
 
TrialAddTags (Tag &&value)
 
const Aws::Vector< TrialComponentSimpleSummary > & GetTrialComponentSummaries () const
 
bool TrialComponentSummariesHasBeenSet () const
 
void SetTrialComponentSummaries (const Aws::Vector< TrialComponentSimpleSummary > &value)
 
void SetTrialComponentSummaries (Aws::Vector< TrialComponentSimpleSummary > &&value)
 
TrialWithTrialComponentSummaries (const Aws::Vector< TrialComponentSimpleSummary > &value)
 
TrialWithTrialComponentSummaries (Aws::Vector< TrialComponentSimpleSummary > &&value)
 
TrialAddTrialComponentSummaries (const TrialComponentSimpleSummary &value)
 
TrialAddTrialComponentSummaries (TrialComponentSimpleSummary &&value)
 

Detailed Description

The properties of a trial as returned by the Search API.

See Also:

AWS API Reference

Definition at line 39 of file Trial.h.

Constructor & Destructor Documentation

◆ Trial() [1/2]

Aws::SageMaker::Model::Trial::Trial ( )

◆ Trial() [2/2]

Aws::SageMaker::Model::Trial::Trial ( Aws::Utils::Json::JsonView  jsonValue)

Member Function Documentation

◆ AddTags() [1/2]

Trial& Aws::SageMaker::Model::Trial::AddTags ( const Tag value)
inline

The list of tags that are associated with the trial. You can use Search API to search on the tags.

Definition at line 410 of file Trial.h.

◆ AddTags() [2/2]

Trial& Aws::SageMaker::Model::Trial::AddTags ( Tag &&  value)
inline

The list of tags that are associated with the trial. You can use Search API to search on the tags.

Definition at line 416 of file Trial.h.

◆ AddTrialComponentSummaries() [1/2]

Trial& Aws::SageMaker::Model::Trial::AddTrialComponentSummaries ( const TrialComponentSimpleSummary value)
inline

A list of the components associated with the trial. For each component, a summary of the component's properties is included.

Definition at line 459 of file Trial.h.

◆ AddTrialComponentSummaries() [2/2]

Trial& Aws::SageMaker::Model::Trial::AddTrialComponentSummaries ( TrialComponentSimpleSummary &&  value)
inline

A list of the components associated with the trial. For each component, a summary of the component's properties is included.

Definition at line 465 of file Trial.h.

◆ CreatedByHasBeenSet()

bool Aws::SageMaker::Model::Trial::CreatedByHasBeenSet ( ) const
inline

Who created the trial.

Definition at line 278 of file Trial.h.

◆ CreationTimeHasBeenSet()

bool Aws::SageMaker::Model::Trial::CreationTimeHasBeenSet ( ) const
inline

When the trial was created.

Definition at line 247 of file Trial.h.

◆ DisplayNameHasBeenSet()

bool Aws::SageMaker::Model::Trial::DisplayNameHasBeenSet ( ) const
inline

The name of the trial as displayed. If DisplayName isn't specified, TrialName is displayed.

Definition at line 140 of file Trial.h.

◆ ExperimentNameHasBeenSet()

bool Aws::SageMaker::Model::Trial::ExperimentNameHasBeenSet ( ) const
inline

The name of the experiment the trial is part of.

Definition at line 187 of file Trial.h.

◆ GetCreatedBy()

const UserContext& Aws::SageMaker::Model::Trial::GetCreatedBy ( ) const
inline

Who created the trial.

Definition at line 273 of file Trial.h.

◆ GetCreationTime()

const Aws::Utils::DateTime& Aws::SageMaker::Model::Trial::GetCreationTime ( ) const
inline

When the trial was created.

Definition at line 242 of file Trial.h.

◆ GetDisplayName()

const Aws::String& Aws::SageMaker::Model::Trial::GetDisplayName ( ) const
inline

The name of the trial as displayed. If DisplayName isn't specified, TrialName is displayed.

Definition at line 134 of file Trial.h.

◆ GetExperimentName()

const Aws::String& Aws::SageMaker::Model::Trial::GetExperimentName ( ) const
inline

The name of the experiment the trial is part of.

Definition at line 182 of file Trial.h.

◆ GetLastModifiedBy()

const UserContext& Aws::SageMaker::Model::Trial::GetLastModifiedBy ( ) const
inline

Definition at line 333 of file Trial.h.

◆ GetLastModifiedTime()

const Aws::Utils::DateTime& Aws::SageMaker::Model::Trial::GetLastModifiedTime ( ) const
inline

Who last modified the trial.

Definition at line 304 of file Trial.h.

◆ GetMetadataProperties()

const MetadataProperties& Aws::SageMaker::Model::Trial::GetMetadataProperties ( ) const
inline

Definition at line 352 of file Trial.h.

◆ GetSource()

const TrialSource& Aws::SageMaker::Model::Trial::GetSource ( ) const
inline

Definition at line 221 of file Trial.h.

◆ GetTags()

const Aws::Vector<Tag>& Aws::SageMaker::Model::Trial::GetTags ( ) const
inline

The list of tags that are associated with the trial. You can use Search API to search on the tags.

Definition at line 374 of file Trial.h.

◆ GetTrialArn()

const Aws::String& Aws::SageMaker::Model::Trial::GetTrialArn ( ) const
inline

The Amazon Resource Name (ARN) of the trial.

Definition at line 92 of file Trial.h.

◆ GetTrialComponentSummaries()

const Aws::Vector<TrialComponentSimpleSummary>& Aws::SageMaker::Model::Trial::GetTrialComponentSummaries ( ) const
inline

A list of the components associated with the trial. For each component, a summary of the component's properties is included.

Definition at line 423 of file Trial.h.

◆ GetTrialName()

const Aws::String& Aws::SageMaker::Model::Trial::GetTrialName ( ) const
inline

The name of the trial.

Definition at line 51 of file Trial.h.

◆ Jsonize()

Aws::Utils::Json::JsonValue Aws::SageMaker::Model::Trial::Jsonize ( ) const

◆ LastModifiedByHasBeenSet()

bool Aws::SageMaker::Model::Trial::LastModifiedByHasBeenSet ( ) const
inline

Definition at line 336 of file Trial.h.

◆ LastModifiedTimeHasBeenSet()

bool Aws::SageMaker::Model::Trial::LastModifiedTimeHasBeenSet ( ) const
inline

Who last modified the trial.

Definition at line 309 of file Trial.h.

◆ MetadataPropertiesHasBeenSet()

bool Aws::SageMaker::Model::Trial::MetadataPropertiesHasBeenSet ( ) const
inline

Definition at line 355 of file Trial.h.

◆ operator=()

Trial& Aws::SageMaker::Model::Trial::operator= ( Aws::Utils::Json::JsonView  jsonValue)

◆ SetCreatedBy() [1/2]

void Aws::SageMaker::Model::Trial::SetCreatedBy ( const UserContext value)
inline

Who created the trial.

Definition at line 283 of file Trial.h.

◆ SetCreatedBy() [2/2]

void Aws::SageMaker::Model::Trial::SetCreatedBy ( UserContext &&  value)
inline

Who created the trial.

Definition at line 288 of file Trial.h.

◆ SetCreationTime() [1/2]

void Aws::SageMaker::Model::Trial::SetCreationTime ( Aws::Utils::DateTime &&  value)
inline

When the trial was created.

Definition at line 257 of file Trial.h.

◆ SetCreationTime() [2/2]

void Aws::SageMaker::Model::Trial::SetCreationTime ( const Aws::Utils::DateTime value)
inline

When the trial was created.

Definition at line 252 of file Trial.h.

◆ SetDisplayName() [1/3]

void Aws::SageMaker::Model::Trial::SetDisplayName ( Aws::String &&  value)
inline

The name of the trial as displayed. If DisplayName isn't specified, TrialName is displayed.

Definition at line 152 of file Trial.h.

◆ SetDisplayName() [2/3]

void Aws::SageMaker::Model::Trial::SetDisplayName ( const Aws::String value)
inline

The name of the trial as displayed. If DisplayName isn't specified, TrialName is displayed.

Definition at line 146 of file Trial.h.

◆ SetDisplayName() [3/3]

void Aws::SageMaker::Model::Trial::SetDisplayName ( const char *  value)
inline

The name of the trial as displayed. If DisplayName isn't specified, TrialName is displayed.

Definition at line 158 of file Trial.h.

◆ SetExperimentName() [1/3]

void Aws::SageMaker::Model::Trial::SetExperimentName ( Aws::String &&  value)
inline

The name of the experiment the trial is part of.

Definition at line 197 of file Trial.h.

◆ SetExperimentName() [2/3]

void Aws::SageMaker::Model::Trial::SetExperimentName ( const Aws::String value)
inline

The name of the experiment the trial is part of.

Definition at line 192 of file Trial.h.

◆ SetExperimentName() [3/3]

void Aws::SageMaker::Model::Trial::SetExperimentName ( const char *  value)
inline

The name of the experiment the trial is part of.

Definition at line 202 of file Trial.h.

◆ SetLastModifiedBy() [1/2]

void Aws::SageMaker::Model::Trial::SetLastModifiedBy ( const UserContext value)
inline

Definition at line 339 of file Trial.h.

◆ SetLastModifiedBy() [2/2]

void Aws::SageMaker::Model::Trial::SetLastModifiedBy ( UserContext &&  value)
inline

Definition at line 342 of file Trial.h.

◆ SetLastModifiedTime() [1/2]

void Aws::SageMaker::Model::Trial::SetLastModifiedTime ( Aws::Utils::DateTime &&  value)
inline

Who last modified the trial.

Definition at line 319 of file Trial.h.

◆ SetLastModifiedTime() [2/2]

void Aws::SageMaker::Model::Trial::SetLastModifiedTime ( const Aws::Utils::DateTime value)
inline

Who last modified the trial.

Definition at line 314 of file Trial.h.

◆ SetMetadataProperties() [1/2]

void Aws::SageMaker::Model::Trial::SetMetadataProperties ( const MetadataProperties value)
inline

Definition at line 358 of file Trial.h.

◆ SetMetadataProperties() [2/2]

void Aws::SageMaker::Model::Trial::SetMetadataProperties ( MetadataProperties &&  value)
inline

Definition at line 361 of file Trial.h.

◆ SetSource() [1/2]

void Aws::SageMaker::Model::Trial::SetSource ( const TrialSource value)
inline

Definition at line 227 of file Trial.h.

◆ SetSource() [2/2]

void Aws::SageMaker::Model::Trial::SetSource ( TrialSource &&  value)
inline

Definition at line 230 of file Trial.h.

◆ SetTags() [1/2]

void Aws::SageMaker::Model::Trial::SetTags ( Aws::Vector< Tag > &&  value)
inline

The list of tags that are associated with the trial. You can use Search API to search on the tags.

Definition at line 392 of file Trial.h.

◆ SetTags() [2/2]

void Aws::SageMaker::Model::Trial::SetTags ( const Aws::Vector< Tag > &  value)
inline

The list of tags that are associated with the trial. You can use Search API to search on the tags.

Definition at line 386 of file Trial.h.

◆ SetTrialArn() [1/3]

void Aws::SageMaker::Model::Trial::SetTrialArn ( Aws::String &&  value)
inline

The Amazon Resource Name (ARN) of the trial.

Definition at line 107 of file Trial.h.

◆ SetTrialArn() [2/3]

void Aws::SageMaker::Model::Trial::SetTrialArn ( const Aws::String value)
inline

The Amazon Resource Name (ARN) of the trial.

Definition at line 102 of file Trial.h.

◆ SetTrialArn() [3/3]

void Aws::SageMaker::Model::Trial::SetTrialArn ( const char *  value)
inline

The Amazon Resource Name (ARN) of the trial.

Definition at line 112 of file Trial.h.

◆ SetTrialComponentSummaries() [1/2]

void Aws::SageMaker::Model::Trial::SetTrialComponentSummaries ( Aws::Vector< TrialComponentSimpleSummary > &&  value)
inline

A list of the components associated with the trial. For each component, a summary of the component's properties is included.

Definition at line 441 of file Trial.h.

◆ SetTrialComponentSummaries() [2/2]

void Aws::SageMaker::Model::Trial::SetTrialComponentSummaries ( const Aws::Vector< TrialComponentSimpleSummary > &  value)
inline

A list of the components associated with the trial. For each component, a summary of the component's properties is included.

Definition at line 435 of file Trial.h.

◆ SetTrialName() [1/3]

void Aws::SageMaker::Model::Trial::SetTrialName ( Aws::String &&  value)
inline

The name of the trial.

Definition at line 66 of file Trial.h.

◆ SetTrialName() [2/3]

void Aws::SageMaker::Model::Trial::SetTrialName ( const Aws::String value)
inline

The name of the trial.

Definition at line 61 of file Trial.h.

◆ SetTrialName() [3/3]

void Aws::SageMaker::Model::Trial::SetTrialName ( const char *  value)
inline

The name of the trial.

Definition at line 71 of file Trial.h.

◆ SourceHasBeenSet()

bool Aws::SageMaker::Model::Trial::SourceHasBeenSet ( ) const
inline

Definition at line 224 of file Trial.h.

◆ TagsHasBeenSet()

bool Aws::SageMaker::Model::Trial::TagsHasBeenSet ( ) const
inline

The list of tags that are associated with the trial. You can use Search API to search on the tags.

Definition at line 380 of file Trial.h.

◆ TrialArnHasBeenSet()

bool Aws::SageMaker::Model::Trial::TrialArnHasBeenSet ( ) const
inline

The Amazon Resource Name (ARN) of the trial.

Definition at line 97 of file Trial.h.

◆ TrialComponentSummariesHasBeenSet()

bool Aws::SageMaker::Model::Trial::TrialComponentSummariesHasBeenSet ( ) const
inline

A list of the components associated with the trial. For each component, a summary of the component's properties is included.

Definition at line 429 of file Trial.h.

◆ TrialNameHasBeenSet()

bool Aws::SageMaker::Model::Trial::TrialNameHasBeenSet ( ) const
inline

The name of the trial.

Definition at line 56 of file Trial.h.

◆ WithCreatedBy() [1/2]

Trial& Aws::SageMaker::Model::Trial::WithCreatedBy ( const UserContext value)
inline

Who created the trial.

Definition at line 293 of file Trial.h.

◆ WithCreatedBy() [2/2]

Trial& Aws::SageMaker::Model::Trial::WithCreatedBy ( UserContext &&  value)
inline

Who created the trial.

Definition at line 298 of file Trial.h.

◆ WithCreationTime() [1/2]

Trial& Aws::SageMaker::Model::Trial::WithCreationTime ( Aws::Utils::DateTime &&  value)
inline

When the trial was created.

Definition at line 267 of file Trial.h.

◆ WithCreationTime() [2/2]

Trial& Aws::SageMaker::Model::Trial::WithCreationTime ( const Aws::Utils::DateTime value)
inline

When the trial was created.

Definition at line 262 of file Trial.h.

◆ WithDisplayName() [1/3]

Trial& Aws::SageMaker::Model::Trial::WithDisplayName ( Aws::String &&  value)
inline

The name of the trial as displayed. If DisplayName isn't specified, TrialName is displayed.

Definition at line 170 of file Trial.h.

◆ WithDisplayName() [2/3]

Trial& Aws::SageMaker::Model::Trial::WithDisplayName ( const Aws::String value)
inline

The name of the trial as displayed. If DisplayName isn't specified, TrialName is displayed.

Definition at line 164 of file Trial.h.

◆ WithDisplayName() [3/3]

Trial& Aws::SageMaker::Model::Trial::WithDisplayName ( const char *  value)
inline

The name of the trial as displayed. If DisplayName isn't specified, TrialName is displayed.

Definition at line 176 of file Trial.h.

◆ WithExperimentName() [1/3]

Trial& Aws::SageMaker::Model::Trial::WithExperimentName ( Aws::String &&  value)
inline

The name of the experiment the trial is part of.

Definition at line 212 of file Trial.h.

◆ WithExperimentName() [2/3]

Trial& Aws::SageMaker::Model::Trial::WithExperimentName ( const Aws::String value)
inline

The name of the experiment the trial is part of.

Definition at line 207 of file Trial.h.

◆ WithExperimentName() [3/3]

Trial& Aws::SageMaker::Model::Trial::WithExperimentName ( const char *  value)
inline

The name of the experiment the trial is part of.

Definition at line 217 of file Trial.h.

◆ WithLastModifiedBy() [1/2]

Trial& Aws::SageMaker::Model::Trial::WithLastModifiedBy ( const UserContext value)
inline

Definition at line 345 of file Trial.h.

◆ WithLastModifiedBy() [2/2]

Trial& Aws::SageMaker::Model::Trial::WithLastModifiedBy ( UserContext &&  value)
inline

Definition at line 348 of file Trial.h.

◆ WithLastModifiedTime() [1/2]

Trial& Aws::SageMaker::Model::Trial::WithLastModifiedTime ( Aws::Utils::DateTime &&  value)
inline

Who last modified the trial.

Definition at line 329 of file Trial.h.

◆ WithLastModifiedTime() [2/2]

Trial& Aws::SageMaker::Model::Trial::WithLastModifiedTime ( const Aws::Utils::DateTime value)
inline

Who last modified the trial.

Definition at line 324 of file Trial.h.

◆ WithMetadataProperties() [1/2]

Trial& Aws::SageMaker::Model::Trial::WithMetadataProperties ( const MetadataProperties value)
inline

Definition at line 364 of file Trial.h.

◆ WithMetadataProperties() [2/2]

Trial& Aws::SageMaker::Model::Trial::WithMetadataProperties ( MetadataProperties &&  value)
inline

Definition at line 367 of file Trial.h.

◆ WithSource() [1/2]

Trial& Aws::SageMaker::Model::Trial::WithSource ( const TrialSource value)
inline

Definition at line 233 of file Trial.h.

◆ WithSource() [2/2]

Trial& Aws::SageMaker::Model::Trial::WithSource ( TrialSource &&  value)
inline

Definition at line 236 of file Trial.h.

◆ WithTags() [1/2]

Trial& Aws::SageMaker::Model::Trial::WithTags ( Aws::Vector< Tag > &&  value)
inline

The list of tags that are associated with the trial. You can use Search API to search on the tags.

Definition at line 404 of file Trial.h.

◆ WithTags() [2/2]

Trial& Aws::SageMaker::Model::Trial::WithTags ( const Aws::Vector< Tag > &  value)
inline

The list of tags that are associated with the trial. You can use Search API to search on the tags.

Definition at line 398 of file Trial.h.

◆ WithTrialArn() [1/3]

Trial& Aws::SageMaker::Model::Trial::WithTrialArn ( Aws::String &&  value)
inline

The Amazon Resource Name (ARN) of the trial.

Definition at line 122 of file Trial.h.

◆ WithTrialArn() [2/3]

Trial& Aws::SageMaker::Model::Trial::WithTrialArn ( const Aws::String value)
inline

The Amazon Resource Name (ARN) of the trial.

Definition at line 117 of file Trial.h.

◆ WithTrialArn() [3/3]

Trial& Aws::SageMaker::Model::Trial::WithTrialArn ( const char *  value)
inline

The Amazon Resource Name (ARN) of the trial.

Definition at line 127 of file Trial.h.

◆ WithTrialComponentSummaries() [1/2]

Trial& Aws::SageMaker::Model::Trial::WithTrialComponentSummaries ( Aws::Vector< TrialComponentSimpleSummary > &&  value)
inline

A list of the components associated with the trial. For each component, a summary of the component's properties is included.

Definition at line 453 of file Trial.h.

◆ WithTrialComponentSummaries() [2/2]

Trial& Aws::SageMaker::Model::Trial::WithTrialComponentSummaries ( const Aws::Vector< TrialComponentSimpleSummary > &  value)
inline

A list of the components associated with the trial. For each component, a summary of the component's properties is included.

Definition at line 447 of file Trial.h.

◆ WithTrialName() [1/3]

Trial& Aws::SageMaker::Model::Trial::WithTrialName ( Aws::String &&  value)
inline

The name of the trial.

Definition at line 81 of file Trial.h.

◆ WithTrialName() [2/3]

Trial& Aws::SageMaker::Model::Trial::WithTrialName ( const Aws::String value)
inline

The name of the trial.

Definition at line 76 of file Trial.h.

◆ WithTrialName() [3/3]

Trial& Aws::SageMaker::Model::Trial::WithTrialName ( const char *  value)
inline

The name of the trial.

Definition at line 86 of file Trial.h.


The documentation for this class was generated from the following file: