Download Latest Version effectopedia.jar (12.8 MB)
Email in envelope

Get an email when there's a new version of Effectopedia

Home / All versions / version 0.9.64 Alpha
Name Modified Size InfoDownloads / Week
Parent folder
OfflineDB 2016-02-28
Windows_Installer 2016-02-28
readme.txt 2016-02-28 23.6 kB
effectopedia.jar 2016-02-28 13.4 MB
Totals: 4 Items   13.4 MB 0
Download and use effectopedia.jar without need of installation on Windows, Mac OS, Linux and other operating systems supporting Java SE 8. You can use the windows setup file available in Windows_Installer folder if you prefer to run Effectopedia as a native windows application. Effectopedia could be also used offline by loading the last official release of the centralized database file available in OfflineDB folder. 

        ***** Effectopedia 0.9.64 (r418) Alpha Update Log ***** 28 Feb 2016
**********************************************************************************
 - The new version 0.9.64 introduces Test Response Mapping (TRM) user interface. Test response mapping captures all mathematical transformations which need to be made in order to interpret the output of a test assay in in-vivo settings. Multiple transformation function sets can be defined converting the measured test response to in-vivo response of equivalent concentration of the chemical at different target site of interaction. Target site was also indexed and will be used as a searchable properly to find all test methods which can be mapped to the same target site (usually corresponding to certain MIE). Different transformation sets can be also based on different assumptions, function choices and or applicability domains, etc. To capture all of these properties the transformation set interface has two description sections summarizing the “Biological context comparative analysis” and the “Applicability domain”, and a list of transformation functions. The list can contain as many transformation functions as needed and can be also empty in which case no transformation is made.
 - The user interface of the transformation function, allows definition and evaluation of user defined expression. The following functions are currently supported: 
NOT(expression)	Boolean negation, 1 (means true) if the expression is not zero
RANDOM()	Produces a random number between 0 and 1
MIN(e1,e2)	Returns the smaller of both expressions
MAX(e1,e2)	Returns the bigger of both expressions
ABS(expression)	Returns the absolute (non-negative) value of the expression
ROUND(expression,precision)	Rounds a value to a certain number of digits, uses the current rounding mode
LOG(expression)	Returns the natural logarithm (base e) of an expression
LOG10(expression)	Returns the logarithm (base 10) of an expression
EXP(expression)	Returns e to a power of an expression
SQRT(expression)	Returns the square root of an expression
SIN(expression)	Returns the trigonometric sine of an angle (in degrees)
COS(expression)	Returns the trigonometric cosine of an angle (in degrees)
TAN(expression)	Returns the trigonometric tangens of an angle (in degrees)
SINH(expression)	Returns the hyperbolic sine of a value
COSH(expression)	Returns the hyperbolic cosine of a value
TANH(expression)	Returns the hyperbolic tangens of a value
RAD(expression)	Converts an angle measured in degrees to an approximately equivalent angle measured in radians
DEG(expression)	Converts an angle measured in radians to an approximately equivalent angle measured in degrees
IF(Boolean expression, expression 1, expression 2)	conditional expression returning expression 1 if the Boolean expression is true and expression 2 otherwise. 

Boolean operators:
=	Equals
==	Equals
!=	Not equals
<>	Not equals
<	Less than
<=	Less than or equal to
>	Greater than
>=	Greater than or equal to
&&	Boolean and
||	Boolean or

and mathematical operations: 
Mathematical Operators
Operator	Description
+	Additive operator
–	Subtraction operator
*	Multiplication operator
/	Division operator
%	Remainder operator (Modulo)
^	Power operator
Transformation functions are executed in the order of definition and modify the original data or the output of previously applied functions. Each function has a scope and transforms only a subset of the variables - for examples Treatment scope modifies chemical concentration (mean and raw data), Response – modifies mean, median, minimal, maximal and raw response data. 
 - Experimental support evidences interface was updated to handle the choice of Transformation Set and allow generation of response - response with or without transformation.
 - The user interface for the analytic function description (also used in the transformation function) now provides additional column for parameter description. This change need to be tested with and without uncertainty columns
 - Graphical representation of the TestResponseMapping is now reduced to two symbols: “?” and “f” for undefined and defined set of transformation functions.
 - Several more editors now respond to double clicking on the title and loading the dedicated editor for the object. 
 - BugFix: Important for Mac OS users! Inconsistency of Java runtime environment on Mac (missing constant declaration, describing the multi-click interval) caused major problems in the use of the pathway editor by generating exceptions on each mouse click. Default interval is now assigned in case the variable is not defined and all interface modes seem to function normally.
 - BugFix: Pasting data in the nonlinear response – response tables did not paste the last raw of data – in the new version the problem was fixed
 - PartialFix: Merging file to the centalizedDB did cause corruption of the cenralizedDB and inability to load it on restart. Several changes have been made which reduced the corruption of the centralizedDB (now it is loading) but not all pathway components (i.e quantitative relationships) load normaly.Some of these changes include:
   - (Technical details) EffectopediaObject.cloneFieldsTo(EffectopediaObject clone) was modified to add the clone to the idMAP in case CLONEIDs==false
   - (Technical details) IDs getContainedIDs now calls recursively the getContainedIDs of the nested objects ( dislike to the parent method which does put the ids only to the parent referred objects and not their content 
   - (Technical details) DescriptionSection_Structured.process(BatchProcessor batch) was also added processing the associated structured content if possible
   - (Technical details) Links now clone their quantitativeRelationships and temporalConcordances 
   - (Technical details) Pathways now clone their groups, uids, statuses 
   - (Technical details) Test clone their substanceDataIDs 
   - (Technical details) Test_InSilico overrides the standard update methods to include globalModelIDs
   - (Technical details) DataSource.autoExternalID is still flagging an error for Assigining externalID for an object which is not indexed in the data set by the time of assigning
 - The addition of DefaultObjects handling TransformationSets lead to introduction of a new version of the file format 0.9.64 which should be also backward compatible with 0.9.61
 - BugFix: getDisplayValue was adding an extra blank space after the value with no apparent need. 
 - BugFix: ObjectPropertyMultivalued was modified to handle the case when multiple entries format has been used but no data recorder (count=0)


        ***** Effectopedia 0.9.63 (r417) Alpha Update Log ***** 22 Feb 2016
**********************************************************************************
 - (Key) even relationship (the link between two effects in the original terminology) editor now supports the definition of multiple quantitative relationships of the same nature. This allows response – response curves and analytic models derived from different information sources and or tested substances to be simultaneously stored and compared.
 - Quantitative relationship editing panel was split into three sections. The first section captures the nonlinear or analytic response-response curve available in the previous version of the interface. The next two sections are available in a collapsible panel titled Support Evidences. Two types of supporting evidences are currently planned: experimental data and in silico models. This release implements only the experimental data support evidences.
 - Experimental data support evidences interface initially shows a diagram allowing the user to define the origin and transformations of the data used for deriving the response response curve. Upstream and downstream (key) events are automatically filled in the diagram. The user then can pick from a list of available tests the method used to measure each of the (key) events. Once test method is selected the tested substance can be selected from the respective lists below the tests. Once the tested substance data is selected for both test methods a new panel appears showing the two (key) events in a single chart with common x axis and dual y axis. This chart is designed to show the transformed test data using the designated transformation functions / test response mappings. Current version however does not use transformation and shows the test data for both (key) events without any transformation. 
 - Current version also allows generation of a response-response curve in the simplest possible case – when mapping only the existing measurements of the upstream (key) event / effect to the downstream (key) event/ effect (no interpolation) for the same chemical concentration. Future versions could allow data interpolation and also fit the data into different analytic models. Statistical errors are also not computed.
 - The interface for editing nonlinear dose response curves was supplemented with two fields allowing editing of a description (notes). The new feature is availble for both: dose response or response-response curves.
 - Temporal Concordance was included in the link description allowing users to add data for two time courses - one for the upstream element of the link and one for the downstream. All relevant interface (including dual axis capabilities in the chart component) for handling the data was also implemented. Currently it is used only in (key) event relationships, but will be potentially added to the all types of links.
 - The new file format version 0.9.63 was introduced capturing all the changes in the default objects (describing time series and evidence supported quantitative relationships). It is backward compatible with the last 0.9.62 version
 - Small cosmetic changes were made into EffectopediaUI and AddressBarUI to allow the display of very long title of a datasource without hiding the command toolbar buttons.
 - EstrogenBinding qAOP chemical information was updated and files regenerated.
 - Several refinements were made with respect to the editing of to the analytic functional relationships.
 - PathwayHeader was slightly optimized to scale better ecpecially when shown in the element editor where the width of the panel is quite small.
 - BugFix: Test_InLab did have a bug using clone.getParent() as paret of the cloned referenceIDs instead of the clone itself
 - BugFix: Test interface mode did not react to double clicking on the tests (which for all other elements brings the dedicated editor for the selected component)
 - BugFix: Some default objects clones in a secondary loaded dataSource had dataSource property pointing to the first loaded dataSource (effectopedia.org...). This caused problems with storing the essentiality descriptions of pathways and potentially many other problems.
 - BugFix: UpdateParenhood of the Pathway method was not using the correct dataSource when creating clones of default objects causing the problem described above.
 - BugFix: PathwayElements remained generic after assigning subobjects referenced by IDs (e.g. Test after adding new substance data). beforeUpdate was overridden to handle this case however does not completely cover any other scenario for modifying the generic status.
 - BugFix: ObjectProperties were using the same types object instance (the default) which caused problems when loading custom types by modifying the default. ObjectProperties now use clones of the types containers.
Default description section title was changed to "Definition" instead of abstract.
 - BugFix: New tested substances were added without parent test.
 - BugFix: New tests added to a pathway were not associated with the pathway
 - Bug Fix: Default object properties containing dose response data were not update to the latest Types which were initialized later in the DefaultEffectopediaObject code.

        ***** Effectopedia 0.9.62 (r411) Alpha Update Log ***** 27 Jan 2016
**********************************************************************************
Multiple changes and additions were made since last public release of version 0.9.46 the most significant of which are described below. Details can be obtained from the SVN release 338-411

              *************** User interface changes ***************
 *********************************************************************************

    -------- Harmonisation with the OECD Guidance and terminology -------------   
 ---------------------------------------------------------------------------------
The basic building block of AOPs: effects and links are now referred as (key) events and (key) event relationships, respectively. Since Link is broader concept it is still used to connect chemical structures with Molecular Initiating Events (MIE)s and two chemicals when representing absorption, distribution, metabolism, and excretion (ADME) processes. Effectopedia encourages linking of existing and creation of new and description of non-key events (e.g. biomarkers) as part of the AOP description. Since events can be key in some pathways and non-key in others the key term is shown in brackets. 
Below are listed some of the harmonisation related changes 
 - Introduction of  LinkType  which could have one of three possible values Unknown, Direct and Indirect. The quantitative nature of relationship is now represented in the field Link Nature
 - (Key) event Relationship Weight of Evidences is a structured description section which provides a field with four possible values – undefined, weak, moderate and strong to summarise the weight of available evidences. The evidences can be further described in the body of the section by describing the biological plausibility, empirical support of linkage and uncertainties or inconsistencies. More details of the empirical support and uncertainties can be provided in the explicit elements (tests, transformation functions (test response mappings), measured data with statistical errors from multiple sources)
 - Support of Essentiality of (Key) Events is now introduced as structured description section of an AOP element. Each event included in the pathway is listed as expandable structured description section.  The essentiality of the key events can be categorised as undefined, weak, moderate and strong. A separate key word will be proposed for non-key events e.g. non-essential. 
 - AOP status free text field was introduced as part of AOP properties
 - A comma separated list of pathway identifiers was also introduced as part of AOP properties. The OECD Project Number can be listed in this field. 
 - Several default description sections were added to different elements. E.g. Quantitative considerations, Applicability of the AOP, Considerations for Potential Application in the pathway description,  Measurement and Detection section in the (key) events, etc. 


    ---------------  Response – response editing interface --------------------
 ---------------------------------------------------------------------------------
Response-response editing interface is now available in the (Key) Event Relationship (the link between two events). The interface allows the editing of Proportional, Threshold and data based Response-Response curves. New more universal Analytic function interface is under development which will allow the definition of wide variety of analytic functions. Also categorical response – response curve will be also added for the cases where no continuous information is available. All data interfaces allow definition statistical errors (available by default are: standard deviation, standard error and 95% confidence interval).  In case of analytic function the statistical error need to be provided using the same function type as the relationship. 


    -------------------  Dose – Response editing interface --------------------   
 ---------------------------------------------------------------------------------
Dose – response editing interface is now available in the Link between Chemical Structure and MIE, as well as part of summary information on tested substances in Test definition. Dose response in the Test definition can also include the data measured for a reference substance. All dependencies are shown in the embedded chart component along with error bars and areas. Appearance of the charts can be customized and saved as part of the description. 


    --------------------  Chemical substance interface  ----------------------
 ---------------------------------------------------------------------------------
Major changes of the chemical structure interface were made with the introduction of substances. While the chemical structure elements represent an abstract notion of chemical a substance represents a physical entity which can be associated with specific supplier or manufacturer. Therefore a single chemical structure can correspond to one or more physical substances. The substances themselves can consist of constituents. Each constituent refers to a specific structure and its typical and actual percent of the mix mass. Each element of the physical mix can be marked as constituent or impurity. Substances can have their own list of identifiers and properties. The new substance interface is embedded in Chemical Structure interface in a collapsible panel


    ------------  Element editor in the Pathway View  ------------------------
 ---------------------------------------------------------------------------------
New element editor is now available in the main pathway viewer available under View tab from the main interface. The new element editor allows users when in edit mode to click on any element of a pathway and load its dedicated editor. When clicking outside of any element the AOP editor is loaded providing overview of the whole pathway. Normal full screen editor is still available with double clicking on the representing visual element (or its title in any editor interface)


    ---------------------  Remote description sections  ----------------------
 ---------------------------------------------------------------------------------
Description sections now can display remote web content not managed in Effectopedia. Two initial sources for remote content were allowed (white listed) Wikipedia and AOP-Wiki. The Wikipedia based description section allows embedding a related Wikipedia pages in the document description. Similarly information from AOP-Wiki can be embedded in Effectopedia. The pages AOP-Wiki content can be directly edited from Effectopedia interface using the normal editing capabilities of AOP-Wiki. 


    ----------------------  Global in-silico models  -------------------------
 ---------------------------------------------------------------------------------
Similarly to Studies which can consist of several lab based experimental assays and tests, several in-silico models can refer to a single global model. A Global in-silico model can be defined and used across several key events and respective (local) in-silico models. The global in-silico model interface is accessible in the in-silico test description can contain mathematical description of the methods used (including MathML formulas) and also a list of parameters describing the model. The parameter list allows users to specify the normal ranged of parameters, mean values, additional descriptors as well as descriptions and references. Each parameter can have more than one value based on different assumptions, references and so on. 

              ***************** File format changes ****************
 *********************************************************************************
- Current file format is version 0.9.61 and is not backward compatible with older versions of Effectopedia (current versions of Effectopedia can still open old versions of the file format but old versions of the program cannot read the current format). The change that produced this lack of backward compatibility is so called DefaultID Negative Revolution. All default objects have negative IDs which are incrementally decreased with the introduction of each new default object. This allows generation of XML files from Java source code which will be used in the future as a backup mechanism. There were several changes in the format related to naming of individual XML elements which also causes lack of backward compatibility. 
 - All experimental and model data are represented in a universal structure called ObjectProperties. This structure is currently used to represent: dose responses and response responses curves, model parameters, analytic function specification, etc. ObjectProperties is a list of ObjectProperty objects each of which has his own type defining its data format. Each object is also array of objects which contain a list of specified values e.g. mean, min, max value, description, reference as well as user defined list of descriptors for example chemical concentration, temperature in which the measurement was taken. Object properties can be also hierarchical and contain a list of sub properties. In summary the structure can represent a table with arbitrary number of columns and rows each cell of which is either simple value or can be another table. 

              *************** Architectural changes ****************
 *********************************************************************************
Major internal source code restructuring was performed to allow cleaner separation of individual modules in line with the adopted OSGI architecture. The essential Effectopedia classes are defined in the kernel bundle of packages which include core, base, data, history, search and other system packages. The kernel does not refer to any external libraries nor depend on any other bundle and can be compiled in a standalone jar with approximate size of 1.5Mb. As part of this package is BaseIO interface which separates the data structure from different format implementations. Multiple implementations can be registered allowing Effectopedia to load and save information from different file formats and systems. Currently two XML format implementations are available one based on JDOM library (originally used in Effectopedia) and one based on Jackson library which is also used for the JSON implementation of BaseIO. All Effectopedia specific graphic representations of objects and their layout is implemented in “go” bundle. This bundle is used as a dependency from the base “gui” bundle which along with “gui.swing” implements the graphic user interface of Effectopedia.  “gui.javafx” library provides rendering of webpages based on java webkit but is currently not available as bundle and prevent the full transition of Effectopedia toward OSGI. 

                ***** Effectopedia < 0.9.62 Alpha Update Log ***** 
*********************************************************************************
Changes log for earlier versions is available in the respective folders under Archive. 
Source: readme.txt, updated 2016-02-28