Update add_well() comment to reflect intended pre- and post-condition.

This commit is contained in:
Bård Skaflestad 2012-04-22 11:36:49 +02:00
parent 7125e31748
commit 829f6aa003

View File

@ -126,19 +126,22 @@ struct Wells *
create_wells(int nwells_reserve_cap, int nperf_reserve_cap); create_wells(int nwells_reserve_cap, int nperf_reserve_cap);
/** Append a new well to an existing Wells object. /**
* If successful, W->number_of_wells is incremented by 1. * Append a new well to an existing Wells object.
* The newly added well will have no controls associated with it, add *
* controls using append_well_controls(). The current control index is set * Increments W->number_of_wells by one if successful. The new well
* to -1 (invalid). * does not include operational constraints. Such information is
* \param[in] type Type of well. * specified using function append_well_controls(). The current
* \param[in] depth_ref Reference depth for bhp. * control index is set to -1 (invalid).
* \param[in] nperf Number of perforations. *
* \param[in] zfrac Injection fraction (three components) or NULL. * \param[in] type Type of well.
* \param[in] cells Perforation cell indices. * \param[in] depth_ref Reference depth for bhp.
* \param[in] WI Well production index per perforation, or NULL. * \param[in] nperf Number of perforations.
* \param[inout] W The Wells object to be modified. * \param[in] zfrac Injection fraction (three components) or NULL.
* \return 1 if successful, 0 if failed. * \param[in] cells Perforation cell indices.
* \param[in] WI Well production index per perforation, or NULL.
* \param[inout] W The Wells object to be modified.
* \return Non-zero (true) if successful and zero otherwise.
*/ */
int int
add_well(enum WellType type , add_well(enum WellType type ,