Creates the experiment.

        Parameters
        ----------
        workflow_type: str
            workflow type
        microscope_type: str
            microscope type
        plate_format: int
            well-plate format, i.e. total number of wells per plate
        plate_acquisition_mode: str
            mode of image acquisition that determines whether acquisitions will
            be interpreted as time points as part of a time series experiment
            or as multiplexing cycles as part of a serial multiplexing
            experiment

        Returns
        -------
        dict
            experiment resource representation

        See also
        --------
        :func:`tmserver.api.experiment.create_experiment`
        :class:`tmlib.models.experiment.ExperimentReference`
        :class:`tmlib.models.experiment.Experiment`

def create_experiment(self, workflow_type, microscope_type, plate_format,
            plate_acquisition_mode):
        '''Creates the experiment.

        Parameters
        ----------
        workflow_type: str
            workflow type
        microscope_type: str
            microscope type
        plate_format: int
            well-plate format, i.e. total number of wells per plate
        plate_acquisition_mode: str
            mode of image acquisition that determines whether acquisitions will
            be interpreted as time points as part of a time series experiment
            or as multiplexing cycles as part of a serial multiplexing
            experiment

        Returns
        -------
        dict
            experiment resource representation

        See also
        --------
        :func:`tmserver.api.experiment.create_experiment`
        :class:`tmlib.models.experiment.ExperimentReference`
        :class:`tmlib.models.experiment.Experiment`
        '''
        logger.info('create experiment "%s"', self.experiment_name)
        content = {
            'name': self.experiment_name,
            'workflow_type': workflow_type,
            'microscope_type': microscope_type,
            'plate_format': plate_format,
            'plate_acquisition_mode': plate_acquisition_mode
        }
        url = self._build_api_url('/experiments')
        res = self._session.post(url, json=content)
        res.raise_for_status()
        data = res.json()['data']
        self._experiment_id = data['id']
        return data