ajgraph.c

Datatypes:
none Graphics internals
AjPGraph Graph object
AjPGraphdata Graph data object
none Reporting internals


Datatype: none

Function is for controlling the graphics internals without using an AjPGraph object

Sections:
modifiersModifiers
Base coloursConstructors
QueriesGeneral use
DrawingGeneral use
CalculationsCasts
unusedMiscellaneous
exitMiscellaneous


Section: modifiers

Controlling the internals

Functions:
ajGraphicsCloseClose current Plot.
ajGraphicsCloseWinClose current window Plot
ajGraphicsPlenvDefines a plot environment. i.e. tells plplot whether the graph is boxed, whether it has tick marks, whether it has labels etc. These should already be set in the flags.
ajGraphicsResetBgcolourReset the background colour to either black or white depending on the current settings.
ajGraphicsResetFgcolourReset the foreground plotting colour using current stored colour.
ajGraphicsSetBgcolourBlackSet the background colour to black
ajGraphicsSetBgcolourWhiteSet the background colour to white (the default colour)
ajGraphicsSetCharscaleSet the character scale factor
ajGraphicsSetCharsizeSet the character size factor
ajGraphicsSetDefcharsizeSet the default character size in mm.
ajGraphicsSetDeviceSet internal graph device to that selected for a graph object
ajGraphicsSetFgcolourSet the foreground plotting colour
ajGraphicsSetFilenameset BaseName and extension.
ajGraphicsSetFillpatSet the Fill Pattern type.
ajGraphicsSetLabelsCLabel current Plot.
ajGraphicsSetLabelsSLabel current Plot.
ajGraphicsSetLinestyleSet the line style.
ajGraphicsSetPagesizeSet the width and height of the plot page.
ajGraphicsSetPenwidthSet the current pen width.
ajGraphicsSetPortraitSet graph orientation
ajGraphicsSetRlabelCLabel the right hand y axis.
ajGraphicsSetRlabelSLabel the right hand y axis.


Function ajGraphicsClose

Close current Plot.

Prototype

void ajGraphicsClose (
      void
);

TypeNameRead/WriteDescription
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsCloseWin

Close current window Plot

Prototype

void ajGraphicsCloseWin (
      void
);

TypeNameRead/WriteDescription
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsPlenv

Defines a plot environment. i.e. tells plplot whether the graph is boxed, whether it has tick marks, whether it has labels etc. These should already be set in the flags.

Prototype

void ajGraphicsPlenv (
      float xmin,
      float xmax,
      float ymin,
      float ymax,
      ajint flags
);

TypeNameRead/WriteDescription
floatxminInputX axis start
floatxmaxInputX axis end
floatyminInputY axis start
floatymaxInputY axis end
ajintflagsInputflag bit settings
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsResetBgcolour

Reset the background colour to either black or white depending on the current settings.

Prototype

void ajGraphicsResetBgcolour (
      void
);

TypeNameRead/WriteDescription
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsResetFgcolour

Reset the foreground plotting colour using current stored colour.

Prototype

void ajGraphicsResetFgcolour (
      void
);

TypeNameRead/WriteDescription
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsSetBgcolourBlack

Set the background colour to black

Prototype

void ajGraphicsSetBgcolourBlack (
      void
);

TypeNameRead/WriteDescription
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsSetBgcolourWhite

Set the background colour to white (the default colour)

Prototype

void ajGraphicsSetBgcolourWhite (
      void
);

TypeNameRead/WriteDescription
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsSetCharscale

Set the character scale factor

Prototype

float ajGraphicsSetCharscale (
      float scale
);

TypeNameRead/WriteDescription
floatscaleInputcharacter scale.
float RETURNthe previous character scale factor.

From EMBOSS 6.2.0


Function ajGraphicsSetCharsize

Set the character size factor

Prototype

float ajGraphicsSetCharsize (
      float size
);

TypeNameRead/WriteDescription
floatsizeInputcharacter size.
float RETURNthe previous character size factor.

From EMBOSS 6.2.0


Function ajGraphicsSetDefcharsize

Set the default character size in mm.

Prototype

float ajGraphicsSetDefcharsize (
      float size
);

TypeNameRead/WriteDescription
floatsizeInputcharacter size in mm.
float RETURNthe previous character size in mm.

From EMBOSS 6.2.0


Function ajGraphicsSetDevice

Set internal graph device to that selected for a graph object

Prototype

void ajGraphicsSetDevice (
      const AjPGraph graph
);

TypeNameRead/WriteDescription
const AjPGraphgraphInputGraph object with display type set
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsSetFgcolour

Set the foreground plotting colour

Prototype

ajint ajGraphicsSetFgcolour (
      ajint colour
);

TypeNameRead/WriteDescription
ajintcolourInputcolour to set drawing to.
ajint RETURNthe previous colour.

From EMBOSS 6.2.0


Function ajGraphicsSetFilename

set BaseName and extension.

Prototype

void ajGraphicsSetFilename (
      const AjPGraph graph
);

TypeNameRead/WriteDescription
const AjPGraphgraphInputGraph object.
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsSetFillpat

Set the Fill Pattern type.

Prototype

ajint ajGraphicsSetFillpat (
      ajint patstyle
);

TypeNameRead/WriteDescription
ajintpatstyleInputline style to set drawing to.
ajint RETURNthe previous line style.

From EMBOSS 6.2.0


Function ajGraphicsSetLabelsC

Label current Plot.

Prototype

void ajGraphicsSetLabelsC (
      const char* x,
      const char* y,
      const char* title,
      const char* subtitle
);

TypeNameRead/WriteDescription
const char*xInputtext for x axis labelling.
const char*yInputtext for y axis labelling.
const char*titleInputtext for title of plot.
const char*subtitleInputtext for subtitle of plot.
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsSetLabelsS

Label current Plot.

Prototype

void ajGraphicsSetLabelsS (
      const AjPStr strx,
      const AjPStr stry,
      const AjPStr strtitle,
      const AjPStr strsubtitle
);

TypeNameRead/WriteDescription
const AjPStrstrxInputtext for x axis labelling.
const AjPStrstryInputtext for y axis labelling.
const AjPStrstrtitleInputtext for title of plot.
const AjPStrstrsubtitleInputtext for subtitle of plot.
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsSetLinestyle

Set the line style.

Prototype

ajint ajGraphicsSetLinestyle (
      ajint linestyle
);

TypeNameRead/WriteDescription
ajintlinestyleInputline style to set drawing to.
ajint RETURNthe previous line style.

From EMBOSS 6.2.0


Function ajGraphicsSetPagesize

Set the width and height of the plot page.

Prototype

void ajGraphicsSetPagesize (
      ajuint plotwidth,
      ajuint plotheight
);

TypeNameRead/WriteDescription
ajuintplotwidthInputPage width in pixels or mm
ajuintplotheightInputPage height in pixels or mm
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsSetPenwidth

Set the current pen width.

Prototype

void ajGraphicsSetPenwidth (
      float penwidth
);

TypeNameRead/WriteDescription
floatpenwidthInputwidth for the pen.
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsSetPortrait

Set graph orientation

Prototype

void ajGraphicsSetPortrait (
      AjBool set
);

TypeNameRead/WriteDescription
AjBoolsetInputportrait orientation if true, else landscape
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsSetRlabelC

Label the right hand y axis.

Prototype

void ajGraphicsSetRlabelC (
      const char* txt
);

TypeNameRead/WriteDescription
const char*txtInputtext for label of right y axis.
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsSetRlabelS

Label the right hand y axis.

Prototype

void ajGraphicsSetRlabelS (
      const AjPStr str
);

TypeNameRead/WriteDescription
const AjPStrstrInputtext for label of right y axis.
void RETURN

From EMBOSS 6.2.0


Section: Base colours

Generating arrays of valid colour codes

Functions:
ajGraphicsBasecolourNewNucInitialise a base colours array for a string of nucleotide sequence characters
ajGraphicsBasecolourNewProtInitialize a base colours array for a string of protein sequence characters according to the following colour scheme designed by Toby Gibson (EMBL Heidelberg) to show the chemical properties important in sequence and structure alignment and to be clear to those with common forms of colour blindness.


Function ajGraphicsBasecolourNewNuc

Initialise a base colours array for a string of nucleotide sequence characters

Prototype

ajint* ajGraphicsBasecolourNewNuc (
      const AjPStr codes
);

TypeNameRead/WriteDescription
const AjPStrcodesInputResidue codes for each numbered position
ajint* RETURNArray of colours (see PLPLOT)

From EMBOSS 6.2.0


Function ajGraphicsBasecolourNewProt

Initialize a base colours array for a string of protein sequence characters according to the following colour scheme designed by Toby Gibson (EMBL Heidelberg) to show the chemical properties important in sequence and structure alignment and to be clear to those with common forms of colour blindness.

Prototype

ajint* ajGraphicsBasecolourNewProt (
      const AjPStr codes
);

TypeNameRead/WriteDescription
const AjPStrcodesInputResidue codes for each numbered position
ajint* RETURNArray of colours (see PLPLOT)

From EMBOSS 6.2.0


Section: Queries

Querying and reporting internal values

Functions:
ajGraphicsCheckColourCFind if the colour is on the list
ajGraphicsCheckColourSFind if the colour is on the list
ajGraphicsGetCharsizeGet the char size.
ajGraphicsGetFgcolourReturn current foreground colour
ajGraphicsGetParamsPageGet the output page parameters for plplot internal use. These can be set by the user and used by some device drivers.


Function ajGraphicsCheckColourC

Find if the colour is on the list

Prototype

ajint ajGraphicsCheckColourC (
      const char* txt
);

TypeNameRead/WriteDescription
const char*txtInputcolour name.
ajint RETURNthe colour number if found else -1.

From EMBOSS 6.2.0


Function ajGraphicsCheckColourS

Find if the colour is on the list

Prototype

ajint ajGraphicsCheckColourS (
      const AjPStr str
);

TypeNameRead/WriteDescription
const AjPStrstrInputcolour name.
ajint RETURNthe colour number if found else -1.

From EMBOSS 6.2.0


Function ajGraphicsGetCharsize

Get the char size.

Prototype

void ajGraphicsGetCharsize (
      float* defheight,
      float* currentscale
);

TypeNameRead/WriteDescription
float*defheightModifywhere to store the default character height
float*currentscaleModifywhere to store the current (scaled) character height
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsGetFgcolour

Return current foreground colour

Prototype

ajint ajGraphicsGetFgcolour (
      void
);

TypeNameRead/WriteDescription
ajint RETURNcolour.

From EMBOSS 6.2.0


Function ajGraphicsGetParamsPage

Get the output page parameters for plplot internal use. These can be set by the user and used by some device drivers.

Prototype

void ajGraphicsGetParamsPage (
      float* xp,
      float* yp,
      ajint* xleng,
      ajint* yleng,
      ajint* xoff,
      ajint* yoff
);

TypeNameRead/WriteDescription
float*xpModifywhere to store the x pixels/inch
float*ypModifywhere to store the y pixels/inch
ajint*xlengModifywhere to store the x length
ajint*ylengModifywhere to the y length
ajint*xoffModifywhere to store the x offset
ajint*yoffModifywhere to store the y offset
void RETURN

From EMBOSS 6.2.0


Section: Drawing

Drawing lines and objects

Functions:
ajGraphicsDrawarcArcDraw a portion of a circle (an arc).
ajGraphicsDrawarcRectDraw a rectangle along a curve with the current pen colour/style.
ajGraphicsDrawarcRectFillDraw a rectangle along a curve and fill it with the current pen colour/style.
ajGraphicsDrawarcTextJustifyDraw text along a curve (i.e., an arc of a circle). The text is written character by character, forwards or backwards depending on the angle.
ajGraphicsDrawbarsHorizDraw Horizontal Error Bars.
ajGraphicsDrawbarsVertDraw vertical Error Bars.
ajGraphicsDrawposBoxDraw a box to the plotter device at point xx0,yy0 size big.
ajGraphicsDrawposBoxFillDraw a box to the plotter device at point xx0,yy0 size big and fill it in.
ajGraphicsDrawposCircleDraw a circle.
ajGraphicsDrawposDiaDraw a diamond to the plotter device at point xx0,yy0 size big.
ajGraphicsDrawposDiaFillDraw a diamond to the plotter device at point xx0,yy0 size big and fill it in.
ajGraphicsDrawposLineDraw line between 2 points.
ajGraphicsDrawposRectDraw a rectangle with the current pen colour/style.
ajGraphicsDrawposRectFillDraw a rectangle and fill it with the current pen colour/style.
ajGraphicsDrawposTextAtendDraw text ending at position (xx1,yy1)
ajGraphicsDrawposTextAtlineJustifyDraw text along a line.
ajGraphicsDrawposTextAtmidDraw text with Mid point of text at (xx1,yy1).
ajGraphicsDrawposTextAtstartDraw text starting at position (xx1,yy1)
ajGraphicsDrawposTextJustifyDraw text, positioning with respect to (xx1,yy1) by justified as defined by just.
ajGraphicsDrawposTriDraw a Triangle.
ajGraphicsDrawposTriFillDraw a Triangle and fill it in.
ajGraphicsDrawsetDotsDraw a set of dots.
ajGraphicsDrawsetLinesDraw a set of lines.
ajGraphicsDrawsetPolyDraw a polygon.
ajGraphicsDrawsetPolyFillDraw a polygon and fill it in.
ajGraphicsDrawsetSymbolsDraw a set of dots.


Function ajGraphicsDrawarcArc

Draw a portion of a circle (an arc).

Prototype

void ajGraphicsDrawarcArc (
      PLFLT xcentre,
      PLFLT ycentre,
      PLFLT radius,
      PLFLT startangle,
      PLFLT endangle
);

TypeNameRead/WriteDescription
PLFLTxcentreInputx coord for centre.
PLFLTycentreInputy coord for centre.
PLFLTradiusInputradius of the circle.
PLFLTstartangleInputangle of the start of the arc.
PLFLTendangleInputangle of the end of the arc.
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsDrawarcRect

Draw a rectangle along a curve with the current pen colour/style.

Prototype

void ajGraphicsDrawarcRect (
      PLFLT xcentre,
      PLFLT ycentre,
      PLFLT radius,
      PLFLT startangle,
      PLFLT endangle,
      PLFLT height
);

TypeNameRead/WriteDescription
PLFLTxcentreInputx coord for centre.
PLFLTycentreInputy coord for centre.
PLFLTradiusInputradius of the circle.
PLFLTstartangleInputangle of the start of the rectangle.
PLFLTendangleInputangle of the end of the rectangle.
PLFLTheightInputHeight of the rectangle in user coordinates.
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsDrawarcRectFill

Draw a rectangle along a curve and fill it with the current pen colour/style.

Prototype

void ajGraphicsDrawarcRectFill (
      PLFLT xcentre,
      PLFLT ycentre,
      PLFLT radius,
      PLFLT startangle,
      PLFLT endangle,
      PLFLT height
);

TypeNameRead/WriteDescription
PLFLTxcentreInputx coord for centre.
PLFLTycentreInputy coord for centre.
PLFLTradiusInputradius of the circle.
PLFLTstartangleInputangle of the start of the rectangle.
PLFLTendangleInputangle of the end of the rectangle.
PLFLTheightInputHeight of the rectangle in user coordinates.
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsDrawarcTextJustify

Draw text along a curve (i.e., an arc of a circle). The text is written character by character, forwards or backwards depending on the angle.

Prototype

void ajGraphicsDrawarcTextJustify (
      PLFLT xcentre,
      PLFLT ycentre,
      PLFLT radius,
      PLFLT startangle,
      PLFLT endangle,
      const char* txt,
      PLFLT just
);

TypeNameRead/WriteDescription
PLFLTxcentreInputx coord for centre.
PLFLTycentreInputy coord for centre.
PLFLTradiusInputradius of the circle.
PLFLTstartangleInputangle of the start of the arc (in deg).
PLFLTendangleInputangle of the end of the arc (in deg).
const char*txtInputThe text to be displayed.
PLFLTjustInputjustification of the string. (0=left,1=right,0.5=middle etc)
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsDrawbarsHoriz

Draw Horizontal Error Bars.

Prototype

void ajGraphicsDrawbarsHoriz (
      ajuint num,
      PLFLT* y,
      PLFLT* xmin,
      PLFLT* xmax
);

TypeNameRead/WriteDescription
ajuintnumInputnumber of error bars to be drawn.
CONST PLFLT*yInputy positions to draw at.
CONST PLFLT*xminInputx positions to start at.
CONST PLFLT*xmaxInputx positions to end at.
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsDrawbarsVert

Draw vertical Error Bars.

Prototype

void ajGraphicsDrawbarsVert (
      ajuint num,
      PLFLT* x,
      PLFLT* ymin,
      PLFLT* ymax
);

TypeNameRead/WriteDescription
ajuintnumInputnumber of error bars to be drawn.
CONST PLFLT*xInputx positions to draw at.
CONST PLFLT*yminInputy positions to start at.
CONST PLFLT*ymaxInputy positions to end at.
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsDrawposBox

Draw a box to the plotter device at point xx0,yy0 size big.

Prototype

void ajGraphicsDrawposBox (
      PLFLT x,
      PLFLT y,
      PLFLT size
);

TypeNameRead/WriteDescription
PLFLTxInputx position to draw the box.
PLFLTyInputy position to draw the box.
PLFLTsizeInputhow big to draw the box.
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsDrawposBoxFill

Draw a box to the plotter device at point xx0,yy0 size big and fill it in.

Prototype

void ajGraphicsDrawposBoxFill (
      PLFLT x,
      PLFLT y,
      PLFLT size
);

TypeNameRead/WriteDescription
PLFLTxInputx position to draw the box.
PLFLTyInputy position to draw the box.
PLFLTsizeInputhow big to draw the box.
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsDrawposCircle

Draw a circle.

Prototype

void ajGraphicsDrawposCircle (
      PLFLT x,
      PLFLT y,
      float radius
);

TypeNameRead/WriteDescription
PLFLTxInputx coord for centre.
PLFLTyInputy coord for centre.
floatradiusInputradius of the circle.
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsDrawposDia

Draw a diamond to the plotter device at point xx0,yy0 size big.

Prototype

void ajGraphicsDrawposDia (
      PLFLT x,
      PLFLT y,
      PLFLT size
);

TypeNameRead/WriteDescription
PLFLTxInputx position to draw the diamond.
PLFLTyInputy position to draw the diamond.
PLFLTsizeInputhow big to draw the diamond.
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsDrawposDiaFill

Draw a diamond to the plotter device at point xx0,yy0 size big and fill it in.

Prototype

void ajGraphicsDrawposDiaFill (
      PLFLT x,
      PLFLT y,
      PLFLT size
);

TypeNameRead/WriteDescription
PLFLTxInputx position to draw the diamond.
PLFLTyInputy position to draw the diamond.
PLFLTsizeInputhow big to draw the diamond.
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsDrawposLine

Draw line between 2 points.

Prototype

void ajGraphicsDrawposLine (
      PLFLT x,
      PLFLT y,
      PLFLT x2,
      PLFLT y2
);

TypeNameRead/WriteDescription
PLFLTxInputx start position.
PLFLTyInputy start position.
PLFLTx2Inputx end position.
PLFLTy2Inputy end position.
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsDrawposRect

Draw a rectangle with the current pen colour/style.

Prototype

void ajGraphicsDrawposRect (
      PLFLT x,
      PLFLT y,
      PLFLT x2,
      PLFLT y2
);

TypeNameRead/WriteDescription
PLFLTxInputxx0 coord.
PLFLTyInputyy0 coord.
PLFLTx2Inputxx1 coord.
PLFLTy2Inputyy1 coord.
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsDrawposRectFill

Draw a rectangle and fill it with the current pen colour/style.

Prototype

void ajGraphicsDrawposRectFill (
      PLFLT x,
      PLFLT y,
      PLFLT x2,
      PLFLT y2
);

TypeNameRead/WriteDescription
PLFLTxInputxx0 coord.
PLFLTyInputyy0 coord.
PLFLTx2Inputxx1 coord.
PLFLTy2Inputyy1 coord.
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsDrawposTextAtend

Draw text ending at position (xx1,yy1)

Prototype

void ajGraphicsDrawposTextAtend (
      PLFLT x,
      PLFLT y,
      const char* txt
);

TypeNameRead/WriteDescription
PLFLTxInputxx1 coord.
PLFLTyInputyy1 coord.
const char*txtInputThe text to be displayed.
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsDrawposTextAtlineJustify

Draw text along a line.

Prototype

void ajGraphicsDrawposTextAtlineJustify (
      PLFLT x,
      PLFLT y,
      PLFLT x2,
      PLFLT y2,
      const char* txt,
      PLFLT just
);

TypeNameRead/WriteDescription
PLFLTxInputx1 coord.
PLFLTyInputy1 coord.
PLFLTx2Inputx2 coord.
PLFLTy2Inputy2 coord.
const char*txtInputThe text to be displayed.
PLFLTjustInputjustification of the string. (0=left,1=right,0.5=middle etc)
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsDrawposTextAtmid

Draw text with Mid point of text at (xx1,yy1).

Prototype

void ajGraphicsDrawposTextAtmid (
      PLFLT x,
      PLFLT y,
      const char* txt
);

TypeNameRead/WriteDescription
PLFLTxInputxx1 coord.
PLFLTyInputyy1 coord.
const char*txtInputThe text to be displayed.
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsDrawposTextAtstart

Draw text starting at position (xx1,yy1)

Prototype

void ajGraphicsDrawposTextAtstart (
      PLFLT x,
      PLFLT y,
      const char* txt
);

TypeNameRead/WriteDescription
PLFLTxInputxx1 coordinate
PLFLTyInputyy1 coordinate
const char*txtInputThe text to be displayed.
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsDrawposTextJustify

Draw text, positioning with respect to (xx1,yy1) by justified as defined by just.

Prototype

void ajGraphicsDrawposTextJustify (
      PLFLT x,
      PLFLT y,
      const char* txt,
      PLFLT just
);

TypeNameRead/WriteDescription
PLFLTxInputxx1 coord.
PLFLTyInputyy1 coord.
const char*txtInputThe text to be displayed.
PLFLTjustInputjustification of the string. (0=left,1=right,0.5=middle etc)
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsDrawposTri

Draw a Triangle.

Prototype

void ajGraphicsDrawposTri (
      PLFLT x,
      PLFLT y,
      PLFLT x2,
      PLFLT y2,
      PLFLT x3,
      PLFLT y3
);

TypeNameRead/WriteDescription
PLFLTxInputxx1 coord of point 1.
PLFLTyInputyy1 coord of point 1.
PLFLTx2Inputxx2 coord of point 2.
PLFLTy2Inputyy2 coord of point 2.
PLFLTx3Inputx3 coord of point 3.
PLFLTy3Inputy3 coord of point 3.
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsDrawposTriFill

Draw a Triangle and fill it in.

Prototype

void ajGraphicsDrawposTriFill (
      PLFLT x,
      PLFLT y,
      PLFLT x2,
      PLFLT y2,
      PLFLT x3,
      PLFLT y3
);

TypeNameRead/WriteDescription
PLFLTxInputxx1 coord of point 1.
PLFLTyInputyy1 coord of point 1.
PLFLTx2Inputxx2 coord of point 2.
PLFLTy2Inputyy2 coord of point 2.
PLFLTx3Inputx3 coord of point 3.
PLFLTy3Inputy3 coord of point 3.
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsDrawsetDots

Draw a set of dots.

Prototype

void ajGraphicsDrawsetDots (
      ajuint num,
      PLFLT* xx,
      PLFLT* yy
);

TypeNameRead/WriteDescription
ajuintnumInputThe number of dots to be drawn.
CONST PLFLT*xxInputxx1 coord.
CONST PLFLT*yyInputyy1 coord.
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsDrawsetLines

Draw a set of lines.

Prototype

void ajGraphicsDrawsetLines (
      ajuint num,
      PLFLT* xx,
      PLFLT* yy,
      PLFLT* xx2,
      PLFLT* yy2
);

TypeNameRead/WriteDescription
ajuintnumInputThe number of lines to be drawn.
CONST PLFLT*xxModifyx start coordinates
CONST PLFLT*yyModifyy start coordinates
CONST PLFLT*xx2Modifyx end coordinates
CONST PLFLT*yy2Modifyy end coordinates
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsDrawsetPoly

Draw a polygon.

Prototype

void ajGraphicsDrawsetPoly (
      ajuint num,
      PLFLT* xx,
      PLFLT* yy
);

TypeNameRead/WriteDescription
ajuintnumInputnumber of points
CONST PLFLT*xxInputx coord of points
CONST PLFLT*yyInputy coord of points
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsDrawsetPolyFill

Draw a polygon and fill it in.

Prototype

void ajGraphicsDrawsetPolyFill (
      ajuint num,
      PLFLT* xx,
      PLFLT* yy
);

TypeNameRead/WriteDescription
ajuintnumInputnumber of points
CONST PLFLT*xxInputx coord of points
CONST PLFLT*yyInputy coord of points
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsDrawsetSymbols

Draw a set of dots.

Prototype

void ajGraphicsDrawsetSymbols (
      ajuint num,
      PLFLT* xx,
      PLFLT* yy,
      ajuint symbol
);

TypeNameRead/WriteDescription
ajuintnumInputNumber of coordinates in xx1 and xx2.
CONST PLFLT*xxInputxx1 coord.
CONST PLFLT*yyInputyy1 coord.
ajuintsymbolInputSymbol code.
void RETURN

From EMBOSS 6.2.0


Section: Calculations

Calculations using plot internals

Functions:
ajGraphicsCalcCharsizeComputes the character size (in mm) needed to write a text string with specified height and length (in user coord). The length of the string is the distance between (xx1,yy1) and (xx2,yy2); its height is TextHeight. If the default size is too large, characters are shrunk. If it is too small, characters are enlarged.
ajGraphicsCalcCoordcompute the coordinates of a point on a circle knowing the angle.
ajGraphicsCalcDistanceCompute the distance between 2 points in user coordinates.
ajGraphicsCalcRangeGet the max and min of the data points you wish to display.
ajGraphicsCalcTextheightCompute the height of a character in millimetres.
ajGraphicsCalcTextlengthCCompute the length of a string in millimetres.
ajGraphicsCalcTextlengthSCompute the length of a string in millimetres.


Function ajGraphicsCalcCharsize

Computes the character size (in mm) needed to write a text string with specified height and length (in user coord). The length of the string is the distance between (xx1,yy1) and (xx2,yy2); its height is TextHeight. If the default size is too large, characters are shrunk. If it is too small, characters are enlarged.

Prototype

PLFLT ajGraphicsCalcCharsize (
      PLFLT xx1,
      PLFLT yy1,
      PLFLT xx2,
      PLFLT yy2,
      const char* text,
      PLFLT TextHeight
);

TypeNameRead/WriteDescription
PLFLTxx1Inputxx1 coord.
PLFLTyy1Inputyy1 coord.
PLFLTxx2Inputxx2 coord.
PLFLTyy2Inputyy2 coord.
const char*textInputThe text to be displayed.
PLFLTTextHeightInputThe height of the text (in user coord).
PLFLT RETURNThe character size (in mm) that fits the specified height and length.

From EMBOSS 6.2.0


Function ajGraphicsCalcCoord

compute the coordinates of a point on a circle knowing the angle.

Prototype

PLFLT* ajGraphicsCalcCoord (
      PLFLT x,
      PLFLT y,
      PLFLT radius,
      PLFLT angle
);

TypeNameRead/WriteDescription
PLFLTxInputx coord for centre.
PLFLTyInputy coord for centre.
PLFLTradiusInputRadius of the circle.
PLFLTangleInputangle at which the point is.
PLFLT* RETURNThe x and y coordinates of the point.

From EMBOSS 6.2.0


Function ajGraphicsCalcDistance

Compute the distance between 2 points in user coordinates.

Prototype

PLFLT ajGraphicsCalcDistance (
      PLFLT xx1,
      PLFLT yy1,
      PLFLT xx2,
      PLFLT yy2
);

TypeNameRead/WriteDescription
PLFLTxx1Inputx coord of point 1
PLFLTyy1Inputy coord of point 1
PLFLTxx2Inputx coord of point 2
PLFLTyy2Inputy coord of point 2
PLFLT RETURNThe distance between the 2 points in user coordinates.

From EMBOSS 6.2.0


Function ajGraphicsCalcRange

Get the max and min of the data points you wish to display.

Prototype

void ajGraphicsCalcRange (
      const float* array,
      ajuint npoints,
      float* min,
      float* max
);

TypeNameRead/WriteDescription
const float*arrayInputarray
ajuintnpointsInputNumber of data points
float*minOutputmin.
float*maxOutputmax.
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsCalcTextheight

Compute the height of a character in millimetres.

Prototype

PLFLT ajGraphicsCalcTextheight (
      void
);

TypeNameRead/WriteDescription
PLFLT RETURNThe height of the character in user coordinates.

From EMBOSS 6.2.0


Function ajGraphicsCalcTextlengthC

Compute the length of a string in millimetres.

Prototype

PLFLT ajGraphicsCalcTextlengthC (
      const char* txt
);

TypeNameRead/WriteDescription
const char*txtInputText
PLFLT RETURNThe length of the string in user coordinates.

From EMBOSS 6.2.0


Function ajGraphicsCalcTextlengthS

Compute the length of a string in millimetres.

Prototype

PLFLT ajGraphicsCalcTextlengthS (
      const AjPStr str
);

TypeNameRead/WriteDescription
const AjPStrstrInputText
PLFLT RETURNThe length of the string in user coordinates.

From EMBOSS 6.2.0


Section: unused

Functions:
ajGraphicsUnusedUnused functions to avoid compiler warnings


Function ajGraphicsUnused

Unused functions to avoid compiler warnings

Prototype

void ajGraphicsUnused (
      void
);

TypeNameRead/WriteDescription
void RETURN

From EMBOSS 6.2.0


Section: exit

Functions called on exit

Functions:
ajGraphicsExitCleans up graphics internal memory


Function ajGraphicsExit

Cleans up graphics internal memory

Prototype

void ajGraphicsExit (
      void
);

TypeNameRead/WriteDescription
void RETURN

From EMBOSS 6.2.0


Datatype: AjPGraph

Function is for manipulating an AjPGraph general graph object

Sections:
ConstructorsConstructors
OpeningModifiers
ModifiersModifiers
QueriesGeneral use
PlottingGeneral use
DebuggingGeneral use
Graph data managementModifiers


AjPGraph: Constructors

Construct a new graph object to be populated by other functions

Functions:
ajGraphNewCreate a structure to hold a general graph.


Function ajGraphNew

Create a structure to hold a general graph.

Prototype

AjPGraph ajGraphNew (
      void
);

TypeNameRead/WriteDescription
AjPGraph RETURNmultiple graph structure.

From EMBOSS 1.0.0


AjPGraph: Opening

Opens a plot page

Functions:
ajGraphInitSeqInitialises a graph using default values based on a sequence.
ajGraphNewpageClear Screen if (X) or new page if plotter/postscript. Also pass a boolean to state whether you want the current pen colour character sizes, plot title and subtitle, etc to be reset or stay the same for the next page.
ajGraphOpenFlagsOpen a window whose view is defined by the x's and y's min and max values.
ajGraphOpenMmOpen a window whose view is defined by x and y's size in millimetres to allow easy scaling of characters and strings whose sizes are always in millimetres.
ajGraphOpenPlotsetOpen a window with a set of plots
ajGraphOpenWinOpen a window whose view is defined by x and y's min and max.


Function ajGraphInitSeq

Initialises a graph using default values based on a sequence.

Prototype

void ajGraphInitSeq (
      AjPGraph thys,
      const AjPSeq seq
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph
const AjPSeqseqInputSequence
void RETURN

From EMBOSS 1.0.0


Function ajGraphNewpage

Clear Screen if (X) or new page if plotter/postscript. Also pass a boolean to state whether you want the current pen colour character sizes, plot title and subtitle, etc to be reset or stay the same for the next page.

Prototype

void ajGraphNewpage (
      AjPGraph thys,
      AjBool resetdefaults
);

TypeNameRead/WriteDescription
AjPGraphthysOutputGraph object
AjBoolresetdefaultsInputreset page setting?
void RETURN

From EMBOSS 6.2.0


Function ajGraphOpenFlags

Open a window whose view is defined by the x's and y's min and max values.

Prototype

void ajGraphOpenFlags (
      AjPGraph thys,
      PLFLT xmin,
      PLFLT xmax,
      PLFLT ymin,
      PLFLT ymax,
      ajint flags
);

TypeNameRead/WriteDescription
AjPGraphthysOutputGraph object
PLFLTxminInputminimum x value.(user coordinates)
PLFLTxmaxInputmaximum x value.
PLFLTyminInputminimum y value.
PLFLTymaxInputmaximum y value.
ajintflagsInputflag bit settings
void RETURN

From EMBOSS 6.2.0


Function ajGraphOpenMm

Open a window whose view is defined by x and y's size in millimetres to allow easy scaling of characters and strings whose sizes are always in millimetres.

Prototype

void ajGraphOpenMm (
      AjPGraph thys,
      float* xmm,
      float* ymm
);

TypeNameRead/WriteDescription
AjPGraphthysOutputGraph object
float*xmmOutputx length in millimetres
float*ymmOutputy length in millimetres
void RETURN

From EMBOSS 6.2.0


Function ajGraphOpenPlotset

Open a window with a set of plots

Prototype

void ajGraphOpenPlotset (
      AjPGraph thys,
      ajuint numofsets
);

TypeNameRead/WriteDescription
AjPGraphthysOutputGraph object.
ajuintnumofsetsInputnumber of plots in set.
void RETURN

From EMBOSS 6.2.0


Function ajGraphOpenWin

Open a window whose view is defined by x and y's min and max.

Prototype

void ajGraphOpenWin (
      AjPGraph thys,
      float xmin,
      float xmax,
      float ymin,
      float ymax
);

TypeNameRead/WriteDescription
AjPGraphthysOutputGraph object
floatxminInputminimum x value.(user coordinates)
floatxmaxInputmaximum x value.
floatyminInputminimum y value.
floatymaxInputmaximum y value.
void RETURN

From EMBOSS 1.0.0


AjPGraph: Modifiers

Modifying a general graph object

Functions:
ajGraphAppendTitleCSet an empty graph title from the description or program name and extra text 'of ...' supplied by the caller.
ajGraphAppendTitleSSet an empty graph title from the description or program name and extra text 'of ...' supplied by the caller.
ajGraphClearDelete all the drawable objects connected to the graph object.
ajGraphSetDatanameCSet the graph data source name.
ajGraphSetDatanameSSet the graph data source name.
ajGraphSetDescCSet the graph description.
ajGraphSetDescSSet the graph description.
ajGraphSetDevicetypeInitialize options for a general graph object
ajGraphSetFlagSet the flags for the graph to add or subtract "flag" depending on set
ajGraphSetMultiCreate a structure to hold a number of graphs.
ajGraphSetOutdirSSet the directory of the output file. Only used later if the device plotter is capable of writing to a file (e.g. postscript or png)
ajGraphSetOutfileCSet the name of the output file. Only used later if the device plotter is capable of postscript output. ps and cps.
ajGraphSetOutfileSSet the name of the output file. Only used later if the device plotter is capable of postscript output. ps and cps.
ajGraphSetSubtitleCSet the graph subtitle.
ajGraphSetSubtitleSSet the title for the Y axis.
ajGraphSetTitleCSet the graph Title.
ajGraphSetTitleSSet the graph title.
ajGraphSetXlabelCSet the title for the X axis for multiple plot on one graph.
ajGraphSetXlabelSSet the title for the X axis for multiple plots on one graph.
ajGraphSetYlabelCSet the title for the Y axis for multiple plots on one graph.
ajGraphSetYlabelSSet the title for the Y axis for multiple plots on one graph.
ajGraphShowSubtitleSet whether the graph is to display the subtitle.
ajGraphShowTitleSet whether the graph is to display the title.


Function ajGraphAppendTitleC

Set an empty graph title from the description or program name and extra text 'of ...' supplied by the caller.

Prototype

void ajGraphAppendTitleC (
      AjPGraph thys,
      const char* txt
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph structure to store info in.
const char*txtInputTitle.
void RETURN

From EMBOSS 6.2.0


Function ajGraphAppendTitleS

Set an empty graph title from the description or program name and extra text 'of ...' supplied by the caller.

Prototype

void ajGraphAppendTitleS (
      AjPGraph thys,
      const AjPStr str
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph structure to store info in.
const AjPStrstrInputTitle.
void RETURN

From EMBOSS 6.2.0


Function ajGraphClear

Delete all the drawable objects connected to the graph object.

Prototype

void ajGraphClear (
      AjPGraph thys
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph object
void RETURN

From EMBOSS 2.9.0


Function ajGraphSetDatanameC

Set the graph data source name.

Prototype

void ajGraphSetDatanameC (
      AjPGraph thys,
      const char* txt
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph structure to store info in.
const char*txtInputData source name.
void RETURN

From EMBOSS 6.5.0


Function ajGraphSetDatanameS

Set the graph data source name.

Prototype

void ajGraphSetDatanameS (
      AjPGraph thys,
      const AjPStr str
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph structure to store info in.
const AjPStrstrInputData source name.
void RETURN

From EMBOSS 6.5.0


Function ajGraphSetDescC

Set the graph description.

Prototype

void ajGraphSetDescC (
      AjPGraph thys,
      const char* txt
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph structure to store info in.
const char*txtInputTitle.
void RETURN

From EMBOSS 6.2.0


Function ajGraphSetDescS

Set the graph description.

Prototype

void ajGraphSetDescS (
      AjPGraph thys,
      const AjPStr str
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph structure to store info in.
const AjPStrstrInputTitle.
void RETURN

From EMBOSS 6.2.0


Function ajGraphSetDevicetype

Initialize options for a general graph object

Prototype

AjBool ajGraphSetDevicetype (
      AjPGraph thys,
      const AjPStr devicetype
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph object
const AjPStrdevicetypeInputGraph type
AjBool RETURNajTrue on success

From EMBOSS 6.2.0


Function ajGraphSetFlag

Set the flags for the graph to add or subtract "flag" depending on set

Prototype

void ajGraphSetFlag (
      AjPGraph thys,
      ajint flag,
      AjBool set
);

TypeNameRead/WriteDescription
AjPGraphthysModifygraph to have flags altered.
ajintflagInputflag to be set.
AjBoolsetInputwhether to set the flag or remove it.
void RETURN

From EMBOSS 2.9.0


Function ajGraphSetMulti

Create a structure to hold a number of graphs.

Prototype

void ajGraphSetMulti (
      AjPGraph thys,
      ajuint numsets
);

TypeNameRead/WriteDescription
AjPGraphthysOutputGraph structure to store info in.
ajuintnumsetsInputmaximum number of graphs that can be stored.
void RETURN

From EMBOSS 1.0.0


Function ajGraphSetOutdirS

Set the directory of the output file. Only used later if the device plotter is capable of writing to a file (e.g. postscript or png)

Prototype

void ajGraphSetOutdirS (
      AjPGraph thys,
      const AjPStr str
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph structure to update file name
const AjPStrstrInputName of the file.
void RETURN

From EMBOSS 6.2.0


Function ajGraphSetOutfileC

Set the name of the output file. Only used later if the device plotter is capable of postscript output. ps and cps.

Prototype

void ajGraphSetOutfileC (
      AjPGraph thys,
      const char* txt
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph structure to write file name to.
const char*txtInputName of the file.
void RETURN

From EMBOSS 6.2.0


Function ajGraphSetOutfileS

Set the name of the output file. Only used later if the device plotter is capable of postscript output. ps and cps.

Prototype

void ajGraphSetOutfileS (
      AjPGraph thys,
      const AjPStr str
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph structure to write file name to.
const AjPStrstrInputName of the file.
void RETURN

From EMBOSS 6.2.0


Function ajGraphSetSubtitleC

Set the graph subtitle.

Prototype

void ajGraphSetSubtitleC (
      AjPGraph thys,
      const char* txt
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph structure to store info in.
const char*txtInputSubtitle.
void RETURN

From EMBOSS 6.2.0


Function ajGraphSetSubtitleS

Set the title for the Y axis.

Prototype

void ajGraphSetSubtitleS (
      AjPGraph thys,
      const AjPStr str
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph structure to store info in.
const AjPStrstrInputSubtitle
void RETURN

From EMBOSS 6.2.0


Function ajGraphSetTitleC

Set the graph Title.

Prototype

void ajGraphSetTitleC (
      AjPGraph thys,
      const char* txt
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph structure to store info in.
const char*txtInputtitle.
void RETURN

From EMBOSS 2.9.0


Function ajGraphSetTitleS

Set the graph title.

Prototype

void ajGraphSetTitleS (
      AjPGraph thys,
      const AjPStr str
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph structure to store info in.
const AjPStrstrInputTitle.
void RETURN

From EMBOSS 6.2.0


Function ajGraphSetXlabelC

Set the title for the X axis for multiple plot on one graph.

Prototype

void ajGraphSetXlabelC (
      AjPGraph thys,
      const char* txt
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph structure to store info in.
const char*txtInputtitle for the x axis.
void RETURN

From EMBOSS 6.2.0


Function ajGraphSetXlabelS

Set the title for the X axis for multiple plots on one graph.

Prototype

void ajGraphSetXlabelS (
      AjPGraph thys,
      const AjPStr str
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph structure to store info in.
const AjPStrstrInputtitle for the x axis.
void RETURN

From EMBOSS 6.2.0


Function ajGraphSetYlabelC

Set the title for the Y axis for multiple plots on one graph.

Prototype

void ajGraphSetYlabelC (
      AjPGraph thys,
      const char* txt
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph structure to store info in.
const char*txtInputtitle for the y axis.
void RETURN

From EMBOSS 6.2.0


Function ajGraphSetYlabelS

Set the title for the Y axis for multiple plots on one graph.

Prototype

void ajGraphSetYlabelS (
      AjPGraph thys,
      const AjPStr str
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph structure to store info in.
const AjPStrstrInputtitle for the y axis.
void RETURN

From EMBOSS 6.2.0


Function ajGraphShowSubtitle

Set whether the graph is to display the subtitle.

Prototype

void ajGraphShowSubtitle (
      AjPGraph thys,
      AjBool set
);

TypeNameRead/WriteDescription
AjPGraphthysModifygraph to have flag altered
AjBoolsetInputwhether to set or turn off.
void RETURN

From EMBOSS 6.2.0


Function ajGraphShowTitle

Set whether the graph is to display the title.

Prototype

void ajGraphShowTitle (
      AjPGraph thys,
      AjBool set
);

TypeNameRead/WriteDescription
AjPGraphthysModifygraph to have flag altered
AjBoolsetInputwhether to set or turn off.
void RETURN

From EMBOSS 6.2.0


AjPGraph: Queries

Querying and reporting internal values

Functions:
ajGraphGetParamsPageGet the output page parameters stored in a graph object
ajGraphGetSubtitleCReturn plot subtitle
ajGraphGetSubtitleSReturn plot subtitle
ajGraphGetTitleCReturn plot title
ajGraphGetTitleSReturn plot title
ajGraphGetXlabelCReturn plot x-axis label
ajGraphGetXlabelSReturn plot x-axis label
ajGraphGetYlabelCReturn plot y-axis label
ajGraphGetYlabelSReturn plot y-axis label
ajGraphIsDatareturns ajTrue if the graph is creating a data file


Function ajGraphGetParamsPage

Get the output page parameters stored in a graph object

Prototype

void ajGraphGetParamsPage (
      const AjPGraph thys,
      float* xp,
      float* yp,
      ajint* xleng,
      ajint* yleng,
      ajint* xoff,
      ajint* yoff
);

TypeNameRead/WriteDescription
const AjPGraphthysInputGraph object.
float*xpModifywhere to store the x position
float*ypModifywhere to store the y position
ajint*xlengModifywhere to store the x length
ajint*ylengModifywhere to the y length
ajint*xoffModifywhere to store the x offset
ajint*yoffModifywhere to store the y offset
void RETURN

From EMBOSS 6.2.0


Function ajGraphGetSubtitleC

Return plot subtitle

Prototype

const char* ajGraphGetSubtitleC (
      const AjPGraph thys
);

TypeNameRead/WriteDescription
const AjPGraphthysInputGraph object.
const char* RETURNSubtitle

From EMBOSS 6.2.0


Function ajGraphGetSubtitleS

Return plot subtitle

Prototype

const AjPStr ajGraphGetSubtitleS (
      const AjPGraph thys
);

TypeNameRead/WriteDescription
const AjPGraphthysInputGraph object.
const AjPStr RETURNSubtitle

From EMBOSS 6.2.0


Function ajGraphGetTitleC

Return plot title

Prototype

const char* ajGraphGetTitleC (
      const AjPGraph thys
);

TypeNameRead/WriteDescription
const AjPGraphthysInputGraph object.
const char* RETURNTitle

From EMBOSS 2.9.0


Function ajGraphGetTitleS

Return plot title

Prototype

const AjPStr ajGraphGetTitleS (
      const AjPGraph thys
);

TypeNameRead/WriteDescription
const AjPGraphthysInputGraph object.
const AjPStr RETURNTitle

From EMBOSS 6.2.0


Function ajGraphGetXlabelC

Return plot x-axis label

Prototype

const char* ajGraphGetXlabelC (
      const AjPGraph thys
);

TypeNameRead/WriteDescription
const AjPGraphthysInputGraph object.
const char* RETURNTitle of x-axis

From EMBOSS 6.2.0


Function ajGraphGetXlabelS

Return plot x-axis label

Prototype

const AjPStr ajGraphGetXlabelS (
      const AjPGraph thys
);

TypeNameRead/WriteDescription
const AjPGraphthysInputGraph object.
const AjPStr RETURNTitle of x-axis

From EMBOSS 6.2.0


Function ajGraphGetYlabelC

Return plot y-axis label

Prototype

const char* ajGraphGetYlabelC (
      const AjPGraph thys
);

TypeNameRead/WriteDescription
const AjPGraphthysInputGraph object.
const char* RETURNTitle of y-axis

From EMBOSS 6.2.0


Function ajGraphGetYlabelS

Return plot y-axis label

Prototype

const AjPStr ajGraphGetYlabelS (
      const AjPGraph thys
);

TypeNameRead/WriteDescription
const AjPGraphthysInputGraph object.
const AjPStr RETURNTitle of y-axis

From EMBOSS 6.2.0


Function ajGraphIsData

returns ajTrue if the graph is creating a data file

Prototype

AjBool ajGraphIsData (
      const AjPGraph thys
);

TypeNameRead/WriteDescription
const AjPGraphthysInputGraph object
AjBool RETURNajTrue if the graph is of type data

From EMBOSS 2.9.0


AjPGraph: Plotting

Plotting drawable objects

Functions:
ajGraphAddLineAdd a line to be drawn when the graph is plotted.
ajGraphAddRectAdd a Rectangle to be drawn when the graph is plotted, fill states whether the rectangle should be filled in.
ajGraphAddTextCAdd text to be drawn when the graph is plotted.
ajGraphAddTextSAdd text to be drawn when the graph is plotted.
ajGraphAddTextScaleCAdd text to be drawn when the graph is plotted.
ajGraphAddTextScaleSAdd text to be drawn when the graph is plotted.


Function ajGraphAddLine

Add a line to be drawn when the graph is plotted.

Prototype

void ajGraphAddLine (
      AjPGraph thys,
      float x,
      float y,
      float x2,
      float y2,
      ajint colour
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph object
floatxInputStart x position
floatyInputStart y position
floatx2InputEnd x position
floaty2InputEnd y position
ajintcolourInputColour code (see PLPLOT)
void RETURN

From EMBOSS 2.9.0


Function ajGraphAddRect

Add a Rectangle to be drawn when the graph is plotted, fill states whether the rectangle should be filled in.

Prototype

void ajGraphAddRect (
      AjPGraph thys,
      float x,
      float y,
      float x2,
      float y2,
      ajint colour,
      ajint fill
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph object
floatxInputStart x coordinate
floatyInputStart y coordinate
floatx2InputEnd x coordinate
floaty2InputEnd y coordinate
ajintcolourInputColour code (see PLPLOT)
ajintfillInputFill code (see PLPLOT)
void RETURN

From EMBOSS 2.9.0


Function ajGraphAddTextC

Add text to be drawn when the graph is plotted.

Prototype

void ajGraphAddTextC (
      AjPGraph thys,
      float x,
      float y,
      ajint colour,
      const char* txt
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph object
floatxInputStart x position
floatyInputStart y position
ajintcolourInputColour code (see PLPLOT)
const char*txtInputText
void RETURN

From EMBOSS 6.2.0


Function ajGraphAddTextS

Add text to be drawn when the graph is plotted.

Prototype

void ajGraphAddTextS (
      AjPGraph thys,
      float x,
      float y,
      ajint colour,
      const AjPStr str
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph object
floatxInputStart x position
floatyInputStart y position
ajintcolourInputColour code (see PLPLOT)
const AjPStrstrInputText
void RETURN

From EMBOSS 6.2.0


Function ajGraphAddTextScaleC

Add text to be drawn when the graph is plotted.

Prototype

void ajGraphAddTextScaleC (
      AjPGraph thys,
      float x,
      float y,
      ajint colour,
      float scale,
      const char* txt
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph object
floatxInputStart x position
floatyInputStart y position
ajintcolourInputColour code (see PLPLOT)
floatscaleInputCharacter scale (0.0 to use the default)
const char*txtInputText
void RETURN

From EMBOSS 6.2.0


Function ajGraphAddTextScaleS

Add text to be drawn when the graph is plotted.

Prototype

void ajGraphAddTextScaleS (
      AjPGraph thys,
      float x,
      float y,
      ajint colour,
      float scale,
      const AjPStr str
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph object
floatxInputStart x position
floatyInputStart y position
ajintcolourInputColour code (see PLPLOT)
floatscaleInputCharacter scale (0.0 to use the default)
const AjPStrstrInputText
void RETURN

From EMBOSS 6.2.0


AjPGraph: Debugging

Tracing the internal values of a graph object

Functions:
ajGraphTraceWrites debug messages to trace the contents of a graph object.


Function ajGraphTrace

Writes debug messages to trace the contents of a graph object.

Prototype

void ajGraphTrace (
      const AjPGraph thys
);

TypeNameRead/WriteDescription
const AjPGraphthysInputGraph object
void RETURN

From EMBOSS 1.0.0


AjPGraph: Graph data management

Functions to manage the graphdata objects associated with a graph object

Functions:
ajGraphDataAddAdd another graph structure to the multiple graph structure.
ajGraphDataReplaceReplace graph structure into the multiple graph structure.
ajGraphDataReplaceIReplace one of the graph structures in the multiple graph structure.


Function ajGraphDataAdd

Add another graph structure to the multiple graph structure.

Prototype

AjBool ajGraphDataAdd (
      AjPGraph thys,
      AjPGraphdata graphdata
);

TypeNameRead/WriteDescription
AjPGraphthysModifymultiple graph structure.
AjPGraphdatagraphdataModifygraph to be added.
AjBool RETURNTrue if graph added successfully

From EMBOSS 2.9.0


Function ajGraphDataReplace

Replace graph structure into the multiple graph structure.

Prototype

AjBool ajGraphDataReplace (
      AjPGraph thys,
      AjPGraphdata graphdata
);

TypeNameRead/WriteDescription
AjPGraphthysModifymultiple graph structure.
AjPGraphdatagraphdataModifygraph to be added.
AjBool RETURNTrue if graph added successfully

From EMBOSS 2.9.0


Function ajGraphDataReplaceI

Replace one of the graph structures in the multiple graph structure.

Prototype

AjBool ajGraphDataReplaceI (
      AjPGraph thys,
      AjPGraphdata graphdata,
      ajuint num
);

TypeNameRead/WriteDescription
AjPGraphthysModifymultiple graph structure.
AjPGraphdatagraphdataModifygraph to be added.
ajuintnumInputnumber within multiple graph.
AjBool RETURNTrue if graph added successfully

From EMBOSS 4.1.0


AjPGraph: Constructors

Construct a new graph object to be populated by other functions

Functions:
ajGraphxyNewICreate a structure to hold a number of graphs.


Function ajGraphxyNewI

Create a structure to hold a number of graphs.

Prototype

AjPGraph ajGraphxyNewI (
      ajuint numsets
);

TypeNameRead/WriteDescription
ajuintnumsetsInputmaximum number of graphs that can be stored.
AjPGraph RETURNmultiple graph structure.

From EMBOSS 1.0.0


AjPGraph: Destructors

Destructors for AjGraph XY graph data

Functions:
ajGraphxyDelDestructor for a graph object


Function ajGraphxyDel

Destructor for a graph object

Prototype

void ajGraphxyDel (
      AjPGraph* pthis
);

TypeNameRead/WriteDescription
AjPGraph*pthisOutputGraph structure to store info in.
void RETURN

From EMBOSS 1.0.0


AjPGraph: Display

Functions to display or write the graph

Functions:
ajGraphxyDisplayA general routine for drawing graphs.


Function ajGraphxyDisplay

A general routine for drawing graphs.

Prototype

void ajGraphxyDisplay (
      AjPGraph thys,
      AjBool closeit
);

TypeNameRead/WriteDescription
AjPGraphthysModifyMultiple graph pointer.
AjBoolcloseitInputWhether to close graph at the end.
void RETURN

From EMBOSS 1.0.0


AjPGraph: Modifiers

Set or modify internal values of an XY graph object

Functions:
ajGraphxySetDevicetypeInitialize options for a graphxy object
ajGraphxySetMinmaxSet the max and min of the data points for all graphs.
ajGraphxySetRangesCalculate the max and min of the data points and store them.
ajGraphxySetXendFSet the end position for X in the graph.
ajGraphxySetXrangeIISets the X axis range with integers
ajGraphxySetXstartFSet the start position for X in the graph.
ajGraphxySetYendFSet the end position for Y in the graph.
ajGraphxySetYrangeIISets the Y axis range with integers
ajGraphxySetYstartFSet the start position for Y in the graph.
ajGraphxySetflagGapsSet whether the graphs should enable gaps.
ajGraphxySetflagOverlaySet whether the graphs should lay on top of each other.
ajGraphxyShowPointsCircleSet the graph to draw circles at the points.
ajGraphxyShowPointsJoinSet the graph to draw lines between the points.
ajGraphxyShowRaxisSet the graph is to display a right hand Y axis.
ajGraphxyShowUaxisSet whether the graph is to display the left X axis at the top.
ajGraphxyShowUnumSet whether the graph is to display the labels on the upper x axis.
ajGraphxyShowXaxisSet whether the graph is to display a bottom x axis.
ajGraphxyShowXgridSet whether the graph is to grid the tick marks on the x axis.
ajGraphxyShowXinvertSet whether the graph is to display the tick marks inside the plot on the x axis.
ajGraphxyShowXlabelSet whether the graph is to label the x axis.
ajGraphxyShowXtickSet whether the graph is to display tick marks on the x axis.
ajGraphxyShowYaxisSet whether the graph is to display the left Y axis.
ajGraphxyShowYgridSet whether the graph is to grid the tick marks on the x axis.
ajGraphxyShowYinvertSet whether the graph is to display the tick marks inside the plot on the y axis.
ajGraphxyShowYlabelSet whether the graph is to label the y axis.
ajGraphxyShowYnumSet whether the graph is to display the numbers on the left Y axis.
ajGraphxyShowYtickSet the graph is to display tick marks on the y axis.


Function ajGraphxySetDevicetype

Initialize options for a graphxy object

Prototype

AjBool ajGraphxySetDevicetype (
      AjPGraph thys,
      const AjPStr devicetype
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph object
const AjPStrdevicetypeInputDevice type
AjBool RETURNajTrue on success

From EMBOSS 6.2.0


Function ajGraphxySetMinmax

Set the max and min of the data points for all graphs.

Prototype

void ajGraphxySetMinmax (
      AjPGraph thys,
      float xmin,
      float xmax,
      float ymin,
      float ymax
);

TypeNameRead/WriteDescription
AjPGraphthysModifymultiple graph structure.
floatxminInputx min.
floatxmaxInputx max.
floatyminInputy min.
floatymaxInputy max.
void RETURN

From EMBOSS 6.2.0


Function ajGraphxySetRanges

Calculate the max and min of the data points and store them.

Prototype

void ajGraphxySetRanges (
      AjPGraph thys
);

TypeNameRead/WriteDescription
AjPGraphthysModifymultiple graph structure.
void RETURN

From EMBOSS 6.2.0


Function ajGraphxySetXendF

Set the end position for X in the graph.

Prototype

void ajGraphxySetXendF (
      AjPGraph thys,
      float val
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph structure to store info in.
floatvalInputThe end value for x graph coord
void RETURN

From EMBOSS 6.2.0


Function ajGraphxySetXrangeII

Sets the X axis range with integers

Prototype

void ajGraphxySetXrangeII (
      AjPGraph thys,
      ajint start,
      ajint end
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph
ajintstartInputstart position
ajintendInputend position
void RETURN

From EMBOSS 6.2.0


Function ajGraphxySetXstartF

Set the start position for X in the graph.

Prototype

void ajGraphxySetXstartF (
      AjPGraph thys,
      float val
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph structure to store info in.
floatvalInputThe start value for x graph coord.
void RETURN

From EMBOSS 6.2.0


Function ajGraphxySetYendF

Set the end position for Y in the graph.

Prototype

void ajGraphxySetYendF (
      AjPGraph thys,
      float val
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph structure to store info in.
floatvalInputThe start value for y graph coord.
void RETURN

From EMBOSS 6.2.0


Function ajGraphxySetYrangeII

Sets the Y axis range with integers

Prototype

void ajGraphxySetYrangeII (
      AjPGraph thys,
      ajint start,
      ajint end
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph
ajintstartInputstart position
ajintendInputend position
void RETURN

From EMBOSS 6.2.0


Function ajGraphxySetYstartF

Set the start position for Y in the graph.

Prototype

void ajGraphxySetYstartF (
      AjPGraph thys,
      float val
);

TypeNameRead/WriteDescription
AjPGraphthysModifyGraph structure to store info in.
floatvalInputThe end value for y graph coord.
void RETURN

From EMBOSS 6.2.0


Function ajGraphxySetflagGaps

Set whether the graphs should enable gaps.

Prototype

void ajGraphxySetflagGaps (
      AjPGraph thys,
      AjBool set
);

TypeNameRead/WriteDescription
AjPGraphthysModifyMultiple graph object
AjBoolsetInputif true allow gaps else do not.
void RETURN

From EMBOSS 6.2.0


Function ajGraphxySetflagOverlay

Set whether the graphs should lay on top of each other.

Prototype

void ajGraphxySetflagOverlay (
      AjPGraph thys,
      AjBool set
);

TypeNameRead/WriteDescription
AjPGraphthysModifyMultiple graph object
AjBoolsetInputif true overlap else do not.
void RETURN

From EMBOSS 6.2.0


Function ajGraphxyShowPointsCircle

Set the graph to draw circles at the points.

Prototype

void ajGraphxyShowPointsCircle (
      AjPGraph thys,
      AjBool set
);

TypeNameRead/WriteDescription
AjPGraphthysModifygraph to have flag altered
AjBoolsetInputwhether to set or turn off.
void RETURN

From EMBOSS 6.2.0


Function ajGraphxyShowPointsJoin

Set the graph to draw lines between the points.

Prototype

void ajGraphxyShowPointsJoin (
      AjPGraph thys,
      AjBool set
);

TypeNameRead/WriteDescription
AjPGraphthysModifygraph to have flag altered
AjBoolsetInputwhether to set or turn off.
void RETURN

From EMBOSS 6.2.0


Function ajGraphxyShowRaxis

Set the graph is to display a right hand Y axis.

Prototype

void ajGraphxyShowRaxis (
      AjPGraph thys,
      AjBool set
);

TypeNameRead/WriteDescription
AjPGraphthysModifygraph to have flag altered
AjBoolsetInputwhether to set or turn off.
void RETURN

From EMBOSS 6.2.0


Function ajGraphxyShowUaxis

Set whether the graph is to display the left X axis at the top.

Prototype

void ajGraphxyShowUaxis (
      AjPGraph thys,
      AjBool set
);

TypeNameRead/WriteDescription
AjPGraphthysModifygraph to have flag altered
AjBoolsetInputwhether to set or turn off.
void RETURN

From EMBOSS 6.2.0


Function ajGraphxyShowUnum

Set whether the graph is to display the labels on the upper x axis.

Prototype

void ajGraphxyShowUnum (
      AjPGraph thys,
      AjBool set
);

TypeNameRead/WriteDescription
AjPGraphthysModifygraph to have flag altered
AjBoolsetInputwhether to set or turn off.
void RETURN

From EMBOSS 6.2.0


Function ajGraphxyShowXaxis

Set whether the graph is to display a bottom x axis.

Prototype

void ajGraphxyShowXaxis (
      AjPGraph thys,
      AjBool set
);

TypeNameRead/WriteDescription
AjPGraphthysModifygraph to have flag altered
AjBoolsetInputwhether to set or turn off.
void RETURN

From EMBOSS 6.2.0


Function ajGraphxyShowXgrid

Set whether the graph is to grid the tick marks on the x axis.

Prototype

void ajGraphxyShowXgrid (
      AjPGraph thys,
      AjBool set
);

TypeNameRead/WriteDescription
AjPGraphthysModifygraph to have flag altered
AjBoolsetInputwhether to set or turn off.
void RETURN

From EMBOSS 6.2.0


Function ajGraphxyShowXinvert

Set whether the graph is to display the tick marks inside the plot on the x axis.

Prototype

void ajGraphxyShowXinvert (
      AjPGraph thys,
      AjBool set
);

TypeNameRead/WriteDescription
AjPGraphthysModifygraph to have flag altered
AjBoolsetInputwhether to set or turn off.
void RETURN

From EMBOSS 6.2.0


Function ajGraphxyShowXlabel

Set whether the graph is to label the x axis.

Prototype

void ajGraphxyShowXlabel (
      AjPGraph thys,
      AjBool set
);

TypeNameRead/WriteDescription
AjPGraphthysModifygraph to have flag altered
AjBoolsetInputwhether to set or turn off.
void RETURN

From EMBOSS 6.2.0


Function ajGraphxyShowXtick

Set whether the graph is to display tick marks on the x axis.

Prototype

void ajGraphxyShowXtick (
      AjPGraph thys,
      AjBool set
);

TypeNameRead/WriteDescription
AjPGraphthysModifygraph to have flag altered
AjBoolsetInputwhether to set or turn off.
void RETURN

From EMBOSS 6.2.0


Function ajGraphxyShowYaxis

Set whether the graph is to display the left Y axis.

Prototype

void ajGraphxyShowYaxis (
      AjPGraph thys,
      AjBool set
);

TypeNameRead/WriteDescription
AjPGraphthysModifygraph to have flag altered
AjBoolsetInputwhether to set or turn off.
void RETURN

From EMBOSS 6.2.0


Function ajGraphxyShowYgrid

Set whether the graph is to grid the tick marks on the x axis.

Prototype

void ajGraphxyShowYgrid (
      AjPGraph thys,
      AjBool set
);

TypeNameRead/WriteDescription
AjPGraphthysModifygraph to have flag altered
AjBoolsetInputwhether to set or turn off.
void RETURN

From EMBOSS 6.2.0


Function ajGraphxyShowYinvert

Set whether the graph is to display the tick marks inside the plot on the y axis.

Prototype

void ajGraphxyShowYinvert (
      AjPGraph thys,
      AjBool set
);

TypeNameRead/WriteDescription
AjPGraphthysModifygraph to have flag altered
AjBoolsetInputwhether to set or turn off.
void RETURN

From EMBOSS 6.2.0


Function ajGraphxyShowYlabel

Set whether the graph is to label the y axis.

Prototype

void ajGraphxyShowYlabel (
      AjPGraph thys,
      AjBool set
);

TypeNameRead/WriteDescription
AjPGraphthysModifygraph to have flag altered
AjBoolsetInputwhether to set or turn off.
void RETURN

From EMBOSS 6.2.0


Function ajGraphxyShowYnum

Set whether the graph is to display the numbers on the left Y axis.

Prototype

void ajGraphxyShowYnum (
      AjPGraph thys,
      AjBool set
);

TypeNameRead/WriteDescription
AjPGraphthysModifygraph to have flag altered
AjBoolsetInputwhether to set or turn off.
void RETURN

From EMBOSS 6.2.0


Function ajGraphxyShowYtick

Set the graph is to display tick marks on the y axis.

Prototype

void ajGraphxyShowYtick (
      AjPGraph thys,
      AjBool set
);

TypeNameRead/WriteDescription
AjPGraphthysModifygraph to have flag altered
AjBoolsetInputwhether to set or turn off.
void RETURN

From EMBOSS 6.2.0


Datatype: AjPGraphdata

Function is for manipulating an AjPGraphdata object

Sections:
ConstructorsConstructors
DestructorsDestructors
ModifiersModifiers
PlottingGeneral use
DebuggingGeneral use


AjPGraphdata: Constructors

Constructors for AjGraphdata plot data

Functions:
ajGraphdataNewCreates a new empty graph
ajGraphdataNewICreate and initialise the data structure for the graph with a defined number of data points.


Function ajGraphdataNew

Creates a new empty graph

Prototype

AjPGraphdata ajGraphdataNew (
      void
);

TypeNameRead/WriteDescription
AjPGraphdata RETURNNew empty graph

From EMBOSS 6.2.0


Function ajGraphdataNewI

Create and initialise the data structure for the graph with a defined number of data points.

Prototype

AjPGraphdata ajGraphdataNewI (
      ajuint numofpoints
);

TypeNameRead/WriteDescription
ajuintnumofpointsInputNumber of points
AjPGraphdata RETURNPointer to new graph structure.

From EMBOSS 6.2.0


AjPGraphdata: Destructors

Destructors for AjGraphdata plot data

Functions:
ajGraphdataDelDestructor for a graph data object


Function ajGraphdataDel

Destructor for a graph data object

Prototype

void ajGraphdataDel (
      AjPGraphdata* pthys
);

TypeNameRead/WriteDescription
AjPGraphdata*pthysDeleteGraph data object
void RETURN

From EMBOSS 6.2.0


AjPGraphdata: Modifiers

Set or modify the internals of a graph data object

Functions:
ajGraphdataSetColourSet the colour for the plot on one graph.
ajGraphdataSetDatanameCSet the Subtitle.
ajGraphdataSetDatanameSSet the Subtitle.
ajGraphdataSetLinetypeSet the line type for this graph.
ajGraphdataSetMinmaxSet the max and min of the data points you wish to display.
ajGraphdataSetSubtitleCSet the subtitle.
ajGraphdataSetSubtitleSSet the Subtitle.
ajGraphdataSetTitleCSet the title.
ajGraphdataSetTitleSSet the title.
ajGraphdataSetTruescaleSet the scale max and min of the data points you wish to display.
ajGraphdataSetTypeCSet the type of the graph for data output.
ajGraphdataSetTypeSSet the type of the graph for data output.
ajGraphdataSetXlabelCSet the title for the X axis.
ajGraphdataSetXlabelSSet the title for the X axis.
ajGraphdataSetYlabelCSet the title for the Y axis.
ajGraphdataSetYlabelSSet the title for the Y axis.


Function ajGraphdataSetColour

Set the colour for the plot on one graph.

Prototype

void ajGraphdataSetColour (
      AjPGraphdata graphdata,
      ajint colour
);

TypeNameRead/WriteDescription
AjPGraphdatagraphdataModifyGraph structure to store info in.
ajintcolourInputcolour for this plot.
void RETURN

From EMBOSS 6.2.0


Function ajGraphdataSetDatanameC

Set the Subtitle.

Prototype

void ajGraphdataSetDatanameC (
      AjPGraphdata graphdata,
      const char* txt
);

TypeNameRead/WriteDescription
AjPGraphdatagraphdataModifyGraph structure to store info in.
const char*txtInputData source name
void RETURN

From EMBOSS 6.5.0


Function ajGraphdataSetDatanameS

Set the Subtitle.

Prototype

void ajGraphdataSetDatanameS (
      AjPGraphdata graphdata,
      const AjPStr str
);

TypeNameRead/WriteDescription
AjPGraphdatagraphdataModifyGraph structure to store info in.
const AjPStrstrInputData source name
void RETURN

From EMBOSS 6.5.0


Function ajGraphdataSetLinetype

Set the line type for this graph.

Prototype

void ajGraphdataSetLinetype (
      AjPGraphdata graphdata,
      ajint type
);

TypeNameRead/WriteDescription
AjPGraphdatagraphdataModifyGraph structure to store info in.
ajinttypeInputSet the line type.
void RETURN

From EMBOSS 6.2.0


Function ajGraphdataSetMinmax

Set the max and min of the data points you wish to display.

Prototype

void ajGraphdataSetMinmax (
      AjPGraphdata graphdata,
      float xmin,
      float xmax,
      float ymin,
      float ymax
);

TypeNameRead/WriteDescription
AjPGraphdatagraphdataModifymultiple graph structure.
floatxminInputx min.
floatxmaxInputx max.
floatyminInputy min.
floatymaxInputy max.
void RETURN

From EMBOSS 6.2.0


Function ajGraphdataSetSubtitleC

Set the subtitle.

Prototype

void ajGraphdataSetSubtitleC (
      AjPGraphdata graphdata,
      const char* txt
);

TypeNameRead/WriteDescription
AjPGraphdatagraphdataModifyGraph structure to store info in.
const char*txtInputSub Title
void RETURN

From EMBOSS 6.2.0


Function ajGraphdataSetSubtitleS

Set the Subtitle.

Prototype

void ajGraphdataSetSubtitleS (
      AjPGraphdata graphdata,
      const AjPStr str
);

TypeNameRead/WriteDescription
AjPGraphdatagraphdataModifyGraph structure to store info in.
const AjPStrstrInputSub Title
void RETURN

From EMBOSS 6.2.0


Function ajGraphdataSetTitleC

Set the title.

Prototype

void ajGraphdataSetTitleC (
      AjPGraphdata graphdata,
      const char* txt
);

TypeNameRead/WriteDescription
AjPGraphdatagraphdataModifyGraph structure to store info in.
const char*txtInputTitle
void RETURN

From EMBOSS 6.2.0


Function ajGraphdataSetTitleS

Set the title.

Prototype

void ajGraphdataSetTitleS (
      AjPGraphdata graphdata,
      const AjPStr str
);

TypeNameRead/WriteDescription
AjPGraphdatagraphdataModifyGraph structure to store info in.
const AjPStrstrInputTitle
void RETURN

From EMBOSS 6.2.0


Function ajGraphdataSetTruescale

Set the scale max and min of the data points you wish to display.

Prototype

void ajGraphdataSetTruescale (
      AjPGraphdata graphdata,
      float xmin,
      float xmax,
      float ymin,
      float ymax
);

TypeNameRead/WriteDescription
AjPGraphdatagraphdataModifymultiple graph structure.
floatxminInputtrue x min.
floatxmaxInputtrue x max.
floatyminInputtrue y min.
floatymaxInputtrue y max.
void RETURN

From EMBOSS 6.2.0


Function ajGraphdataSetTypeC

Set the type of the graph for data output.

Prototype

void ajGraphdataSetTypeC (
      AjPGraphdata graphdata,
      const char* txt
);

TypeNameRead/WriteDescription
AjPGraphdatagraphdataModifymultiple graph structure.
const char*txtInputType e.g. "2D Plot", "Histogram".
void RETURN

From EMBOSS 6.2.0


Function ajGraphdataSetTypeS

Set the type of the graph for data output.

Prototype

void ajGraphdataSetTypeS (
      AjPGraphdata graphdata,
      const AjPStr str
);

TypeNameRead/WriteDescription
AjPGraphdatagraphdataModifymultiple graph structure.
const AjPStrstrInputType e.g. "2D Plot", "Histogram".
void RETURN

From EMBOSS 6.2.0


Function ajGraphdataSetXlabelC

Set the title for the X axis.

Prototype

void ajGraphdataSetXlabelC (
      AjPGraphdata graphdata,
      const char* txt
);

TypeNameRead/WriteDescription
AjPGraphdatagraphdataModifyGraph structure to store info in.
const char*txtInputtitle for the X axis.
void RETURN

From EMBOSS 6.2.0


Function ajGraphdataSetXlabelS

Set the title for the X axis.

Prototype

void ajGraphdataSetXlabelS (
      AjPGraphdata graphdata,
      const AjPStr str
);

TypeNameRead/WriteDescription
AjPGraphdatagraphdataModifyGraph structure to store info in.
const AjPStrstrInputtitle for the X axis.
void RETURN

From EMBOSS 6.2.0


Function ajGraphdataSetYlabelC

Set the title for the Y axis.

Prototype

void ajGraphdataSetYlabelC (
      AjPGraphdata graphdata,
      const char* txt
);

TypeNameRead/WriteDescription
AjPGraphdatagraphdataModifyGraph structure to store info in.
const char*txtInputtitle for the Y axis.
void RETURN

From EMBOSS 6.2.0


Function ajGraphdataSetYlabelS

Set the title for the Y axis.

Prototype

void ajGraphdataSetYlabelS (
      AjPGraphdata graphdata,
      const AjPStr str
);

TypeNameRead/WriteDescription
AjPGraphdatagraphdataModifyGraph structure to store info in.
const AjPStrstrInputtitle for the Y axis.
void RETURN

From EMBOSS 6.2.0


AjPGraphdata: Plotting

Plotting drawable objects

Functions:
ajGraphdataAddXYAdds (x,y) data points defined in two floating point arrays
ajGraphdataAddposLineAdd a line to be drawn when the graph is plotted.
ajGraphdataAddposRectAdd a Rectangle to be drawn when the graph is plotted, fill states whether the rectangle should be filled in.
ajGraphdataAddposTextCAdd Text to be drawn when the graph is plotted.
ajGraphdataAddposTextSAdd Text to be drawn when the graph is plotted.
ajGraphdataAddposTextScaleCAdd Text to be drawn when the graph is plotted.
ajGraphdataAddposTextScaleSAdd Text to be drawn when the graph is plotted.
ajGraphdataCalcXYAdds (x,y) data points defined by an x-axis start and increment and a floating point array of y-axis values.


Function ajGraphdataAddXY

Adds (x,y) data points defined in two floating point arrays

Prototype

void ajGraphdataAddXY (
      AjPGraphdata graphdata,
      const float* xx,
      const float* yy
);

TypeNameRead/WriteDescription
AjPGraphdatagraphdataModifyGraph object
const float*xxInputX coordinates
const float*yyInputY coordinates
void RETURN

From EMBOSS 6.2.0


Function ajGraphdataAddposLine

Add a line to be drawn when the graph is plotted.

Prototype

void ajGraphdataAddposLine (
      AjPGraphdata graphdata,
      float x,
      float y,
      float x2,
      float y2,
      ajint colour
);

TypeNameRead/WriteDescription
AjPGraphdatagraphdataModifyGraph data object
floatxInputStart x position
floatyInputStart y position
floatx2InputEnd x position
floaty2InputEnd y position
ajintcolourInputColour code (see PLPLOT)
void RETURN

From EMBOSS 6.2.0


Function ajGraphdataAddposRect

Add a Rectangle to be drawn when the graph is plotted, fill states whether the rectangle should be filled in.

Prototype

void ajGraphdataAddposRect (
      AjPGraphdata graphdata,
      float x,
      float y,
      float x2,
      float y2,
      ajint colour,
      ajint fill
);

TypeNameRead/WriteDescription
AjPGraphdatagraphdataModifyGraph data object
floatxInputStart x position
floatyInputStart y position
floatx2InputEnd x position
floaty2InputEnd y position
ajintcolourInputColour code (see PLPLOT)
ajintfillInputFill code (see PLPLOT)
void RETURN

From EMBOSS 6.2.0


Function ajGraphdataAddposTextC

Add Text to be drawn when the graph is plotted.

Prototype

void ajGraphdataAddposTextC (
      AjPGraphdata graphdata,
      float x,
      float y,
      ajint colour,
      const char* txt
);

TypeNameRead/WriteDescription
AjPGraphdatagraphdataModifyGraph data object
floatxInputStart x position
floatyInputStart y position
ajintcolourInputColour code (see PLPLOT)
const char*txtInputText to add 1
void RETURN

From EMBOSS 6.2.0


Function ajGraphdataAddposTextS

Add Text to be drawn when the graph is plotted.

Prototype

void ajGraphdataAddposTextS (
      AjPGraphdata graphdata,
      float x,
      float y,
      ajint colour,
      const AjPStr str
);

TypeNameRead/WriteDescription
AjPGraphdatagraphdataModifyGraph data object
floatxInputStart x position
floatyInputStart y position
ajintcolourInputColour code (see PLPLOT)
const AjPStrstrInputText to add
void RETURN

From EMBOSS 6.2.0


Function ajGraphdataAddposTextScaleC

Add Text to be drawn when the graph is plotted.

Prototype

void ajGraphdataAddposTextScaleC (
      AjPGraphdata graphdata,
      float x,
      float y,
      ajint colour,
      float scale,
      const char* txt
);

TypeNameRead/WriteDescription
AjPGraphdatagraphdataModifyGraph data object
floatxInputStart x position
floatyInputStart y position
ajintcolourInputColour code (see PLPLOT)
floatscaleInputCharacter scale (0.0 to use the default)
const char*txtInputText to add
void RETURN

From EMBOSS 6.2.0


Function ajGraphdataAddposTextScaleS

Add Text to be drawn when the graph is plotted.

Prototype

void ajGraphdataAddposTextScaleS (
      AjPGraphdata graphdata,
      float x,
      float y,
      ajint colour,
      float scale,
      const AjPStr str
);

TypeNameRead/WriteDescription
AjPGraphdatagraphdataModifyGraph data object
floatxInputStart x position
floatyInputStart y position
ajintcolourInputColour code (see PLPLOT)
floatscaleInputCharacter scale (0.0 to use the default)
const AjPStrstrInputText to add
void RETURN

From EMBOSS 6.2.0


Function ajGraphdataCalcXY

Adds (x,y) data points defined by an x-axis start and increment and a floating point array of y-axis values.

Prototype

void ajGraphdataCalcXY (
      AjPGraphdata graphdata,
      ajuint numofpoints,
      float start,
      float incr,
      const float* y
);

TypeNameRead/WriteDescription
AjPGraphdatagraphdataModifyGraph object
ajuintnumofpointsInputNumber of points in array
floatstartInputStart position
floatincrInputIncrement
const float*yInputY coordinates
void RETURN

From EMBOSS 6.2.0


AjPGraphdata: Debugging

Tracing the internal values of a graph data object

Functions:
ajGraphdataTraceWrites debug messages to trace the contents of a graphdata object.


Function ajGraphdataTrace

Writes debug messages to trace the contents of a graphdata object.

Prototype

void ajGraphdataTrace (
      const AjPGraphdata thys
);

TypeNameRead/WriteDescription
const AjPGraphdatathysInputGraphdata object
void RETURN

From EMBOSS 6.2.0


Datatype: none

Reporting internal values for general graphs

Sections:
Reporting internalsOutput


Section: Reporting internals

Functions:
ajGraphicsDumpDevicesDump device options for a graph object
ajGraphicsGetOutfilesInformation on files created for graph output
ajGraphicsListDevicesStore device names for a graph object in a list
ajGraphicsPrintTypePrint graph types


Function ajGraphicsDumpDevices

Dump device options for a graph object

Prototype

void ajGraphicsDumpDevices (
      void
);

TypeNameRead/WriteDescription
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsGetOutfiles

Information on files created for graph output

Prototype

ajuint ajGraphicsGetOutfiles (
      AjPList* files
);

TypeNameRead/WriteDescription
AjPList*filesOutputList of graph files
ajuint RETURNNumber of files (will match length of list)

From EMBOSS 6.2.0


Function ajGraphicsListDevices

Store device names for a graph object in a list

Prototype

void ajGraphicsListDevices (
      AjPList list
);

TypeNameRead/WriteDescription
AjPListlistOutputList to write device names to.
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsPrintType

Print graph types

Prototype

void ajGraphicsPrintType (
      AjPFile outf,
      AjBool full
);

TypeNameRead/WriteDescription
AjPFileoutfModifyOutput file
AjBoolfullInputFull report (usually ajFalse)
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsxyDumpDevices

Dump device options for a graph object

Prototype

void ajGraphicsxyDumpDevices (
      void
);

TypeNameRead/WriteDescription
void RETURN

From EMBOSS 6.2.0


Function ajGraphicsxyListDevices

Store device names for a graph object in a list

Prototype

void ajGraphicsxyListDevices (
      AjPList list
);

TypeNameRead/WriteDescription
AjPListlistOutputList to write device names to.
void RETURN

From EMBOSS 6.2.0