Skip to content

Visualization APIs

joshuaselsky edited this page Feb 9, 2012 · 19 revisions

The out-of-the-box visualization APIs dispatch to opencpu in order to generate statistical plots using R. When a request is sent to a visualization API, it is proxied by ohmage to opencpu. opencpu then calls back into ohmage and uses survey_response/read to retrieve data to plot.



What does it do?

Returns a PNG image showing the number of survey responses for each survey within a particular campaign.

URI

/viz/survey_response_count/read

Access Rules

TODO

Input Parameters

  • (r) auth_token = The authentication token for the requester.
  • (r) client = A short description of the software client making the request.
  • (r) campaign_urn = The URN of the campaign whose aggregated survey response count you desire.
  • (r) width = The desired width of the resulting image.
  • (r) height = The desired height of the resulting image.
  • (o) privacy_state = "shared" to plot only shared responses.
  • (o) start_date = A start date for the time range of the request. It must be of the format "yyyy-MM-dd".
  • (o) end_date = A end date for the time range of the request. It must be of the format "yyyy-MM-dd".

Example POST

POST /app/viz/survey_response_count/read HTTP/1.1
 Host: dev.ohmage.org
 Mozilla/5.0 (Macintosh; Intel Mac OS X 10_6_8) AppleWebKit/535.7 (KHTML, like Gecko) Chrome/16.0.912.77 Safari/535.7
 Content-Length: byte-length-of-content
 Content-Type: application/x-www-form-urlencoded

  auth_token=b1457284-536d-11e1-a713-c82a142568c4
  &client=ohmage-gwt
  &campaign_urn=urn:some:campaign
  &width=800
  &height=600

Output Format

Success

The requested plot is returned as an PNG image in the HTTP stream.

Failure

See the error page for a description of error codes and their associated descriptions.

Back to Top



What does it do?

Returns a PNG image showing the number of survey responses for each survey by privacy state within a particular campaign.

URI

viz/survey_responses_privacy_state/read

Access Rules

TODO

Input Parameters

  • (r) auth_token = The authentication token for the requester.
  • (r) client = A short description of the software client making the request.
  • (r) campaign_urn = The URN of the campaign whose aggregated survey response count you desire.
  • (r) width = The desired width of the resulting image.
  • (r) height = The desired height of the resulting image.
  • (o) start_date = A start date for the time range of the request. It must be of the format "yyyy-MM-dd".
  • (o) end_date = A end date for the time range of the request. It must be of the format "yyyy-MM-dd".

Example POST

POST /app/viz/survey_responses_privacy_state/read HTTP/1.1
 Host: dev.ohmage.org
 Mozilla/5.0 (Macintosh; Intel Mac OS X 10_6_8) AppleWebKit/535.7 (KHTML, like Gecko) Chrome/16.0.912.77 Safari/535.7
 Content-Length: byte-length-of-content
 Content-Type: application/x-www-form-urlencoded

  auth_token=c74f82f4-536d-11e1-b1a5-c82a142568c4
  &client=ohmage-gwt
  &campaign_urn=urn:some:campaign
  &width=800
  &height=600
  &start_date=2012-01-01
  &end_date=2012-02-01

Output Format

Success

The requested plot is returned as an PNG image in the HTTP stream.

Failure

See the error page for a description of error codes and their associated descriptions.

Back to Top



What does it do?

Returns a PNG image showing the number of survey responses for each survey within a particular campaign as a time series.

URI

viz/survey_responses_privacy_state_time/read

Access Rules

TODO

Input Parameters

  • (r) auth_token = The authentication token for the requester.
  • (r) client = A short description of the software client making the request.
  • (r) campaign_urn = The URN of the campaign whose aggregated survey response count you desire.
  • (r) width = The desired width of the resulting image.
  • (r) height = The desired height of the resulting image.
  • (o) start_date = A start date for the time range of the request. It must be of the format "yyyy-MM-dd".
  • (o) end_date = A end date for the time range of the request. It must be of the format "yyyy-MM-dd".

Example POST

POST /app/viz/survey_responses_privacy_state_time/read HTTP/1.1
 Host: dev.ohmage.org
 Mozilla/5.0 (Macintosh; Intel Mac OS X 10_6_8) AppleWebKit/535.7 (KHTML, like Gecko) Chrome/16.0.912.77 Safari/535.7
 Content-Length: byte-length-of-content
 Content-Type: application/x-www-form-urlencoded

  auth_token=23a2fbc4-5370-11e1-baed-c82a142568c4
  &client=ohmage-gwt
  &campaign_urn=urn:some:campaign
  &width=800
  &height=600
  &start_date=2012-01-01
  &end_date=2012-02-01

Output Format

Success

The requested plot is returned as an PNG image in the HTTP stream.

Failure

See the error page for a description of error codes and their associated descriptions.

Back to Top



What does it do?

Returns a PNG image showing a count of prompt responses for a survey within a particular campaign.

URI

viz/prompt_distribution/read

Access Rules

TODO

Input Parameters

  • (r) auth_token = The authentication token for the requester.
  • (r) client = A short description of the software client making the request.
  • (r) campaign_urn = The URN of the campaign whose aggregated survey response count you desire.
  • (r) prompt_id = The prompt ID of indicating which data to plot.
  • (r) width = The desired width of the resulting image.
  • (r) height = The desired height of the resulting image.
  • (o) privacy_state = "shared" to plot only shared responses.
  • (o) start_date = A start date for the time range of the request. It must be of the format "yyyy-MM-dd".
  • (o) end_date = A end date for the time range of the request. It must be of the format "yyyy-MM-dd".

Example POST

POST /app/viz/prompt_distribution/read HTTP/1.1
 Host: dev.ohmage.org
 Mozilla/5.0 (Macintosh; Intel Mac OS X 10_6_8) AppleWebKit/535.7 (KHTML, like Gecko) Chrome/16.0.912.77 Safari/535.7
 Content-Length: byte-length-of-content
 Content-Type: application/x-www-form-urlencoded

  auth_token=f6014f02-5371-11e1-b1f1-c82a142568c4
  &client=ohmage-gwt
  &campaign_urn=urn:some:campaign
  &width=800
  &height=600
  &start_date=2012-01-01
  &end_date=2012-02-01
  &prompt_id=sleepTime

Output Format

Success

The requested plot is returned as an PNG image in the HTTP stream.

Failure

See the error page for a description of error codes and their associated descriptions.

Back to Top