Merge branch 'dev' into lrossman-dev
This commit is contained in:
@@ -1,4 +1,3 @@
|
|||||||
|
|
||||||
Release Notes for EPANET 2.2 (Draft)
|
Release Notes for EPANET 2.2 (Draft)
|
||||||
============================
|
============================
|
||||||
|
|
||||||
@@ -162,6 +161,35 @@ Both network files are available [here](https://doi.org/10.23719/1375314).
|
|||||||
|`ENdeleterule` ||
|
|`ENdeleterule` ||
|
||||||
|`ENsetnodeid` ||
|
|`ENsetnodeid` ||
|
||||||
|`ENsetlinkid` ||
|
|`ENsetlinkid` ||
|
||||||
|
|`ENgetcurvetype`|Get the type of a curve|
|
||||||
|
|`ENgetdemandmodel`|Retrieves the type of demand model in use and its parameters|
|
||||||
|
|`ENsetdemandmodel`|Sets the type of demand model to use and its parameters|
|
||||||
|
|`ENsetflowunits`|Sets the flow units|
|
||||||
|
|`ENaddcontrol`|Specify parameters to add a new simple control|
|
||||||
|
|`ENsetdemandpattern`|Sets the index of the demand pattern assigned to a node for a category index|
|
||||||
|
|`ENgetrule`|Gets the number of premises, true actions, and false actions and the priority of an existing rule-based control|
|
||||||
|
|`ENsetrulepriority`|Sets the priority of the existing rule-based control|
|
||||||
|
|`ENgetpremise`|Gets the components of a premise/condition in an existing rule-based control|
|
||||||
|
|`ENsetpremise`|Sets the components of a premise/condition in an existing rule-based control|
|
||||||
|
|`ENsetpremiseindex`|Sets the index of an object in a premise of an existing rule-based control|
|
||||||
|
|`ENsetpremisestatus`|Sets the status in a premise of an existing rule-based control|
|
||||||
|
|`ENsetpremisevalue`|Sets the value in a premise of an existing rule-based control|
|
||||||
|
|`ENgettrueaction`|Gets the components of a true-action in an existing rule-based control|
|
||||||
|
|`ENsettrueaction`|Sets the components of a true-action in an existing rule-based control|
|
||||||
|
|`ENgetfalseaction`|Gets the components of a false-action in an existing rule-based control|
|
||||||
|
|`ENsetfalseaction`|Sets the components of a false-action in an existing rule-based control|
|
||||||
|
|`ENgetruleID`|Returns the ID of a rule|
|
||||||
|
|`ENinit`|Initializes an EPANET session|
|
||||||
|
|`ENsetheadcurveindex`|Sets the curve id for a specified pump index|
|
||||||
|
|`ENsetlinktype`|Set the link type code for a specified link|
|
||||||
|
|`ENaddnode`|Adds a new node|
|
||||||
|
|`ENaddlink`|Adds a new link|
|
||||||
|
|`ENdeletelink`|Deletes a link|
|
||||||
|
|`ENdeletenode`|Deletes a node|
|
||||||
|
| `ENsetnodeid` |Change the ID name for a node|
|
||||||
|
| `ENsetlinkid` |Change the ID name for a link|
|
||||||
|
|`ENgetdemandname`|Sets the node's demand name for a category|
|
||||||
|
|`ENsetdemandname`|Sets the node's demand name for a category|
|
||||||
|
|
||||||
## API Extensions (additional definitions)
|
## API Extensions (additional definitions)
|
||||||
### Link value types:
|
### Link value types:
|
||||||
@@ -178,10 +206,14 @@ Both network files are available [here](https://doi.org/10.23719/1375314).
|
|||||||
- `EN_HW`
|
- `EN_HW`
|
||||||
- `EN_DW`
|
- `EN_DW`
|
||||||
- `EN_CM`
|
- `EN_CM`
|
||||||
### Misc. options:
|
### Option types:
|
||||||
- `EN_HEADERROR`
|
- `EN_HEADERROR`
|
||||||
- `EN_FLOWCHANGE`
|
- `EN_FLOWCHANGE`
|
||||||
- `EN_DEMANDDEFPAT`
|
- `EN_DEMANDDEFPAT`
|
||||||
|
- `EN_HEADLOSSFORM`
|
||||||
|
### Time statistic types:
|
||||||
|
- `EN_MAXHEADERROR`
|
||||||
|
- `EN_MAXFLOWCHANGE`
|
||||||
- `EN_MASSBALANCE`
|
- `EN_MASSBALANCE`
|
||||||
- `EN_UNCONDITIONAL`
|
- `EN_UNCONDITIONAL`
|
||||||
- `EN_CONDITIONAL`
|
- `EN_CONDITIONAL`
|
||||||
@@ -191,7 +223,10 @@ Both network files are available [here](https://doi.org/10.23719/1375314).
|
|||||||
- `EN_E_CURVE`
|
- `EN_E_CURVE`
|
||||||
- `EN_H_CURVE`
|
- `EN_H_CURVE`
|
||||||
- `EN_G_CURVE`
|
- `EN_G_CURVE`
|
||||||
|
### Demand model types:
|
||||||
|
- `EN_DDA`
|
||||||
|
- `EN_PDA`
|
||||||
|
|
||||||
## Authors contributing to this release:
|
## Authors contributing to this release:
|
||||||
- List item
|
- List item
|
||||||
|
|
||||||
|
|||||||
@@ -3209,6 +3209,9 @@ int DLLEXPORT EN_setlinknodes(EN_ProjectHandle ph, int index, int node1, int nod
|
|||||||
int type;
|
int type;
|
||||||
EN_Project *p = (EN_Project*)ph;
|
EN_Project *p = (EN_Project*)ph;
|
||||||
EN_Network *net = &p->network;
|
EN_Network *net = &p->network;
|
||||||
|
|
||||||
|
// Check that end and start nodes are not the same
|
||||||
|
if (node1 == node2) return set_error(p->error_handle, 222);
|
||||||
|
|
||||||
// Check that nodes exist
|
// Check that nodes exist
|
||||||
if (node1 < 0 || node1 > net->Nnodes) return set_error(p->error_handle, 203);
|
if (node1 < 0 || node1 > net->Nnodes) return set_error(p->error_handle, 203);
|
||||||
|
|||||||
@@ -24,34 +24,42 @@
|
|||||||
|
|
||||||
#define DATA_PATH "./example1.out"
|
#define DATA_PATH "./example1.out"
|
||||||
|
|
||||||
using namespace std;
|
using namespace std;
|
||||||
|
|
||||||
// Custom test to check the minimum number of correct decimal digits between
|
// Custom test to check the minimum number of correct decimal digits between
|
||||||
// the test and the ref vectors.
|
// the test and the ref vectors.
|
||||||
boost::test_tools::predicate_result check_cdd(std::vector<float>& test,
|
boost::test_tools::predicate_result check_cdd(std::vector<float>& test,
|
||||||
std::vector<float>& ref, long cdd_tol)
|
std::vector<float>& ref, long cdd_tol){
|
||||||
{
|
float tmp, min_cdd = 10.0;
|
||||||
float tmp, min_cdd = 100.0;
|
|
||||||
|
// TODO: What if the vectors aren't the same length?
|
||||||
// TODO: What is the vectors aren't the same length?
|
|
||||||
|
|
||||||
std::vector<float>::iterator test_it;
|
std::vector<float>::iterator test_it;
|
||||||
std::vector<float>::iterator ref_it;
|
std::vector<float>::iterator ref_it;
|
||||||
|
|
||||||
for (test_it = test.begin(); test_it < test.end(); ++test_it) {
|
for (test_it = test.begin(), ref_it = ref.begin();
|
||||||
for (ref_it = ref.begin(); ref_it < ref.end(); ++ref_it) {
|
(test_it < test.end()) && (ref_it < ref.end());
|
||||||
|
++test_it, ++ref_it)
|
||||||
if (*test_it != *ref_it) {
|
{
|
||||||
tmp = - log10f(abs(*test_it - *ref_it));
|
if (*test_it != *ref_it) {
|
||||||
if (tmp < min_cdd) min_cdd = tmp;
|
// Compute log absolute error
|
||||||
}
|
tmp = abs(*test_it - *ref_it);
|
||||||
|
if (tmp < 1.0e-7f)
|
||||||
|
tmp = 1.0e-7f;
|
||||||
|
|
||||||
|
else if (tmp > 2.0f)
|
||||||
|
tmp = 1.0f;
|
||||||
|
|
||||||
|
tmp = -log10(tmp);
|
||||||
|
if (tmp < 0.0f)
|
||||||
|
tmp = 0.0f;
|
||||||
|
|
||||||
|
if (tmp < min_cdd)
|
||||||
|
min_cdd = tmp;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
if (min_cdd == 100.0)
|
return floor(min_cdd) >= cdd_tol;
|
||||||
return true;
|
|
||||||
else
|
|
||||||
return floor(min_cdd) <= cdd_tol;
|
|
||||||
}
|
}
|
||||||
|
|
||||||
boost::test_tools::predicate_result check_string(std::string test, std::string ref)
|
boost::test_tools::predicate_result check_string(std::string test, std::string ref)
|
||||||
@@ -96,7 +104,7 @@ struct Fixture{
|
|||||||
free((void*)array);
|
free((void*)array);
|
||||||
error = ENR_close(&p_handle);
|
error = ENR_close(&p_handle);
|
||||||
}
|
}
|
||||||
|
|
||||||
std::string path;
|
std::string path;
|
||||||
int error;
|
int error;
|
||||||
ENR_Handle p_handle;
|
ENR_Handle p_handle;
|
||||||
@@ -110,14 +118,14 @@ BOOST_AUTO_TEST_SUITE(test_output_fixture)
|
|||||||
BOOST_FIXTURE_TEST_CASE(test_getNetSize, Fixture)
|
BOOST_FIXTURE_TEST_CASE(test_getNetSize, Fixture)
|
||||||
{
|
{
|
||||||
int *i_array = NULL;
|
int *i_array = NULL;
|
||||||
|
|
||||||
error = ENR_getNetSize(p_handle, &i_array, &array_dim);
|
error = ENR_getNetSize(p_handle, &i_array, &array_dim);
|
||||||
BOOST_REQUIRE(error == 0);
|
BOOST_REQUIRE(error == 0);
|
||||||
|
|
||||||
// nodes, tanks, links, pumps, valves
|
// nodes, tanks, links, pumps, valves
|
||||||
std::vector<int> test;
|
std::vector<int> test;
|
||||||
test.assign(i_array, i_array + array_dim);
|
test.assign(i_array, i_array + array_dim);
|
||||||
|
|
||||||
std::vector<int> ref = {11,2,13,1,0};
|
std::vector<int> ref = {11,2,13,1,0};
|
||||||
|
|
||||||
BOOST_CHECK_EQUAL_COLLECTIONS(ref.begin(), ref.end(), test.begin(), test.end());
|
BOOST_CHECK_EQUAL_COLLECTIONS(ref.begin(), ref.end(), test.begin(), test.end());
|
||||||
@@ -149,11 +157,11 @@ BOOST_FIXTURE_TEST_CASE(test_getElementName, Fixture) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
BOOST_FIXTURE_TEST_CASE(test_getNodeAttribute, Fixture) {
|
BOOST_FIXTURE_TEST_CASE(test_getNodeAttribute, Fixture) {
|
||||||
|
|
||||||
error = ENR_getNodeAttribute(p_handle, 1, ENR_quality, &array, &array_dim);
|
error = ENR_getNodeAttribute(p_handle, 1, ENR_quality, &array, &array_dim);
|
||||||
BOOST_REQUIRE(error == 0);
|
BOOST_REQUIRE(error == 0);
|
||||||
|
|
||||||
std::vector<float> ref_vec = { 1.0f,
|
std::vector<float> ref_vec = { 1.0f,
|
||||||
0.44407997f,
|
0.44407997f,
|
||||||
0.43766347f,
|
0.43766347f,
|
||||||
0.42827705f,
|
0.42827705f,
|
||||||
@@ -197,10 +205,10 @@ BOOST_FIXTURE_TEST_CASE(test_getLinkAttribute, Fixture) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
BOOST_FIXTURE_TEST_CASE(test_getNodeResult, Fixture) {
|
BOOST_FIXTURE_TEST_CASE(test_getNodeResult, Fixture) {
|
||||||
|
|
||||||
error = ENR_getNodeResult(p_handle, 1, 2, &array, &array_dim);
|
error = ENR_getNodeResult(p_handle, 1, 2, &array, &array_dim);
|
||||||
BOOST_REQUIRE(error == 0);
|
BOOST_REQUIRE(error == 0);
|
||||||
|
|
||||||
std::vector<float> ref_vec = {0.041142918f,
|
std::vector<float> ref_vec = {0.041142918f,
|
||||||
150.0f,
|
150.0f,
|
||||||
987.98358f,
|
987.98358f,
|
||||||
@@ -213,7 +221,7 @@ BOOST_FIXTURE_TEST_CASE(test_getNodeResult, Fixture) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
BOOST_FIXTURE_TEST_CASE(test_getLinkResult, Fixture) {
|
BOOST_FIXTURE_TEST_CASE(test_getLinkResult, Fixture) {
|
||||||
|
|
||||||
error = ENR_getLinkResult(p_handle, 24, 13, &array, &array_dim);
|
error = ENR_getLinkResult(p_handle, 24, 13, &array, &array_dim);
|
||||||
BOOST_REQUIRE(error == 0);
|
BOOST_REQUIRE(error == 0);
|
||||||
|
|
||||||
@@ -233,7 +241,7 @@ BOOST_FIXTURE_TEST_CASE(test_getLinkResult, Fixture) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
BOOST_FIXTURE_TEST_CASE(test_getNodeSeries, Fixture){
|
BOOST_FIXTURE_TEST_CASE(test_getNodeSeries, Fixture){
|
||||||
|
|
||||||
error = ENR_getNodeSeries(p_handle, 2, ENR_pressure, 0, 10, &array, &array_dim);
|
error = ENR_getNodeSeries(p_handle, 2, ENR_pressure, 0, 10, &array, &array_dim);
|
||||||
BOOST_REQUIRE(error == 0);
|
BOOST_REQUIRE(error == 0);
|
||||||
|
|
||||||
@@ -250,12 +258,12 @@ BOOST_FIXTURE_TEST_CASE(test_getNodeSeries, Fixture){
|
|||||||
|
|
||||||
std::vector<float> test_vec;
|
std::vector<float> test_vec;
|
||||||
test_vec.assign(array, array + array_dim);
|
test_vec.assign(array, array + array_dim);
|
||||||
|
|
||||||
BOOST_CHECK(check_cdd(test_vec, ref_vec, 3));
|
BOOST_CHECK(check_cdd(test_vec, ref_vec, 3));
|
||||||
}
|
}
|
||||||
|
|
||||||
BOOST_FIXTURE_TEST_CASE(test_getLinkSeries, Fixture) {
|
BOOST_FIXTURE_TEST_CASE(test_getLinkSeries, Fixture) {
|
||||||
|
|
||||||
error = ENR_getLinkSeries(p_handle, 2, ENR_flow, 0, 10, &array, &array_dim);
|
error = ENR_getLinkSeries(p_handle, 2, ENR_flow, 0, 10, &array, &array_dim);
|
||||||
BOOST_REQUIRE(error == 0);
|
BOOST_REQUIRE(error == 0);
|
||||||
|
|
||||||
@@ -277,7 +285,7 @@ BOOST_FIXTURE_TEST_CASE(test_getLinkSeries, Fixture) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
BOOST_FIXTURE_TEST_CASE(test_getNetReacts, Fixture) {
|
BOOST_FIXTURE_TEST_CASE(test_getNetReacts, Fixture) {
|
||||||
|
|
||||||
error = ENR_getNetReacts(p_handle, &array, &array_dim);
|
error = ENR_getNetReacts(p_handle, &array, &array_dim);
|
||||||
BOOST_REQUIRE(error == 0);
|
BOOST_REQUIRE(error == 0);
|
||||||
|
|
||||||
@@ -293,7 +301,7 @@ BOOST_FIXTURE_TEST_CASE(test_getNetReacts, Fixture) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
BOOST_FIXTURE_TEST_CASE(test_getEnergyUsage, Fixture) {
|
BOOST_FIXTURE_TEST_CASE(test_getEnergyUsage, Fixture) {
|
||||||
|
|
||||||
int linkIdx;
|
int linkIdx;
|
||||||
|
|
||||||
error = ENR_getEnergyUsage(p_handle, 1, &linkIdx, &array, &array_dim);
|
error = ENR_getEnergyUsage(p_handle, 1, &linkIdx, &array, &array_dim);
|
||||||
|
|||||||
@@ -36,6 +36,7 @@ EXPORTS
|
|||||||
ENgetlinkid = _ENgetlinkid@8
|
ENgetlinkid = _ENgetlinkid@8
|
||||||
ENgetlinkindex = _ENgetlinkindex@8
|
ENgetlinkindex = _ENgetlinkindex@8
|
||||||
ENgetlinknodes = _ENgetlinknodes@12
|
ENgetlinknodes = _ENgetlinknodes@12
|
||||||
|
ENsetlinknodes = _ENsetlinknodes@12
|
||||||
ENgetlinktype = _ENgetlinktype@8
|
ENgetlinktype = _ENgetlinktype@8
|
||||||
ENgetlinkvalue = _ENgetlinkvalue@12
|
ENgetlinkvalue = _ENgetlinkvalue@12
|
||||||
ENgetnodeid = _ENgetnodeid@8
|
ENgetnodeid = _ENgetnodeid@8
|
||||||
|
|||||||
Reference in New Issue
Block a user